PHP

PHP调试、开发与性能优化专家

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:PHP。
它的用途是:PHP调试、开发与性能优化专家
完整的 Skill 内容见:https://321skill.com/skills/php-x-3/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'我的 PHP 页面返回 500 错误,nginx 日志显示

介绍

这个技能专为 PHP 开发者打造,解决日常开发中遇到的各种棘手问题:当页面突然变成空白或返回 500 错误且无任何提示时,它能快速定位是语法错误、类型强制转换问题还是内存溢出;当出现“headers already sent”、“Allowed memory size exhausted”等典型错误时,它能给出精准的修复方案;对于 Composer 安装后“Class not found”、== 比较逻辑错误、strpospreg_match 返回假值匹配、json_encode 返回 false 等常见陷阱,它也能逐一排查。此外,它还涵盖 PHP 版本升级导致的弃用兼容性、OPcache 缓存旧代码、Nginx 与 PHP-FPM 配合的 502/504 错误、Session 序列化导致 AJAX 并行请求冲突等高级问题。

使用方式非常直接:只需将报错信息、代码片段或运行环境描述告诉它,它会分析根因并给出可执行的修复步骤。例如,你可以说“页面返回 500 错误,nginx 日志显示 upstream timed out”,它会检查 PHP-FPM 进程池配置、超时设置和慢日志;你也可以说“json_encode 返回 false,但数据看起来正常”,它会检查 UTF-8 编码、递归深度限制和对象属性可见性。它还支持输出 HTML 转义、密码哈希、FPM 工作进程调优、PHPUnit 测试编写以及 PHPStan 静态分析错误清理等任务。

适合后端开发工程师、全栈开发工程师以及运维工程师,尤其是那些需要频繁调试遗留 PHP 项目或参与高并发 PHP 应用维护的团队。对于 Laravel 等框架的内部机制(如 Eloquent、队列、认证),建议使用专门的 Laravel 技能;本技能专注于 PHP 语言本身和基础组件(PDO、Session、OPcache、PHP-FPM)的深度问题。

使用建议:提供尽可能完整的上下文,包括 PHP 版本、错误日志、相关代码片段和环境配置(如 nginx 配置、php.ini 设置)。对于白屏问题,可先开启 display_errors 或检查 error_log 路径;对于内存耗尽,建议同时提供 memory_limit 当前值和实际数据量。该技能不适用于框架内部的功能开发,但能帮你解决因框架底层 PHP 特性引发的错误。

核心特点

与通用的 PHP 调试助手不同,这个技能不仅覆盖常见错误(白页、500、内存耗尽),还专门处理 PHP 特有的类型强制转换陷阱、`==` 比较语义、`strpos` 假值问题、PDO 预处理模拟模式、Session 并行竞争等极难排查的深层问题,并且内置了 FPM 调优、OPcache 缓存清理、PHPStan 错误消除等生产环境实用知识。

注意事项

不适用于 Laravel、Symfony 等框架的内部机制(如 Eloquent、队列、认证),也不适用于前端或服务器配置之外的 PHP 相关问题。

常见问题

PHP 页面白屏怎么办?

先检查错误日志或开启 display_errors,然后描述具体场景(如是否刚部署、是否修改了代码),它会帮你定位是语法错误、内存耗尽还是 OPcache 缓存问题。

`json_encode` 返回 false 怎么解决?

检查数据中是否包含非 UTF-8 字符、递归深度是否超过限制、对象是否具有私有属性。可以使用 `json_last_error_msg()` 获取具体错误原因。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/php-x-3/raw/index.md 读取 PHP 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。