http://yangzi520.com/index.php/archives/256

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!”。该脚本代码如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
    #!/usr/local/bin/php –q
<?php
//Windows平台上，上行应该为：#!C:\php\php.exe -q
echo "你好 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，脚本代码如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
    #!C:\php\php.exe –q
<?php
//UNIX和Linux平台下应该为#!/usr/local/bin/php –q
echo "测试获取参数:\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
测试获取参数:
4
Always
To
Be
Best

因为我们输入了一串单词，为“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’)

下面的例子是显示用户输入：

1
2
3
4
5
    #!/usr/local/bin/php -q
<?php
$file = file_get_contents("php://stdin", "r");
echo $file;
?>

这段代码的工作原理与cat命令很相似，回转提供给它的所有输入。但是，这时它还不能接收参数。

STDIN是PHP的标准输入设备，利用它，CLI PHP脚本可以做更多的事情。如下面例子：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
    #!/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函数进行数据流输出。如下面例子：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
   #!/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 –q
Output #1.
<?php
echo "Output #2.";
print "Output #3."
?>
这将得到：
Output #1.
Output #2.Output #3.

说明：PHP标记外的新行已被输出，但是echo命令或print命令中没有指示换行。事实上，命令提示符重新出现在Output #2.Output #3. 所在的行中。PHP拥有的任何其他打印函数将会像此函数一样运行正常，任何写回文件的函数也是一样的。

1
2
3
4
5
6
    #!/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’)

下面的脚本表示如何把一行文本输出到错误流中。

1
2
3
4
5
6
#!/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文件，并一直执行下去。脚本代码如下：

1
2
3
4
5
6
7
8
9
    #! /usr/local/bin/php
<?php
set_time_limit(0);
while(true){
@fopen("/usr/local/www/data-dist/content/
article_".time().".html","w");
sleep(600);
}
?>

保存并且退出vi编辑器，然后赋予genHTML.php文件可执行权限：

1
2
3
4
5
#>chmod 755 genHTML.php
然后让脚本在后台执行，执行如下命令：
$nohup genHTML.php –f &
执行上述命令后出现如下提示：
[1] 16623

按回车键后将出现shell提示符。上面的提示就是说，所有命令执行的输出信息都会放到nohup.out文件中。

执行上面命令后，每隔10分钟就会在指定的目录生成指定的HTML文件，如article_111990120.html等文件。

如何终止CLI程序的后台运行呢？

可以使用kill命令来终止这个进程，终止进程之前要知道进程的PID号，即进程ID，我们使用ps命令：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
    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命令。