Download the PHP package assegaiphp/console without Composer

Assegai Console

Requirements

• PHP 8.4 (minimum)
• Composer 2.x.x

Description

The Assegai Console is the framework CLI for:

• creating new projects
• serving apps locally
• generating framework features
• exporting API contracts and clients
• working with queues, migrations, databases, and Web Components
• upgrading existing workspaces across supported framework release lines

It also supports custom schematics so teams can teach assegai generate about their own company-specific features.

Contribution workflow

For commit and pull request conventions in this repo, see:

• docs/commit-and-pr-guidelines.md

Installation

Install the Assegai Console globally using Composer:

Then make sure Composer's global bin directory is on your PATH:

If the printed directory is not already on your PATH, add it in your shell profile. For example:

Refer to the official Composer documentation if your global Composer home is configured differently.

Usage

Get Started

To create a new Assegai project, run the following command:

This command will create a new Assegai project in the my-app directory.

The scaffold flow can also:

• initialize git
• configure a database
• write sensitive config to config/secure.php
• set up a starter users resource when ORM is enabled

Development

After creating a new project, you can start the development server to preview your application in the browser.

To start the development server, navigate to the project directory and run the following command:

OpenSwoole runtime

If you want to try the long-lived runtime path instead of the default PHP development server, install the OpenSwoole extension first and then run:

You can also persist that choice in assegai.json:

If the extension is not installed, the CLI now stops early with a direct setup message instead of falling into a runtime bootstrap failure.

The current OpenSwoole path is still experimental. It is intended for careful testing and advanced runtime work, not as a blanket replacement for the default php runtime in every project.

Upgrading existing projects

Use the update command to move an existing workspace onto the current supported framework line:

The CLI now upgrades installed first-party packages more deliberately and is aware of the active framework release line.

Generating code

Use assegai generate (or assegai g) to scaffold framework artifacts:

Useful options include:

• --flat to generate directly into the target path instead of creating a name-based subdirectory
• --path to place generated files at a source-relative path

Database-aware commands also support MySQL, MariaDB, PostgreSQL, SQLite, and MSSQL where applicable.

Custom schematics

You can extend the generator without forking the CLI.

The default local convention is:

Start with a declarative starter:

Or scaffold a PHP-backed starter when generation needs real logic:

Inspect what the CLI discovered:

Run a custom schematic through the normal generate workflow:

For reusable team schematics, package manifests can be exposed through composer.json:

Learn more in the official documentation.

Stay in touch

• Author - Andrew Masiye, Daniel Kaluba
• Website - https://assegaiphp.com
• X - @assegaiphp

License

Assegai Console is MIT Licensed