php 8.6批处理脚本可以用getopt解析长选项,再显式检查必需参数和剩余位置参数。解析成功只说明选项形状被识别,不表示文件、业务模式或权限已经合法。下面把dry-run与真正执行区分,并用非零退出码告诉调度器参数有误。

PHP官方文档中的CLI选项相关说明。 图源:PHP Documentation Group(CC BY3.0)。
定义参数契约并拒绝缺省值
<?php
if (PHP_SAPI !== 'cli') { exit(2); }
$options = getopt('', ['input:', 'mode:', 'dry-run'], $rest);
if ($options === false || $rest !== $argc
|| !isset($options['input'], $options['mode'])
|| !is_string($options['input']) || !is_string($options['mode'])
|| !in_array($options['mode'], ['check', 'convert'], true)
|| str_contains($options['input'], "\0")) {
fwrite(STDERR, "usage: php job.php --input=FILE --mode=check|convert [--dry-run]\n");
exit(2);
}
$input = realpath($options['input']);
if ($input === false || !is_file($input) || !is_readable($input)) {
fwrite(STDERR, "input is not a readable file\n"); exit(2);
}
$dryRun = array_key_exists('dry-run', $options);
echo json_encode(['input' => $input, 'mode' => $options['mode'], 'dry_run' => $dryRun], JSON_THROW_ON_ERROR), PHP_EOL;
// 在此调用固定业务入口;dry-run只做检查,不写入目标。
exit(0);按三条路径检查入口
用--input=/可信路径/data.csv --mode=check --dry-run检查正常输入,再分别删去--input或把--mode改成未知值,确认返回2。重复选项可能产生数组,本例也会拒绝。getopt在遇到第一个非选项参数后停止,不应把后续内容默默当成已处理。
使用明确的长参数值
这里使用单冒号表示必须提供值。若选择可选值的双冒号写法,空格不能作为可选值的分隔符,容易让脚本与调用方产生分歧。调度配置最好使用--name=value的明确形式,并让业务失败与参数失败分别留下可追溯的简短错误。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。

PHP官方文档中的CLI选项相关说明。 图源:PHP Documentation Group(CC BY3.0)。
本例是命令入口,不包含特定业务的转换实现。接入现有业务函数时,应在写入前再次核对dry-run并传播失败退出码。包含秘密的参数不宜直接出现在命令行或打印计划中,路径可读也不代表调用者有业务访问权限。


















