[WIP]laravel 构成的概念

创建: 2019/06/21

 

请求的生命周期
 生命周期概述

 

 首先

 index.php 文件加载 Composer 生成的自动加载设置，

 然后从 bootstrap/app.php 脚本中检索 Laravel 应用程序的实例。

 Laravel 本身采取的第一个动作是创建一个应用程序 / 服务容器。 

 应用入口

 

public/index.php

 

 
 然后

 

bootstrap/app.php

 

 

 
 HTTP/Console内核

 接下来， 根据进入应用程序的请求类型来将传入的请求发送到 HTTP 内核或控制台内核。

 而这两个内核是用来作为所有请求都要通过的中心位置

 

 http内核

 

 位置  app/Http/Kernel.php 
 

 ● 继承 Illuminate\Foundation\Http\Kernel 

 ● 该类定义了一个 bootstrappers 数组

 

 

 这个数组中的类在请求被执行前运行，

   这些 bootstrappers 配置了错误处理， 日志， 检测应用环境，

   以及其它在请求被处理前需要执行的任务
   

还定义了所有请求被应用程序处理之前必须经过的 HTTP 中间件 ，

  这些中间件处理 HTTP 会话 读写、判断应用是否处于维护模式、

  验证 CSRF 令牌 等等。
 handle  获取一个 Request ，返回一个 Response

   

 

 
 Console内核

 

 位置   app/console/Kernel.php 
   

 

 
 服务提供者

 注册服务提供者是内核启动操作中最重要的环节

 位置

 config/app.php

 服务提供者注册在 providers 数组里
 注册过程

 

 第一步  调用服务提供者的 register 
 第二步  所有服务都注册后，调用 boot 方法

 
   

 
 请求调度

 应用的初期处理完成后，服务提供者也注册完了以后,

 Request会被传送给路由, 路由把request调度给route或controller，

 这是由路由指定的中间件会被运行

 
 聚焦服务提供者   AppServiceProvider 默认为空, 可以防止自己的服务提供者, 也可以新建其他文件
   
   
service container
 简介

 服务容器是管理类依赖和执行依赖注入的工具.

 通过构造函数或者setter将外部依赖放入类中
 绑定

 由于大多数用户的服务容器都被注册在服务提供者中，所以下面的大多数的例子都是在演示服务提供者中使用容器。

 基础绑定

 在服务提供者里可以通过 $this->app 来访问服务容器

 bind(类/接口名, 返回实例的闭包) 

 闭包参数是服务容器

$this->app->bind('Sample\Test', function($app) {
    return new Sample\Test($app->make('HttpClient'));
});

 

 

 singleton(类/接口名, 返回实例的闭包) 

 闭包参数是服务容器

 将类或接口绑定到只解析一次的容器中。一旦单例绑定被解析，相同的对象实例会在随后的调用中返回到容器中

$this->app->singleton('HelpSpot\API', function ($app) {
    return new HelpSpot\API($app->make('HttpClient'));
});

 

 instance(类/接口名, 指定类/接口的实例) 

 闭包参数是服务容器

 将现有对象实例绑定到容器中。给定的实例会始终在随后的调用中返回到容器中：

$api = new HelpSpot\API(new HttpClient);

$this->app->instance('HelpSpot\API', $api);

 

 

 绑定基础值

 闭包参数是服务容器

$this->app->when('App\Http\Controllers\UserController')
          ->needs('$variableName')
          ->give($value);

 

 
 绑定接口到实现

 

bind(接口, 实现)

 例

$this->app->bind(
    'App\Contracts\EventPusher',
    'App\Services\RedisEventPusher'
);

 
 上下文绑定

 

use Illuminate\Support\Facades\Storage;
use App\Http\Controllers\PhotoController;
use App\Http\Controllers\VideoController;
use Illuminate\Contracts\Filesystem\Filesystem;

$this->app->when(PhotoController::class)
          ->needs(Filesystem::class)
          ->give(function () {
              return Storage::disk('local');
          });

$this->app->when([VideoController::class, UploadController::class])
          ->needs(Filesystem::class)
          ->give(function () {
              return Storage::disk('s3');
          });

 

$this->app->bind('ReportAggregator', function ($app) {
    return new ReportAggregator($app->tagged('reports'));
});

  
 标记

 有时候，你可能需要解析某个 “分类” 下的所有绑定。

 比如， 你可能正在构建一个报表的聚合器，它接收一个包含不同 Report 接口实现的数组。注册 Report 实现之后，你可以使用 tag 方法给他们分配一个标签

$this->app->bind('SpeedReport', function () {
    //
});

$this->app->bind('MemoryReport', function () {
    //
});

$this->app->tag(['SpeedReport', 'MemoryReport'], 'reports');

 一旦服务被标记，你就可以通过 tagged 方法轻松地解析它们： 

