README

This is the command-line utility for the FW Ecosystem, acting as the core compiler that transforms declarative YAML into highly-optimized, strictly-typed PHP code.

Available Commands

When running php fw from your application root, the following commands are available:

build:api

• Purpose: Compiles api/*.yaml files.
• Output:
  • Generates strict readonly class DTOs for payloads.
  • Generates *Handler classes with invoked methods.
  • Compiles build/routes.php as a static array for the Kernel.

build:db

• Purpose: Compiles database/schema.yaml.
• Output:
  • Generates strictly-typed native PHP *Model classes (e.g., UserModel).
  • Generates *RepositoryInterface contracts.
  • Generates Base*Repository classes containing explicit parameter-bound SQL queries mapping to the DTOs, completely eliminating N+1 lazy loading.

build:migrations

• Purpose: Compiles database/schema.yaml diffs into SQL scripts.
• Output:
  • Drops raw CREATE TABLE .sql scripts into database/migrations/.

build:container

• Purpose: Compiles the Dependency Injection Container.
• Output:
  • Reflects across your entire application and specifically bound config/dependencies.php file.
  • Writes build/container.php, a gigantic switch/case statement of instantiated singletons to eliminate runtime reflection overhead.