淺談Laravel核心解讀之Console內核

更新時間：2018年12月02日 15:48:19 作者：KevinYan

這篇文章主要介紹了淺談Laravel核心解讀之Console內核，小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧

Console內核

上一篇文章我們介紹了Laravel的HTTP內核，詳細概述了網(wǎng)絡請求從進入應用到應用處理完請求返回HTTP響應整個生命周期中HTTP內核是如何調動Laravel各個核心組件來完成任務的。除了處理HTTP請求一個健壯的應用經(jīng)常還會需要執(zhí)行計劃任務、異步隊列這些。Laravel為了能讓應用滿足這些場景設計了artisan工具，通過artisan工具定義各種命令來滿足非HTTP請求的各種場景，artisan命令通過Laravel的Console內核來完成對應用核心組件的調度來完成任務。今天我們就來學習一下Laravel Console內核的核心代碼。

內核綁定

跟HTTP內核一樣，在應用初始化階有一個內核綁定的過程，將Console內核注冊到應用的服務容器里去，還是引用上一篇文章引用過的bootstrap/app.php里的代碼

<?php
// 第一部分： 創(chuàng)建應用實例
$app = new Illuminate\Foundation\Application(
  realpath(__DIR__.'/../')
);

// 第二部分： 完成內核綁定
$app->singleton(
  Illuminate\Contracts\Http\Kernel::class,
  App\Http\Kernel::class
);
// console內核綁定
$app->singleton(
  Illuminate\Contracts\Console\Kernel::class,
  App\Console\Kernel::class
);

$app->singleton(
  Illuminate\Contracts\Debug\ExceptionHandler::class,
  App\Exceptions\Handler::class
);

return $app;

Console內核 \App\Console\Kernel繼承自Illuminate\Foundation\Console， 在Console內核中我們可以注冊artisan命令和定義應用里要執(zhí)行的計劃任務。

/**
* Define the application's command schedule.
*
* @param \Illuminate\Console\Scheduling\Schedule $schedule
* @return void
*/
protected function schedule(Schedule $schedule)
{
  // $schedule->command('inspire')
  //     ->hourly();
}
/**
* Register the commands for the application.
*
* @return void
*/
protected function commands()
{
  $this->load(__DIR__.'/Commands');
  require base_path('routes/console.php');
}

在實例化Console內核的時候，內核會定義應用的命令計劃任務(shedule方法中定義的計劃任務)

public function __construct(Application $app, Dispatcher $events)
{
  if (! defined('ARTISAN_BINARY')) {
    define('ARTISAN_BINARY', 'artisan');
  }

  $this->app = $app;
  $this->events = $events;

  $this->app->booted(function () {
    $this->defineConsoleSchedule();
  });
}

應用解析Console內核

查看aritisan文件的源碼我們可以看到，完成Console內核綁定的綁定后，接下來就會通過服務容器解析出console內核對象

$kernel = $app->make(Illuminate\Contracts\Console\Kernel::class);

$status = $kernel->handle(
  $input = new Symfony\Component\Console\Input\ArgvInput,
  new Symfony\Component\Console\Output\ConsoleOutput
);

執(zhí)行命令任務

解析出Console內核對象后，接下來就要處理來自命令行的命令請求了，我們都知道PHP是通過全局變量$_SERVER['argv']來接收所有的命令行輸入的，和命令行里執(zhí)行shell腳本一樣（在shell腳本里可以通過$0獲取腳本文件名，$1 $2這些依次獲取后面?zhèn)鬟f給shell腳本的參數(shù)選項）索引0對應的是腳本文件名，接下來依次是命令行里傳遞給腳本的所有參數(shù)選項，所以在命令行里通過artisan腳本執(zhí)行的命令，在artisan腳本中$_SERVER['argv']數(shù)組里索引0對應的永遠是artisan這個字符串，命令行里后面的參數(shù)會依次對應到$_SERVER['argv']數(shù)組后續(xù)的元素里。

因為artisan命令的語法中可以指定命令參數(shù)選項、有的選項還可以指定實參，為了減少命令行輸入?yún)?shù)解析的復雜度，Laravel使用了Symfony\Component\Console\Input對象來解析命令行里這些參數(shù)選項（shell腳本里其實也是一樣，會通過shell函數(shù)getopts來解析各種格式的命令行參數(shù)輸入），同樣地Laravel使用了Symfony\Component\Console\Output對象來抽象化命令行的標準輸出。

引導應用

在Console內核的handle方法里我們可以看到和HTTP內核處理請求前使用bootstrapper程序引用應用一樣在開始處理命令任務之前也會有引導應用這一步操作

