PHP命令行脚本怎么写_PHP命令行程序编写与运行方法
PHP作为一种广泛使用的服务端脚本语言，除了用于开发Web应用，也支持编写命令行脚本，实现定时任务、数据处理、系统运维工具等功能。本文将详细介绍PHP命令行程序的编写方法和运行方式。
一、PHP命令行脚本的基础认知
PHP命令行脚本是脱离Web服务器环境，直接在操作系统终端中运行的PHP程序，不需要依赖Apache、Nginx等Web服务，仅需要PHP解释器即可执行。这类脚本常用于以下场景：
定期执行的数据备份、日志清理任务
批量处理文件、数据库数据的工具
系统运维相关的自动化脚本
简单的命令行工具开发
二、PHP命令行脚本的编写基础
2.1 脚本第一行：指定解释器路径
在类Unix系统（Linux、macOS）中，PHP命令行脚本通常以#!/usr/bin/env php作为第一行，用于指定脚本使用的解释器，这样不需要每次输入php命令也能直接运行脚本。Windows系统不需要这一行，直接通过php 脚本名即可运行。
示例脚本开头：
#!/usr/bin/env php <?php // 脚本逻辑从这里开始
2.2 接收命令行参数
PHP命令行脚本可以通过全局数组$argv获取传入的参数，通过$argc获取参数数量。$argv[0]固定为当前脚本的文件名，后续的索引对应传入的参数。
示例：接收并打印命令行参数
#!/usr/bin/env php
<?php
echo "参数数量：" . $argc . PHP_EOL;
echo "参数列表：" . PHP_EOL;
foreach ($argv as $index => $value) {
echo "第{$index}个参数：{$value}" . PHP_EOL;
}在终端执行php test.php hello world 123，输出结果如下：
参数数量：4 参数列表： 第0个参数：test.php 第1个参数：hello 第2个参数：world 第3个参数：123
2.3 标准输入输出操作
命令行脚本常常需要和用户交互，PHP提供了多个函数处理标准输入输出：
fwrite(STDOUT, $string)：向标准输出打印内容，效果等同于echo，但更适合精确控制输出fSTDIN)：从标准输入读取一行用户输入，返回读取到的字符串（包含换行符）error_log($message)：将错误信息输出到标准错误流，不会混入正常输出
示例：简单的交互式脚本
#!/usr/bin/env php
<?php
fwrite(STDOUT, "请输入你的名字：");
$name = trim(fgets(STDIN));
fwrite(STDOUT, "你好，{$name}！欢迎使用PHP命令行脚本。" . PHP_EOL);三、完整的PHP命令行脚本示例
下面编写一个简单的文件批量重命名脚本，实现指定目录下所有.txt文件添加前缀的功能：
#!/usr/bin/env php
<?php
// 检查参数是否正确
if ($argc != 3) {
fwrite(STDERR, "用法：php rename_script.php 目标目录 文件名前缀" . PHP_EOL);
exit(1);
}
$targetDir = $argv[
$prefix = $argv[2];
// 检查目录是否存在
if (!is_dir($targetDir)) {
fwrite(STDERR, "错误：目录 {$targetDir} 不存在" . PHP_EOL);
exit(1);
}
// 遍历目录下的.txt文件
$files = scandir($targetDir);
foreach ($files as $file) {
// 跳过.和..目录项，只处理.txt文件
if ($file == '.' || $file == '..') {
continue;
}
if (pathinfo($file, PATHINFO_EXTENSION) == 'txt') {
$oldPath = $targetDir ._SEPARATOR . $file;
$newName = $prefix . $file;
$newPath = $targetDir . DIRECTORY_SEPARATOR . $newName;
if (rename($oldPath, $newPath)) {
echo "重命名成功：{$file} -> {$newName}" . PHP_EOL;
} else {
fwrite(STDERR, "重命名失败：{$file}" . PHP_EOL);
}
}
}
echo "批量重命名操作完成" . PHP_EOL;四、PHP命令行脚本的运行方法
4.1 通用运行方式（所有系统适用）
无论Windows还是类Unix系统，都可以通过php命令直接运行脚本，格式为：
php 脚本文件路径 [参数1] [参数2] ...
例如运行上面的重命名脚本：
php rename_script.php ./test_dir file_
4.2 类Unix系统直接运行脚本
在Linux或macOS系统中，完成以下步骤后可以直接执行脚本：
确保脚本第一行已经添加
#!/usr/bin/env php给脚本添加可执行权限：
chmod +x rename_script.php直接运行脚本：
./rename_script.php ./test_dir file_
4.3 Windows系统运行方式
Windows系统可以在命令提示符（CMD）或PowerShell中运行，首先确保PHP的安装路径已经添加到系统环境变量PATH中，然后执行：
php rename_script.php C:test_dir file_
如果需要直接双击运行，可以将脚本后缀改为.php，并关联PHP解释器，不过更推荐在终端中运行以便查看输出和错误信息。
五、PHP命令行常用内置函数与技巧
5.1 常用内置函数
| 函数名 | 功能说明 |
|---|---|
php_sapi_name() | 获取当前PHP运行接口类型，命令行环境下返回cli，可用于判断脚本是否运行在命令行模式 |
getopt($options, $longopts) | 解析命令行参数选项，支持短选项（如-f）和长选项（如--file），比直接操作$argv更方便 |
sleep($seconds) | 让脚本暂停指定秒数，常用于定时任务间隔控制 |
exec($command) | 执行外部系统命令，获取最后一行输出，适合调用系统工具完成PHP不擅长的操作 |
5.2 判断命令行环境示例
可以在脚本开头添加环境判断，避免脚本被Web访问执行：
<?php
if (php_sapi_name() != 'cli') {
die("该脚本仅支持在命令行环境下运行");
}
// 后续脚本逻辑六、注意事项
命令行脚本的执行用户权限需要注意，尤其是操作文件、系统命令时，避免因权限不足导致执行失败
长时间运行的脚本可以设置
set_time_limit(0)取消执行时间限制，避免脚本被中断处理外部传入的参数时一定要做校验，避免命令注入等安全问题，尤其是使用
exec等函数时如果需要定时执行脚本，类Unix系统可以配置crontab任务，Windows系统可以配置任务计划程序