Cursor需本地PHP环境和Intelephense扩展才能正常运行AI功能：PHP必须安装且php -v可执行，PATH配置正确并重启Cursor；安装benmarchwick.intelephense，禁用微软PHP扩展，配置vendor路径和文件关联。
Cursor 本身是基于 VS Code 的独立编辑器，不原生支持 PHP 运行时或语言服务——它依赖外部 PHP 环境和 LSP（Language Server Protocol）才能实现准确的代码补全、跳转、错误提示等 AI 协作基础能力。没配好 PHP 环境，Cursor 的 Ctrl+K 或自然语言指令（如“修复这个 foreach 循环”）大概率会失效或给出错误建议。
PHP 必须已安装且在系统 PATH 中
Cursor 不自带 PHP 解释器，所有代码分析、执行、AI 上下文理解都依赖你本地的 php 命令可用。常见失败现象：AI 提示“无法读取文件结构”“找不到类定义”，往往只是因为 php --version 在终端报错或根本未找到命令。
- 在终端运行
php -v，必须返回版本号（如PHP 8.2.12），否则先装 PHP（推荐用brew install php（macOS）或apt install php-cli（Ubuntu）） - 确认
php可执行文件路径已加入系统PATH：macOS/Linux 检查echo $PATH是否含/opt/homebrew/bin或/usr/bin；Windows 检查系统环境变量里的Path - 重启 Cursor（不是重载窗口），让它重新探测环境变量——这点常被忽略，改完 PATH 后不重启 Cursor，
php仍不可见
必须启用 PHP Intelephense 扩展
Cursor 的 AI 功能严重依赖语言服务器提供的 AST 和符号索引。官方推荐且目前最稳定的 PHP LSP 实现是 Intelephense，不是 PHPStan、Psalm 或内置的 PHP Language Features。
- 在 Cursor 扩展市场搜索并安装
benmarchwick.intelephense（作者名+扩展名，认准图标为紫色齿轮） - 安装后默认启用，但需检查设置中
"intelephense.environment.includePaths"是否包含你项目用到的 vendor 路径（例如["./vendor"]），否则use语句和 Composer 类无法被 AI 正确识别 - 禁用 VS Code 兼容的
PHP Language Features（微软官方扩展），它与 Intelephense 冲突，会导致跳转错乱或补全消失
AI 指令对 PHP 语法敏感，需规避动态写法
Cursor 的模型训练数据以静态、可分析的 PHP 代码为主。遇到强动态行为（如 eval()、魔术方法 __call()、运行时 class_alias()）时，AI 很难推断上下文，容易生成无效或危险代码。
立即学习“PHP免费学习笔记（深入）”；
- 给 AI 的指令尽量绑定具体文件和行号，例如：“在
app/Services/UserService.php第 42 行的handleLogin()方法里，把密码哈希逻辑改成使用password_hash()” - 避免模糊描述如“让这个函数更安全”，AI 可能擅自加
htmlspecialchars()到不该处理的地方 - 对 Laravel/Yii 等框架项目，确保
intelephense.files.associations已配置"*.php": "php"，否则 Blade 模板中的 PHP 片段可能不被索引
真正卡住的地方往往不是 Cursor 设置，而是 PHP 本身的环境可见性——比如 WAMP/XAMPP 用户只把 php.exe 加进了 Apache 的 PATH，但终端和 Cursor 根本看不到；又比如 M1 Mac 用户用 Rosetta 安装了 PHP，但 Cursor 是原生 ARM 架构，导致二进制不兼容。这些细节不排查，光调 Cursor 设置毫无意义。
