speeding-up-laravel-tests
Speeding up Laravel tests
A curated list of techniques for making Laravel test suites faster. Apply these in roughly the order shown; environment fixes usually give the biggest wins for the least effort.
When to use
- Test suite takes more than a few seconds per test on average.
- CI duration is climbing and you want to knock minutes off.
- A specific test is slow and you want to audit what it is actually doing.
- You are onboarding a new project and want a standard checklist.
Environment and config
- Set
BCRYPT_ROUNDS=4in.env.testing(orphpunit.xml). Default is 12 and hashing dominates auth tests. - Disable XDebug. Disable pcov too at scale unless you specifically need coverage.
- Disable background packages in the testing environment: Pulse, Telescope, Nightwatch, and similar 3rd-party packages that do work on every request/command.
- Use
WithCachedConfigandWithCachedRoutestraits to avoid re-parsing config and routes on every test. - Call
withoutVite()(orwithoutMix()) in your test setup so the framework does not try to resolve built assets.
Fake external interactions
Any interaction with an outside service that is not the subject of the test should be faked.
Notification::fake(),Mail::fake(),Bus::fake(),Event::fake(),Queue::fake().- HTTP endpoints that dispatch jobs: fake the queue unless the test is asserting job behavior. Otherwise the jobs execute inline and pull in everything they touch.
- Event listeners: if unrelated listeners are firing and doing work,
Event::fake()them. Use Laravel's event system to discover what is being triggered during a slow test. Http::preventingStrayRequests()in your test suite. A single slow stray request can punish every test. Note this only catches requests made through Laravel's HTTP client. Audit direct Guzzle / cURL usage separately.Sleep::fake(syncWithCarbon: true)so retries and backoffs do not actually sleep. Requires your code to use theSleephelper rather than PHP'ssleep().Exceptions::fake()to make sure you are not reporting to Flare/Sentry/Bugsnag from within tests.
Database
LazilyRefreshDatabaseinstead ofRefreshDatabase. Tests that never touch the DB skip the migration/truncation cost entirely.- Audit factory usage. Factories are a common hotspot because it is easy to create more models than a test needs. Look for nested
create()calls spawning extra rows. - Use
$factory->recycle($model)to create a shared parent once and thread it through nested factory calls, instead of each nested factory creating its own parent.
Profile and diagnose
./vendor/bin/pest --profileprints the slowest tests per shard. Start there. Patterns in the top-10 often apply suite-wide.- Visualize the suite with https://marmelab.com/phpunit-d3-report/ (originally PHPUnit; verify Pest compatibility).
- When a slow test is mysterious, instrument event listeners or add temporary logging to find the unexpected work happening behind the scenes.
Quick reference
| Area | Action |
|---|---|
| Hashing | BCRYPT_ROUNDS=4 |
| Debuggers | Disable XDebug, disable pcov |
| Background pkgs | Disable Pulse, Telescope, Nightwatch |
| Config / routes | WithCachedConfig, WithCachedRoutes |
| Assets | withoutVite() / withoutMix() |
| External services | Notification::fake(), Mail::fake(), Bus::fake(), Event::fake(), Queue::fake() |
| HTTP | Http::preventingStrayRequests() |
| Sleep | Sleep::fake(syncWithCarbon: true) |
| Exceptions | Exceptions::fake() |
| DB | LazilyRefreshDatabase |
| Factories | $factory->recycle($model), audit nested creates |
| Profiling | pest --profile |
Common mistakes
- Enabling
RefreshDatabaseon every test even when the test does not hit the DB. - Calling real
sleep()or using Carbon in production code, which preventsSleep::fake()from helping. - Adding
Queue::fake()but still asserting side effects of the job (those will never happen). - Running the suite with XDebug loaded "just in case" a test fails.
- Leaving
BCRYPT_ROUNDSat the default because.env.testingwas never created.
More from freekmurze/dotfiles
php-guidelines-from-spatie
Describes PHP and Laravel guidelines provided by Spatie. These rules result in more maintainable, and readable code.
144context7-auto-research
Automatically fetches up-to-date documentation from Context7 when users ask about libraries, frameworks, APIs, or need code examples. Triggers proactively without explicit user request.
27react-native-best-practices
Provides React Native performance optimization guidelines for FPS, TTI, bundle size, memory leaks, re-renders, and animations. Applies to tasks involving Hermes optimization, JS thread blocking, bridge overhead, FlashList, native modules, or debugging jank and frame drops.
24agent-browser
Automates browser interactions for web testing, form filling, screenshots, and data extraction. Use when the user needs to navigate websites, interact with web pages, fill forms, take screenshots, test web applications, or extract information from web pages.
24copy-editing
When the user wants to edit, review, or improve existing marketing copy. Also use when the user mentions 'edit this copy,' 'review my copy,' 'copy feedback,' 'proofread,' 'polish this,' 'make this better,' or 'copy sweep.' This skill provides a systematic approach to editing marketing copy through multiple focused passes.
24fix-github-issue
Fix GitHub issues using gh CLI. Use when asked to fix, resolve, or address a GitHub issue. Creates fixes on separate branches, runs tests locally, and creates PRs when tests pass. Requires gh CLI authenticated and repo cloned locally.
22