這篇文章為大家帶來了關於Laravel的相關知識,其中主要介紹了運行命令列腳本的相關問題,Laravel 中有個專門單獨的目錄,也就是Console 目錄,它是用於存放腳本文件的。下面一起來看一下,希望對大家有幫助。
推薦學習:Laravel入門
#我們看到了Laravel 中有個專門單獨的目錄,也就是Console 目錄,它是用於存放腳本文件的。這個腳本檔案一般指的就是我們透過 php 指令來執行的命令列腳本,在許多框架中都有這樣的功能。對於現代化的應用開發來說,一些資料統計、資料匯出、佇列處理等比較耗時的功能,以及一些自動化的後端執行程序,都需要使用這種命令列腳本來執行。
在目前的框架目錄中,我們在根目錄執行php artisan ,就可以看到命令列的幫助信息,這裡就列出了所有已經存在的命令列腳本。在第一篇文章中,我們就接觸過這其中的兩個指令。
# php artisan key:generate # php artisan serve
它們的作用一個是產生一個加密快取等需要使用的唯一 Key ,另一個是運行一個自帶的簡易伺服器。從腳本名稱我們可以看出,腳本可以以一個 : 分隔,冒號前面是大的分類,例如有 cache:xxx 相關的,也有 make:xxx 相關的。 cache 相關的就是處理一些快取資訊的,而 make 相關的則是創建一些我們需要的文件,例如創建一個控制器可以使用 make:controller ,創建一個資料模型可以使用 make:model 。
關於這些預設自帶的腳本,我們將在學習到相關內容的時候順帶著一起學習。
自訂一個腳本非常簡單。我們可以使用 make:command 指令來產生一個命令列腳本。
# php artisan make:command test1 Console command created successfully.
這時,在 app/Console/Commands 目錄下就會出現一個 test1.php 檔案。打開這個文件,我們需要做一些修改。
/** * The name and signature of the console command. * * @var string */ protected $signature = 'command:name'; /** * The console command description. * * @var string */ protected $description = 'Command description';
signature 用來設定目前這個腳本的名稱,description 用來定義腳本的註解說明。它們用在什麼地方呢?其實 signature 就是我們透過 php artisan 來執行這個腳本時所需要用到的名稱。例如我們現在直接執行 php artisan 的話,就會看到下面這樣一條可執行命令列腳本的出現。
command command:name Command description
當然,使用這個預設的名稱並不是好的主意,所以我們可以修改這兩個屬性。
/** * The name and signature of the console command. * * @var string */ protected $signature = 'ZyBlog:Test1'; /** * The console command description. * * @var string */ protected $description = '硬核测试1';
這時候我們再執行 php artisan 的話,就可以看到我們定義的資訊了。
ZyBlog ZyBlog:Test1 硬核测试1
如果要執行這個腳本也非常簡單。
# php artisan ZyBlog:Test1
當然,我們還什麼都沒做呢,所以不會有任何輸出。接下來我們把接收參數和輸出訊息一起做了。接收參數需要在 signature 中定義我們要接收的參數及選項。還記得我們之前講過的 PHP 如何接收腳本參數及選項資訊的文章嗎? Laravel 已經將這些封裝好了,不需要再去使用那些函數來進行接收處理,直接使用就可以了。需要複習的同學可以移步 【如何取得PHP命令列參數】mp.weixin.qq.com/s/dFuGaM1JT… 進行複習或學習。
protected $signature = 'ZyBlog:Test1 {a=1} {--b=*}'; /** * Execute the console command. * * @return int */ public function handle() { echo "欢迎进来测试!", PHP_EOL; print_r($this->arguments()); // Array // ( // [command] => ZyBlog:Test1 // [a] => 1 // ) print_r($this->options()); // Array // ( // [b] => Array // ( // [0] => 2 // ) // [help] => // [quiet] => // [verbose] => // [version] => // [ansi] => // [no-ansi] => // [no-interaction] => // [env] => // ) echo $this->argument('a'); // 1 print_r($this->option('b')); // Array // ( // [0] => 2 // ) return 0; }
在 handle() 函數中,我們可以寫出目前這個腳本需要執行的函數程式碼。其中,透過 arguments() 和 argument() 可以接收到腳本的參數訊息,透過 options() 和 option() 可以接收到腳本的選項訊息。關於參數和選項的問題,之前的文章中我們也講解過了,這裡也就不多說了,一切都是以基礎為準的。
對於參數和選項來說,Laravel 的底層呼叫的其實是symfony 的Console 元件,在symfony/console/Input/ArgvInput.php 中,我們可以看到下面這些程式碼。
public function __construct(array $argv = null, InputDefinition $definition = null) { $argv = $argv ?? $_SERVER['argv'] ?? []; // strip the application name array_shift($argv); $this->tokens = $argv; parent::__construct($definition); } // …………………… // …………………… protected function parse() { $parseOptions = true; $this->parsed = $this->tokens; while (null !== $token = array_shift($this->parsed)) { if ($parseOptions && '' == $token) { $this->parseArgument($token); } elseif ($parseOptions && '--' == $token) { $parseOptions = false; } elseif ($parseOptions && 0 === strpos($token, '--')) { $this->parseLongOption($token); } elseif ($parseOptions && '-' === $token[0] && '-' !== $token) { $this->parseShortOption($token); } else { $this->parseArgument($token); } } }
很明顯,在 symfony 中,也是使用的 argv 取得參數和選項,然後將它們放到 input 變數中向下傳遞。這個 input 變數很重要,後面我們在學習請求相關的內容時也會接觸到。之後在我們的執行程式碼中,也就是 Command 的 handle() 方法中使用 argument() 或 option() 取得到的就是這個 input 中的資料。從斷點調試中我們就可以看到它們的身影。
那麼 Laravel 是如何執行 handle() 函數的呢?首先透過artisan 檔案呼叫到laravel/framework/src/Illuminate/Foundation/Console/Kernel.php 文件,在這個Kernel.php 中的handle() 方法中會呼叫symfony/console/Application.php ,接著進入laravel/frameworklaravel/framework /src/Illuminate/Console/Command.php 中執行execute() 方法,透過回呼的方式呼叫我們自訂的那個handle() 方法。
注意,在 laravel/framework/src/Illuminate/Console/Command.php 的底層還是呼叫的 symfony 下面的 console/command.php 裡面的方法。
整個呼叫鏈條非常長,不過也可以清楚看出我們的 Laravel 確實就是在 Symfony 的基礎上又套了層殼。而且不僅僅是命令列這裡,在 Web 請求這一塊,依然底層還是 Symfony 在發揮著至關重要的作用。
推薦學習:Laravel影片教學
#以上是一起聊聊Laravel運行命令列腳本的詳細內容。更多資訊請關注PHP中文網其他相關文章!