コード内でコンテナインスタンスを取得する（Laravel）

この記事は、laravel のチュートリアルコラムで、コード内でコンテナインスタンスを取得する方法を紹介する記事です。

laravel コンテナインスタンスはリクエストライフサイクル全体を通じて一意であり、すべてのサービスコンポーネントインスタンスを管理します。それでは、laravelコンテナのインスタンスを取得するにはどのような方法があるのでしょうか?以下の方法が一般的に使用されます:

1) アプリのヘルプ機能経由:

$app = app();

アプリの補助機能は

# で定義されています。 ## このファイルでは、多くのヘルプ関数が定義されており、composer を通じてプロジェクトに自動的にロードされます。したがって、関数には、app() などの http リクエスト処理に関係する任意のコードの場所からアクセスできます。

2) アプリ ファサード経由

<?php
Route::get(&#39;/&#39;, function () {
    dd(App::basePath());
    return &#39;&#39;;
});

アプリ ファサード経由でコンテナ インスタンスを取得する方法は上記とは異なります。最初にアプリを変数に割り当ててからコンテナを呼び出すことはできません変数を通じて。これは、App は単なるクラス名であり、クラス名を変数にコピーできないためです。 $app = App; は正当な実行可能ステートメントではありませんが、 $app = app(); の後に関数呼び出しを表す app() が続くため、正当な実行可能ステートメントとなります。 App::basePath(); も正当なステートメントであり、クラスの静的メソッドを呼び出しています。

さらに 2 つのポイントを追加します:

最初のポイント: Facade は、laravel フレームワークの特別な機能です。各 Facade は、コンテナー内のインスタンス オブジェクトに関連付けられます。Facade を直接渡すことができます。クラスの静的メソッド呼び出しは、関連付けられたインスタンス オブジェクトのメソッドを呼び出すために使用されます。たとえば、App::basePath() を呼び出すときの App のファサードは、実際には app()->basePath() と同等です。

この基礎となるメカニズムは、PHP 言語の特性にも依存します。各 Facade に静的メンバーを設定し、それをサービスのインスタンス オブジェクトに関連付ける必要があります。Facade クラスの静的メソッドを呼び出すとき、呼び出されたメソッド名を解析し、関連付けられたサービス インスタンスの同じ名前のメソッドを呼び出し、最後に結果を返します。

Facade がどのような役割を果たし得るのかを理解するだけで十分だと思います。実装の詳細を理解するために最下層を掘り下げる必要はありません。結局のところ、実際の開発では、Facade は使用されません。 laravelフレームワークの使用には全く影響しません。また、実際のコーディングでは、Facade のカスタマイズが非常に簡単で、laravel でカプセル化された Facade 基本クラスを継承するだけです:

<?php
namespace ThirdProviders\CasServer\Facades;
use Illuminate\Support\Facades\Facade;
use ThirdProviders\CasServer\CasServerManager;
class CasServer extends Facade
{
    protected static function getFacadeAccessor()
    {
        return CasServerManager::class;
    }
}

Facade 基本クラスの getFacadeAccessor メソッドを実装すると、laravel フレームワークが何を認識するかがわかります。この Facade クラスは、どのサービス インスタンスが関連付けられているかのようになる必要があります。実際、この getFacadeAccess メソッドによって返される名前は、後で紹介するサービス バインディング名です。 laravelコンテナでは、サービスインスタンスには固定のバインド名があり、この名前を通じてインスタンスを見つけることができます。では、なぜ Facade クラスはサービス バインディング名を返すだけでよいのでしょうか。

App Facade クラスのコードを見てみましょう:

<?php
namespace Illuminate\Support\Facades;
/**
 * @see \Illuminate\Foundation\Application
 */
class App extends Facade
{
    /**
     * Get the registered name of the component.
     *
     * @return string
     */
    protected static function getFacadeAccessor()
    {
        return &#39;app&#39;;
    }
}

その getFacadeAccessor は文字列「app」を返します。これは、laravel コンテナーがそれ自体をバインドするために使用する名前です。

2 番目のポイント: 前のポイントの App Facade のソース コードから、App Facade の完全なクラス名が実際には Illuminate\Support\Facades\App であることがわかります。コード内で直接使用できますか? アプリにはショート ネームでアクセスできます:

<?php
Route::get(&#39;/&#39;, function () {
    dd(App::basePath());
    return &#39;&#39;;
});

