nikolaposa/phoundation

Framework-agnostic basis for bootstrapping PHP applications

Phoundation

![Build Status][ico-build] ![Code Quality][ico-code-quality] , _(*1)

Phoundation (pronounced the same way as "foundation") facilitates the routine step of bootstrapping PHP applications., _(*2)

Installation

The preferred method of installation is via Composer. Run the following command to install the latest version of a package and add it to your project's composer.json:, _(*3)

composer require nikolaposa/phoundation

Purpose

Bootstrapping of today's PHP applications typically comes down to:, _(*4)

1. Configuration loading
2. Dependency Injection Container initialization

Phoundation aims to reduce the amount of repetitive code needed for the application startup logic by abstracting bootstrapping process., _(*5)

Usage

Given the configuration files:, _(*6)

config/global.php, _(*7)

return [
    'db' => [
        'driver' => 'pdo_mysql',
        'host' => 'localhost',
        'user' => 'root',
        'password' => 'secret',
        'dbname' => 'test',
    ],
    'dependencies' => [
        'factories' => [
            \PDO::class => function () {
                return new \PDO('sqlite::memory:');
            },
            'My\\Web\\Application' => My\Web\ApplicationFactory::class,
        ]
    ],
];

config/local.php, _(*8)

return [
    'db' => [
        'user' => 'admin',
        'password' => '1234',
    ],
];

Create bootstrap script which typically lives in src/bootstrap.php:, _(*9)

use Phoundation\Bootstrap;
use Phoundation\Config\FileConfigLoader;
use Phoundation\DependencyInjection\LaminasServiceManagerFactory;

$bootstrap = new Bootstrap(
    new FileConfigLoader(glob(sprintf('config/{{,*.}global,{,*.}%s}.php', getenv('APP_ENV') ?: 'local'), GLOB_BRACE)),
    new LaminasServiceManagerFactory()
);

return $bootstrap();

Load bootstrap in your web application root (for example public/index.php):, _(*10)

/* @var \Psr\Container\ContainerInterface $diContainer */
$diContainer = require  __DIR__ . '/../src/bootstrap.php';

$diContainer->get('My\\Web\\Application')->run();

Credits

• Nikola Poša
• All Contributors

License

Released under MIT License - see the License File for details., _(*11)