用PHP命令列控制指令碼

可執行檔

    所有的PHP發行版，不論是編譯自原始碼的版本還是預建立的版本，都在預設情況下帶有一個PHP可執行檔。這個可執行檔可以被用來運行命令列的PHP程式。

    要在你的系統上找到這個可執行檔，就要遵照下面的步驟：

        在Windows作業系統裡，它被放在PHP主安裝目錄下，檔案名稱是php.exe或者（在老版本的PHP裡）是php-cli.exe。

        在Linux作業系統裡，它被儲存在PHP安裝目錄的bin/子目錄下。

    不論是在哪一個作業系統裡，你都需要對它進行測試，以保證它能夠正常運行，方法是用-v參數調用它：

shell> /path/to/php -v
PHP 5.0.0 (cli) (built: Jun 1 2005 18:32:10)
Copyright (c) 1997-2004 The PHP Group
Zend Engine v2.0.0, Copyright (c) 1998-2004 Zend Technologies

它應該會返回PHP的版本號碼。

一個簡單的PHP CLI程式
    一旦找到了這個CLI可執行檔，你就可以用一個簡單的程式來使用一下。建立一個簡單的文字檔，其中包含有以下PHP代碼，並把它儲存為hello.php：

<?php
echo "Hello from the CLI";
?>

    現在，試著在命令列提示符下運行這個程式，方法是調用CLI可執行檔並提供指令碼的檔案名稱：

shell> /path/to/phphello.php
Hello from the CLI

使用標準的輸入和輸出
    PHP CLI會定義三個常量，以便讓在命令列提示符下與解譯器進行互動操作更加容易。這些常量見表格A。

表格A

常量	說明
STDIN	標準的輸入裝置
STDOUT	標準的輸出裝置
STDERR	標準的錯誤裝置

    你可以在自己的PHP指令碼裡使用這三個常量，以接受使用者的輸入，或者顯示處理和計算的結果。要更好地理解這一點，可以看看下面的指令碼（列表A）：

列表A
<?php
// ask for input
fwrite(STDOUT, "Enter your name: ");

// get input
$name = trim(fgets(STDIN));

// write input back
fwrite(STDOUT, "Hello, $name!");
?>
Look what happens when you run it:
shell> /path/to/phphello.php
Enter your name: Joe
Hello, Joe!

    在這個指令碼裡，fwrite()函數首先會向標準的輸出裝置寫一條訊息，詢問使用者的姓名。然後它會把從標準輸入裝置獲得的使用者輸入資訊讀取到一個PHP變數裡，並它把合并成為一個字串。然後就用fwrite()把這個字串列印輸出到標準的輸出裝置上。

使用命令列自變數
    在命令列裡輸入程式參數來更改其運行方式是很常見的做法。你也可以對CLI程式這樣做。PHP CLI帶有兩個特殊的變數，專門用來達到這個目的：一個是$argv變數，它通過命令列把傳遞給PHP指令碼的參數儲存為單獨的數組元素；另一個是$ argc變數，它用來儲存$argv數組裡元素的個數。

    用PHP指令碼編寫一段讀取$argv並處理它所含參數的代碼是很簡單的。試試列表B裡的樣本指令碼，看看它是如何工作的：

列表B
<?php
print_r($argv);
?>

Run this script by passing it some arbitrary values, and check the output:

shell> /path/to/phptest.php chocolate 276 "killer tie, dude!"
Array
( [0] => test.php
[1] => chocolate
[2] => 276
[3] => killer tie, dude!
)

    正如你可以從輸出的結果看到的，傳遞給test.php的值會自動地作為數組元素出現在$argv裡。要注意的是，$argvis的第一個自變數總是指令碼自己的名稱。

    下面是一個更加複雜的例子（列表C）：

列表C
<?php
// check for all required arguments
// first argument is always name of script!
if ($argc != 4) {
die("Usage: book.php <check-in-date> <num-nights> <room-type>/n");
}

// remove first argument
array_shift($argv);

// get and use remaining arguments
$checkin = $argv[0];
$nights = $argv[1];
$type = $argv[2];
echo "You have requested a $type room for $nights nights, checking in on $checkin. Thank you for your order!/n";
?>

    下面是其用法的樣本：

shell> /path/to/phpbook.php 21/05/2005 7 single
You have requested a single room for 7 nights, checking in on 21/05/2005. Thank you for your order!

    在這裡，指令碼首先會檢查$argc，以確保自變數的數量符合要求。它然後會從$argv裡提取出每一個自變數，把它們列印輸出到標準的輸出裝置上。

    注意：你可以用Console_Getopt PEAR類向PHP增加更加複雜的命令列參數。

使用CLI參數
    除了用命令列傳遞PHP指令碼參數，你還可以傳遞PHP CLI參數以更改其工作方式。表格B就是一些重要參數的列表：

表格B

參數	說明
-a	互動式運行Run interactively
-c	path 從path讀取php的.ini檔案
-n	不用讀取php的.ini檔案就直接運行
-m	列出經過編譯的模組
-i	顯示有關PHP構建的資訊
-l	檢查PHP指令碼的句法
-s	以彩色方式顯示原始碼
-w	顯示去掉注釋之後的原始碼
-h	顯示協助

互動模式
    你還可以以互動方式使用PHP CLI，也就是輸入命令，馬上獲得結果。要得到這種效果，只需要使用一個參數調用CLI可執行檔就行了，就像下面這樣：

shell> /path/to/php -a

    你會看到一個空行，你可以在裡面輸入PHP代碼。看看：

shell> /path/to/php -a
Interactive mode enabled
<?php
echo mktime();
1121187283
echo 2+2;
4
exit();
shell>

    或者，你可以不使用-a參數就調用CLI可執行檔，直接輸入完整的指令碼或者程式碼片段。用<Ctrl>-D來結束程式碼片段，並讓CLI來執行它。見下面的例子：

shell> /path/to/php
<?php
echo date("d-M-Y h:i:s", time());
?>
<Ctrl-D>
12-Jul-2005 06:54:04

    這就是PHP的命令列，現在你應該已經對PHP CLI有了足夠的瞭解，並開始使用它了。