1. 基础命令行帮助：直接查看 PHP 解释器的帮助信息
快速入口：使用 php -h/--help
快速入口：在命令行直接输入 php -h 可以看到解释器层面的帮助信息，包含版本、配置选项、常用参数等。这是了解 Linux/Windows 环境下 PHP 命令行行为的第一手资料。
重点要点：关注 Help 的结构、Usage、Options、Configuration File、PHP Binary 等字段，帮助你快速定位与你的应用场景相关的参数。
$ php -h
Usage: php [ options ] [-f] [ --] [args...]-a Run interactively-d foo=bar Define INI entries on the fly-f Interpret .--help Show this help...
辅助信息：快速查看环境信息
辅助信息：除了帮助信息，php -i 可以快速输出完整的配置信息，帮助你在排错与性能调优时对比环境差异。
使用场景：当你不确定当前 CLI 环境是否启用了某个扩展时，结合 -i 与 -m、-v 的组合查看，会比单纯看帮助信息更快定位问题。
$ php -i | head -n 15
PHP Version => 8.x.x
Loaded Configuration File => /etc/php/8.x/cli/php.ini
Configured Command Search Path => ...
2. 查看脚本自带的帮助信息的最佳实践
通过 -h/--help 向脚本索取帮助
约定俗成：多数 CLI 脚本在启动时提供自定义的帮助信息，通常通过 --help 或 -h 开关输出。这其中包含参数说明、用法示例以及对温度参数的专门说明。
温度参数的说明：在脚本帮助中应明确标注 --temperature 的取值范围、单位、默认值以及示例用法，确保开发与运维人员能快速对接。
$ php myscript.php --help
Usage: php myscript.php [--temperature=] [options]--temperature= Temperature value (default: 0.6)-h, --help Show this help
自定义帮助文本的实现要点
核心点：在脚本开始阶段使用 getopt() 或 optparse 解析参数，检测到 --help 时输出帮助文本并立即退出，避免执行主逻辑。
示例要点：确保帮助信息覆盖了 temperature 的用法、默认值、边界情况以及示例命令。
]\n";echo " --temperature= Temperature value, range 0-1, default 0.6\n";exit(0);
}
?>
3. 实战技巧：如何实现温度参数 temperature 的帮助输出
设计友好的帮助文本结构
文本要简洁、层次分明，将参数分组展示，并给出最常见的示例。对于温度参数，建议给出默认值、取值范围以及合理的取值区间。
示例展示：在帮助文本中放置一个清晰的示例命令，方便复制粘贴，降低误用风险。
$ php script.php --help
Options:--temperature= Set temperature (default: 0.6)-h, --help Show this help
结合实际代码演示：解析并展示温度参数
代码片段：演示如何在 PHP 里解析 temperature，并在帮助中体现默认值与示例。
"Temperature value", "help" => "Show help"];
$options = getopt($shortOpts, $longOpts);if (isset($options['help'])) {echo "Usage: php script.php [--temperature=VALUE] [options]\n";exit(0);
}
$temperature = isset($options['temperature']) ? (float)$options['temperature'] : 0.6;
echo "Temperature: ".$temperature."\n";
?>
4. 实战场景：带有 temperature=0.6 的命令行如何快速查看帮助
场景一：直接查看脚本帮助
场景要点：直接运行脚本的帮助开关，可以快速确认 temperature 的正确参数名、默认值和示例。
典型命令：通过 --help 查看参数释义，确保后续实操时能准确传参。
$ php generate.php --help
Usage: php generate.php [--temperature=]--temperature= Temperature value, default 0.6-h, --help Show this help
场景二：结合 -d 或环境变量进行调试
调试技巧：在需要快速覆盖默认设置测试不同温度时，可以结合 PHP 运行时选项或环境变量实现灵活调试。
$ php -d detect_unicode=0 generate.php --temperature=0.8
场景三：在自定义脚本中实现对温度参数的互斥与校验
互斥与校验：若有多个模式对温度有影响，应该在帮助中标注互斥选项，并在脚本中进行取值范围校验，避免无效输入。
1) {fwrite(STDERR, "Error: temperature must be between 0 and 1.\n");exit(2);
}
?>
5. 实用排错点与快速定位技巧
常见问题与排错步骤
常见错误：参数名写错、未正确解析 --temperature、帮助文本未触发等。
排错时优先检查脚本的参数解析代码路径，以及帮助文本输出条件是否正确触发。
性能与兼容性考量
性能要点：帮助信息的输出应尽量短路（如检测到 --help 即退出），避免在主逻辑中进行冗余计算。
兼容性要点：使用 getopt 解析参数时，尽量覆盖短格式和长格式，确保在不同操作系统的行为一致。
