php命令找不到是环境配置问题:需确认安装路径并加入path;cli与web的php.ini不同,需检查扩展是否启用;输出乱码需统一utf-8编码并调整终端;传参用$argv或getopt(),不可用$_get;cli无web初始化逻辑,须单独验证。

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 数组。
立即学习“PHP免费学习笔记(深入)”;
-
$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() 会直接报错。别假设“能网页跑就能命令行跑”,每个入口都得单独验。











