Upgrading from v2

Requirements#

• PHP 8.5+
• pionia/pionia-core ^3.0

Bootstrap#

v3 environment/settings.ini (switches):

[app_switches]
v1=Application\Switches\MainSwitch

v3 bootstrap/application.php:

<?php

require __DIR__ . '/../vendor/autoload.php';

use Pionia\Realm\AppRealm;

return AppRealm::create(__DIR__);

Switches#

registerServices() must return Arrayable (use arr([...])):

public static function registerServices(): Arrayable
{
    return arr(['auth' => AuthService::class]);
}

Static assets#

Move static/ at repo root → public/static/ (or rely on the framework welcome page).

Autoload#

Prefer a single PSR-4 root:

"Application\\": "./"

CLI (native console)#

v3 ships a native console at Pionia\Console\Application. Custom and generated commands extend Pionia\Console\Command. Input types live under Pionia\Console\Input\ (InputArgument, InputOption).

The CLI banner shows the installed pionia/pionia-core version from Composer (e.g. v3.0.2-beta), not a hardcoded framework string.

HTTP routing (Symfony removed)#

v3 replaces Symfony Routing with native classes:

See HTTP routing for CompiledRouteMatcher, bootstrap route cache, and production php pionia optimize --production.

Production optimization (new in v3)#

Deploy-time performance is opt-in:

composer install --no-dev -o
php pionia optimize --production

See Production performance.

Fresh start option#

Regenerate and port services:

composer create-project pionia/pionia-app my-api-v3
# copy services/, switches/, environment/ from the old app

Or from an existing Pionia install: php pionia new my-api-v3 --install.

See Application structure for the full v3 tree.