php-cli知識

以下是 PHP 二進制文件（即 php.exe 程序）提供的命令行模式的選項參數，您隨時可以通過 PHP -h 命令來查詢這些參數。

Usage: php [options] [-f] <file> [args...]
       php [options] -r <code> [args...]
       php [options] [-- args...]
  -s               Display colour syntax highlighted source.
  -w               Display source with stripped comments and whitespace.
  -f <file>        Parse <file>.
  -v               Version number
  -c <path>|<file> Look for php.ini file in this directory
  -a               Run interactively
  -d foo[=bar]     Define INI entry foo with value 'bar'
  -e               Generate extended information for debugger/profiler
  -z <file>        Load Zend extension <file>.
  -l               Syntax check only (lint)
  -m               Show compiled in modules
  -i               PHP information
  -r <code>        Run PHP <code> without using script tags <?..?>
  -h               This help
 
  args...          Arguments passed to script. Use -- args when first argument 
                   starts with - or script is read from stdin

CLI SAPI 模塊有以下三種不同的方法來獲取您要運行的 PHP 代碼：

 

 

在windows環境下，儘量使用雙引號， 在linux環境下則儘量使用單引號來完成。

1. 讓 PHP 運行指定文件。

   php my_script.php 
   php -f  "my_script.php"

   以上兩種方法（使用或不使用 -f 參數）都能夠運行給定的 my_script.php 文件。您可以選擇任何文件來運行，您指定的 PHP 腳本並非必須要以 .php 爲擴展名，它們可以有任意的文件名和擴展名。

2. 在命令行直接運行 PHP 代碼。

   php -r "print_r(get_defined_constants());"

   在使用這種方法時，請您注意外殼變量的替代及引號的使用。

   注: 請仔細閱讀以上範例，在運行代碼時沒有開始和結束的標記符！加上 -r 參數後，這些標記符是不需要的，加上它們會導致語法錯誤。

3. 通過標準輸入（stdin）提供需要運行的 PHP 代碼。

   以上用法給我們提供了非常強大的功能，使得我們可以如下範例所示，動態地生成 PHP 代碼並通過命令行運行這些代碼：

   $ some_application | some_filter | php | sort -u >final_output.txt

 

以上三種運行代碼的方法不能同時使用。

和所有的外殼應用程序一樣，PHP 的二進制文件（php.exe 文件）及其運行的 PHP 腳本能夠接受一系列的參數。PHP 沒有限制傳送給腳本程序的參數的個數（外殼程序對命令行的字符數有限制，但您通常都不會超過該限制）。傳遞給您腳本的參數可在全局變量 $argv 中獲取。該數組中下標爲零的成員爲腳本的名稱（當 PHP 代碼來自標準輸入獲直接用 -r 參數以命令行方式運行時，該名稱爲“-”）。另外，全局變量 $argc 存有 $argv 數組中成員變量的個數（而非傳送給腳本程序的參數的個數）。

只要您傳送給您腳本的參數不是以 - 符號開頭，您就無需過多的注意什麼。向您的腳本傳送以 - 開頭的參數會導致錯誤，因爲 PHP 會認爲應該由它自身來處理這些參數。您可以用參數列表分隔符 -- 來解決這個問題。在 PHP 解析完參數後，該符號後所有的參數將會被原樣傳送給您的腳本程序。

# 以下命令將不會運行 PHP 代碼，而只顯示 PHP 命令行模式的使用說明：
$ php -r 'var_dump($argv);' -h
Usage: php [options] [-f] <file> [args...]
[...]
 
# 以下命令將會把“-h”參數傳送給腳本程序，PHP 不會顯示命令行模式的使用說明：
$ php -r "var_dump($argv);" -- -h
array(2) {
  [0]=>
  string(1) "-"
  [1]=>
  string(2) "-h"
}

除此之外，我們還有另一個方法將 PHP 用於外殼腳本。您可以在寫一個腳本，並在第一行以 #!/usr/bin/php 開頭，在其後加上以 PHP 開始和結尾標記符包含的正常的 PHP 代碼，然後爲該文件設置正確的運行屬性。該方法可以使得該文件能夠像外殼腳本或 PERL 腳本一樣被直接執行。

#!/usr/bin/php
<?php
    var_dump($argv);
?>

假設改文件名爲 test 並被放置在當前目錄下，我們可以做如下操作：

$ chmod 755 test
$ ./test -h -- foo
array(4) {
  [0]=>
  string(6) "./test"
  [1]=>
  string(2) "-h"
  [2]=>
  string(2) "--"
  [3]=>
  string(3) "foo"
}

正如您所看到的，在您向該腳本傳送以 - 開頭的參數時，腳本仍然能夠正常運行。

 

 

 

 

 

 

------------------------------------------------------------------------------命令選項-----------------------------------------------------

 

表格 23-3. 命令行選項

選項名稱	描 述
-s	顯示有語法高亮色彩的源文件。 該參數使用內建機制來解析文件併爲其生成一個 HTML 高亮版本並將結果寫到標準輸出。請注意該過程所做的只是生成了一個 <code> [...] </code> 的 HTML 標記符塊，並不包含任何的 HTML 頭。 注: 該選項不能和 -r 參數同時使用。
-w	顯示除去了註釋和空格的源代碼。 注: 該選項不能和 -r 參數同時使用。
-f	解析並運行給定的文件名。該參數爲可選參數且可以不加，僅指明需要運行的文件名即可。
-v	將 PHP、PHP SAPI 及 Zend 的版本信息寫入的標準輸出。例如： $ php -v PHP 4.3.0-dev (cli), Copyright (c) 1997-2002 The PHP Group Zend Engine v1.3.0, Copyright (c) 1998-2002 Zend Technologies
-c	用該參數，您可以指定一個放置 php.ini 文件的目錄，或者直接指定一個自定義的 INI 文件，其文件名可以不是 php.ini。例如： $ php -c /custom/directory/ my_script.php   $ php -c /custom/directory/custom-file.ini my_script.php
-a	交互地運行 PHP。
-d	用該參數可以自行設置 php.ini 文件中設置變量的值，其語法爲： -d configuration_directive[=value] 範例： # Ommiting the value part will set the given configuration directive to "1" $ php -d max_execution_time         -r '$foo = ini_get("max_execution_time"); var_dump($foo);' string(1) "1"   # Passing an empty value part will set the configuration directive to "" php -d max_execution_time=         -r '$foo = ini_get("max_execution_time"); var_dump($foo);' string(0) ""   # The configuration directive will be set to anything passed after the '=' character $  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"
-e	爲調試器等生成擴展信息。
-z	加載 Zend 擴展庫。如果僅給定一個文件名，PHP 將試圖從您系統擴展庫的默認路徑（在 Linux 系統下，該路徑通常由 /etc/ld.so.conf 指定）加載該擴展庫。如果您用一個絕對路徑指定文件名，則系統的擴展庫默認路徑將不會被使用。如果用相對路徑指定的文件名，PHP 則僅試圖加載相對於當前目錄的擴展庫。
-l	該參數提供了對指定 PHP 代碼進行語法檢查的方便的方法。如果成功，則向標準輸出寫入 No syntax errors detected in <filename> 字符串，並且外殼返回值爲 0。如果失敗，則 Errors parsing <filename> 以及內部解析器錯誤信息會一起被寫入到標準輸出，同時外殼返回值將別設置爲 255。 該參數將無法檢查致命錯誤（如未定義函數），如果您希望檢測之名錯誤，請使用 -f 參數。 注: 該參數不能和 -r 一同使用。
-m	使用該參數，PHP 將打印出內置以及已加載的 PHP 及 Zend 模塊： $ php -m [PHP Modules] xml tokenizer standard session posix pcre overload mysql mbstring ctype   [Zend Modules]
-i	該命令行參數會調用 phpinfo() 函數，並打印出結果。如果 PHP 沒有正常工作，我們建議您執行 php -i 命令來查看在信息表格之前或者對應的地方是否有任何錯誤信息輸出。請注意輸出的內容爲 HTML 格式，因此輸出的信息篇幅較大。
-r	使用該參數可以在命令行運行 PHP 代碼。您無需加上 PHP 的起始和結束標識符（<?php 和 ?>），否則將會導致語法解析錯誤。 注: 使用這種形式的 PHP 時，應個別注意避免和外殼環境進行的命令行參數替換相沖突。 顯示語法解析錯誤的範例 $ php -r "$foo = get_defined_constants();" Command line code(1) : Parse error - parse error, unexpected '=' 這裏的問題在於即時使用了雙引號 "，sh/bash 仍然實行了參數替換。由於 $foo 沒有被定義，被替換後它所在的位置變成了空字符，因此在運行時，實際被PHP 讀取的代碼爲： $ php -r " = get_defined_constants();" 正確的方法是使用單引號 '。在用單引號引用的字符串中，變量不會被 sh/bash 還原成其原值。 $ 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"]=>   [...] 如果您使用的外殼不是 sh/bash，您可能會碰到其它的問題。請報告您碰到的 bug，或者發郵件到 [email protected]。 當您試圖將外殼的環境變量引入到馬或者用反斜線來轉義字符時也可能碰到各種各樣的問題，請您在使用時注意！ 注: -r 在 CLI SAPI 中有效，在 CGI SAPI 中無效。
-h	使用該參數，您可以得到完整的命令行參數的列表及這些參數作用的簡單描述。

 

