Download the PHP package morrislaptop/laravel-boot-maker without Composer

Laravel Boot Maker

When you extend TestCase, you're booting the whole framework for each test in your suite. It's likely that you're not using all the features for each test, slowing down your test suite considerably.

This package allows you to "opt in" to boot just the Laravel features you need for your test to pass. Your test will run much quicker as a result.

Installation

You can install the package via composer:

Create the following trait in tests/CreatesPartialApplication.php

Create a base partial test class which uses this trait at tests/PartialTestCase.php

Usage

It's recommended to get the tests passing using the full TestCase first, and then drop down to PartialTestCase and select only the Laravel features you need.

This approach ensures you're only using the Laravel features you think are using, which might be useful if trying to decouple from the framework bit.

HTTP requests and authentication

Routes lets $this->get() and friends run without a full boot:

• Errors still render: a missing route is a 404, a failed validation is a 422.
• Route model binding works. A missing model is a 404. Add Database for it.
• Middleware does not run. Test middleware on the full TestCase.
• Route files run your code, so a route test can need concerns it does not seem to use. Add what the error names.
• Auth is enough for actingAs(), $request->user() and $request->session(). To find a user by id, add Database too.

Extra service providers

Put providers that no concern covers on your base test case:

Only Routes, Console and AdditionalProviders register them. Use AdditionalProviders when a test needs a provider but makes no request and runs no command.

• One test can add a provider on top of the base list:

• Providers that change the database layer, for example by rebinding db.factory, go in databaseProviders(). Database registers them before the database manager is built.

Commands and migrations

Console lets $this->artisan() run without a full boot. RefreshDatabase and DatabaseMigrations use it.

On Laravel 11 and later, list the commands the test runs:

• The schedule is not available. Resolving it throws FullBootRequired.
• Without Console, $this->artisan() throws FullBootRequired.
• $this->seed() runs the seeders directly. It needs Database, not Console.
• Both run migrate:fresh. They ignore an override of refreshTestDatabase().

Traps

• Database alone does not roll back. A test that writes keeps its rows. Use DatabaseTransactions or RefreshDatabase for those. Both include Database.
• app('redis') needs the Redis concern. Without it you get Nothing is bound for [redis], not phpredis' own Redis class.
• A file can pass alone and fail in the full suite, because an earlier full boot leaves global state behind. Run the whole suite before you keep a conversion.
• You may see new PHP deprecation warnings. A full boot hides them; a partial boot does not. They come from your code or its dependencies, not from this package.
• Your full TestCase may reset static state in setUp(), like a static cache. The partial base does not inherit that, so do it there too.

For a full list of features to enable, see src/Concerns;

You can easily create your own Concerns by including it in a TestCase and ensuring it has the setUpXXXX and tearDownXXXX methods.

AI agents

This package ships Laravel Boost resources, so agents working in an app that installs it know how to use it without being told:

• resources/boost/guidelines/core.blade.php — a short always-loaded note on the base class and the concern convention.
• resources/boost/skills/partial-boot-testing/ — an on-demand skill with the conversion workflow, an error-to-concern table, and what each concern registers.

Users pick these up with php artisan boost:install, or php artisan boost:update --discover in an app that already has Boost.

Testing

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

Inspired by @ekvedaras at @gosuperscript

• Craig Morris
• All Contributors

License

The MIT License (MIT). Please see License File for more information.

Todo

• [ ] Installer to create CreatesPartialApplication and PartialTestCase
• [ ] Listener to determine what Laravel features are used