PHP命令行工具怎么用_PHP_CLI模式脚本开发指南-php教程-PHP中文网

PHP命令行工具怎么用_PHP_CLI模式脚本开发指南

絕刀狂花

发布： 2025-10-03 18:08:02

原创

205人浏览过

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

php命令行工具怎么用_php_cli模式脚本开发指南

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: $arg\n";
}
?>

运行：

千帆大模型平台

面向企业开发者的一站式大模型开发及服务运行平台

查看详情

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<?php ... ?>
保存后给执行权限：chmod +x script.php，之后可直接 ./script.php 运行
输出信息用 stderr 报错，避免干扰正常输出：
fwrite(STDERR, "Error: something went wrong\n");
返回退出码，帮助其他程序判断结果：
exit(1); // 表示出错
支持帮助提示，比如传 -h 或 --help 时显示用法

示例：一个简单备份脚本 backup.php

#!/usr/bin/env php
<?php
function showHelp() {
    echo "Usage: backup.php <source> <target>\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