PHP CLI模式開發不需要任何一種Web服務器(包括Apache或MS IIS等),這樣,CLI可以運行在各種場合。
有兩種方法可以運行PHP CLI腳本。
第一種方法是使用php -f /path/to/yourfile.php。調用PHP CLI解釋器,並給腳本傳遞參數。這種方法首先要設置php解釋器的路徑,Windows平台在運行CLI之前,需設置類似path c:\php的命令,也失去了CLI腳本第一行的意義,因此不建議使用該方法。
第二種方法是首先運行chmod+x <要運行的腳本文件名>(UNIX/Linux環境),將該PHP文件置為可執行權限,然后在CLI腳本頭部第一行加入聲明(類似於#! /usr/bin/php或PHP CLI解釋器位置),接着在命令行直接執行。這是CLI首選方法,建議采用。
下面我們來看看怎樣編寫PHP CLI腳本。
1.編寫第一個CLI腳本
首先創建一個名為myfile.php的PHP腳本,用於運行PHP CLI。該腳本很簡單,僅顯示“你好 PHP CLI!”。該腳本代碼如下:
#!/usr/local/bin/php –q <?php//Windows平台上,上行應該為:#!C:\php\php.exe -qecho "你好 PHP CLI!";?> 不要忘了給該文件設置為可執行的權限:$ chmod 755 myfile.php然后直接輸入以下命令,按回車鍵即可以運行:$ ./myfile.php 如果要在Windows系統下運行該腳本,則不需要設置文件屬性,可以直接運行該腳本。Microsoft Windows [版本 6.0.6000] 版權所有 (C) 2006 Microsoft Corporation。保留所有權利。C:\ >myfile.php你好 PHP CLI!
再重申一次:如果在Windows平台,CLI腳本的第一行一定要寫正確php.exe所在的位置,像這樣(另外,如果要在CLI腳本中加注釋語句,則要把注釋寫在PHP標簽里面,因為CLI解釋只認識第一行,不在PHP標簽里認為是語法錯誤):
#!C:\php\php.exe -q
這樣,可以看到在命令行下信息已經打印出來,證明該CLI腳本已經成功運行。
2.從命令行上讀取參數
如果想從命令行獲取參數,CLI可以從$_SERVER['argc']和$_SERVER['argv'']取得參數的個數和值。我們再建立一個文件,名字為testargs.php,腳本代碼如下:
#!C:\php\php.exe –q <?php//UNIX和Linux平台下應該為#!/usr/local/bin/php –qecho "測試獲取參數:\n"; echo $_SERVER["argc"]."\n";//顯示傳入的參數值,從索引1開始顯示echo $_SERVER["argv"][1]."\n"; echo $_SERVER["argv"][2]."\n";echo $_SERVER["argv"][3]."\n"; echo $_SERVER["argv"][4]."\n";?>在命令行輸入如下代碼: C:\Users\John>testargs.php Always To Be Best測試獲取參數:4AlwaysToBeBest
因為我們輸入了一串單詞,為“Always To Be Best”,腳本參數以空格分隔。因此,PHP將其計為4個參數,下面對此說明。
$_SERVER["argc"]數組返回一個整型的數,代表從命令行上回車后一共輸入了幾個參數。
從上例的結果已經看出,要訪問已經傳入的參數值,需要從索引1開始。因為腳本本身的文件已經占用了索引0,即$_SERVER["argv"][0]。
3.處理I/O通道
PHP最初設計不是用於與用戶直接的鍵盤輸入或文本輸出結合使用。了解這一設計是至關重要的,因為如果需要在命令行中執行任何操作,都必須能夠與用戶來回通信。
輸入輸出(I/O)通道這個思想來源於UNIX系統,UNIX系統提供3個文件句柄,用以從一個應用程序及用戶終端發送和接收數據。
我們可以把一個腳本的輸出重定向到一個文件:
php world.php > outputfile
如果是在UNIX系統下,也可以使用通道定向到另一個命令或應用程序中。例如:
php world.php | sort.
在PHP 5 CLI中,有一個文件流句柄,可以使用3個系統常量,分別為STDIN、STDOUT和STDERR。下面我們分別介紹。
(1)STDIN
STDIN全稱為standard in或standard input,標准輸入可以從終端取得任何數據。
格式:stdin (’php://stdin’)
下面的例子是顯示用戶輸入:
#!/usr/local/bin/php -q<?php $file = file_get_contents("php://stdin", "r");echo $file;?>
這段代碼的工作原理與cat命令很相似,回轉提供給它的所有輸入。但是,這時它還不能接收參數。
STDIN是PHP的標准輸入設備,利用它,CLI PHP腳本可以做更多的事情。如下面例子:
#!/usr/local/bin/php -q <?php//UNIX平台下第一行應該為#!/usr/bin/php –q/* 如果STDIN未定義,將新定義一個STDIN輸入流 */ if(!defined("STDIN")) {define("STDIN", fopen('php://stdin','r'))} echo "你好!你叫什么名字(請輸入):\n";$strName = fread(STDIN, 100); //從一個新行讀入80個字符 echo '歡迎你'.$strName."\n";?>該腳本執行后將顯示:你好!你叫什么名字(請輸入):比如,輸入Raymond之后,將顯示:歡迎你Raymond
(2)STDOUT
STDOUT全稱為standard out或standard output,標准輸出可以直接輸出到屏幕(也可以輸出到其他程序,使用STDIN取得),如果在PHP CLI模式里使用print或echo語句,則這些數據將發送到STDOUT。
格式:stdout (’php://stdout’)
我們還可以使用PHP函數進行數據流輸出。如下面例子:
#!/usr/local/bin/php –q<?php $STDOUT = fopen('php://stdout', 'w');fwrite($STDOUT,"Hello World"); fclose($STDOUT);?>輸出結果如下:Hello World例如,echo和print命令打印到標准輸出。 #!/usr/local/bin/php –qOutput #1.<?phpecho "Output #2.";print "Output #3." ?>這將得到:Output #1.Output #2.Output #3.
說明:PHP標記外的新行已被輸出,但是echo命令或print命令中沒有指示換行。事實上,命令提示符重新出現在Output #2.Output #3. 所在的行中。PHP擁有的任何其他打印函數將會像此函數一樣運行正常,任何寫回文件的函數也是一樣的。
#!/usr/local/bin/php -q <?php$STDOUT = fopen("php://stdout", "w");fwrite($STDOUT, "Output #1."); fclose($STDOUT);?>
以上代碼將把php://stdout作為輸出通道顯式打開,並且php://output通常以與php://stdout相同的方法運行。
(3)STDERR
STDERR全稱為standard error,在默認情況下會直接發送至用戶終端,當使用STDIN文件句柄從其他應用程序沒有讀取到數據時會生成一個“stdin.stderr”。
格式:stderr (’php://stderr’)
下面的腳本表示如何把一行文本輸出到錯誤流中。
#!/usr/local/bin/php –q<?php $STDERR = fopen('php://stderr', 'w');fwrite($STDERR,"There was an Error"); fclose($STDERR);?>
PHP 5.2可以直接使用STDOUT作為常量,而不是定義上面使用的變量$STDOUT,為了兼容之前版本,我們仍使用了自定義變量,如果您使用的是PHP 5.2,則可以參考STDIN的第二個例子。
4.后台運行CLI
如果正在運行一個進程,而且在退出賬戶時該進程還不會結束,即在系統后台或背景下運行,那么就可以使用nohup命令。該命令可以在退出賬戶之后繼續運行相應的進程。
nohup在英文中就是不掛起的意思(no hang up)。該命令的一般形式為:
nohup –f scriptname.php &
使用nohup命令提交作業,在默認情況下該作業的所有輸出都被重定向到一個名為nohup.out的文件中,除非另外指定了輸出文件。
nohup scriptname.php > log.txt &
這樣,PHP CLI腳本執行后的結果將輸出到log.txt中,我們可以使用tail命令查看該內容:
tail -n50 -f log.txt
現在再來實現兩個例子,第一個是每隔10分鍾自動生成一個靜態HTML文件,並一直執行下去。腳本代碼如下:
#! /usr/local/bin/php <?phpset_time_limit(0);while(true){@fopen("/usr/local/www/data-dist/content/ article_".time().".html","w");sleep(600);}?>
保存並且退出vi編輯器,然后賦予genHTML.php文件可執行權限:
#>chmod 755 genHTML.php 然后讓腳本在后台執行,執行如下命令:$nohup genHTML.php –f &執行上述命令后出現如下提示:[1] 16623
按回車鍵后將出現shell提示符。上面的提示就是說,所有命令執行的輸出信息都會放到nohup.out文件中。
執行上面命令后,每隔10分鍾就會在指定的目錄生成指定的HTML文件,如article_111990120.html等文件。
如何終止CLI程序的后台運行呢?
可以使用kill命令來終止這個進程,終止進程之前要知道進程的PID號,即進程ID,我們使用ps命令:
www# ps PID TT STAT TIME COMMAND 561 v0 Is+ 0:00.00 /usr/libexec/getty Pc ttyv0 562 v1 Is+ 0:00.00 /usr/libexec/getty Pc ttyv1 563 v2 Is+ 0:00.00 /usr/libexec/getty Pc ttyv2 564 v3 Is+ 0:00.00 /usr/libexec/getty Pc ttyv3 565 v4 Is+ 0:00.00 /usr/libexec/getty Pc ttyv4 566 v5 Is+ 0:00.00 /usr/libexec/getty Pc ttyv5 567 v6 Is+ 0:00.00 /usr/libexec/getty Pc ttyv6 568 v7 Is+ 0:00.00 /usr/libexec/getty Pc ttyv7 16180 p0 I 0:00.01 su 16181 p0 S 0:00.06 _su (csh) 16695 p0 R+ 0:00.00 ps 16623 p0 S 0:00.06 /usr/local/bin/php /usr/local/www/data/genHTML.php 已經看到PHP的進程ID是:16623,於是再執行kill命令:$ kill -9 16623 [1]+ Killed nohup /usr/local/www/data/genHTML.php 這時該命令的進程就已經被終止了,再使用ps命令:$ ps PID TT STAT TIME COMMAND 82374 p3 Ss 0:00.17 -bash (bash) 82535 p3 R+ 0:00.00 ps
剛才的PHP CLI腳本已經沒有了,如果直接運行ps命令無法看到進程,那么就結合使用ps & apos兩個命令來查看。
注意:上面例子必須運行在UNIX或者Linux系統中,如FreeBSD、Redhat Linux等,在Windows環境不支持nohup命令。