عرض مصدر Laravel/providers

 <noinclude>{{DISPLAYTITLE:مقدمو الخدمات (Service Providers) في Laravel}}</noinclude>
== مقدمة ==
مقدمو الخدمات هن الموقع المركزي لكامل عمليات تمهيد تطبيق [[Laravel]]. تطبيقك، ككامل خدمات [[Laravel]] الجوهرية، مُمَهَّد عبر مقدمي الخدمات.
لكن ما الذي نقصده "بالتمهيد" (bootstrapping)؟ نقصد به عمومًا تسجيل الأشياء، بما في ذلك تسجيل ارتباطات [[Laravel/container|حاويات الخدمات]]، ومنصتات الأحداث، و<nowiki/>[[Laravel/middleware|البرمجيات الوسيطة]]، وحتى [[Laravel/routing|المسارات]] (routes). مقدمو الخدمات هي المكان المركزي لإعداد تطبيقك مثلما ذكرنا سابقًا.
إن فتحت الملف <code>config/app.php</code> المتضمن في [[Laravel]] فسترى المصفوفة <code>providers</code>، والتي تمثّل كل أصناف مقدمي الخدمات التي سَتُحَمَّل من أجل تطبيقك. كثير منهن طبعا مقدمون "مؤجلون"، أي أنهن لن يتُحَمَّلن عند كل طلب بل عند الحاجة إلى خدماتها فقط.

في هذه النظرة العامة ستتعلم كيف تكتب مقدمي خدماتك وتسجلهم في تطبيق [[Laravel]] الخاص بك.

== كتابة مقدمي الخدمات ==
تُوسِّع كل مقدمو الخدمات الصنف <code>Illuminate\Support\ServiceProvider</code>. يحتوي أغلب مقدمو الخدمات دالة <code>register</code> و <code>boot</code>. يجب ربط الأشياء داخل حاوي الخدمات فقط  داخل كل دالة <code>register</code>. لا يجب أن تحاول تسجيل أي منصت أحداث، مسار أو أي جزء وظيفي آخر ضمن دالة <code>register</code>.

تولّد واجهة سطر الأوامر لبرمجية Artisan مقدّمًا جديدًا باستخدام الأمر <code>make:provider</code>:<syntaxhighlight lang="php">
php artisan make:provider RiakServiceProvider
</syntaxhighlight>

=== التابع <code>register</code> ===
كما ذُكِر سابقًا، يجب أن تربط الأشياء فقط في حاوي الخدمات في تابع التسجيل <code>register</code>. لا يجب أن تحاول أبدًا تسجيل أي منصت أحداث، أو مسار، أو أي جزء وظيفي آخر ضمن تابع التسجيل. إن لم تفعل ذلك، فقد تستخدم خدمة لم يُحَمَّل مقدم خدماتها بعد عن غير قصد.
فلنلقِ نظرة على مقدم خدمات بسيط. لديك دائما حق الوصول لخاصية <code>app$</code> في أي من توابع مقدم الخدمة والتي تمنحك القدرة على الوصول لحاوي الخدمات:<syntaxhighlight lang="php">
<?php

namespace App\Providers;

use Riak\Connection;
use Illuminate\Support\ServiceProvider;

class RiakServiceProvider extends ServiceProvider
{
    /**
     * تسجيل الارتباطات  في الحاوي
     *
     * @return void
     */
    public function register()
    {
        $this->app->singleton(Connection::class, function ($app) {
            return new Connection(config('riak'));
        });
    }
}

</syntaxhighlight>تُعَرِّف هذه الخدمة دالة التسجيل فقط وتستخدم تلك الدالة لتُعَرِّف تعريف الاستخدام <code>Riak\Connection</code> في حاوي الخدمات. إن لم تفهم كيفية عمل حاوي الخدمات ألقِ نظرةً على توثيقه.

==== الخاصيات <code>bindings</code>  و <code>singletons</code> ====
إن سجل مقدم خدمتك عدة ارتباطات بسيطة، فقد ترغب في استخدام الخاصيات <code>bindings</code> و <code>singletons</code> بدل تسجيل كل ارتباط بالحاوي على حدة. عندما يُحَمَّل مقدم الخدمات من طرف إطار العمل سيتفقد هذه الخاصيات تلقائيًا ويسجل ارتباطاتها:<syntaxhighlight lang="php">
<?php

namespace App\Providers;

use App\Contracts\ServerProvider;
use App\Contracts\DowntimeNotifier;
use Illuminate\Support\ServiceProvider;
use App\Services\PingdomDowntimeNotifier;
use App\Services\DigitalOceanServerProvider;

class AppServiceProvider extends ServiceProvider
{
    /**
  *. يجب تسجيل كل ارتباطات الحاوي.
     *
     * @var array
     */
    public $bindings = [
        ServerProvider::class => DigitalOceanServerProvider::class,
    ];

