在做開發的時候，我們不僅僅只是做各種網站或接口，也常常需要寫一些命令列腳本用來處理一些後端的事務。比如對資料進行處理統計等。當然也是為了效率著想，當一個事務有可能會有較長的耗時時，往往會交由伺服器的定時器來固定時間呼叫腳本進行處理，從而讓客戶端能夠有更好的用戶體驗。我們今天就來了解下 PHP 的命令列運行模式，也就是 PHP CLI 。
CLI 與 CGI
先來看看 CLI 和 CGI 的差異。我們都知道，Nginx 使用的是 FastCgi 來呼叫 PHP 的服務。 CGI 是通用程式接口，也就是提供給呼叫者的一種使用本程式的接口。 Nginx 這種類型的伺服器並不是直接執行 PHP 程式的，而是透過 FastCgi 來執行 PHP 程式並獲得回傳結果。
CLI 則是 Command Line Interface，也就是命令列介面。主要用作 PHP 的開發外殼應用。也就是用 PHP 來進行 shell 腳本的開發。比起 linux 原生的 shell 來說，當然方便了許多。在命令列狀態下，直接使用 php 指令就可以執行某段 PHP 程式碼或某個 PHP 檔案了。
另外，我們在命令列也可以直接使用 phpcgi 來執行一段 PHP 程式碼或某個 PHP 文件，它和直接使用 php 指令來執行有什麼不同呢？
CLI 的輸出沒有任何頭資訊
-
#CLI 在執行時，不會把工作目錄改為腳本的目前目錄
CLI 出錯時輸出純文字的錯誤訊息（非HTML 格式）
強制覆寫了php.ini 中的某些設置，因為這些設置在外殼環境下是沒有意義的
// PHP的CLI命令行运行模式浅析.php echo getcwd(); // php-cgi dev-blog/php/202004/source/PHP的CLI命令行运行模式浅析.php // ...../MyDoc/博客文章/dev-blog/php/202004/source // php dev-blog/php/202004/source/PHP的CLI命令行运行模式浅析.php // ...../MyDoc/博客文章
我們選取最典型的一個例子，我們執行的這個檔案中，使用getcwd() 輸出目前腳本運行的目錄，可以看出兩種運行方式輸出的結果明顯不同。 php-cgi 是以檔案所在目錄為基準輸出，而 php 則是以目前執行這個指令的目錄為基準輸出。
直接執行 PHP 程式碼
在做一些簡單的偵錯的時候，我們可以直接透過 CLI 來執行一段程式碼。
// php -r "echo 121;" // 121
也就是簡單的加個 -r 參數，後面跟上一段程式碼，這段程式碼必須用引號括起來。而且這個引號比較推薦使用單引號，後面的範例會顯示為什麼用單引號比較好。
CLI 取得參數
命令列模式下也是可以給腳本傳遞參數的。
// PHP的CLI命令行运行模式浅析.php print_r($argv); // php-cgi dev-blog/php/202004/source/PHP的CLI命令行运行模式浅析.php 1 2 3 // X-Powered-By: PHP/7.3.0 // Content-type: text/html; charset=UTF-8 // php dev-blog/php/202004/source/PHP的CLI命令行运行模式浅析.php 1 2 3 // Array // ( // [0] => dev-blog/php/202004/source/PHP的CLI命令行运行模式浅析.php // [1] => 1 // [2] => 2 // [3] => 3 // )
在測試檔案中，我們列印了 \$argv 變數。 PHP 腳本運行的時候，會將命令列的所有參數保存在 $argv 變數中，並且還有一個 $argc 變數會保存參數的個數。
我們仍然是使用 php-cgi 和 php ，兩種模式來測試，從這裡我們能發現 php-cgi 模式中 $argv 打印的內容竟然是頭信息，而不是具體的參數信息。這也沒錯，畢竟 CGI 模式本來就是為 Web 伺服器提供的接口，所以它接收的是 post 、 get 這類的參數而不是命令列的參數。
CLI 模式下我們正常獲得了參數內容，而 $argv[0] 始終保存的是目前運行檔案及路徑。
CLI 命令列實用選項
最後，我們再介紹一些命令列中常用的選項。
-r 直接執行程式碼時的參數傳遞
// php -r "var_dump($argv);" app
// Warning: var_dump() expects at least 1 parameter, 0 given in Command line code on line 1
// 双引号 "，sh/bash 实行了参数替换
// php -r 'var_dump($argv);' app
// array(2) {
// [0]=>string(19) "Standard input code"
// [1]=>string(3) "app"
// }
// php -r 'var_dump($argv);' -- -h
// array(2) {
// [0]=>string(19) "Standard input code"
// [1]=>string(2) "-h"
// }第一段程式碼在對雙引號執行的 CLI 程式碼進行參數傳遞的時候，會直接封包警告。其實很好理解，雙引號裡面的$會讓系統的 sh/bash 以為這是個變數從而進行變數參數替換。所以更推薦使用單引號進行日常的簡單測試。
第二段程式碼能夠正常列印傳遞進來的參數內容。第三行程式碼則是需要傳遞帶 - 符號的內容時，需要先給一個 -- 參數清單分隔符號。這是因為 -xxx 的內容會讓 php 指令認為這是一個指令選項而不是參數，所以我們加入一個分隔符號就可以讓分隔符號之後的參數內容原樣傳遞進程式碼中。
互動式地運行 PHP
// php -a // php > $a = 1; // php > echo $a; // php > 1
新增一個 -a 選項，PHP 就會以互動式地形式運行，我們可以直接在互動狀態下寫程式碼或運行任何內容。
查看 phpinfo() 及已經安裝的模組
這兩個應該是大家常會使用的兩個選項。
// 输出 phpinfo() // php -i // 输出 PHP 中加载的模块 // php -m // 查看模块详细信息 // php --ri swoole
另外我們也可以透過 --ri 模組名稱 這個指令來查看具體某個擴充模組的詳細資訊。例如這裡我們可以查看到 swoole 擴充功能的版本及相關的設定資訊。
查看某个文件
// 显示去除了注释和多余空白的源代码 // php -w dev-blog/php/202004/source/PHP的CLI命令行运行模式浅析.php // <?php // echo getcwd(); print_r($argv); // 通过 linux 管道读取输入 // cat dev-blog/php/202004/source/PHP的CLI命令行运行模式浅析.php | php -r "print file_get_contents('php://stdin');" // ......这个文件里面所有的内容
最后两个小技巧，一个是通过 -w 选项，我们可以打印这个 php 文件中所有非注释和换行的内容。可以看成是像前端的代码压缩一样的能力。我们这个测试文件中有非常多的注释，通过这个命令后我们打印出来的内容是去除掉所有注释和空白行的结果。
另一个是我们可以用 linux 管道的方式向 PHP CLI 发送数据。这里我们通过 cat 查看我们的测试文件然后通过管道发送给 PHP CLI，在脚本中使用 STDIN 来读取管道发送过来的内容完成了整个文件内容的打印。这里我们没进行任何过滤，所以打印的是整个文件里面的内容，大家可以运行这个命令来测试。
总结
其实命令行模式运行的时候还有很多的选项，这里我们只是选取了一部分非常有用的内容进行展示。当然，大部分框架都提供了用于命令行的脚本框架，比如 laravel 中可以通过 php artisan make:command 来创建命令行脚本，然后使用 php artisan 来运行框架中的脚本。这些内容将来我们在学习框架方面知识的内容将会进行详细的讲解。
命令行 CLI 模式的应用非常广泛，几乎任何项目中都会使用到，所以，深入的学习掌握它将会使我们大受裨益。
测试代码：
https://github.com/zhangyue0503/dev-blog/blob/master/php/202004/source/PHP%E7%9A%84CLI%E5%91%BD%E4%BB%A4%E8%A1%8C%E8%BF%90%E8%A1%8C%E6%A8%A1%E5%BC%8F%E6%B5%85%E6%9E%90.php
推荐学习：php视频教程