PHP CLI脚本可直接运行无需Web服务器，但需确保php命令已加入PATH；通过php -v验证，否则需手动配置XAMPP/MAMP路径；脚本用$argv获取参数，注意CLI无$_GET/$_POST及$_SERVER变量，且php.ini配置与Web环境独立。
PHP本地环境可以直接运行CLI脚本，不需要Web服务器参与——只要你的PHP解释器已正确安装并加入系统PATH，php 命令就能在终端里直接执行脚本。
确认PHP CLI是否可用
很多人卡在这一步：以为装了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脚本并执行
CLI脚本和Web脚本写法几乎一样，但要注意输出不经过HTTP头、不依赖$_GET/$_POST，常用 $argv 接收命令行参数。
#!/usr/bin/env php <?php // hello.php echo "Hello from CLI!\n"; print_r($argv); // 第一个元素是脚本路径，后续才是传入的参数 ?>
- 保存为
hello.php，然后在同目录下运行php hello.php arg1 arg2 - Windows下无需
#!/usr/bin/env php行，但Linux/macOS建议保留，方便后续加执行权限直接运行./hello.php arg1 - 注意换行用
\n，不是HTML的<br>；CLI不解析HTML标签，echo "<h1>Hi</h1>"会原样打印字符串
常见执行失败原因和绕过方法
不是代码写错了，而是环境或调用方式不对。以下错误出现频率极高：
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
立即学习“PHP免费学习笔记（深入）”；
-
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”即可
调试CLI脚本的小技巧
没有浏览器开发者工具，得靠更直接的方式观察执行过程：
- 用
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——它很可能找不到。