上記のコードでは、Illuminate\Support\Facades\App を使用する方法や完全修飾方法を使用していないことがわかります。実際、App は Illuminate\Support\Facades\App と完全に同等ですが、App は Illuminate\Support\Facades\App よりもはるかに短く、使用する必要がないため、使いやすい点が異なります。これは、laravel コンテナーで設定されたエイリアスに関連しています。config/app.php の

には、いくつかのタイプのエイリアスの設定に特に使用されるエイリアスのセクションがあります:

'aliases' => [
    'App' => Illuminate\Support\Facades\App::class,
    'Artisan' => Illuminate\Support\Facades\Artisan::class,
    'Auth' => Illuminate\Support\Facades\Auth::class,
    'Blade' => Illuminate\Support\Facades\Blade::class,
    'Bus' => Illuminate\Support\Facades\Bus::class,
    'Cache' => Illuminate\Support\Facades\Cache::class,
    'Config' => Illuminate\Support\Facades\Config::class,
    'Cookie' => Illuminate\Support\Facades\Cookie::class,
    'Crypt' => Illuminate\Support\Facades\Crypt::class,
    'DB' => Illuminate\Support\Facades\DB::class,
    'Eloquent' => Illuminate\Database\Eloquent\Model::class,
    'Event' => Illuminate\Support\Facades\Event::class,
    'File' => Illuminate\Support\Facades\File::class,
    'Gate' => Illuminate\Support\Facades\Gate::class,
    'Hash' => Illuminate\Support\Facades\Hash::class,
    'Lang' => Illuminate\Support\Facades\Lang::class,
    'Log' => Illuminate\Support\Facades\Log::class,
    'Mail' => Illuminate\Support\Facades\Mail::class,
    'Notification' => Illuminate\Support\Facades\Notification::class,
    'Password' => Illuminate\Support\Facades\Password::class,
    'Queue' => Illuminate\Support\Facades\Queue::class,
    'Redirect' => Illuminate\Support\Facades\Redirect::class,
    'Redis' => Illuminate\Support\Facades\Redis::class,
    'Request' => Illuminate\Support\Facades\Request::class,
    'Response' => Illuminate\Support\Facades\Response::class,
    'Route' => Illuminate\Support\Facades\Route::class,
    'Schema' => Illuminate\Support\Facades\Schema::class,
    'Session' => Illuminate\Support\Facades\Session::class,
    'Storage' => Illuminate\Support\Facades\Storage::class,
    'URL' => Illuminate\Support\Facades\URL::class,
    'Validator' => Illuminate\Support\Facades\Validator::class,
    'View' => Illuminate\Support\Facades\View::class
],

その後、リクエストは次のようになります。 laravelフレームワークで処理される プロセス中に、これらのエイリアスはIlluminate\Foundation\Bootstrap\RegisterFacadesクラスを通じてグローバル環境に登録されます:

<?php
namespace Illuminate\Foundation\Bootstrap;
use Illuminate\Support\Facades\Facade;
use Illuminate\Foundation\AliasLoader;
use Illuminate\Contracts\Foundation\Application;
class RegisterFacades
{
    /**
     * Bootstrap the given application.
     *
     * @param  \Illuminate\Contracts\Foundation\Application  $app
     * @return void
     */
    public function bootstrap(Application $app)
    {
        Facade::clearResolvedInstances();
        Facade::setFacadeApplication($app);
        AliasLoader::getInstance($app->make(&#39;config&#39;)->get(&#39;app.aliases&#39;, []))->register();
    }
}

したがって、完全な型名の代わりにエイリアスを直接使用して実行できます。同じアクセス機能です。長い名前のクラスを自分で作成し、コード内で頻繁に使用されている場合は、それらを config/app.php エイリアスで構成することも検討できます。そうすれば、laravel がそれらを登録します。

3) laravel コンテナインスタンスを取得するもう 1 つの方法は、サービスプロバイダーで $this->app

を直接使用することです。サービスプロバイダーについては後で紹介しますが、紹介したばかりです。今。サービスプロバイダークラスはlaravelコンテナーによってインスタンス化されるため、これらのクラスはIlluminate\Support\ServiceProviderを継承し、サービスプロバイダーのインスタンス化時にインスタンス属性$app

laravelを定義します。 、laravelコンテナインスタンスが$appに注入されます。したがって、サービスプロバイダーでは、app() 関数や App Facade を使用せずに、$this->$app を通じて常に laravel コンテナインスタンスにアクセスできます。

laravel の技術記事をさらに詳しく知りたい場合は、laravel チュートリアル 列をご覧ください。

以上がコード内でコンテナインスタンスを取得する（Laravel）の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。