PHP 命令行模式完全指南：常用參數、腳本執行、語法檢查、代碼高亮、內置手冊查詢

PHP 不僅是 Web 開發語言，其 CLI (Command Line Interface) 模式同樣強大，可用於定時任務、腳本自動化、代碼檢查、手冊查詢等。本文系統整理命令行參數與實用技巧。

核心命令行參數速查

實用場景示例

1. 將 PHP 腳本作為 Shell 命令執行

#!/usr/bin/php -q
 1 && $argv[1] && echo "Arg: $argv[1]\n";

2. 定時任務 (Crontab) 調用

# 每天凌晨 3 點執行備份腳本
0 3 * * * /usr/bin/php -q /var/www/html/scripts/backup.php >> /var/log/backup.log 2>&1

注意： CLI 環境下 $_SERVER、$_SESSION、$_GET 等超全局變量不可用或為空，僅 $argc/$argv 可靠。

3. 語法檢查與代碼高亮

# 檢查語法錯誤（CI/CD 必備）
php -l src/Controller/UserController.php
# 輸出: No syntax errors detected in ...

# 生成高亮 HTML 用於文檔/博客展示
php -s src/Controller/UserController.php > UserController.html

4. 交互式調試 (REPL)

$ php -a
Interactive shell
php > $arr = [1,2,3];
php > echo array_sum($arr);
6
php > quit

5. 查看函數簽名 (內置手冊)

$ php --rf json_encode
Function [  function json_encode ] {
  - Parameters [3] {
    Parameter #0 [  $value ]
    Parameter #1 [  $options ]
    Parameter #2 [  $depth ]
  }
}

6. 運行時覆蓋配置

# 臨時開啟所有錯誤報告
php -d error_reporting=E_ALL -d display_errors=1 -f script.php

CLI vs Web SAPI 關鍵差異

進階技巧

• 獲取標準輸入：$stdin = fopen('php://stdin', 'r'); $line = fgets($stdin); 或 stream_get_contents(STDIN)。
• 顏色輸出：echo "\033[32mGreen\033[0m\n"; (ANSI 轉義碼)，或用 symfony/console 組件。
• 進程信號處理：CLI 下可用 pcntl_signal 捕獲 SIGINT (Ctrl+C) 做優雅關閉。
• Composer 腳本調用："scripts": {"test": "php -d memory_limit=512M vendor/bin/phpunit"}。

總結

掌握 PHP CLI 模式，能將 PHP 能力延伸至運維自動化、數據遷移、隊列消費、代碼質量檢查等非 Web 領域。-l、-s、--rf、-a 是開發階段的高頻利器；-q、-f、-d 是生產部署的標準配置。善用命令行，效率倍增。