    /**
     *  الحاوي singletons يجب تسجيل جميع 
     * @var array
     */
    public $singletons = [
        DowntimeNotifier::class => PingdomDowntimeNotifier::class,
    ];
}

</syntaxhighlight>

=== التابع <code>boot</code> ===
ماذا لو احتجنا لتسجيل مؤلف عرض (view composer) داخل مقدم خدماتنا؟ يجب القيام بذلك داخل التابع <code>boot</code>. '''يُنادى هذا التابع بعد تسجيل كل مقدمي الخدمات الأخرى'''، أي عندما يكون لديك حق الولوج لكل خدمة أخرى مُسجَّلة في إطار العمل:<syntaxhighlight lang="php">
<?php

namespace App\Providers;

use Illuminate\Support\ServiceProvider;

class ComposerServiceProvider extends ServiceProvider
{
    /**
     * مَهِّد أية خدمات تطبيقية
     *
     * @return void
     */
    public function boot()
    {
        view()->composer('view', function () {
           //
        });
    }
}

</syntaxhighlight>

==== إضافة الاعتماديَّة للتابع <code>Boot</code> ====
تستطيع التلميح عن نوع (type-hint) الاعتمادية للتابع <code>boot</code> بمقدم خدماتك. سيضيف حاوي الخدمات أي اعتماديات تحتاج لها تلقائيًا:<syntaxhighlight lang="php">
use Illuminate\Contracts\Routing\ResponseFactory;

public function boot(ResponseFactory $response)
{
    $response->macro('caps', function ($value) {
       //
    });
}
</syntaxhighlight>

== تسجيل المقدِّمين ==
كل مقدمي الخدمات مُسَجَّلات في ملف الإعدادات <code>config/app.php</code>. يتضمن هذا الملف مصفوفة من المُقَدِّمين <code>providers</code> حيث تستطيع إيراد أسماء أصناف مُقَدِّمي خدماتك. ستجد هناك قائمةً تحتوي أسماء مقدمي الخدمات الأساسية لإطار [[Laravel]] افتراضيًّا. يُمَهِّد (bootstrap) هؤلاء المُقَدِّمون مكوِّنات [[Laravel]] الجوهرية مثل المُرسِل (mailer)، والطابور (queue)، وذاكرة التخزين المؤقتة (cache)، وغيرها.

لتُسَجِّل مُقَدِّمك أضفه لهذه المصفوفة:<syntaxhighlight lang="php">
'providers' => [
   // مقدمو الخدمات الأخرى
    App\Providers\ComposerServiceProvider::class,
],
</syntaxhighlight>

== المقدِّمون المؤجَّلون ==
يمكنك تأجيل تسجيل مقدم خدماتك حتى تحتاج لإحدى ارتباطاته المُسجَّلة ان كان يُسجّل ارتباطاته (bindings) في حاوي الخدمات '''حصرا'''. يُحسِّن تأجيل تحميل هذا النوع من المقدمين من أداء تطبيقك بما أنها لا تحمَّل من نظام الملفات مع كل طلب.

يُتَرجِم [[Laravel]] ويُخَزِّن قائمة من كل الخدمات التي توفِّرها مُقدِّمات الخدمات المُؤجَّلات. ثم يُحَمَّل [[Laravel]] مقدم الخدمة فقط عندما تحاول قبول (resolve) أحد تلك الخدمات.
لتأجيل تحميل مقدِّم ما، اضبط خاصية التأجيل <code>defer</code>  على <code>true</code> وعرِّف دالة تقديم <code>provides</code>. يجب على دالة التقديم <code>provides</code>  رد إرتباطات حاوي الخدمات التي سجلها المقدِّم:<syntaxhighlight lang="php">
<?php

namespace App\Providers;

use Riak\Connection;
use Illuminate\Support\ServiceProvider;

class RiakServiceProvider extends ServiceProvider
{
    /**
     * تشير إن كان المقدِّم مُؤجَّلا
     *
     * @var bool
     */
    protected $defer = true;

    /**
     * تسجيل لمقدِّم الخدمات
     *
     * @return void
     */
    public function register()
    {
        $this->app->singleton(Connection::class, function ($app) {
            return new Connection($app['config']['riak']);
        });
    }

    /**
     * .الحصول على الخدمة التي يوفرها مقدِّم الخدمات
     *
     * @return array
     */
    public function provides()
    {
        return [Connection::class];
   }

}

</syntaxhighlight>

== مصادر ==
* [https://laravel.com/docs/5.6/providers صفحة Service providers في توثيق Laravel الرسمي.]
[[تصنيف:Laravel|{{SUBPAGENAME}}]]
[[تصنيف:Laravel Architecture Concepts|{{SUBPAGENAME}}]]