Componenta Skeleton

Starter project for PHP 8.4+ with HTTP, CLI and WebSocket presets.

Install

composer create-project componenta/skeleton my-app
cd my-app
php bin/console.php list

The installer selects dependencies, creates entry points and a local .env, then removes its installation files. Without interactive input it selects Web with Nyholm PSR-7, Plates, Pest, CQRS and policies.

Preset	Features
Web	HTTP, routing and optional templates
API	HTTP and routing, without templates by default
Full	HTTP, templates, CQRS, policies, authentication and Cycle ORM
CLI	Console commands
WebSocket	WebSocket application

HTTP presets support Nyholm, Diactoros, Guzzle and Slim. Interactive setup also selects Pest or PHPUnit and optional integrations. Full uses Nyholm, Plates and Pest. WebSocket can be added to another preset.

Configuration and lifecycle

Entry points load Composer and call Componenta\App\run() with a scope and PathResolver. The application loads config/container.php.

config/config.php returns a ConfigDefinition with providers, configuration files and optional discovery directories. Componenta\App\Config\ConfigFactory produces a composition containing runtime Config and separate dependency definitions. Componenta\DI\ContainerFactory receives these objects and creates the container. Factories receive ContainerValue and access the same Config through $container->config.

Composer generates config/componenta-providers.php from package metadata. Project providers can use #[AsConfig] under src/; project configuration files live under config/autoload/.

Configuration is composed in every environment. The configured class source is shared through DI. Bootloaders prepare the selected execution scope.

Build and deployment

php bin/console.php app:build

This ordinary console command uses the existing container. Builders are created only when it executes; list and help keep build dependencies lazy.

Packages and applications register an ordered service list under Componenta\App\ConfigKey::BUILDERS. Each builder implements ApplicationBuilderInterface::build(): void and receives dependencies through its constructor. Each builder writes its own artifact atomically. A failure stops the sequence and preserves artifacts already written by earlier builders.

Installed integrations can generate CQRS, route, interceptor and validation maps. Runtime factories select optimized implementations and supported source fallback. Custom providers and native attribute behavior are preserved. Validation uses its attribute provider for classes whose rules cannot be exported. Policy uses its normal provider and memory cache.

Use APP_ENV=production when deploying. Startup does not require build artifacts and runtime never invokes builders. Build during deployment to enable optimization, then restart long-running workers after updating code and artifacts.

Development

• composer test checks actual bootstrap and build-command help.
• composer serve starts the HTTP development server.
• bin/console.php is the console entry point.
• HTTP presets add public/index.php, route and pipeline configuration.
• WebSocket presets add bin/websocket.php and config/websocket.php.

See package documentation for App, DI, Config, Router App, CQRS App, Interceptor, Validation App, Policy, Cycle App and WebSocket App.