Proveedor de servicios
As noted throughout this documentation, Flarum uses Laravel's service container (or IoC container) for dependency injection. Service Providers allow low-level configuration and modification of the Flarum backend. El caso de uso más común para los proveedores de servicio es crear, modificar o reemplazar los enlaces del contenedor. Dicho esto, los proveedores de servicios le permiten un acceso completo para ejecutar cualquier lógica que necesite durante el arranque de la aplicación con acceso al contenedor.
A diferencia de otros extensores, la capa del proveedor de servicios NO está orientada a los casos de uso y NO se considera una API pública. Está sujeta a cambios en cualquier momento, sin previo aviso o depreciación. Esto sólo debe ser utilizado si usted sabe lo que está haciendo, y los otros extensores no satisfacen su caso de uso.
Proceso de arranque de Flarum
Para entender los proveedores de servicios, primero hay que entender el orden en que Flarum arranca. Most of this happens in Flarum\Foundation\InstalledSite
- El contenedor y la aplicación se inicializan, y se registran los bindings esenciales (config, environment, logger)
- Se ejecutan los métodos
registerde todos los proveedores de servicios esenciales. - Se ejecutan los métodos
extendde todos los extensores utilizados por todas las extensiones habilitadas. - Se ejecutan los métodos
extendde todos los extensores utilizados en el sitio local de Flarumextend.php. - Se ejecutan los métodos
bootde todos los proveedores de servicios centrales. - The
Flarum\Foundation\Event\ApplicationBootedevent is fired. See backend events for details.
Proveedores de servicios personalizados
Un proveedor de servicios personalizado debe extender Flarum\Foundation\AbstractServiceProvider, y puede tener un método boot y otro register. Third-party Laravel packages that ship their own service providers (extending Illuminate\Support\ServiceProvider) can also be registered directly — see below.
Por ejemplo:
<?php
use Flarum\Foundation\AbstractServiceProvider;
use Illuminate\Contracts\Container\Container;
class CustomServiceProvider extends AbstractServiceProvider
{
public function register()
{
// custom logic here, for example:
$this->container->resolving(SomeClass::class, function ($container) {
return new SomeClass($container->make('some.binding'));
});
}
public function boot(Container $container)
{
// custom logic here
}
}
El método register se ejecutará durante el paso (3) anterior, y el método boot se ejecutará durante el paso (5) anterior. En ambos métodos, el contenedor está disponible a través de $this->app. In the boot method, the container (or any other arguments), should be injected via typehinted method arguments.
Flarum does not currently support Laravel Octane, but some best practices, like using the $container argument inside bind, singleton, and resolving callbacks instead of $this->container should be used. See the Octane documentation for more information.
Registering a Service Provider
To register a service provider, use the ServiceProvider extender in extend.php:
<?php
use Flarum\Extend;
return [
// Otros extensores
(new Extend\ServiceProvider())
->register(CustomServiceProvider::class),
// Otros extensores
];
The register method accepts any class that extends either Flarum\Foundation\AbstractServiceProvider or Illuminate\Support\ServiceProvider. This means you can directly register service providers shipped by third-party Laravel packages without wrapping them:
use Flarum\Extend;
use SomePackage\SomePackageServiceProvider;
return [
(new Extend\ServiceProvider())
->register(SomePackageServiceProvider::class),
];