موفرو الخدمات

namespace App\Providers;

use Illuminate\Support\ServiceProvider;

class AppServiceProvider extends ServiceProvider
{
    /**
     * Register any application services.
     */
    public function register(): void
    {
        // ربط الخدمات في الحاوية
        // يعمل قبل أي طريقة boot()
    }

    /**
     * Bootstrap any application services.
     */
    public function boot(): void
    {
        // تنفيذ بدء التشغيل بعد التسجيل
        // يعمل بعد تسجيل جميع الموفرين
    }
}

namespace App\Providers;

use Illuminate\Support\ServiceProvider;
use App\Services\PaymentGateway;
use App\Services\StripePaymentGateway;
use App\Contracts\ReportGeneratorInterface;
use App\Services\PdfReportGenerator;

class AppServiceProvider extends ServiceProvider
{
    public function register(): void
    {
        // ربط بسيط
        $this->app->bind(PaymentGateway::class, function ($app) {
            return new StripePaymentGateway(
                config('services.stripe.key')
            );
        });

        // ربط Singleton
        $this->app->singleton(
            ReportGeneratorInterface::class,
            PdfReportGenerator::class
        );

        // تسجيل ملف التكوين
        $this->mergeConfigFrom(
            __DIR__.'/../config/mypackage.php',
            'mypackage'
        );

        // التسجيل الشرطي بناءً على البيئة
        if ($this->app->environment('local')) {
            $this->app->register(DebugServiceProvider::class);
        }
    }
}

namespace App\Providers;

use Illuminate\Support\ServiceProvider;
use Illuminate\Support\Facades\View;
use Illuminate\Support\Facades\Gate;
use Illuminate\Support\Facades\Blade;
use App\Models\User;

class AppServiceProvider extends ServiceProvider
{
    public function boot(): void
    {
        // مشاركة البيانات مع جميع العروض
        View::share('appName', config('app.name'));

        // تعريف بوابات التفويض
        Gate::define('update-post', function (User $user, $post) {
            return $user->id === $post->user_id;
        });

        // تسجيل توجيهات Blade
        Blade::directive('datetime', function ($expression) {
            return "<?php echo ($expression)->format('m/d/Y H:i'); ?>";
        });

        // تسجيل مراقبي النموذج
        User::observe(UserObserver::class);

        // نشر أصول الحزمة
        $this->publishes([
            __DIR__.'/../resources/views' => resource_path('views/vendor/mypackage'),
        ], 'mypackage-views');

        // تسجيل الماكرو
        \Illuminate\Support\Str::macro('titleSnake', function ($value) {
            return \Illuminate\Support\Str::title(
                str_replace('_', ' ', $value)
            );
        });
    }
}

namespace App\Providers;

use Illuminate\Support\ServiceProvider;
use Illuminate\Contracts\Routing\ResponseFactory;
use Illuminate\Contracts\View\Factory as ViewFactory;

class AppServiceProvider extends ServiceProvider
{
    public function register(): void
    {
        //
    }

    /**
     * التبعيات محقونة تلقائياً
     */
    public function boot(
        ResponseFactory $response,
        ViewFactory $view
    ): void {
        // استخدام التبعيات المحقونة
        $view->composer('*', function ($view) {
            $view->with('currentYear', date('Y'));
        });

        // إضافة ماكرو استجابة مخصص
        $response->macro('caps', function ($value) use ($response) {
            return $response->make(strtoupper($value));
        });
    }
}

// إنشاء موفر خدمات جديد
php artisan make:provider PaymentServiceProvider

// app/Providers/PaymentServiceProvider.php
namespace App\Providers;

use Illuminate\Support\ServiceProvider;
use App\Services\Payment\StripeGateway;
use App\Services\Payment\PayPalGateway;
use App\Contracts\PaymentGatewayInterface;