其父類「IlluminateFoundationConsoleKernel」內部定義了屬性名為「bootstrappers」的引導程序數(shù)組：

protected $bootstrappers = [
  \Illuminate\Foundation\Bootstrap\LoadEnvironmentVariables::class,
  \Illuminate\Foundation\Bootstrap\LoadConfiguration::class,
  \Illuminate\Foundation\Bootstrap\HandleExceptions::class,
  \Illuminate\Foundation\Bootstrap\RegisterFacades::class,
  \Illuminate\Foundation\Bootstrap\SetRequestForConsole::class,
  \Illuminate\Foundation\Bootstrap\RegisterProviders::class,
  \Illuminate\Foundation\Bootstrap\BootProviders::class,
];

數(shù)組中包括的引導程序基本上和HTTP內核中定義的引導程序一樣，都是應用在初始化階段要進行的環(huán)境變量、配置文件加載、注冊異常處理器、設置Console請求、注冊應用中的服務容器、Facade和啟動服務。其中設置Console請求是唯一區(qū)別于HTTP內核的一個引導程序。

執(zhí)行命令

執(zhí)行命令是通過Console Application來執(zhí)行的，它繼承自Symfony框架的Symfony\Component\Console\Application類，通過對應的run方法來執(zhí)行命令。

name Illuminate\Foundation\Console;
class Kernel implements KernelContract
{
  public function handle($input, $output = null)
  {
    try {
      $this->bootstrap();

      return $this->getArtisan()->run($input, $output);
    } catch (Exception $e) {
      $this->reportException($e);

      $this->renderException($output, $e);

      return 1;
    } catch (Throwable $e) {
      $e = new FatalThrowableError($e);

      $this->reportException($e);

      $this->renderException($output, $e);

      return 1;
    }
  }
}

namespace Symfony\Component\Console;
class Application
{
  //執(zhí)行命令
  public function run(InputInterface $input = null, OutputInterface $output = null)
  {
    ......
    try {
      $exitCode = $this->doRun($input, $output);
    } catch {
      ......
    }
    ......
    return $exitCode;
  }
  
  public function doRun(InputInterface $input, OutputInterface $output)
  {
    //解析出命令名稱
    $name = $this->getCommandName($input);
    
    //解析出入?yún)?
    if (!$name) {
      $name = $this->defaultCommand;
      $definition = $this->getDefinition();
      $definition->setArguments(array_merge(
        $definition->getArguments(),
        array(
          'command' => new InputArgument('command', InputArgument::OPTIONAL, $definition->getArgument('command')->getDescription(), $name),
        )
      ));
    }
    ......
    try {
      //通過命令名稱查找出命令類（命名空間、類名等）
      $command = $this->find($name);
    }
    ......
    //運行命令類
    $exitCode = $this->doRunCommand($command, $input, $output);
    
    return $exitCode;
  }
  
  protected function doRunCommand(Command $command, InputInterface $input, OutputInterface $output)
  {
    ......
    //執(zhí)行命令類的run方法來處理任務
    $exitCode = $command->run($input, $output);
    ......
    
    return $exitcode;
  }
}

執(zhí)行命令時主要有三步操作：

通過命令行輸入解析出命令名稱和參數(shù)選項。
通過命令名稱查找命令類的命名空間和類名。
執(zhí)行命令類的run方法來完成任務處理并返回狀態(tài)碼。

和命令行腳本的規(guī)范一樣，如果執(zhí)行命令任務程序成功會返回0, 拋出異常退出則返回1。

還有就是打開命令類后我們可以看到并沒有run方法，我們把處理邏輯都寫在了handle方法中，仔細查看代碼會發(fā)現(xiàn)run方法定義在父類中，在run方法會中會調用子類中定義的handle方法來完成任務處理。嚴格遵循了面向對象程序設計的SOLID 原則。

結束應用

執(zhí)行完命令程序返回狀態(tài)碼后，在artisan中會直接通過exit($status)函數(shù)輸出狀態(tài)碼并結束PHP進程，接下來shell進程會根據(jù)返回的狀態(tài)碼是否為0來判斷腳本命令是否執(zhí)行成功。

到這里通過命令行開啟的程序進程到這里就結束了，跟HTTP內核一樣Console內核在整個生命周期中也是負責調度，只不過Http內核最終將請求落地到了Controller程序中而Console內核則是將命令行請求落地到了Laravel中定義的各種命令類程序中，然后在命令類里面我們就可以寫其他程序一樣自由地使用Laravel中的各個組件和注冊到服務容器里的服務了。

本文已經(jīng)收錄在系列文章Laravel源碼學習里，歡迎訪問閱讀。

以上就是本文的全部內容，希望對大家的學習有所幫助，也希望大家多多支持腳本之家。