本文详解 Cron 环境下 PHP 脚本接收参数的原理与实践，澄清 $_GET 与 $argv 的误用误区，提供兼容 Web 和 CLI 的参数解析方案，并推荐符合命令行规范的 getopt() 实现方式。
本文详解 cron 环境下 php 脚本接收参数的原理与实践，澄清 `$_get` 与 `$argv` 的误用误区，提供兼容 web 和 cli 的参数解析方案，并推荐符合命令行规范的 `getopt()` 实现方式。
在共享服务器上通过 Cron 执行 PHP 脚本时，常见写法如 * * * * * /usr/bin/php /path/to/script.php country_id=10，看似简洁，却容易引发参数解析混乱。关键在于：Cron 启动的是 CLI（命令行）SAPI 模式，而非 Web SAPI（如 Apache 或 FPM）。这意味着 $_GET、$_POST 等超全局变量默认为空——除非你手动填充它们。
你观察到 $_GET['country_id'] “意外”生效，其实并非 PHP 自动解析，而是某些共享主机环境（或自定义配置）在 CLI 模式下对 $argv 做了隐式处理（例如将 country_id=10 当作查询字符串注入 $_GET），但这属于非标准、不可靠行为，绝不应依赖。而 $argv[1] 为 null 的真正原因，很可能是脚本未启用 CLI 参数解析（如未加 #!/usr/bin/env php 或未设置可执行权限），或 cron 调用时参数被 shell 解析异常（如空格/等号未转义）。
✅ 正确做法是明确区分运行环境，并主动解析参数。以下是两种推荐方案：
方案一：兼容 Web + CLI 的轻量适配（使用 parse_str()）
适用于需复用现有 $_GET 逻辑的场景。在脚本开头添加：
立即学习“PHP免费学习笔记（深入）”；
<?php
// 兼容 CLI：若 $argv[1] 存在且形如 "key=value"，则解析进 $_GET
if (PHP_SAPI === 'cli' && isset($argv[1]) && strpos($argv[1], '=') !== false) {
parse_str($argv[1], $temp_get);
$_GET = array_merge($_GET, $temp_get);
}
// 现在可安全使用
$country_id = $_GET['country_id'] ?? null;
echo "Country ID: " . ($country_id ?: 'not set') . "\n";⚠️ 注意：parse_str() 默认按 URL 编码规则解析，因此传参时需确保 = 和 & 等字符已正确编码（如 country_id=US%26region=west），避免 shell 解析错误。
方案二：专业 CLI 参数解析（推荐 getopt()）
更健壮、可扩展、符合 Unix 命令行惯例。修改 cron 条目为：
10 * * * * /usr/bin/php /home/website/cron/my_script.php --country_id=10 # 或等价形式 10 * * * * /usr/bin/php /home/website/cron/my_script.php --country_id 10
脚本内使用：
<?php
// 支持长选项（--country_id=10 或 --country_id 10）
$options = getopt('', ['country_id:']);
$country_id = $options['country_id'] ?? null;
if ($country_id === null) {
fwrite(STDERR, "Error: --country_id is required.\n");
exit(1);
}
echo "Processing country ID: $country_id\n";
// 后续业务逻辑...? 提示：getopt() 第二个参数中 : 表示该选项必须带值；无冒号表示布尔开关（如 --verbose）。还可组合短选项（如 -c 10），只需扩展 getopt('c:', ['country_id:']) 并映射即可。
总结
- ❌ 不要依赖 $_GET 在 CLI 中自动可用，也不应假设 $argv[1] 总是原始字符串；
- ✅ 使用 parse_str() 是快速兼容方案，但需手动控制输入格式；
- ✅ 使用 getopt() 是长期维护首选，支持类型校验、帮助提示（配合 getopt() 扩展库如 symfony/console 更佳）、多参数组合；
- ? Cron 脚本务必添加错误处理与日志输出（如重定向 >> /var/log/my_cron.log 2>&1），便于排查环境差异问题。
