Los proveedores permiten al desarrollador reutilizar partes de una aplicación en otra. Silex ofrece dos tipos de proveedores definidos por dos interfaces: ServiceProviderInterface para los servicios y ControllerProviderInterface para los controladores.
Con el fin de cargar y usar un proveedor de servicios, lo debes registrar en la aplicación:
$app = new Silex\Application();
$app->register(new Acme\DatabaseServiceProvider());
También puedes proporcionar algunos parámetros como segundo argumento. Estos se pondrán después de registrar al proveedor, pero antes de iniciarlo:
$app->register(new Acme\DatabaseServiceProvider(), array(
'database.dsn' => 'mysql:host=localhost;dbname=myapp',
'database.user' => 'root',
'database.password' => 'secret_root_password',
));
Necesitas tener cuidado con el orden en que haces ciertas cosas cuando interactúas con proveedores. Sólo sigue estas reglas:
La redefinición de servicios existentes debe ocurrir después de haber registrado el proveedor.
Razón: Si los servicios ya existen, el proveedor los sobrescribirá.
Puedes configurar los parámetros en cualquier momento antes de acceder al servicio.
Asegúrate de que te adhieres a este comportamiento al crear tus propios proveedores.
Hay algunos proveedores que obtienes fuera de la caja. Todos ellos están dentro del espacio de nombres Silex\Provider.
Algunos proveedores de servicios son desarrollados por la comunidad. Esos proveedores están listados en el wiki del repositorio de Silex.
Te animamos a compartir los tuyos.
Los proveedores deben implementar el Silex\ServiceProviderInterface:
interface ServiceProviderInterface
{
function register(Application $app);
function boot(Application $app);
}
Esto es muy sencillo, basta con crear una nueva clase que implemente los dos métodos. En el método register() tienes que definir los servicios de la aplicación que pueden usar otros servicios y parámetros. En el método boot() puedes configurar la aplicación, justo antes de manipular una petición.
He aquí un ejemplo de tal proveedor:
namespace Acme;
use Silex\Application;
use Silex\ServiceProviderInterface;
class HelloServiceProvider implements ServiceProviderInterface
{
public function register(Application $app)
{
$app['hello'] = $app->protect(function ($name) use ($app) {
$default = $app['hello.default_name'] ? $app['hello.default_name'] : '';
$name = $name ?: $default;
return 'Hello '.$app->escape($name);
});
}
public function boot(Application $app)
{
}
}
Esta clase proporciona un servicio, hello, el cual es un cierre protegido. Este toma un argumento nombre y devolverá hello.default_name si no se da un nombre. Si además falta el predeterminado, utilizará una cadena vacía.
Ahora puedes utilizar este proveedor de la siguiente manera:
$app = new Silex\Application();
$app->register(new Acme\HelloServiceProvider(), array(
'hello.default_name' => 'Igor',
));
$app->get('/hello', function () use ($app) {
$name = $app['request']->get('name');
return $app['hello']($name);
});
En este ejemplo estamos obteniendo el parámetro name desde la cadena de consulta, por lo que la ruta de la petición tendría que ser /hello?name=Fabien.
Con el fin de cargar y usar un proveedor de controladores, debes «montar» tus controladores bajo una ruta:
$app = new Silex\Application();
$app->mount('/blog', new Acme\BlogControllerProvider());
Todos los controladores definidos por el proveedor ahora estarán disponibles bajo la ruta /blog.
Los proveedores deben implementar la Silex\ControllerProviderInterface:
interface ControllerProviderInterface
{
function connect(Application $app);
}
He aquí un ejemplo de tal proveedor:
namespace Acme;
use Silex\Application;
use Silex\ControllerProviderInterface;
class HelloControllerProvider implements ControllerProviderInterface
{
public function connect(Application $app)
{
// crea un nuevo controlador basándose en la ruta predefinida
$controllers = $app['controllers_factory'];
$controllers->get('/', function (Application $app) {
return $app->redirect('/hello');
});
return $controllers;
}
}
El método connect debe regresar una instancia de ControllerCollection. ControllerCollection es la clase donde están definidos todos los métodos controladores relacionados (como get, post, match, ...).
Truco
La clase Application de hecho actúa en un delegado para estos métodos.
Ahora puedes utilizar este proveedor de la siguiente manera:
$app = new Silex\Application();
$app->mount('/blog', new Acme\HelloControllerProvider());
En este ejemplo, la ruta /blog/ ahora hace referencia al controlador definido en el proveedor.
Truco
También puedes definir un proveedor que implemente ambos, el servicio y la interfaz del proveedor del controlador y envasar en la misma clase los servicios necesarios para hacer que tu controlador funcione.
