CHANGELOG-9.x.md

Changes for 9.x

This changelog references the relevant changes (bug and security fixes) done to orchestra/testbench-core.

9.9.0

Released: 2024-12-24

Added

• Add ability to symlink directory in from skeleton to package.

Changes

• Use realpath() on vendor:publish output.

9.8.2

Released: 2024-12-19

Changes

• Add Orchestra\Testbench\Workbench\Workbench::flushCachedClassAndNamespaces() to flush cached namespaces and classes during installation.

9.8.1

Released: 2024-12-18

Changes

• Update skeleton to match v11.5.0.

9.8.0

Released: 2024-12-15

Added

• Added Orchestra\Testbench\transform_realpath_to_relative() function.
• Override Laravel's vendor:publish command.

Changes

• Add $force parameter to Orchestra\Testbench\Workbench\Workbench::detectNamespace() method.

9.7.3

Released: 2024-12-14

Fixes

• Fixes database seeding using Orchestra\Testbench\Concerns\WithWorkbench and Illuminate\Foundation\Testing\RefreshDatabase.

9.7.2

Released: 2024-12-06

Fixes

• Fixes Orchestra\Testbench\phpunit_version_compare() function on PHPUnit (dev).

9.7.1

Released: 2024-12-05

Changes

• Add support for PHPUnit 11.5.

Fixes

• Fixes usesSqliteInMemoryDatabaseConnection() to be able to handled named in-memory SQLite connections.

9.7.0

Released: 2024-12-01

Added

• Added ability to detect Workbench namespace via Orchestra\Testbench\Workbench\Workbench::detectNamespace() method.
• Added ability to detect the default user model via Orchestra\Testbench\Workbench\Workbench::applicationUserModel() method.
• Added support for authentication routes within Workbench by configurating workbench.auth config to true.
• Added new package:sync-skeleton command.

Changes

• Testbench Dusk integration improvements:
  • Refactor Orchestra\Testbench\Bootstrap\LoadConfiguration and Orchestra\Testbench\Bootstrap\LoadConfigurationWithWorkbench to allow being extended by Testbench Dusk.
  • Refactor Orchestra\Testbench\Console\Commander.
• Add $tty parameter to Orchestra\Testbench\remote() function.
• Refactor Orchestra\Testbench\Foundation\Bootstrap\CreateVendorSymlink class and mark it as @api.
• Add $backupExistingFile and $resetOnTerminating parameter to following methods in Orchestra\Testbench\Foundation\Console\Concerns\CopyTestbenchFiles trait:
  • copyTestbenchConfigurationFile()
  • copyTestbenchDotEnvFile()
• Supports laravel/serializable-closure v2.

Deprecated

• Deprecate Orchestra\Testbench\Foundation\Console\Concerns\HandleTerminatingConsole trait, use Orchestra\Testbench\Foundation\Console\TerminatingConsole class instead.

9.6.4

Released: 2024-12-06

Fixes

• Fixes Orchestra\Testbench\phpunit_version_compare() function on PHPUnit (dev).

9.6.3

Released: 2024-12-05

Changes

• Add support for PHPUnit 11.5.

Fixes

• Fixes usesSqliteInMemoryDatabaseConnection() to be able to handled named in-memory SQLite connections.

9.6.2

Released: 2024-11-21

Fixes

• Fixes route:cache when health: true configured using testbench.yaml.

9.6.1

Released: 2024-11-20

Fixes

• Fixes compatibility with Laravel Framework v11.33.0.

9.6.0

Released: 2024-11-18

Added

• Added Orchestra\Testbench\Foundation\Bootstrap\DeleteVendorSymlink class.
• Added Orchestra\Testbench\Concerns\InteractsWithMockery trait.
• Added --database option to package:create-sqlite-db command.
• Added --database and --all options to package:drop-sqlite-db command.
• Added Orchestra\Testbench\php_binary() function.
• Allows laravel/serializable-closure 2.
• Added draft support for PHP 8.4.

9.5.6

Released: 2024-10-31

Fixed

• Fixed #[WithMigration('queue')] should load the default migrations.

9.5.5

Released: 2024-10-25

Changes

• Ensure database directory exists when running package:create-sqlite-db.
• Allow configuring PHP_CLI_SERVER_WORKERS via Composer Script.

9.5.4

Released: 2024-10-24

Changes

• Improves CTRL+C and CTRL+BREAK supports on Windows without pcntl extension.
• Orchestra\Testbench\Foundation\Console\Actions\GeneratesFile should be able to handle $from and $to when given as false or null.

9.5.3

Released: 2024-10-06

Fixes

• Prevent seeder from being executed when shouldSeed() exists and return false.

9.5.2

Released: 2024-10-05

Changes

• Listen to SIGHUP, SIGUSR1, and SIGUSR2 signals via Testbench CLI.

Fixes

• Fixes Testbench CLI signals via serve command to reset published .env and testbench.yaml.

9.5.1

Released: 2025-09-25

Changes

• Update config/concurrency.php configuration file.

9.5.0

Released: 2024-09-23

Added

• Added Orchestra\Testbench\Attributes\RequiresDatabase attribute class.
• Added markTestSkippedWhen() and markTestSkippedUnless() assertion helper to conditionally handle markTestSkipped().
• Added Orchestra\Testbench\default_migration_path() helper function.
• Added Orchestra\Testbench\laravel_vendor_exists() helper function.
• Allows TestCase to inherit Attributes defined on parent TestCase by @BlackLanzer in #233.

Changes

• Allow Testbench to delete vendor symlink directory if it was created while running tests.

Fixes

• Fixes view.paths configuration not being updated to include workbench/resources/views due to IoC booting sequence.

Deprecated

• Deprecated Orchestra\Testbench\laravel_migration_path(), use default_migration_path() instead.

9.4.1

Released: 2024-09-12

Changes

• Add concurrency.php configuration based on Laravel Framework 11.23.

9.4.0

Released: 2024-08-26

Added

• Added artisan binary to Laravel skeleton.
• Added Orchestra\Testbench\join_paths() function.
• Added Orchestra\Testbench\Attributes\UsesVendor attribute class.
• Added defineStashRoutes() method to register adhoc route for test.

Changes

• Improvements to Orchestra\Testbench\default_skeleton_path(), Orchestra\Testbench\package_path(), and Orchestra\Testbench\workbench_path() usage based on new Orchestra\Testbench\join_paths() function.

9.3.0

Released: 2024-08-14

Changes

• Update Orchestra\Testbench\Foundation\Console\Actions\GeneratesFile to remove .gitkeep file when directory contain one or more files.
• Code Improvements.

9.2.3

Released: 2024-06-28

Changes

• Add support for PHPUnit 11.3 by @kayw-geek in #220.

9.2.2

Released: 2024-07-19

Fixes

• Fixes InteractsWithPublishedFiles should only flush published files within database/migrations directory.

9.2.1

Released: 2024-07-13

Changes

• Change resolveApplicationResolvingCallback() method visibility from private to protected.

9.2.0

Released: 2024-07-13

Added

• Added new attributes:
  • Orchestra\Testbench\Attributes\ResolvesLaravel
  • Orchestra\Testbench\Attributes\UsesFrameworkConfiguration
• Allows to discover factories using Workbench to map Workbench\App\Models to Workbench\Database\Factories classes.
• Allows to auto discover console command classes from workbench/app/Console/Commands.

Changes

• Bump minimum support to Laravel Framework v11.11.
• Implements JsonSerializable to Orchestra\Testbench\Foundation\UndefinedValue.
• Update skeleton to use workbench as default environment value.
• Allow Orchestra\Testbench\Attributes\Define and Orchestra\Testbench\Attributes\DefineEnvironment to be used on the class level by @danjohnson95

Fixes

• Ensure usesTestingFeature() attribute registration is loaded before class attributes instead of method attributes.

9.1.9

Released: 2024-07-10

Changes

• Update skeleton to match v11.1.3.
• Includes server.php improvements from Laravel Framework 11.14.

9.1.8

Released: 2024-06-28

Changes

• Add support for PHPUnit 11.2.

9.1.7

Released: 2024-06-26

Fixes

• Fixes overrideApplicationAliases() and overrideApplicationProviders() unable to override packages aliases or providers.

9.1.6

Released: 2024-06-10

Changes

• Defer setting default Rate Limiter until cache.store is resolved.

9.1.5

Released: 2024-06-10

Changes

• Fallback app.providers using Illuminate\Support\DefaultProviders when the configuration return null.

9.1.4

Released: 2024-06-06

Changes

• Allow $latestResponse static property to be optional.

9.1.3

Released: 2024-06-04

Fixes

