所有的PHP发行版,不论是编译自源代码的版本还是预创建的版本,都在默认情况下带有一个PHP可执行文件。这个可执行文件可以被用来运行命令行的PHP程序。
要在你的系统上找到这个可执行文件,就要遵照下面的步骤:
Windows:放在PHP主安装目录下,文件名是php.exe或者(在老版本的PHP里)是php-cli.exe。
Linux:保存在PHP安装目录的bin/子目录下。
需要注意的是CLI模式和CGI模式运行时用的PHP.INI并非同一套配置,需要单独配置。
不论是在哪一个操作系统里,你都需要对它进行测试,以保证它能够正常运行,方法是用-v参数调用它:
shell> /path/php.exe -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的版本号。
使用CLI命令
一个简单的PHP CLI程序,命名hello.php
<?php echo "Hello from the CLI"; ?>
现在,试着在命令行提示符下运行这个程序,方法是调用CLI可执行文件并提供脚本的文件名:
shell> /path/php.exe /example/hello.php
Hello from the CLI
使用标准的输入和输出
PHP CLI会定义三个常量,以便让在命令行提示符下与解释器进行交互操作更加容易。
这些常量见下表
常量 | 说明 |
STDIN | 标准的输入设备 |
STDOUT | 标准的输出设备 |
STDERR | 标准的错误设备 |
你可以在自己的PHP脚本里使用这三个常量,以接受用户的输入,或者显示处理和计算的结果。
使用范例:
<?php // ask for input fwrite(STDOUT, "Enter your name: "); // get input $name = trim(fgets(STDIN)); // write input back fwrite(STDOUT, "Hello, $name!"); ?>
D:\>\wamp\bin\php\php5.3.0\php.exe \tools\index.php Enter your name: kkk Hello, kkk!
在这个脚本里,fwrite()函数首先会向标准的输出设备写一条消息,询问用户的姓名。
然后它会把从标准输入设备获得的用户输入信息读取到一个PHP变量里,并它把合并成为一个字符串。然后就用fwrite()把这个字符串打印输出到标准的输出设备上。
命令行自定义变量 [ $argv | $argc ]
在命令行里输入程序参数来更改其运行方式是很常见的做法。你也可以对CLI程序这样做。
PHP CLI带有两个特殊的变量,专门用来达到这个目的:
一个是$argv变量,它通过命令行把传递给PHP脚本的参数保存为单独的数组元素;
另一个是$argc变量,它用来保存$argv数组里元素的个数。
使用范例:
<?php print_r($argv); ?>
D:\>\wamp\bin\php\php5.3.0\php.exe \tools\index.php bac ddd Array ( [0] => \tools\index.php [1] => bac [2] => ddd )
正如你可以从输出的结果看到的,传递给index.php的值会自动地作为数组元素出现在$argv里。要注意的是,$argv的第一个自变量总是脚本自己的名称。
注意:我们还可以用Console_Getopt PEAR类向PHP增加更加复杂的命令行参数。
命令行自定义变量 [使用Console_Getopt接收参数]
注意:这个变量仅在 register_argc_argv 打开时可用
getopt($option, $longopts) // 第一个$option接收 -h vb 第二个参数接收 --require sss
使用范例
<?php $shortopts = ""; $shortopts .= "f:"; // Required value $shortopts .= "v::"; // Optional value $shortopts .= "abc"; // These options do not accept values $longopts = array( "required:", // Required value "optional::", // Optional value "option", // No value "opt", // No value ); $options = getopt($shortopts, $longopts); var_dump($options); ?>
D:\>\wamp\bin\php\php5.3.0\php.exe \tools\index.php -f "value for f" -v -a --required value --optional="optional value" --option will
array(6) { ["f"] => string(11) "value for f" ["v"] => bool(false) ["a"] => bool(false) ["required"] => string(5) "value" ["optional"] => string(14) "optional value" ["option"] => bool(false) }
命令行变量 [使用CLI参数]
除了用命令行传递PHP脚本参数,还可以传递PHP CLI参数以更改其工作方式。
参数 | 说明 |
-a | 交互式运行Run interactively |
-c | path 从path读取php的.ini文件 |
-n | 不用读取php的.ini文件就直接运行 |
-m | 列出经过编译的模块 |
-i | 显示有关PHP构建的信息 |
-l | 检查PHP脚本的句法 |
-s | 以彩色方式显示源代码 |
-w | 显示去掉注释之后的源代码 |
-h | 显示帮助 |