怎样在PHP本地环境运行CLI脚本_PHP本地环境跑CLI脚本操作【运行】_技术教程

PHP CLI脚本可直接运行无需Web服务器，但需确保php命令已加入PATH；通过php -v验证，否则需手动配置XAMPP/MAMP路径；脚本用$argv获取参数，注意CLI无$_GET/$_POST及$_SERVER变量，且php.ini配置与Web环境独立。

PHP本地环境可以直接运行CLI脚本，不需要Web服务器参与——只要你的PHP解释器已正确安装并加入系统PATH，php 命令就能在终

端里直接执行脚本。

很多人卡在这一步：以为装了XAMPP/MAMP/WAMP就自动有了CLI，其实它们默认只配了Apache/Nginx的PHP模块，CLI可能是另一个路径、甚至没加到环境变量里。

在终端（Windows用CMD/PowerShell，macOS/Linux用Terminal）运行 php -v，能看到版本号才说明CLI可用
如果报错 command not found: php 或 'php' is not recognized as an internal or external command，就得手动定位PHP可执行文件
XAMPP用户通常要找 C:\xampp\php\php.exe（Windows）或 /Applications/XAMPP/xamppfiles/bin/php（macOS）；MAMP则是 /Applications/MAMP/bin/php/php8.2.12/bin/php（版本号随安装变）
临时运行可用绝对路径，比如 C:\xampp\php\php.exe script.php；长期建议把对应目录加进系统PATH

CLI脚本和Web脚本写法几乎一样，但要注意输出不经过HTTP头、不依赖$_GET/$_POST，常用 $argv 接收命令行参数。

#!/usr/bin/env php

保存为 hello.php，然后在同目录下运行 php hello.php arg1 arg2
Windows下无需#!/usr/bin/env php行，但Linux/macOS建议保留，方便后续加执行权限直接运行 ./hello.php arg1
注意换行用 \n，不是HTML的；CLI不解析HTML标签，echo "Hi " 会原样打印字符串

不是代码写错了，而是环境或调用方式不对。以下错误出现频率极高：

Parse error: syntax error, unexpected token "..." in script.php on line X：PHP CLI用的是独立配置文件 php.ini，可能版本太低（比如CLI是7.4，而Web是8.2），运行 php --ini 查看加载的是哪个配置，再比对 php -v
脚本里用了 $_SERVER['DOCUMENT_ROOT'] 或 $_SERVER['REQUEST_URI'] —— CLI环境下这些变量不存在或为空，应改用 __DIR__ 或 getcwd()
依赖扩展（如 pdo_mysql）在CLI配置里被注释掉了：打开 php --ini 显示的 Loaded Configuration File，检查 extension= 行是否启用，尤其注意CLI专用的 php.ini 和Web用的不是同一个
脚本开头有BOM（UTF-8 with BOM），导致 php 解析器第一行读到不可见字符而报错，用编辑器另存为“UTF-8 without BOM”即可

没有浏览器开发者工具，得靠更直接的方式观察执行过程：

用 var_dump($argv); exit; 快速确认参数是否传进来
写日志比 echo 更可靠：error_log("Step 1 done", 3, __DIR__.'/debug.log');
想模拟Web环境变量？可以临时设置：$_SERVER['HTTP_HOST'] = 'localhost';，但别依赖它做核心逻辑
长脚本卡住？加 pcntl_signal(SIGINT, function() { echo "\nCaught Ctrl+C, exiting.\n"; exit; }); pcntl_signal_dispatch(); 支持Ctrl+C中断

最常被忽略的一点：CLI脚本的当前工作目录是终端所在的路径，不是脚本所在路径。用 __DIR__ 定位资源文件，别用相对路径硬写 ../config/database.php——它很可能找不到。