Apifox 不能直接读取 PHP 代码生成接口文档，需通过框架导出符合 OpenAPI 3.0 规范的 JSON 文件（如 Laravel 用 l5-swagger、ThinkPHP 用 think-swagger）后导入；抓包仅辅助获取请求结构，无法识别业务语义，仍需人工补全字段说明与示例。
Apifox 能否直接读取 PHP 代码生成接口文档？
不能。Apifox 本身不解析 PHP 源码（如 Controller 类、@param 注释或 Route 定义），它没有内置的 PHP AST 解析器，也不支持像 Swagger PHP 那样通过注解实时扫描生成。你看到的“自动生成”，实际依赖的是「人工导出 + 格式适配」或「运行时抓包」两条路径。
最实用的 PHP 对接方式：用 OpenAPI 3.0 JSON 导入 Apifox
主流 PHP 框架（Laravel、ThinkPHP、Hyperf）都有成熟扩展可导出标准 openapi.json，这才是 Apifox 真正能“自动识别”的输入源。关键不是“PHP 自动生成”，而是“PHP 项目输出符合 OpenAPI 3.0 规范的 JSON，Apifox 导入后渲染成文档”。
- Laravel 推荐用
@darkaonline/l5-swagger，配置好swagger.php后执行php artisan l5-swagger:generate，生成文件默认在public/docs/json - ThinkPHP 8 可用
topthink/think-swagger，运行php think swagger:export输出openapi.json - 手动校验：打开生成的 JSON，确认根级有
openapi: "3.0.3"，且paths下包含真实路由（如/api/users），否则 Apifox 导入后会显示“无接口”
别踩坑：Apifox 导入后接口参数为空或类型错乱
常见原因是 PHP 注解未严格遵循 OpenAPI 规范，或框架扩展对嵌套结构/数组/枚举支持不全。例如：
- 使用
@OA\Property时漏写type，Apifox 无法推断字段类型，默认为string - 请求体是
application/json，但注解里只写了@OA\RequestBody却没嵌套@OA\JsonContent和@OA\Property，Apifox 就看不到参数列表 - ThinkPHP 的
think-swagger对array<string>这类泛型识别为object，需手动在注解中加@OA\Schema(type="array", @OA\Items(type="string"))
调试建议：用 Apifox 抓包反向生成文档更省事？
适合无注解历史的老项目，或前后端联调阶段。但要注意：Apifox 的抓包功能只记录请求/响应原始数据，不提取业务语义。比如一个返回 {"code":0,"data":{"id":123}} 的接口，Apifox 不知道 data.id 是必填整数，只会标记为 “unknown”。后续仍需人工补全字段说明、示例值、错误码等——这步省不掉。
立即学习“PHP免费学习笔记（深入）”；
真正省时间的点在于：它能自动捕获真实 URL、Method、Headers、Query 参数和响应状态码，避免手输出错。但一旦接口逻辑变更（如新增分页参数 page_size），抓包不会提醒你更新文档，容易过期。
