jinomial/fw-cli

The command line interface for the FW framework.

v1.0.1 2026-03-07 20:41 UTC

Requires

• php: >=8.3.0
• symfony/console: ^7.0
• symfony/yaml: ^7.4

Requires (Dev)

• jinomial/fw-framework: ^1.0
• mockery/mockery: ^1.6
• pestphp/pest: ^3.0

MIT

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.