Home
PSFS documentation
PSFS (Php Simple Fast & Secure) is a lightweight PHP framework for MVC/API applications built on Twig, Propel and Symfony components. This site collects the operational guides, references and design records of the core.
Every page shows its position as a breadcrumb at the top and links to the previous and next page at the bottom.
Start here
New to the project? Follow this path:
- Operations playbook: boot the Docker runtime, run the key tests and the daily commands.
- DTO validation engine: how requests are validated and CSRF-protected.
- Propel workflow: schema, model generation, migrations and rollback.
Contributing to the core? Add PHP compatibility and the security overview to that list, and validate every change inside Docker.
Guides
| Page | What it covers |
|---|---|
| Operations playbook | First-day flow, daily loop, queues, Swoole, troubleshooting |
| DTO validation engine | Declarative validation, unknown-field policy, CSRF in DTOs |
| Propel workflow | Schema conventions, psfs:migrate, engines, rollback |
Reference
| Page | What it covers |
|---|---|
| PHP compatibility | Supported PHP versions, validation baseline, Propel and PHP 8.5 |
Security
| Page | What it covers |
|---|---|
| Security overview | Required properties, policy, gates and contracts |
| Admin auth cookie secret | Configure and rotate auth.cookie.secret |
Admin UI
| Page | What it covers |
|---|---|
| Admin UI overview | Admin 2.0 migration scope and boundaries |
| UI development | Angular workspace, HMR, static publishing, e2e matrix |
| Regression contract | Behaviour Admin 2.0 must preserve |
| Design history | Specs and implementation plans |
Conventions
- Run project commands inside Docker (
docker exec psfs-php-1 ...). The validation baseline is PHP 8.3. - Command blocks are tagged
validatedorexample-only. - Page names are lowercase and hyphenated; each section has a
README.mdas its index.
Next: Operations playbook →