sbesselsen/symfony-prelude

A simple loader for Symfony DI containers

Symfony Prelude

A simple loader for Symfony DI containers., _(*1)

Purpose

If you want to use Symfony components without using the full framework, this tool gives you a simple and consistent way to load a Dependency Injection container from YAML files without boilerplate code., _(*2)

Getting started

Load it from composer:, _(*3)

composer require sbesselsen/symfony-prelude, _(*4)

Usage

Create a central file where you get the container for the root directory of your project:, _(*5)

bootstrap.php, _(*6)

<?php
require_once 'vendor/bootstrap.php';

$container = SymfonyPrelude\ContainerLoader::containerForDirectory($rootDirectory);

Now create two YAML files to configure the DI container:, _(*7)

app/services.yml, _(*8)

services:
  my_service:
    class: Acme\MyClass
    arguments:
      - "%some_param%"
      - "%root_dir%"

(The root_dir parameter is provided automatically by the loader.), _(*9)

app/parameters.yml, _(*10)

parameters:
  some_param: 'SECRET_KEY'
  other_param: 1234

You can now use $container in your application. It's a normal Symfony DI ContainerBuilder, configured from theses YAML files., _(*11)

Local overrides

Optionally you can create a third config file to override parameters or services:, _(*12)

app/override.yml, _(*13)

parameters:
  server_host: dev-server-host

services:
  my_service:
    class: Acme\AnotherClass

The override file is not required., _(*14)