$this->app->bind('ReportAggregator', function ($app) {
    return new ReportAggregator($app->tagged('reports'));
});

 

 
 扩展绑定

 闭包参数: 需要扩张的服务类

 extend 方法可以修改已解析的服务。比如, 当一个服务被解析后, 你可以添加额外的代码来修饰或者配置它。

 extend 方法接受一个闭包, 该闭包唯一的参数就是这个服务, 并返回修改过的服务

$this->app->extend(Service::class, function ($service) {
    return new DecoratedService($service);
});

 

 
 解析

 

 make方法

 从容器中解析出类实例。 

 ● 参数: 解析的类或接口的名字

$api = $this->app->make('HelpSpot\API');

 ● 若无法访问容器, 则用resolve

$api = resolve('HelpSpot\API');

 ● 如果类依赖不能通过容器解析，你可以通过将它们作为关联数组作为 makeWith 方法的参数注入

$api = $this->app->makeWith('HelpSpot\API', ['id' => 1]);

 

 
 自动注入  

 可以简单地使用 "类型提示" 的方式在类的构造函数中注入那些需要容器解析的依赖项，

 包括 控制器，事件监听器， 队列任务，中间件，等 。实际上，这才是大多数对象应该被容器解析的方式。

 例如，你可以在控制器的构造函数中添加一个 repository 的类型提示，然后这个 repository 将会被自动解析并注入类中

<?php

namespace App\Http\Controllers;

use App\Users\Repository as UserRepository;

class UserController extends Controller
{
    /**
     * The user repository instance.
     */
    protected $users;

    /**
     * Create a new controller instance.
     *
     * @param  UserRepository  $users
     * @return void
     */
    public function __construct(UserRepository $users)
    {
        $this->users = $users;
    }

    /**
     * Show the user with the given ID.
     *
     * @param  int  $id
     * @return Response
     */
    public function show($id)
    {
        //
    }
}

 

 

 
 容器事件

 服务容器每次解析对象会触发一个事件，你可以使用 resolving 方法监听这个事件

$this->app->resolving(function ($object, $app) {
    // Called when container resolves object of any type...
});

$this->app->resolving(HelpSpot\API::class, function ($api, $app) {
    // Called when container resolves objects of type "HelpSpot\API"...
});

 

 
 PSR-11

 Laravel 的服务容器实现了 PSR-11 接口。

 因此，你可以使用 PSR-11 容器 『接口类型提示』 来获取 Laravel 容器的实例： 

use Psr\Container\ContainerInterface;

Route::get('/', function (ContainerInterface $container) {
    $service = $container->get('Service');

    //
});

 

 
service provider
 简介

 

 位置

  config/app.php 

 providers数组
 

 服务提供者是所有 Laravel 应用程序的引导中心. 开发的部分及laravel核心部分都是通过服务提供者来引导

 包括服务容器的绑定, 事件的监听器, filter, 路由等 

 
 编写服务提供者

 

 简介

 所有服务提供者都继承 Illuminate\Support\ServiceProvider 

 ● 大多包含 register 和 boot 方法

    register里只可以进行服务容器的绑定 

 ● 
 生成服务提供者文件

 

php artisan make:provider 文件名
// 例
php artisan make:provider RiakServiceProvider

 

 

 register

 注册

 只需要将服务绑定到服务容器中。而不要尝试在 register 方法中注册任何监听器，路由，或者其他任何功能

<?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'));
        });
    }
}

 

 

 boot

 引导

 该方法在所有服务提供者被注册以后才会被调用

<?php

namespace App\Providers;

use Illuminate\Support\ServiceProvider;

class ComposerServiceProvider extends ServiceProvider
{
    /**
     * 启动所有的应用服务。
     *
     * @return void
     */
    public function boot()
    {
        view()->composer('view', function () {
            //
        });
    }
}

 

 ● 启动方法的依赖注入

 你可以为服务提供者的 boot 方法设置类型提示。 服务容器 会自动注入你所需要的依赖：

use Illuminate\Contracts\Routing\ResponseFactory;

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

 

 

 
 bindings, singletons属性

 一次绑定大量服务

<?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,
    ];

    /**
     * 设定所有的单例模式容器绑定的对应关系
     *
     * @var array
     */
    public $singletons = [
        DowntimeNotifier::class => PingdomDowntimeNotifier::class,
    ];
}

 
   
   
   
   
   

 
 注册提供者

 所有服务提供者都是通过配置文件 config/app.php 进行注册。

 该文件包含了一个列出所有服务提供者名字的 providers 数组，

 默认情况下，其中列出了所有核心服务提供者，这些服务提供者启动 Laravel 核心组件，比如邮件、队列、缓存等等。

 

 要注册提供器，只需要将其添加到数组：

'providers' => [
    // 其他服务提供者

    App\Providers\ComposerServiceProvider::class,
],

 

 
 延迟提供者  TODO: 以后完成这里
   
facade
   
    
   
   
   
契约
   
   
   
   
   
posted @ 2019-06-21 10:19  懒虫哥哥  阅读(635)  评论(0)  编辑  收藏  举报