命令列選項

執行互動式 PHP。參閱互動式 shell 章節獲取更多資訊。

外部 FASTCGI 伺服器模式繫結路徑（僅 CGI 可用）。

不改變指令碼的目錄（僅 CGI 可用）。

安靜模式。禁止輸出 HTTP 頭（僅 CGI 可用）。

測量指令碼重複 count 次的執行時間（僅 CGI 可用）。

在指定目錄查詢 php.ini 或者自定義 INI 檔案（名稱可以不是 php.ini），例如：

$ php -c /custom/directory/ my_script.php

$ php -c /custom/directory/custom-file.ini my_script.php

如果未指定此選項，php.ini 將在預設位置搜索。

完全忽略 php.ini。

允許設定 php.ini 中配置指令的值。語法是：

 -d configuration_directive[=value]
 

# 忽略值部分，將會設定配置指令為 "1"
$ php -d max_execution_time
        -r '$foo = ini_get("max_execution_time"); var_dump($foo);'
string(1) "1"

# 傳遞空值，將會設定配置指令為 ""
php -d max_execution_time=
        -r '$foo = ini_get("max_execution_time"); var_dump($foo);'
string(0) ""

# 配置指令將會設定為 '=' 字元之後傳遞的任何值
$  php -d max_execution_time=20
        -r '$foo = ini_get("max_execution_time"); var_dump($foo);'
string(2) "20"
$  php
        -d max_execution_time=doesntmakesense
        -r '$foo = ini_get("max_execution_time"); var_dump($foo);'
string(15) "doesntmakesense"

啟用擴充套件資訊模式，用於除錯/分析。

解析並執行指定檔案。 -f 可選且可以忽略 —— 只需提供需要執行的檔名就足夠。

提供了僅對指定 PHP 程式碼進行語法檢查的便捷方法。 成功時將會在標準輸出中寫入 No syntax errors detected in <filename> 並且 shell 返回碼為 0。失敗時除了將會在標準輸出中寫入內部解析錯誤訊息之外，還會寫入 Errors parsing <filename>，並且 shell 返回碼為 -1。

此選項不能發現像是函式未定義之類的核心錯誤（fatal errors）。可以使用 -f 測試核心錯誤（fatal errors）。

注意:

此選項不能和 -r 一起使用。

允許在命令列內直接執行單行 PHP 程式碼。 不需要加上 PHP 開始和結束識別符號（<?php 和 ?>），否則將會造成語法錯誤。

注意:

使用這種形式的 PHP 時，應注意避免和 shell 環境進行的命令列參數替換相沖突。

示例 #2 當使用雙引號時會造成語法錯誤

$ php -r "$foo = get_defined_constants();"
PHP Parse error:  syntax error, unexpected '=' in Command line code on line 1

Parse error: syntax error, unexpected '=' in Command line code on line 1

這裡的問題是在使用雙引號 " 時 sh/bash 會執行變數替換。 由於 $foo 變數沒有被定義，因此它將替換為空字元， 從而導致傳遞給 PHP 執行的程式碼實際上會變成：

$ php -r " = get_defined_constants();"

正確的方式是使用單引號 ' 。使用單引號時 sh/bash 不會進行變數替換。

示例 #3 使用單引號防止 shell 變數替換

$ php -r '$foo = get_defined_constants(); var_dump($foo);'
array(370) {
  ["E_ERROR"]=>
  int(1)
  ["E_WARNING"]=>
  int(2)
  ["E_PARSE"]=>
  int(4)
  ["E_NOTICE"]=>
  int(8)
  ["E_CORE_ERROR"]=>
  [...]

如果使用的 shell 不是 sh/bash，可能會碰到更多的問題 —— 如果有的話，請向 » https://github.com/php/php-src/issues 報告 bug。試圖在命令列中使用（ shell/PHP ）變數或者使用反斜槓轉義時需要格外小心，因為很容易遇到問題。勿謂言之不預！

注意:

可以在 CLI SAPI 中使用 -r，但不能在 CGI SAPI 中使用。

注意:

此選項僅適用於非常基本的程式碼，因此在此模式下會忽略某些配置指令（如 auto_prepend_file 和 auto_append_file）。

處理 stdin 之前需要執行的 PHP 程式碼。

對每個輸入行都執行的 PHP 程式碼。

此模式下有兩個特殊變數： $argn 和 $argi。 $argn 將包含 PHP 正在處理的行， $argi 將包含正在處理的行號。

對每個輸入行都執行的 PHP 檔案。

在處理完輸入后執行的 PHP 程式碼。

$ find my_proj | php -B '$l=0;' -R '$l += count(@file($argn));' -E 'echo "Total Lines: $l\n";'
Total Lines: 37328

啟動 內建 web 伺服器.

為原始碼新增語法高亮顯示。

此選項將使用內部機制解析檔案並將產生的 HTML 高亮版本寫入到標準輸出。 注意它所做的只是產生一塊 <code> [...] </code> HTML 標記，沒有 HTML header。

注意:

此選項不能和 -r 一起使用。

顯示忽略註釋和空格后的原始碼。

注意:

此選項不能和 -r 一起使用。

載入 Zend 擴充套件。如果僅指定了檔名，PHP 將嘗試從目前系統預設函式庫中嘗試載入此擴充套件 （例如在 Linux 上通常是 /etc/ld.so.conf）。 傳遞絕對路徑的檔名將不會使用系統庫搜索路徑。如果用相對路徑指定的檔名，則 PHP 僅試圖在目前目錄的相對目錄載入擴充套件庫。

展示配置檔名和掃瞄目錄。

$ php --ini
Configuration File (php.ini) Path: /usr/dev/php/5.2/lib
Loaded Configuration File:         /usr/dev/php/5.2/lib/php.ini
Scan for additional .ini files in: (none)
Additional .ini files parsed:      (none)

展示指定函式或者類方法的有關資訊（例如參數名稱和數量）。

如果 PHP 在編譯時啟用 Reflection 支援，該選項才可以使用。

$ php --rf var_dump
Function [ <internal> public function var_dump ] {

  - Parameters [2] {
    Parameter #0 [ <required> $var ]
    Parameter #1 [ <optional> $... ]
  }
}

展示指定類的有關資訊（常量、屬性和方法的列表）。

如果 PHP 在編譯時啟用 Reflection 支援，該選項才可以使用。

$ php --rc Directory
Class [ <internal:standard> class Directory ] {

  - Constants [0] {
  }

  - Static properties [0] {
  }

  - Static methods [0] {
  }

  - Properties [0] {
  }

  - Methods [3] {
    Method [ <internal> public method close ] {
    }

    Method [ <internal> public method rewind ] {
    }

    Method [ <internal> public method read ] {
    }
  }
}

展示指定擴充套件的有關資訊（php.ini 選項、定義函式、常量和類的列表）。

如果 PHP 在編譯時啟用 Reflection 支援，該選項才可以使用。

$ php --re json
Extension [ <persistent> extension #19 json version 1.2.1 ] {

  - Functions {
    Function [ <internal> function json_encode ] {
    }
    Function [ <internal> function json_decode ] {
    }
  }
}

展示指定 Zend 擴充套件的配置資訊（也可以通過 phpinfo()返回相同資訊）。

展示指定擴充套件的配置資訊（也可以通過 phpinfo()返回相同資訊）。 使用 「main」 作為副檔名可以獲取到核心配置資訊。

$ php --ri date

date

date/time support => enabled
"Olson" Timezone Database Version => 2009.20
Timezone Database => internal
Default timezone => Europe/Oslo

Directive => Local Value => Master Value
date.timezone => Europe/Oslo => Europe/Oslo
date.default_latitude => 59.930972 => 59.930972
date.default_longitude => 10.776699 => 10.776699
date.sunset_zenith => 90.583333 => 90.583333
date.sunrise_zenith => 90.583333 => 90.583333