PHP命令行运行教程详解

本文深入解析了PHP命令行（CLI）环境的常见痛点与实战解决方案，涵盖环境配置失效、CLI与Web配置差异、输出乱码、参数传递误区及初始化逻辑缺失等核心问题，手把手教你定位php命令找不到的原因、切换正确的php.ini、统一UTF-8编码、正确使用$argv/getopt()传参，并强调CLI独立于Web上下文的本质——帮助开发者避开“网页能跑、命令行就崩”的典型陷阱，真正掌握稳定高效的PHP脚本开发能力。

php 命令找不到：确认 PHP 是否已安装并加入 PATH

直接在终端敲 php -v 报错 “command not found”，说明系统压根没识别到 PHP 可执行文件。这不是代码问题，是环境问题。

• macOS（Homebrew 安装）：检查 /opt/homebrew/bin/php 或 /usr/local/bin/php 是否存在，再运行 echo $PATH 看路径是否包含它
• Linux（如 Ubuntu）：用 which php 或 find /usr -name php 2>/dev/null 定位，常见路径是 /usr/bin/php
• Windows：命令行里输 where php；若没结果，需手动把 PHP 安装目录（如 C:\php）加进系统环境变量 PATH

php script.php 执行报错：CLI 和 Web SAPI 的配置不同

同一个 script.php 在浏览器能跑，命令行却报 Fatal error: Undefined function mb_strlen()？因为 CLI 模式默认加载的是独立的 php.ini 文件，和 Apache/Nginx 用的不是同一个。

• 查 CLI 当前配置路径：运行 php --ini，看 “Loaded Configuration File” 行
• 常见位置：/etc/php/*/cli/php.ini（Linux）、/usr/local/etc/php/*/php.ini（macOS Homebrew）、C:\php\php.ini（Windows）
• 扩展没启用？打开对应 php.ini，确认 extension=mbstring 这类行没被注释（去掉前面的分号），然后保存重启终端
• 不想改全局配置？可临时指定 ini：php -c /path/to/cli.ini script.php

脚本里 echo 输出乱码或不显示：CLI 输出缓冲与编码差异

特别是 Windows 下中文 echo "你好" 显示问号或方块，不是 PHP 错了，是终端、文件编码、PHP 输出三者没对齐。

• 确保 PHP 文件本身是 UTF-8 无 BOM 编码（用 VS Code、Notepad++ 检查并转换）
• Windows CMD 默认是 GBK，强制用 UTF-8：chcp 65001（执行后再跑 PHP）
• 避免输出被缓冲干扰：脚本开头加 ob_end_flush();，或关键 echo 后加 flush();
• CLI 下 print_r($arr) 默认不换行，建议改用 var_dump($arr) 或 print_r($arr, true) 配合 echo

想传参数给 PHP 脚本：$argv 不是 $_GET，别混用

php script.php name=alice age=30 这样写，$_GET 是空的——CLI 没有 HTTP 请求上下文，只能靠 $argv 数组。

• $argv[0] 是脚本路径（如 script.php），$argv[1] 才是第一个参数
• 要解析键值对？得自己拆：parse_str(implode('&', array_slice($argv, 1)), $args);，之后 $args['name'] 才是 "alice"
• 更稳妥的做法：用 getopt()，比如 php script.php -n alice -a 30，再在脚本里写 $opts = getopt('n:a:');
• 注意：CLI 下 $_SERVER['argv'] 和 $argv 是同一个数组，但 $_SERVER['argc'] 才是参数个数，不是 count($argv) —— 严格来说一样，但语义更准

CLI 模式下最常被忽略的，是它根本不会自动加载 Web 环境里的那些初始化逻辑：自动加载器可能没触发、.env 文件不会被读取、session_start() 会直接报错。别假设“能网页跑就能命令行跑”，每个入口都得单独验。

今天关于《PHP命令行运行教程详解》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！