要让AI在PHP项目中准确写代码，需提供PHP版本、框架及函数签名等上下文，禁用模糊描述，手动核对use语句；将Copilot补全接入PhpStorm Live Templates并强制格式化；本地小模型须加Laravel方法约束；用php -l预检；数据库操作需含try/catch与Log::error；单元测试须明确Mockery或PHPUnit工具链并处理protected方法；边界条件必须人工指定。
PHP 项目里怎么让 AI 助手真正写对代码，而不是瞎猜 composer.json 依赖？
AI 助手在 PHP 场景下容易忽略项目真实约束：比如你用的是 Laravel 9，它却推荐 str_contains()（PHP 8.0+），而你服务器还是 PHP 7.4；或者直接甩出 match 表达式，根本跑不起来。关键不是让它“写得快”，而是“写得准”。
- 每次提问前，先贴三行上下文：
PHP_VERSION、laravel/framework版本（或symfony/console等实际依赖）、当前函数签名（含public function handle(): void这类可见声明） - 禁用模糊描述，把“优化这个逻辑”换成“把这段 foreach 替换为
collect()->filter()->map()，保持键名不变” - 对 AI 返回的
use语句必须手动核对——它常漏掉Illuminate\Support\Str或错写成Support\String
怎么把 GitHub Copilot / Cursor 的补全结果塞进 PhpStorm 的 Live Template 流程里？
直接让 Copilot 在 PhpStorm 里“自由发挥”，大概率生成不符合 PSR-12 的缩进、混用单双引号、或者把 $request->validate() 写成 $request->validateOrFail()（后者 Laravel 并不存在）。得把它变成“受控组件”，而非“全自动队友”。
- 在 PhpStorm 的
Settings > Editor > Live Templates里新建模板，缩写设为ai-req，展开内容为：/** @var \Illuminate\Http\Request $request */<br>$validated = $request->validate([<br> // ✅ 光标停在这儿，等 Copilot 补全字段<br>]);
- 触发后，立刻按
Ctrl+Shift+A→ 输入Reformat Code，强制套用当前 PSR-12 规则，避免 AI 带来的格式污染 - 禁用 Copilot 的自动括号闭合（在 VS Code/Cursor 设置里关掉
editor.autoClosingBrackets），否则它会在validate([后自作主张补上])，导致你没法继续填字段
本地部署的 Ollama + php-codegen 模型，为什么总把 DB::transaction() 写成 DB::beginTransaction()？
小模型（如 codellama:7b 或轻量 phi-3）缺乏 Laravel 核心方法的调用链训练数据，看到“事务”就硬套 PDO 原生写法。这不是幻觉，是训练分布偏差。
- 别让它“自由联想”，改用指令约束：在 prompt 开头固定加一句
Use only Laravel 10.x facade methods, no raw DB::beginTransaction()/commit() calls. - 用
php -l做预检：把 AI 输出保存为临时.php文件，执行php -l /tmp/ai-out.php，返回非零就丢弃——比肉眼扫快 10 倍 - 对数据库操作类生成，强制要求输出带
try/catch结构，且catch块里必须有Log::error()调用（防止它省略错误处理）
用 AI 写单元测试时，Mockery::mock() 和 createMock() 到底该选哪个？
AI 常混淆 PHPUnit 原生 Mock 和 Mockery 生态，尤其在 Laravel 项目里混用会导致 Class Mock_XXX does not exist 错误。这不是语法问题，是测试运行时加载机制冲突。
立即学习“PHP免费学习笔记（深入）”；
- 明确告诉 AI 当前项目使用的测试工具链：比如 “本项目
phpunit.xml中启用了Mockery\Adapter\Phpunit\MockeryPHPUnitIntegration，请只用Mockery::mock()” - 禁止它生成
$this->createMock()，这个是 PHPUnit 10+ 原生 API，和 Laravel 的Orchestra\Testbench不兼容 - 所有 mock 对象必须显式调用
->makePartial()或->shouldAllowMockingProtectedMethods()（如果涉及 protected 方法），AI 默认不加，但 Laravel 的 service 类常有 protected 辅助方法
最麻烦的不是 AI 写错某一行，而是它把“边界条件”全吃掉了——比如 Storage::disk('s3')->exists($path) 返回 false 时是否该抛异常？AI 从不主动问，只会默认忽略。这类决策点，得你亲手卡在 prompt 里，不能靠它脑补。