• Fixes Orchestra\Testbench\Workench\Workbench::applicationExceptionHandler() usage to detect Workbench\App\Exceptions\Handler class.
• Fixes Orchestra\Testbench\Console\Kernel and Orchestra\Testbench\Foundation\Console\Kernel unable to discover commands.

9.1.2

Released: 2024-06-01

Fixes

• Fixes Orchestra\Testbench\Attributes\RequiresLaravel attribute usage.

9.1.1

Released: 2024-05-23

Changes

• Utilise Orchestra\Testbench\package_path() function instead of TESTBENCH_WORKING_PATH constant.
• Update configuration to match Laravel Framework v11.8.0.

9.1.0

Released: 2024-05-21

Changes

• Uses TESTBENCH_WORKING_PATH from environment variable before fallback to getcwd().
• PHPStan Improvements.

9.0.16

Released: 2024-05-09

Changes

• Update skeleton to match v11.0.7.

9.0.15

Released: 2024-04-24

Changes

• Add support for PHPUnit 11.1.

9.0.14

Released: 2024-04-21

Fixes

• Fixes routing registration using macro with Workbench.

9.0.13

Released: 2024-04-16

Fixes

• Fixes serve command.

9.0.12

Released: 2024-04-13

Changes

• Allows Orchestra\Testbench\remote to accept $env with either array or string.
• Includes TESTBENCH_PACKAGE_REMOTE=true when running command using Orchestra\Testbench\remote.

Fixes

• Fixes runningInUnitTests() returning true when not running tests via Testbench CLI.

9.0.11

Released: 2024-04-08

Changes

• Flush Static Improvements.
• Revert setting workbench environment variable when Testbench CLI is used outside of testing.

9.0.10

Released: 2024-04-05

Fixes

• Fixes runningInUnitTests() returning true when not running tests via Testbench CLI.

9.0.9

Released: 2024-03-27

Fixes

• Force reset RefreshDatabaseState when using LazilyRefreshDatabase with SQLite :in-memory: database connections.

9.0.8

Released: 2024-03-26

Changes

• Add support for HASH_VERIFY environment variables.

9.0.7

Released: 2024-03-25

Fixes

• Fixes RefreshDatabase to be executed on tearDown() only limited when ad-hoc migrations was added during test.

9.0.6

Released: 2024-03-19

Changes

• Run ResetRefreshDatabaseState via tearDownTheTestEnvironmentUsingTestCase() method.

Fixes

• Fixes beforeApplicationDestroyed() usage on loadLaravelMigrations() method.

9.0.5

Released: 2024-03-19

Fixes

• Fixes RefreshDatabase usage does not reset the database migrations between tests.

9.0.4

Released: 2024-03-18

Changes

• Check against RefreshDatabaseState::$migrated and RefreshDatabaseState::$lazilyRefreshed before loading migration paths to the instance of migrator.
• Update skeleton to match v11.0.3.

Fixes

• Fixes class_implements() should only be executed if the Attribute class exists.

9.0.3

Released: 2024-03-14

Changes

• Revert default skeleton database collations to utf8mb4_unicode_ci.

9.0.2

Released: 2024-03-14

Fixes

• Testbench CLI should prioritize application kernels defined via bootstrap/app.php when configured using a custom skeleton.

9.0.1

Released: 2024-03-13

Added

• Added usesRefreshDatabaseTestingConcern() helper method to Orchestra\Testbench\Concerns\InteractsWithTestCase trait.

Changes

• Bump minimum laravel/framework to 11.0.3.

9.0.0

Released: 2024-03-12

Added

• Added support for PHPUnit 11.
• Added new Orchestra\Testbench\Concerns\WithLaravelBootstrapFile trait.
• Added Orchestra\Testbench\Attributes\RequiresLaravel attribute.
• Added Orchestra\Testbench\load_migration_paths() function.

Changes

• Update support for Laravel Framework v11.
• Increase minimum PHP version to 8.2 and above (tested with 8.2 and 8.3).
• Validate MYSQL_*, MSSQL_*, SQLITE_* and POSTGRES_* environment variables before trying to override the configuration values.

Deprecated

• Deprecate Orchestra\Testbench\Concerns\HandlesAnnotations in line with PHPUnit removal support for meta-comment support using annotation.

Removed

• Remove deprecated Orchestra\Testbench\Concerns\Database\HandlesConnections trait.
• Removed deprecated create-sqlite-db and drop-sqlite-db standalone commands.