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