class PaymentServiceProvider extends ServiceProvider
{
    public function register(): void
    {
        // ربط بوابة الدفع بناءً على التكوين
        $this->app->singleton(
            PaymentGatewayInterface::class,
            function ($app) {
                $driver = config('payment.default');

                return match($driver) {
                    'stripe' => new StripeGateway(
                        config('payment.stripe.key')
                    ),
                    'paypal' => new PayPalGateway(
                        config('payment.paypal.client_id')
                    ),
                    default => throw new \Exception("Unsupported payment driver: {$driver}")
                };
            }
        );
    }

    public function boot(): void
    {
        // نشر التكوين
        $this->publishes([
            __DIR__.'/../config/payment.php' => config_path('payment.php'),
        ], 'payment-config');
    }
}

// التسجيل في مصفوفة موفري config/app.php
'providers' => [
    // ... موفرون آخرون
    App\Providers\PaymentServiceProvider::class,
],

namespace App\Providers;

use Illuminate\Support\ServiceProvider;
use Illuminate\Contracts\Support\DeferrableProvider;
use App\Services\ReportGenerator;

class ReportServiceProvider extends ServiceProvider implements DeferrableProvider
{
    public function register(): void
    {
        $this->app->singleton(ReportGenerator::class, function ($app) {
            return new ReportGenerator(
                $app->make('db'),
                $app->make('config')
            );
        });
    }

    /**
     * Get the services provided by the provider.
     *
     * @return array<int, string>
     */
    public function provides(): array
    {
        // قائمة بجميع الخدمات التي يقدمها هذا الموفر
        return [
            ReportGenerator::class,
        ];
    }
}

// الفوائد:
// - يتم تحميل الموفر فقط عندما تكون ReportGenerator مطلوبة
// - يقلل وقت بدء التشغيل
// - يحسن الأداء للطلبات التي لا تحتاج إلى تقارير

namespace App\Providers;

use Illuminate\Support\ServiceProvider;

class MyPackageServiceProvider extends ServiceProvider
{
    public function boot(): void
    {
        // نشر التكوين
        $this->publishes([
            __DIR__.'/../config/mypackage.php' => config_path('mypackage.php'),
        ], 'mypackage-config');

        // نشر العروض
        $this->publishes([
            __DIR__.'/../resources/views' => resource_path('views/vendor/mypackage'),
        ], 'mypackage-views');

        // نشر الهجرات
        $this->publishes([
            __DIR__.'/../database/migrations' => database_path('migrations'),
        ], 'mypackage-migrations');

        // نشر الأصول (CSS، JS، الصور)
        $this->publishes([
            __DIR__.'/../public' => public_path('vendor/mypackage'),
        ], 'mypackage-assets');

        // نشر مجموعات أصول متعددة في وقت واحد
        $this->publishes([
            __DIR__.'/../config/mypackage.php' => config_path('mypackage.php'),
            __DIR__.'/../resources/views' => resource_path('views/vendor/mypackage'),
        ], 'mypackage-all');
    }
}

// المستخدمون ينشرون مع أوامر artisan:
php artisan vendor:publish --tag=mypackage-config
php artisan vendor:publish --tag=mypackage-views
php artisan vendor:publish --tag=mypackage-all
php artisan vendor:publish --provider="App\Providers\MyPackageServiceProvider"

namespace App\Providers;

use Illuminate\Support\ServiceProvider;

class MyPackageServiceProvider extends ServiceProvider
{
    public function boot(): void
    {
        // تحميل عروض الحزمة
        $this->loadViewsFrom(__DIR__.'/../resources/views', 'mypackage');

        // تحميل ترجمات الحزمة
        $this->loadTranslationsFrom(__DIR__.'/../lang', 'mypackage');

        // تحميل هجرات الحزمة
        $this->loadMigrationsFrom(__DIR__.'/../database/migrations');

        // تحميل مسارات الحزمة
        $this->loadRoutesFrom(__DIR__.'/../routes/web.php');
    }
}

// استخدام الموارد المحملة:

// العروض: return view('mypackage::dashboard');
// الترجمات: __('mypackage::messages.welcome')
// الهجرات: تعمل تلقائياً مع php artisan migrate
// المسارات: مسجلة تلقائياً