PHP 的命令行模式能使得 PHP 腳本能完全獨立於 WEB 服務器單獨運行。如果您使用 Unix 系統，您需要在您的 PHP 腳本的最前面加上一行特殊的代碼，使得它能夠被執行，這樣系統就能知道用什麼樣的程序要運行該腳本。在 Windows 平臺下您可以將 php.exe 和 .php 文件的雙擊屬性相關聯，您也可以編寫一個批處理文件來用 PHP 執行腳本。爲 Unix 系統增加的第一行代碼不會影響該腳本在 Windows 下的運行，因此您也可以用該方法編寫跨平臺的腳本程序。以下是一個簡單的PHP 命令行程序的範例。

例子 23-1. 試圖以命令行方式運行的 PHP 腳本（script.php）

#!/usr/bin/php
<?php

if ($argc != 2 || in_array($argv[1], array('--help', '-help', '-h', '-?'))) {
?>

This is a command line PHP script with one option.

  Usage:
  <?php echo $argv[0]; ?> <option>

  <option> can be some word you would like
  to print out. With the --help, -help, -h,
  or -? options, you can get this help.

<?php
} else {
    echo $argv[1];
}
?>

在以上腳本中，我們用第一行特殊的代碼來指明該文件應該由 PHP 來執行。我們在這裏使用 CLI 的版本，因此不會有 HTTP 頭信息輸出。在您用 PHP 編寫命令行應用程序時，您可以使用兩個參數：$argc 和 $argv。前面一個的值是比參數個數大 1 的整數（運行的腳本本身的名稱也被當作一個參數）。第二個時包含有參數的數組，其第一個元素爲腳本的名稱，下標爲數字 0（$argv[0]）。

在以上程序中我們檢查了參數的個數是大於 1 個還是小於 1 個。即時參數是 --help、-help、-h 或 -?，我們仍然打印出幫助信息，並同時動態輸出腳本的名稱。如果還收到了其它參數，我們也把它們顯示出來。

如果您希望在 Unix 下運行以上腳本，您需要使得它成爲可執行腳本，然後簡單的運行 script.php echothis 或 script.php -h。在 Windows 下，您可以爲此編寫一個批處理文件：