coders-tm/laravel-core / .agents/skills/testbench-docs
testbench-package-testing
VerifiedDevelops and tests Laravel packages using Orchestra Testbench. Activates when writing package tests, configuring testbench.yaml, managing migrations, defining routes/environment for tests, using Testbench Dusk for browser tests, or working with Workbench for package preview.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.2 KB |
| api-examples.md | markdown | 907 B |
| getting-started.md | markdown | 3.2 KB |
| getting-started/configuration.md | markdown | 5.2 KB |
| markdown-examples.md | markdown | 1.0 KB |
| testbench-dusk.md | markdown | 3.3 KB |
| testbench-dusk/the-basic.md | markdown | 3.3 KB |
| testbench-dusk/troubleshooting.md | markdown | 1.7 KB |
| testbench.md | markdown | 2.7 KB |
| testbench/cli.md | markdown | 1.9 KB |
| testbench/integrations.md | markdown | 2.0 KB |
| testbench/the-basic.md | markdown | 6.4 KB |
| testbench/the-basic/databases.md | markdown | 5.0 KB |
| testbench/the-basic/environment.md | markdown | 4.9 KB |
| testbench/the-basic/routes.md | markdown | 2.3 KB |
| testbench/troubleshooting.md | markdown | 3.5 KB |
| workbench.md | markdown | 1.2 KB |
testbench.md
View on GitHub---
prev: false
next:
text: 'The Basic'
link: '/testbench/the-basic'
---
# Introduction
Testbench simplifies the process to create feature and integration tests for your Laravel packages without massive configuration and build steps.
[[toc]]
## Installing
You can install **Testbench** using the following command:
```bash
composer require --dev "orchestra/testbench"
```
Next, you can run the following command to scaffold your package with the recommended setup:
```bash
vendor/bin/testbench workbench:install
```
## Version Compatibility
Laravel | Testbench
:---------|:----------
5.x.x | 3.x.x
6.x | 4.x
7.x | 5.x
8.x | 6.x
9.x | 7.x
10.x | 8.x
11.x | 9.x
12.x | 10.x
## Configuration
Please refer to [Configuration](/getting-started/configuration) documentation for further details.
## Getting Started
To use Testbench Component, all you need to do is extend `Orchestra\Testbench\TestCase` instead of `PHPUnit\Framework\TestCase`. The fixture `app` booted by `Orchestra\Testbench\TestCase` is predefined to follow the base application skeleton of Laravel.
```php
class TestCase extends \PHPUnit\Framework\TestCase # [!code --]
class TestCase extends \Orchestra\Testbench\TestCase # [!code ++] # [!code focus]
{
//
}
```
### PHPUnit Configuration
You can separate your tests in your `phpunit.xml` file by providing different test suites, allowing you to run your Feature tests on demand.
For example:
```xml
<testsuites> # [!code focus]
<testsuite name="Feature"> # [!code ++:3] # [!code focus:3]
<directory suffix="Test.php">./tests/Feature</directory>
</testsuite>
<testsuite name="Unit">
<directory suffix="Test.php">./tests/Unit</directory>
</testsuite>
</testsuites> # [!code focus]
```
Run only your feature tests by running PHPUnit with the `--testsuite=Feature` option.
```bash
vendor/bin/phpunit --testsuite=Feature
```
### Autoloading using `testbench.yaml`
Testbench will use the configuration values defined in `testbench.yaml` and use its value when the `TestCase` class uses `Orchestra\Testbench\Concerns\WithWorkbench` trait:
```php
use Orchestra\Testbench\Concerns\WithWorkbench; # [!code ++] # [!code focus]
class TestCase extends \Orchestra\Testbench\TestCase
{
use WithWorkbench; # [!code ++] # [!code focus]
}
```
#### Package Service Providers
Using `WithWorkbench` will make `TestCase` uses `providers` configuration value from `testbench.yaml`:
```yaml
providers:
- Laravel\Sanctum\SanctumServiceProvider
- Workbench\App\Providers\WorkbenchServiceProvider
```
#### Using Custom Laravel Skeleton
Using `WithWorkbench` will make `TestCase` uses `laravel` configuration value from `testbench.yaml`:
```yaml
laravel: ./skeleton
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |