NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #560 most downloaded on Packagist
Laravel Testing Helper for Packages Development
Latest stable
v11.3.0
Last release 1 months ago
24 Sep 2026
Ships fairly regularly
a new release about every 5 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
13 years old
440 releases · first in 2013
Drag across the ruler to compare, or tap a release to open it.
Update minimum support for Testbench Core v8.4.0+. (v8.3.1...v8.4.0)
setUpTheTestEnvironmentTraitToBeIgnored() method to determine setup<Concern> and teardown<Concern> with imported traits should be use on given trait.laravel/framework to 10.6.1.Support Laravel Framework 10.6.
10.6.Update minimum support for Testbench Core v8.3.1+. (v8.3.0...v8.3.1)
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Orchestra\Testbench\Foundation\Config::addProviders() usage.Orchestra\Testbench\transform_relative_path() logic.Update minimum support for Testbench Core v8.3.0+. (v8.2.0...v8.3.0)
Orchestra\Testbench\Foundation\Bootstrap\LoadMigrationsFromArray class to handle loading migrations from testbench.yaml.
migrations: false in testbench.yaml or adding TESTBENCH_WITHOUT_DEFAULT_MIGRATIONS=(true) environment variable.testbench.yaml:
migrations: <bool|array>bootstrappers: <array>Orchestra\Testbench\parse_environment_variables() function.Orchestra\Testbench\transform_relative_path() function.env configuration from testbench.yaml with have higher priority than default_environment_variables().Dotenv\Repository\Adapter\PutenvAdapter when generating environment variable on the fly using Orchestra\Testbench\Foundation\Application.APP_KEY, APP_DEBUG etc.Support Laravel Framework 10.5.
10.5.> Warning: Breaking change is possible if your package contains any traits with setup or teardown
setup<Concern> and teardown<Concern> with imported traits.package:test and --parallel with PHPUnit 10.Warning: Breaking change is possible if your package contains any traits with
setup<TraitClassName>orteardown<TraitClassName>This version now will automatically run those methods during application bootstrap and terminate to be consistent with Laravel Framework implementations.
Avoid database connection from eager loaded via spatie/laravel-ray.
spatie/laravel-ray.Update minimum support for Laravel Framework to v10.4.1.
v10.4.1.Update minimum support for Laravel Framework to v10.4.0.
v10.4.0.v8.1.0.Update minimum support for Testbench Core v8.0.5+. (v8.0.4...v8.0.5)
Update minimum support for Testbench Core v8.0.4+. (v8.0.2...v8.0.4)
Support Laravel Framework 10.3.
10.3.Support Laravel Framework 10.2.
10.2.Update minimum support for Laravel Framework to v10.1.5.
Update minimum support for Laravel Framework to v10.1.4.
Update minimum support for Testbench Core v8.0.2+. (v8.0.1...v8.0.2)
10.1.app.asset_url config default value from '/' to null.Update minimum support for Testbench Core v8.0.1+. (v8.0.0...v8.0.1)
laravel/framework to 10.0.3.$_composer_autoload_path from composer-runtime-api.Update support for Laravel Framework v10.
Released: 2023-02-14
Add Orchestra\Testbench\Foundation\Env::flushState() method and revert class deprecation.
Orchestra\Testbench\Foundation\Env::flushState() method and revert class deprecation.Orchestra\Testbench\php_version_compare() function.--pretend options on relevant commands.Orchestra\Testbench\Attributes\WithConfig after application has been booted to allow merging configuration via Service Provider by default. Use defer: false parameter to disable this.TESTBENCH_USER_MODEL environment variable when running serve command.Orchestra\Testbench\Foundation\Console\TerminatingConsole when running serve.testbench.yaml configured with seeders: true.Orchestra\Testbench\Attributes\WithConfig shouldn't defer setting up framework configuration.--parallel compatibility with WithFixtures trait.#[UsesVendor] attribute fails due to unbooted application, causing BindingResolutionException to be thrown.Limit compatible guzzlehttp/guzzle version to be used with Laravel Framework 9.
guzzlehttp/guzzle version to be used with Laravel Framework 9.Update minimum support for Testbench Core v7.59.0+. (v7.56.0...v7.59.0)
Orchestra\Testbench\package_version_compare() function.Orchestra\Testbench\Concerns\WithFixtures to automatically loads fixtures file for test.Orchestra\Foundation\Env now extends Orchestra\Sidekick\Env.Illuminate\Support\Str states via during test teardown.Orchestra\Sidekick\package_path() for better root package path detection.Update minimum support for Testbench Core v7.56.0+. (v7.55.0...v7.56.0)
Orchestra\Testbench\PHPUnit\TestCase now implements Orchestra\Testbench\Concerns\InteractsWithMockery.Update minimum support for Testbench Core v7.55.0+. (v7.54.0...v7.55.0)
Orchestra\Testbench\remote() function to use Orchestra\Testbench\Foundation\Process\RemoteCommand.TESTBENCH_ENVIRONMENT_FILE_USING to TESTBENCH_ENVIRONMENT_FILE_USING (internal environment variable).workbench/bootstrap/providers.php.Update minimum support for Testbench Core v7.54.0+. (v7.53.0...v7.54.0)
resolvePhpUnitTestClassName() and resolvePhpUnitTestMethodName() to Orchestra\Testbench\Concerns\InteractsWithPHPUnit trait.usesTestingFeature() to register attribute directly on test method.vendor detection on the default skeleton.Orchestra\Sidekick\is_symlink() function instead of is_link() to improves support on Windows.::class instead of get_class().vendor symlink via package:purge-skeleton command.Orchestra\Testbench\Attributes\UsesVendor::beforeEach() method.Re-add deprecated getBasePath() method pending removal in Testbench 10.0.
orchestra/sidekick.Illuminate\Foundation\Testing\Concerns\InteractsWithViews.getBasePath() method pending removal in Testbench 10.0.Update minimum support for Testbench Core v7.52.0+. (v7.51.0...v7.52.0)
Orchestra\Testbench\Concerns\CreatesApplication::resolveApplicationFacades() method.Orchestra\Testbench\Concerns\CreatesApplication::getApplicationBasePath() method as replacement to Orchestra\Testbench\Concerns\CreatesApplication::getBasePath().Orchestra\Testbench\Foundation\Application::deleteVendorSymlink() method.discover.factories.vendor symlink when terminating Testbench CLI.Update minimum support for Testbench Core v7.51.0+. (v7.50.0...v7.51.0)
Orchestra\Testbench\Workbench\Workbench::flushCachedClassAndNamespaces() to flush cached namespaces and classes during installation.realpath() on vendor:publish output.Update minimum support for Testbench Core v7.50.0+. (v7.49.0...v7.50.0)
Orchestra\Testbench\transform_realpath_to_relative() function.vendor:publish command.$force parameter to Orchestra\Testbench\Workbench\Workbench::detectNamespace() method.Deprecate Orchestra\Testbench\Foundation\Console\Concerns\HandleTerminatingConsole trait, use Orchestra\Testbench\Foundation\Console\TerminatingConsol…
Orchestra\Testbench\Workbench\Workbench::detectNamespace() method.Orchestra\Testbench\Workbench\Workbench::applicationUserModel() method.workbench.auth config to true.package:sync-skeleton command.Orchestra\Testbench\Bootstrap\LoadConfiguration and Orchestra\Testbench\Bootstrap\LoadConfigurationWithWorkbench to allow being extended by Testbench Dusk.Orchestra\Testbench\Console\Commander.$tty parameter to Orchestra\Testbench\remote() function.Orchestra\Testbench\Foundation\Bootstrap\CreateVendorSymlink class and mark it as @api.$backupExistingFile and $resetOnTerminating parameter to following methods in Orchestra\Testbench\Foundation\Console\Concerns\CopyTestbenchFiles trait:
copyTestbenchConfigurationFile()copyTestbenchDotEnvFile()Orchestra\Testbench\Foundation\Console\Concerns\HandleTerminatingConsole trait, use Orchestra\Testbench\Foundation\Console\TerminatingConsole class instead.Update minimum support for Testbench Core v7.48.0+. (v7.47.2...v7.48.0)
Orchestra\Testbench\Foundation\Bootstrap\DeleteVendorSymlink class.Orchestra\Testbench\Concerns\InteractsWithMockery trait.--database option to package:create-sqlite-db command.--database and --all options to package:drop-sqlite-db command.Orchestra\Testbench\php_binary() function.resolveApplicationResolvingCallback() method visibility from private to protected.package:create-sqlite-db.PHP_CLI_SERVER_WORKERS via Composer Script.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.Update minimum support for Testbench Core v7.47.2+. (v7.47.1...v7.47.2)
shouldSeed() exists and return false.Update minimum support for Testbench Core v7.47.1+. (v7.47.0...v7.47.1)
SIGHUP, SIGUSR1, and SIGUSR2 signals via Testbench CLI.serve command to reset published .env and testbench.yaml.Deprecated Orchestra\Testbench\laravel_migration_path(), use default_migration_path() instead.
markTestSkippedWhen() and markTestSkippedUnless() assertion helper to conditionally handle markTestSkipped().Orchestra\Testbench\default_migration_path() helper function.Orchestra\Testbench\laravel_vendor_exists() helper function.vendor symlink directory if it was created while running tests.view.paths configuration not being updated to include workbench/resources/views due to IoC booting sequence.Orchestra\Testbench\laravel_migration_path(), use default_migration_path() instead.Update minimum support for Testbench Core v7.46.0+. (v7.45.0...v7.46.0)
artisan binary to Laravel skeleton.Orchestra\Testbench\join_paths() function.Orchestra\Testbench\Attributes\UsesVendor attribute class.defineStashRoutes() method to register adhoc route for test.afterApplicationCreated(), afterApplicationRefreshed(), and beforeApplicationDestroyed() methods visibility from protected to public.Orchestra\Testbench\default_skeleton_path(), Orchestra\Testbench\package_path(), and Orchestra\Testbench\workbench_path() usage based on new Orchestra\Testbench\join_paths() function.Update minimum support for Testbench Core v7.45.0+. (v7.44.0...v7.45.0)
Orchestra\Testbench\Foundation\Console\Actions\GeneratesFile to remove .gitkeep file when directory contain one or more files.InteractsWithPublishedFiles should only flush published files within database/migrations directory.Update minimum support for Testbench Core v7.44.0+. (v7.43.3...v7.44.0)
Orchestra\Testbench\Attributes\ResolvesLaravelOrchestra\Testbench\Attributes\UsesFrameworkConfigurationfactories using Workbench to map Workbench\App\Models to Workbench\Database\Factories classes.workbench/app/Console/Commands.JsonSerializable to Orchestra\Testbench\Foundation\UndefinedValue.workbench as default environment value.Orchestra\Testbench\Attributes\Define and Orchestra\Testbench\Attributes\DefineEnvironment to be used on the class level by @danjohnson95usesTestingFeature() attribute registration is loaded before class attributes instead of method attributes.Update minimum support for Testbench Core v7.43.3+. (v7.43.2...v7.43.3)
Orchestra\Testbench\Workench\Workbench::applicationExceptionHandler() usage to detect Workbench\App\Exceptions\Handler class.Update minimum support for Testbench Core v7.43.2+. (v7.43.0...v7.43.2)
Orchestra\Testbench\package_path() function instead of TESTBENCH_WORKING_PATH constant.Orchestra\Testbench\Attributes\RequiresLaravel attribute usage.Update minimum support for Testbench Core v7.43.0+. (v7.42.6...v7.43.0)
TESTBENCH_WORKING_PATH from environment variable before fallback to getcwd().Update minimum support for Testbench Core v7.42.6+. (v7.42.5...v7.42.6)
Orchestra\Testbench\remote to accept $env with either array or string.TESTBENCH_PACKAGE_REMOTE=true when running command using Orchestra\Testbench\remote.Update minimum support for Testbench Core v7.42.5+. (v7.42.4...v7.42.5)
RefreshDatabase to be executed on tearDown() only limited when ad-hoc migrations was added during test.Update minimum support for Testbench Core v7.42.4+. (v7.42.0...v7.42.4)
ResetRefreshDatabaseState via tearDownTheTestEnvironmentUsingTestCase() method.RefreshDatabaseState::$migrated and RefreshDatabaseState::$lazilyRefreshed before loading migration paths to the instance of migrator.beforeApplicationDestroyed() usage on loadLaravelMigrations() method.RefreshDatabase usage does not reset the database migrations between tests.class_implements(): Class AllowDynamicProperties does not exist and could not be loaded error on PHP 8.1 and lower.Update minimum support for Testbench Core v7.42.0+. (v7.40.1...v7.42.0)
Orchestra\Testbench\Attributes\RequiresLaravel attribute.Orchestra\Testbench\Foundation\Env::has() method.Orchestra\Testbench\once() function.Orchestra\Testbench\load_migration_paths() function.usesRefreshDatabaseTestingConcern() helper method to Orchestra\Testbench\Concerns\InteractsWithTestCase trait.MYSQL_*, MSSQL_*, SQLITE_* and POSTGRES_* environment variables before trying to override the configuration values.$command to Orchestra\Testbench\remote() function using array instead of just string.Orchestra\Testbench\Attributes\ResetRefreshDatabaseState attribute declaration to only Attribute::TARGET_CLASS.Update minimum support for Testbench Core v7.40.1+. (v7.40.0...v7.40.1)
$router->getRoutes()->refreshActionLookups() caused tests to fail.Update minimum support for Testbench Core v7.40.0+. (v7.39.0...v7.40.0)
Orchestra\Testbench\Attributes\WithImmutableDates attribute to force Illuminate\Support\Date to use Carbon\CarbonImmutable.Orchestra\Testbench\default_skeleton_pathOrchestra\Testbench\refresh_router_lookupsAdded support for LOG_DEPRECATIONS_WHILE_TESTING (default to true) environment variables.
Orchestra\Testbench\Features\TestingFeature as replacement to HandlesTestingFeature trait.LOG_DEPRECATIONS_WHILE_TESTING (default to true) environment variables.Orchestra\Testbench\Contracts\Attributes\AfterAllOrchestra\Testbench\Contracts\Attributes\AfterEachOrchestra\Testbench\Contracts\Attributes\BeforeAllOrchestra\Testbench\Contracts\Attributes\BeforeEachOrchestra\Testbench\Concerns\InteractsWithPHPUnit.Orchestra\Testbench\Concerns\HandlesTestingFeature trait.Update minimum support for Testbench Core v7.38.0+. (v7.37.0...v7.38.0)
Orchestra\Testbench\Attributes\RequiresEnv attribute to force an environment variables to be required for the test.Orchestra\Testbench\Attributes\WithConfig attribute add a configuration value for the test.Orchestra\Testbench\Attributes\WithEnv attribute add an environment variable value for the test.set() and forget() methods to Orchestra\Testbench\Foundation\Env.Update minimum support for Testbench Core v7.37.0+. (v7.36.0...v7.37.0)
discovers.components configuration.view.paths configuration when Workbench discover views.Deprecate Orchestra\Testbench\Concerns\Database\HandlesConnections trait.
Orchestra\Testbench\Attributes\ResetRefreshDatabaseState attribute to force refreshing database before executing the test.Orchestra\Testbench\Foundation\Bootstrap\SyncDatabaseEnvironmentVariables bootstrap class and allow database collation to be configurable via environment variables using MYSQL_COLLATION, POSTGRES_COLLATION and MSSQL_COLLATION.defer when using Orchestra\Testbench\Attributes\DefineDatabase.Orchestra\Testbench\Concerns\Database\HandlesConnections trait.Update minimum support for Testbench Core v7.35.0+. (v7.34.0...v7.35.0)
laravel, cache, notifications, queue and session database migrations using Orchestra\Testbench\Attributes\WithMigration.Orchestra\Testbench\defined_environment_variables() function.Orchestra\Testbench\laravel_migration_path() function.Orchestra\Testbench\remote() function.@api:
Orchestra\Testbench\Foundation\ApplicationOrchestra\Testbench\Foundation\ConfigOrchestra\Testbench\Foundation\EnvOrchestra\Testbench\PHPUnit\AttributeParser.Add support for Workbench 7.0+.
Deprecate Orchestra\Testbench\Concerns\WithFactories.
Orchestra\Testbench\Workbench\Workbench to handle integrations with Workbench.Orchestra\Testbench\Foundation\Config::getWorkbenchDiscoversAttributes() method.Orchestra\Testbench\Concerns\Database\InteractsWithSqliteDatabaseFile trait.Orchestra\Testbench\Foundation\Application:
make()makeFromConfig()createFromConfig()@define-env and @environment-setup will be replaced with Orchestra\Testbench\Attributes\DefineEnvironment.@define-db will be replaced with Orchestra\Testbench\Attributes\DefineDatabase.@define-route will be replaced with Orchestra\Testbench\Attributes\DefineRoute.Orchestra\Testbench\package_path() and Orchestra\Testbench\workbench_path().Orchestra\Testbench\Concerns\WithFactories.Orchestra\Testbench\Foundation\Bootstrap\StartWorkbench, use Orchestra\Testbench\Workbench\Workbench::start() or Orchestra\Testbench\Workbench\Workbench::startWithProviders() instead.Update minimum support for Testbench Core v7.33.0+. (v7.32.0...v7.33.0)
Orchestra\Testbench\Bootstrap\LoadEnvironmentVariables class as @internal.Update minimum support for Testbench Core v7.32.0+. (v7.31.0...v7.32.0)
cachedConfigurationForWorkbench() to Orchestra\Testbench\Concern\InteractsWithWorkbench trait.TESTBENCH_WORKING_PATH from environment variables for Testbench Dusk usage.discovers configuration.usesSqliteInMemoryDatabaseConnection to Orchestra\Testbench\Concerns\HandlesDatabases trait.Update minimum support for Testbench Core v7.31.0+. (v7.30.0...v7.31.0)
Orchestra\Testbench\Concerns\InteractsWithPublishedFiles trait:
assertMigrationFileExists.assertMigrationFileNotExists.Orchestra\Testbench\Concerns\InteractsWithPublishedFiles::$files property.assertMigrationFileContains and assertMigrationFileNotContains from Orchestra\Testbench\Concerns\InteractsWithPublishedFiles trait.Orchestra\Testbench\Concerns\InteractsWithPublishedFiles trait:
cleanUpFiles to cleanUpPublishedFiles.cleanUpMigrationFiles to cleanUpPublishedMigrationFiles.getMigrationFile to findFirstPublishedMigrationFile.Update minimum support for Testbench Core v7.30.0+. (v7.29.1...v7.30.0)
Orchestra\Testbench\Concerns\WithLaravelMigrations.Orchestra\Testbench\Foundation\Console\Actions\DeleteFilesOrchestra\Testbench\Foundation\Console\Actions\DeleteDirectoriesOrchestra\Testbench\Foundation\Console\Actions\EnsureDirectoryExistsOrchestra\Testbench\Foundation\Console\Actions\GeneratesFileUpdate minimum support for Testbench Core v7.29.1+. (v7.29.0...v7.29.1)
$model property override when extending Orchestra\Testbench\Factories\UserFactory.Update minimum support for Testbench Core v7.29.0+. (v7.28.3...v7.29.0)
workbench.welcome configuration option.testbench.yaml configuration fallback similar to .env.Illuminate\Support\LazyCollection.Orchestra\Workbench\WorkbenchServiceProvider when applying Orchestra\Testbench\Concerns\WithWorkbench.Update minimum support for Testbench Core v7.28.3+. (v7.28.2...v7.28.3)
Orchestra\Testbench\Concerns\WithWorkbench.Readd deprecated Orchestra\Testbench\Foundation\Console\DevToolCommand for integration compatibility.
Orchestra\Testbench\Foundation\Console\DevToolCommand for integration compatibility.serve command under Composer's script.One column per quarter.