PHP代码怎么在命令行运行_PHP CLI模式使用指南【教程】

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:phpphp.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() 会直接报错。别假设“能网页跑就能命令行跑”，每个入口都得单独验。