四、命令行运行:开发与运维的利器
CLI(Command Line Interface)模式让PHP脱离Web服务器独立运行,是开发脚本、定时任务、API测试的核心工具。掌握php项目怎么运行的CLI方式,可极大提升开发效率。
基础命令与参数
1. 基础运行方式
# 运行单个PHP文件
php /path/to/script.php
# 交互式模式(REPL)
php -a
# 检查PHP配置
php -i
# 显示所有扩展
php -m
# 查看PHP版本
php -v
2. 内置Web服务器(开发测试利器)
无需安装Apache/Nginx,快速启动轻量级服务器:
# 启动内置服务器(默认8000端口)
php -S localhost:8000 -t public/
# 指定路由器脚本(支持MVC)
php -S localhost:8000 -t public/ router.php
router.php示例:
<?php
$path = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
if ($path === '/' || $path === '/index.php') {
return false; # 返回index.php
}
if (file_exists(__DIR__ . $path)) {
return false; # 返回静态文件
}
header("HTTP/1.1 404 Not Found");
include '404.html';
?>
3. 定时任务集成
配合crontab实现自动化任务:
# 编辑crontab
crontab -e
# 每小时执行一次清理任务
0 * * * * /usr/bin/php /var/www/html/cron/cleanup.php
# 每天凌晨执行报表生成
0 0 * * * /usr/bin/php /var/www/html/cron/report.php >> /var/log/cron.log 2>&1
高级技巧:CLI参数解析
通过getopt()解析命令行参数,实现灵活配置:
<?php
// 示例:php export.php --format=csv --limit=100 --output=/tmp/report.csv
$options = getopt('', ['format:', 'limit:', 'output:']);
$format = $options['format'] ?? 'json';
$limit = (int)($options['limit'] ?? 1000);
$output = $options['output'] ?? 'php://stdout';
// 验证参数
if (!in_array($format, ['json', 'csv', 'xml'])) {
fwrite(STDERR, "错误:无效格式。支持:json, csv, xml\n");
exit(1);
}
// 执行导出逻辑
$data = fetchData($limit);
exportData($data, $format, $output);
echo "导出完成!共处理 {$limit} 条数据。\n";
function fetchData($limit) {
// 模拟数据获取
return range(1, $limit);
}
function exportData($data, $format, $output) {
$handle = fopen($output, 'w');
switch ($format) {
case 'csv':
fputcsv($handle, ['ID', 'Value']);
foreach ($data as $id => $val) {
fputcsv($handle, [$id, $val]);
}
break;
case 'json':
fwrite($handle, json_encode($data, JSON_PRETTY_PRINT));
break;
}
fclose($handle);
}
?>
CLI与Web环境差异
关键区别
- 配置文件不同:CLI使用/etc/php/8.2/cli/php.ini,Web使用/etc/php/8.2/apache2/php.ini
- 扩展加载不同:CLI可能未加载php_mysql.dll等扩展
- 路径常量不同:$_SERVER['DOCUMENT_ROOT']在CLI中不存在
- 错误输出不同:CLI直接输出到STDERR,Web记录到日志
验证当前环境:
<?php
if (php_sapi_name() === 'cli') {
echo "当前运行于CLI模式\n";
echo "配置文件路径: " . php_ini_loaded_file() . "\n";
} else {
echo "当前运行于Web模式\n";
}
?>
调试技巧
使用Xdebug CLI模式调试:
# 设置环境变量
export XDEBUG_CONFIG="idekey=PHPSTORM"
export PHP_IDE_CONFIG="serverName=LocalServer"
# 启动调试
php -dzend_extension=xdebug.so -dxdebug.mode=debug -dxdebug.start_with_request=trigger script.php