LayerServiceProvider

Lomkit\Osdd\LayerServiceProvider is an abstract class that extends Illuminate\Support\ServiceProvider. Every layer's provider extends it.

use Lomkit\Osdd\LayerServiceProvider;

class OrdersServiceProvider extends LayerServiceProvider
{
    //
}

loadSeeders()

protected function loadSeeders(array $seeders, int $priority = 0): void

Registers seeder classes in the SeederRegistry. osdd:seed and LayersSeeder run them.

A seeder registered twice runs once: the first registration and its priority win.

$this->loadSeeders([OrdersSeeder::class, OrderStatusesSeeder::class]);

$this->loadSeeders([RolesSeeder::class], priority: -10);

overrideConfigFrom()

protected function overrideConfigFrom(string $path, string $key): void

Loads the PHP config file at $path and merges it over the config key $key. The file's values win over the values already loaded. Does nothing when the configuration is cached.

• Maps are merged key by key, at every depth.
• A list replaces the loaded value as a whole, and an empty array clears it: ['queues' => ['high']] over ['queues' => ['default', 'low']] gives ['high'].

public function register(): void
{
    $this->overrideConfigFrom(__DIR__ . '/../../config/horizon.php', 'horizon');
}

withRouting()

protected function withRouting(
    array|string|null $web = null,
    array|string|null $api = null,
    ?string $commands = null,
    ?string $channels = null,
    ?string $health = null,
    string $apiPrefix = 'api',
): void

Mounts the layer's route files with Laravel's conventions. Missing files are skipped. When routes are cached, the web, api and health routes come from the cache; the commands and channels files are still loaded.

public function boot(): void
{
    $this->withRouting(
        web: __DIR__ . '/../../routes/web.php',
        api: __DIR__ . '/../../routes/api.php',
        commands: __DIR__ . '/../../routes/console.php',
        channels: __DIR__ . '/../../routes/channels.php',
    );
}

See Routes.

withViews()

protected function withViews(string $path, ?string $namespace = null): void

Loads the Blade views of $path under $namespace: view('orders::index'). Does nothing when the folder does not exist.

withTranslations()

protected function withTranslations(string $path, ?string $namespace = null): void

Loads the translation files of $path under $namespace (__('orders::messages.welcome')), and its *.json files without a namespace. Does nothing when the folder does not exist. $namespace defaults like withViews().

withComponents()

protected function withComponents(string $namespace, ?string $prefix = null): void

Registers the Blade components of a PHP namespace under a prefix: withComponents('Functional\\Orders\\View\\Components') makes <x-orders::alert /> render Functional\Orders\View\Components\Alert. $prefix defaults like withViews().

Namespaces and collisions

The three with*() resource methods share these rules:

• Without a namespace, they use the package name of the discovered layer whose autoload.psr-4 prefix covers the provider class. A provider that belongs to no discovered layer throws Lomkit\Osdd\Layers\ProviderLayerNotFoundException: pass the namespace.
• Two providers claiming the same views namespace, translations namespace or component prefix throw Lomkit\Osdd\Resources\ResourceNamespaceCollisionException at boot, naming both providers. Pass the second argument in one of them.

See Views and components.

Inherited methods

Every method of Laravel's ServiceProvider works as usual. The ones a layer uses most: