Phred/README.md

Phred

A PHP MVC framework intended for projects of all sizes, designed for both solo and team development.

Requirements

• PHP: 8.2+
• Web Server: Apache/Nginx (recommended)
• Package Manager: Composer

Installation

Install Phred via Composer:

composer create-project getphred/phred

Getting Started

Creating a Module

Phred uses a modular (Django-style) architecture. All your application logic lives inside modules.

To scaffold a new module:

php phred create:module Blog

This will create the module structure under modules/Blog, register the service provider, and mount the routes.

After creating a module, update your composer.json to include the new namespace:

{
  "autoload": {
    "psr-4": {
      "Project\\\\Modules\\\\Blog\\\\": "modules/Blog/"
    }
  }
}

Then run:

composer dump-autoload

Running the Application

Start the local development server:

php phred run

The application will be available at http://localhost:8000.

CLI Usage (phred)

The phred binary provides several utility and scaffolding commands.

Generators

• php phred create:module <name> — Create a new module.
• php phred create:command <name> — Create a custom CLI command.
• php phred create:<module>:controller <name> — Create a controller.
• php phred create:<module>:view <name> — Create a view and template.
• php phred create:<module>:model <name> — Create a domain model.
• php phred create:<module>:migration <name> — Create a migration.
• php phred create:<module>:seed <name> — Create a database seeder.
• php phred create:<module>:test <name> — Create a test.

Database

• php phred migrate — Run database migrations.
• php phred migration:rollback — Rollback migrations.
• php phred seed — Seed the database.
• php phred db:backup — Backup the database.
• php phred db:restore — Restore the database.

Testing & Utilities

• php phred test — Run tests for the entire project.
• php phred test:<module> — Run tests for a specific module.
• php phred list — List all available commands.

Technical Specifications

For detailed information on the framework architecture, service providers, configuration, and MVC components, please refer to:

👉 SPECS.md | MILESTONES.md

License

Phred is open-source software licensed under the MIT license.