create-functional-test

Create Functional Test

Generate functional test for HTTP controllers and LiveComponents.

When to Use

• HTTP endpoints (GET/POST/PUT/DELETE)
• Form submissions
• LiveComponents
• API responses

Inputs/Outputs

Process

Structure

Functional Test (extends BaseFunctionalTestCase):

final class ControllerNameTest extends BaseFunctionalTestCase {
    use Factories;

    public function testMethodName(): void {
        // Setup with Foundry (auto-persists)
        EntityFactory::createOne(['name' => 'Test']);

        // Request (use $this->client, NOT static::createClient())
        $this->client->request('GET', '/route');

        // Assertions
        self::assertResponseIsSuccessful();
        self::assertSelectorExists('.element');
    }
}

See: docs/GLOSSARY.md#functional-test for detailed definition

Rules

Setup:

• Use Foundry (NOT DataBuilder)
• Foundry auto-persists and commits
• NO manual repository->save() or $em->flush()

Assertions:

• HTTP: assertResponseIsSuccessful(), assertResponseRedirects(), assertResponseStatusCodeSame(404)
• DOM: assertSelectorExists('.class'), assertSelectorTextContains('h1', 'Title'), assertSelectorCount(3, '.item')

CRITICAL:

• Use $this->client (NOT static::createClient())
• Extends BaseFunctionalTestCase
• Use trait Factories
• Performance: ~550ms/test (DB purge + HTTP request)

Templates

• test-functional.php.tpl

Location: .claude/templates/

References

• Functional test definition: docs/GLOSSARY.md#functional-test
• Testing strategy: docs/testing.md#functional
• Base test case: src/Shared/Tests/BaseFunctionalTestCase.php