📄️ REST Controllers
REST controllers in this architecture map HTTP routes to PHP methods using PHP 8 attributes. Every controller method receives HttpRequest and HttpResponse objects and delegates business logic to the Service layer.
📄️ Authentication
Authentication, password management, and JWT issuance are powered by byjg/authuser. This section describes how the default wiring works and what you need to change when you customize users or credentials.
📄️ Database Migrations
Usage
📄️ ORM & Repository
The reference architecture uses byjg/micro-orm with PHP 8 attributes. Your models declare the mapping, repositories receive the shared DatabaseExecutor, and BaseRepository supplies common helpers.
📄️ Service Layer
The Service Layer contains your business logic and orchestrates operations between REST controllers and repositories.
📄️ Advanced Repository Patterns
This guide covers advanced features of the Repository layer, including complex queries, UUID handling, transactions, and custom query methods.
📄️ Template Customization
Guide to customizing the code generator templates to match your project's specific needs.
📄️ Testing
This guide covers all aspects of testing your REST API, from unit tests to integration tests, using FakeApiRequester for in-process API testing.
📄️ JWT Advanced
Complete guide to JWT (JSON Web Token) authentication including token generation, validation, refresh tokens, and custom claims.
📄️ Error Handling
This guide covers error handling patterns, exception types, and best practices for returning consistent error responses in your REST API.
📄️ Configuration
Advanced configuration topics including environment inheritance, layered configs, credentials management, and multi-environment setup.