Cursor rule

1---
2description: "PHP patterns extending common rules"
3globs: ["**/*.php", "**/composer.json"]
4alwaysApply: false
5---
6# PHP Patterns
7 
8> This file extends the common patterns rule with PHP specific content.
9 
10## Thin Controllers, Explicit Services
11 
12- Keep controllers focused on transport: auth, validation, serialization, status codes.
13- Move business rules into application/domain services that are easy to test without HTTP bootstrapping.
14 
15## DTOs and Value Objects
16 
17- Replace shape-heavy associative arrays with DTOs for requests, commands, and external API payloads.
18- Use value objects for money, identifiers, and constrained concepts.
19 
20## Dependency Injection
21 
22- Depend on interfaces or narrow service contracts, not framework globals.
23- Pass collaborators through constructors so services are testable without service-locator lookups.
24