trait HandlesRoutes

Traits

Properties

static protected array<class-string, array<class-string, class-string>> $cachedTestCaseUses

Cached traits used by each test case class.

from  InteractsWithTestCase
static protected array<int, array{key: class-string, instance: object}> $testCaseTestingFeatures

Programmatically added class-level testing features.

from  InteractsWithTestCase
static protected array<int, array{key: class-string, instance: object}> $testCaseMethodTestingFeatures

Programmatically added method-level testing features.

from  InteractsWithTestCase
protected null|Closure): void $testCaseSetUpCallback

The cached test case setUp resolver.

from  InteractsWithPHPUnit
protected null|Closure): void $testCaseTearDownCallback

The cached test case tearDown resolver.

from  InteractsWithPHPUnit
static protected array<string, array<int, array{key: class-string, instance: object}>> $cachedTestCaseClassAttributes

Cached class attributes by class name.

from  InteractsWithPHPUnit
static protected array<string, array<int, array{key: class-string, instance: object}>> $cachedTestCaseMethodAttributes

Cached method attributes by "class:method" key.

from  InteractsWithPHPUnit
null|Application $app from  InteractsWithPHPUnit
protected bool $syncTestbenchRoutesHasRun

Whether Testbench routes have been synchronized for this test.

protected bool $testbenchRouteCleanupRegistered

Whether route file cleanup has been registered for this test.

protected bool $reloadingApplicationForCachedRoutes

Whether defineCacheRoutes() is reloading the application to load cached routes.

protected array<int, string> $testbenchRouteFiles

Route files written by this test instance.

Methods

static bool
usesTestingConcern(string|null $trait = null)

Check if the test case uses a specific trait.

static bool
usesRefreshDatabaseTestingConcern()

Determine if the test case uses refresh-database testing concerns.

static array
cachedUsesForTestCase()

Cache and return traits used by test case.

static void
usesTestingFeature(object $attribute, int $flag = Attribute::TARGET_CLASS)

Programmatically add a testing feature attribute.

static Collection
resolvePhpUnitAttributesForMethod(string $className, string|null $methodName = null)

Resolve PHPUnit method attributes for specific method.

void
setUpTheTestEnvironmentUsingTestCase()

Execute BeforeEach lifecycle attributes.

void
tearDownTheTestEnvironmentUsingTestCase()

Execute AfterEach lifecycle attributes.

static void
setUpBeforeClassUsingTestCase()

Execute BeforeAll lifecycle attributes.

static void
tearDownAfterClassUsingTestCase()

Execute AfterAll lifecycle attributes and clear caches.

bool
isRunningTestCase()

Determine if the object is running as a PHPUnit test case.

string|null
resolvePhpUnitTestClassName()

Resolve the PHPUnit test class name.

string|null
resolvePhpUnitTestMethodName()

Resolve the PHPUnit test method name.

resolvePhpUnitAttributes()

Resolve and cache PHPUnit attributes for current test.

void
setUpTheEnvironmentUsing(Closure $setUp)

Define the setUp environment using callback.

void
tearDownTheEnvironmentUsing(Closure $tearDown)

Define the tearDown environment using callback.

static void
setUpBeforeClassUsingPHPUnit()

Cache uses for test case before class runs.

static void
tearDownAfterClassUsingPHPUnit()

Clear PHPUnit caches after class teardown.

void
setUpApplicationRoutes(Application $app)

Setup application routes.

void
defineRoutes(Router $router)

Define routes setup.

void
defineWebRoutes(Router $router)

Define web routes setup.

void
defineStashRoutes(Closure|string $route)

Define stash routes setup.

void
defineCacheRoutes(Closure|string $route, bool $cached = true)

Define cache routes setup.

void
syncTestbenchRoutes()

Synchronize Testbench routes.

void
registerTestbenchRouteCleanup(Filesystem $files, string $cachedRoutesPath)

Register cleanup for route files and route cache written by this test.

string
testbenchRouteFilePath(string $basePath)

Get a route file path owned by this test instance.

Details

static bool usesTestingConcern(string|null $trait = null)

Check if the test case uses a specific trait.

Parameters

string|null $trait

Return Value

bool

static bool usesRefreshDatabaseTestingConcern()

Determine if the test case uses refresh-database testing concerns.

Return Value

bool

static array cachedUsesForTestCase()

Cache and return traits used by test case.

Return Value

array

static void usesTestingFeature(object $attribute, int $flag = Attribute::TARGET_CLASS)

Programmatically add a testing feature attribute.

Parameters

object $attribute
int $flag

Return Value

void

abstract static protected Collection resolvePhpUnitAttributesForMethod(string $className, string|null $methodName = null)

Resolve PHPUnit method attributes for specific method.

Parameters

string $className
string|null $methodName

Return Value

Collection

protected void setUpTheTestEnvironmentUsingTestCase()

Execute BeforeEach lifecycle attributes.

Return Value

void

protected void tearDownTheTestEnvironmentUsingTestCase()

Execute AfterEach lifecycle attributes.

Return Value

void

static void setUpBeforeClassUsingTestCase()

Execute BeforeAll lifecycle attributes.

Return Value

void

static void tearDownAfterClassUsingTestCase()

Execute AfterAll lifecycle attributes and clear caches.

Return Value

void

bool isRunningTestCase()

Determine if the object is running as a PHPUnit test case.

Return Value

bool

string|null resolvePhpUnitTestClassName()

Resolve the PHPUnit test class name.

Return Value

string|null

string|null resolvePhpUnitTestMethodName()

Resolve the PHPUnit test method name.

Return Value

string|null

protected Collection resolvePhpUnitAttributes()

Resolve and cache PHPUnit attributes for current test.

Return Value

Collection

in InteractsWithPHPUnit at line 135
void setUpTheEnvironmentUsing(Closure $setUp)

Define the setUp environment using callback.

Parameters

Closure $setUp

Return Value

void

in InteractsWithPHPUnit at line 145
void tearDownTheEnvironmentUsing(Closure $tearDown)

Define the tearDown environment using callback.

Parameters

Closure $tearDown

Return Value

void

in InteractsWithPHPUnit at line 153
static void setUpBeforeClassUsingPHPUnit()

Cache uses for test case before class runs.

Return Value

void

in InteractsWithPHPUnit at line 161
static void tearDownAfterClassUsingPHPUnit()

Clear PHPUnit caches after class teardown.

Return Value

void

at line 57
protected void setUpApplicationRoutes(Application $app)

Setup application routes.

Parameters

Application $app

Return Value

void

at line 82
protected void defineRoutes(Router $router)

Define routes setup.

Parameters

Router $router

Return Value

void

at line 90
protected void defineWebRoutes(Router $router)

Define web routes setup.

Parameters

Router $router

Return Value

void

at line 98
protected void defineStashRoutes(Closure|string $route)

Define stash routes setup.

Parameters

Closure|string $route

Return Value

void

at line 106
protected void defineCacheRoutes(Closure|string $route, bool $cached = true)

Define cache routes setup.

Parameters

Closure|string $route
bool $cached

Return Value

void

at line 182
protected void syncTestbenchRoutes()

internal  
 

Synchronize Testbench routes.

Return Value

void

at line 201
protected void registerTestbenchRouteCleanup(Filesystem $files, string $cachedRoutesPath)

Register cleanup for route files and route cache written by this test.

Parameters

Filesystem $files
string $cachedRoutesPath

Return Value

void

at line 254
protected string testbenchRouteFilePath(string $basePath)

Get a route file path owned by this test instance.

Parameters

string $basePath

Return Value

string