php环境安装成功需满足：php -v显示版本号；若提示“命令未找到”则需将php路径加入path（macos需检查~/.zshrc中export path="/opt/homebrew/bin:$path"并source）；运行test.php输出“php运行正常”表明解析正常；php -m检查扩展，缺失则修改对应php.ini并重启服务；注意cli与web服务器可能使用不同php.ini，可用php --ini确认。
直接用 php 命令就能跑，但前提是 PHP 已安装且在 PATH 里——2026 年 macOS 全系（包括 Sequoia）都不再自带 PHP，php -v 报错是常态，不是你操作错了。
确认 PHP 是否可用且路径正确
很多人卡在这一步却以为是命令写错了。先执行：
php -v
如果返回版本号（如 PHP 8.3.12），说明已就绪；若提示 command not found，别急着重装，先查是不是没加进 PATH：
- Homebrew 安装的 PHP，Apple Silicon Mac 路径通常是
/opt/homebrew/bin/php，Intel 是/usr/local/bin/php - 运行
which php，如果输出为空，说明终端根本找不到它 - 检查
~/.zshrc（macOS Catalina 及之后默认 shell）是否包含类似这行：export PATH="/opt/homebrew/bin:$PATH" - 改完记得
source ~/.zshrc，否则新开终端才生效
终端里直接运行单个 PHP 文件
这是最轻量、无服务器依赖的方式，适合调试脚本、CLI 工具或简单逻辑验证。
- 用
cd进到文件所在目录，比如cd ~/Desktop - 确保文件名带
.php后缀，比如test.php - 执行
php test.php——不需要chmod +x，PHP CLI 解释器不依赖文件可执行位 - 如果脚本依赖命令行参数，直接跟在后面：例如
php process.php input.txt --verbose - 注意：脚本里用
$_SERVER['DOCUMENT_ROOT']或$_SERVER['REQUEST_URI']这类 Web 环境变量会是空或报 Notice，CLI 模式下它们不存在
用内置服务器快速预览 Web 页面效果
当你要测 echo 'Hello'; 在浏览器里渲染，或者用 $_GET/$_POST，就得启动一个简易 Web 服务。
- 在 PHP 文件所在目录执行：
php -S localhost:8000 - 端口可换，但避免用 80（需 sudo）、443 或已被占用的（比如 3000、5000 常被 Node 占）
- 浏览器打开
http://localhost:8000/test.php，注意路径是相对于当前目录的，不是绝对路径 - 如果首页不是
index.php，得手动拼 URL；想自动路由，可以加路由器脚本：php -S localhost:8000 router.php，其中router.php需返回true或转发路径 - 这个服务器不解析
.htaccess，也不支持 Apache mod_rewrite 规则
常见失败场景和绕过方法
报错不一定是代码问题，大概率是环境链路断了。
-
Parse error: syntax error：检查 PHP 版本是否支持你写的语法（比如match表达式要 PHP 8.0+，str_contains()要 8.0+） -
Warning: Unknown: failed to open stream：文件路径错，或用了中文路径/空格，建议用拖拽方式生成路径：php后把文件拖进终端 -
Failed to open stream: Permission denied：不是权限问题，而是 PHP 进程没读取权限——检查文件是否在 iCloud 同步中（iCloud Drive 下的文件有时被锁），临时移到~/Desktop试试 -
Connection refused访问localhost:8000：确认php -S进程还在前台运行（没按 Ctrl+C），也可能是另一个进程占了端口，用lsof -i :8000查杀
真正麻烦的不是“怎么跑起来”，而是当你改了 php.ini 加扩展、调 memory_limit，却发现终端里 php -v 和 php -S 用的不是同一个配置文件——Homebrew 的 php.ini 在 /opt/homebrew/etc/php/8.3/php.ini，而系统旧残留可能还在 /etc/php.ini，务必用 php --ini 确认加载路径。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
