gnu-social/vendor/cilex/console-service-provider/README.md

Console Service Provider

Provides Console as a service to Pimple applications.

Requirements

• PHP 5.3+
• Symfony Console ~2.1

Installation

Through Composer as cilex/console-service-provider.

Usage

Pimple

<?php
use Cilex\Provider\Console\BaseConsoleServiceProvider;

$app = new Pimple;

$app['console.name'] = 'MyApp';
$app['console.version'] = '1.0.5';

$consoleServiceProvider = new BaseConsoleServiceProvider;
$consoleServiceProvider->register($app);

$app['console']->run();

Silex

To use the Console Service Provider in a Silex application register the Console Service Provider Silex adapter.

<?php
use Cilex\Provider\Console\Adapter\Silex\ConsoleServiceProvider;
use Silex\Application;

$app = new Application;

$app->register(new ConsoleServiceProvider(), array(
    'console.name' => 'MyApp',
    'console.version' => '1.0.5',
));

$app['console']->run();

Cilex

The Console Service Provider is baked into the Cilex Application itself so there is no need to register it manually.

<?php
use Cilex\Application;

$app = new Application('MyApp', '1.0.5');

$app->run();

Configuration

Parameters

• console.name: Name for the console application.
• console.version: Version for the console application.
• console.class: Class for the console application to be created.

Services

• console: Console Application, instance Symfony\Component\Console\Application.

The Console Service Provider Application Class

By default Console Service Provider will instantiate an instance of Cilex\Pimple\Provider\Console\Application.

Methods

getContainer() : \Pimple

Returns the Pimple container.

getService($name) : \stdClass|null

Returns a service contained in the application container or null if none is found with that name. Convenience method to avoid repeated calls to getContainer() or having to assign the container.

Accessing the Container and Services from Commands

Here are some examples of accessing the Container and Services from a Command:

<?php

use Symfony\Component\Console\Command;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Output\OutputInterface;

class SomeCommand extends Command
{
    protected function configure()
    {
        // configure the command
    }

    protected function execute(InputInterface $input, OutputInterface $output)
    {
        // Direct access to the Container.
        $container = $this->getApplication()->getContainer();

        // Direct access to a service.
        $service = $this->getApplication->getService('some.service');
    }
}

Future

In the event that Pimple Service Providers become a reality, ConsoleServiceProvider will implement the appropriate interface. As soon as Cilex and Silex become Pimple Service Provider aware, their respective adapter classes can be bypassed and the core ConsoleServiceProvider can be used directly.

License

MIT, see LICENSE.