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
- 保存为
hello.php，然后在同目录下运行php hello.php arg1 arg2 - Windows下无需
#!/usr/bin/env php行，但Linux/macOS建议保留，方便后续加执行权限直接运行./hello.php arg1 - 注意换行用
\n，不是HTML的echo "会原样打印字符串Hi
"
常见执行失败原因和绕过方法
不是代码写错了，而是环境或调用方式不对。以下错误出现频率极高：
云枫企业网站源代码1.0
下载
云枫工作室企业网站是由云枫工作室独立开发的一个适用于普通企业的网站展示系统.系统环境:asp+access网站功能主要有订单系统、新闻系统、信息系统、招聘系统、会员系统和在线咨询信息（QQ、MSN）管理系统使用步骤1、把网站源代码拷贝到服务器空间的根目录下。（注：服务器空间需支持ASP脚本运行）2、网站后台地址为http://您的域名/admin/index.asp 管理员用户名和密码都是admi
立即学习“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——它很可能找不到。
