PHP CLI可在命令行直接运行PHP脚本,适用于自动化任务。通过php -v确认环境,使用$argc和$argv接收参数,结合getopt()解析选项,添加shebang并设执行权限实现直接运行,输出错误到STDERR,返回退出码,并支持-help提示,配合日志记录与重定向可开发健壮的运维工具。

PHP不只是用来做网页的,它也能在命令行下运行脚本,这种模式叫CLI(Command Line Interface)。用好PHP CLI,能帮你写自动化任务、定时脚本、数据处理工具等。下面带你一步步掌握PHP命令行工具的基本用法和开发技巧。
什么是PHP CLI
CLI是PHP的一个运行模式,不依赖Web服务器,直接在终端执行PHP代码。你写的脚本不会输出到浏览器,而是打印在终端里。适合跑后台任务,比如清理日志、同步数据、发送邮件等。
检查是否安装了CLI:
php -v
如果看到PHP版本信息,说明已经装好了。大多数系统默认带CLI支持。
立即学习“PHP免费学习笔记(深入)”;
运行第一个CLI脚本
创建一个简单的PHP文件,比如 hello.php:
<?php
echo “Hello from command line!n”;
?>
在终端运行:
php hello.php
你会看到输出:Hello from command line!
注意:加 n 是为了让换行生效,CLI中用echo输出时最好加上换行符,否则提示符会紧跟输出后面。
接收命令行参数
CLI脚本常需要传参数。PHP提供两个全局变量:$argc 和 $argv。
$argc:参数个数(包含脚本名)$argv:参数数组,索引从0开始
例子:arg_test.php
<?php
echo “共 {$argc} 个参数:n”;
foreach ($argv as $index => $arg) {
echo “$index: $argn”;
}
?>
运行:
Poixe AI
统一的 LLM API 服务平台,访问各种免费大模型
75 查看详情
php arg_test.php name=jack action=run –debug
输出会列出所有传入的参数。
你可以自己解析$argv,也可以用 getopt() 处理选项参数:
$options = getopt(“d::”, [“debug::”, “action:”]);
if (isset($options[‘debug’])) {
echo “Debug mode enabled.n”;
}
这样支持短选项(-d)和长选项(–debug),冒号表示是否需要值。
编写实用的CLI工具
真正有用的CLI脚本要有交互性和健壮性。以下几点建议:
加Shebang(#!)让脚本能直接运行:
#!/usr/bin/env php
保存后给执行权限:chmod +x script.php,之后可直接 ./script.php 运行输出信息用 stderr 报错,避免干扰正常输出:
fwrite(STDERR, “Error: something went wrongn”);返回退出码,帮助其他程序判断结果:
exit(1); // 表示出错支持帮助提示,比如传 -h 或 –help 时显示用法
示例:一个简单备份脚本 backup.php
#!/usr/bin/env php
<?php
function showHelp() {
echo “Usage: backup.php n”;
exit(0);
}
if ($argc != 3 || in_array(‘-h’, $argv) || in_array(‘–help’, $argv)) {
showHelp();
}
$source = $argv[1];
$target = $argv[2];
if (!is_dir($source)) {
fwrite(STDERR, “Error: source directory not found.n”);
exit(1);
}
// 模拟复制
echo “Copying $source to $target…n”;
sleep(1);
echo “Done.n”;
?>
运行:php backup.php /tmp/data /backup
调试与日志
CLI脚本调试比Web容易,可以直接 print_r() 或 var_dump() 输出变量。
建议把关键操作写进日志文件,尤其是长时间运行的任务:
$logFile = ‘/var/log/my-script.log’;
file_put_contents($logFile, date(‘Y-m-d H:i:s’) . ” – Startedn”, FILE_APPEND);
也可以结合Linux的重定向功能:
php myscript.php > output.log 2>&1
把标准输出和错误都记录下来。
基本上就这些。PHP CLI模式简单直接,特别适合写中小型运维工具。关键是理解参数处理、错误输出和退出状态。只要逻辑清晰,再配合cron定时任务,就能实现很多自动化功能。
以上就是PHP命令行工具怎么用_PHP_CLI模式脚本开发指南的详细内容,更多请关注php中文网其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/728215.html
微信扫一扫
支付宝扫一扫