和其它 SAPI 模塊的區(qū)別

以下為 CLI SAPI 和其它 SAPI 模塊相比的顯著區(qū)別:

  • CGI SAPI 不同,其輸出沒有任何頭信息。

    盡管 CGI SAPI 提供了取消 HTTP 頭信息的方法,但在 CLI SAPI 中并不存在類似的方法以開啟 HTTP 頭信息的輸出。

    CLI 默認(rèn)以安靜模式開始,但為了保證兼容性,-q--no-header 參數(shù)為了向后兼容仍然保留,使得可以使用舊的 CGI 腳本。

    在運行時,不會把工作目錄改為腳本的當(dāng)前目錄(可以使用 -C--no-chdir 參數(shù)來兼容 CGI 模式)。

    出錯時輸出純文本的錯誤信息(非 HTML 格式)。

  • CLI SAPI 強制覆蓋了 php.ini 中的某些設(shè)置,因為這些設(shè)置在外殼環(huán)境下是沒有意義的。

    覆蓋 php.ini 設(shè)置選項
    設(shè)置選項 CLI SAPI 默認(rèn)值 備注
    html_errors false 無意義的 HTML 標(biāo)記符會使得出錯信息很凌亂,所以在外殼下閱讀報錯信息是十分困難的。因此將該選項的默認(rèn)值改為 false。
    implicit_flush true 在命令行模式下,所有來自 printecho 的輸出將被立即寫到輸出端,而不作任何地緩沖操作。如果希望延緩或控制標(biāo)準(zhǔn)輸出,仍然可以使用 output buffering 設(shè)置項。
    max_execution_time 0(無限值) 鑒于在外殼環(huán)境下使用 PHP 的無窮的可能性,最大運行時間被設(shè)置為了無限值。為 web 開發(fā)的應(yīng)用程序可能只需運行幾秒鐘時間,而外殼應(yīng)用程序的運行時間可能會長的多。
    register_argc_argv true

    由于該設(shè)置為 true,將總是可以在 CLI SAPI 中訪問到 argc(傳送給應(yīng)用程序參數(shù)的個數(shù))和 argv(包含有實際參數(shù)的數(shù)組)。

    在使用 CLI SAPI 時,PHP 變量 $argc$argv 已被注冊并且設(shè)定了對應(yīng)的值。隨時可以通過 $_SERVER 數(shù)組 來訪問它們,例如:$_SERVER['argv']

    output_buffering false

    雖然 php.ini 設(shè)置已經(jīng)硬編碼為 false, 輸出緩沖控制函數(shù)仍然有效。

    max_input_time false

    PHP CLI 不支持 GET、POST、文件上傳。

    注意:

    這些設(shè)置無法在設(shè)置文件 php.ini 或任何指定的其它文件中被初始化為其它值。這些默認(rèn)值被限制在所有其它的設(shè)置文件被解析后改變。 不過,它們的值可以在程序運行的過程中被改變 (盡管對于該運行過程來說,這些設(shè)置項是沒有意義的,例如 register_argc_argv)。

    注意:

    推薦命令行腳本設(shè)置 ignore_user_abort。 更多信息參見 ignore_user_abort()。

  • 為了減輕外殼環(huán)境下的工作,我們?yōu)?I/O 流 定義了一系列常量。

  • CLI SAPI 不會將當(dāng)前目錄改為已運行的腳本所在的目錄。

    以下范例顯示了本模塊與 CGI SAPI 模塊之間的不同:

    <?php
    // 名為 test.php 的簡單測試程序
    echo getcwd(), "\n";
    ?>

    在使用 CGI 版本時,其輸出為

    $ pwd
    /tmp
    
    $ php-cgi -f another_directory/test.php
    /tmp/another_directory
    

    明顯可以看到 PHP 將當(dāng)前目錄改成了剛剛運行過的腳本所在的目錄。

    使用 CLI SAPI 模式,得到:

    $ pwd
    /tmp
    
    $ php -q another_directory/test.php
    /tmp
    
    這使得在利用 PHP 編寫外殼工具時獲得了很大的便利。

    注意:

    可以在命令行運行時給該 CGI SAPI 加上 -C 參數(shù),使其支持 CLI SAPI 的功能。