使用phpDocumentor、Doxygen和Zircote/swagger-php可自动生成PHP项目API文档。首先通过Composer安装phpDocumentor，配置phpdoc.xml并执行命令生成HTML文档；其次安装Doxygen，生成Doxyfile配置文件并设置输入路径与文件类型后运行生成多格式文档；最后使用Zircote/swagger-php在代码中添加OpenAPI注释，通过命令导出openapi.yaml文件并与Swagger UI集成展示。
如果您正在开发PHP项目，并需要为代码中的函数、类和方法生成清晰的API文档，可以通过自动化工具来提取注释并生成结构化文档。以下是实现该目标的具体步骤：
本文运行环境：MacBook Pro，macOS Sonoma
一、使用phpDocumentor生成API文档
phpDocumentor是一个流行的PHP文档生成工具，能够解析代码中的PHPDoc格式注释，并输出HTML格式的API文档。
1、通过Composer安装phpDocumentor：composer require --dev phpdocumentor/phpdocumentor。
立即学习“PHP免费学习笔记（深入）”；
2、在项目根目录下创建配置文件phpdoc.xml，定义源码路径和输出目录。
3、执行命令行生成文档：./vendor/bin/phpdoc run -d ./src -t ./docs，其中-d指定源码目录，-t指定输出目录。
4、完成后，在docs目录中打开index.html即可查看生成的交互式文档。
二、利用Doxygen支持PHP文档生成
Doxygen虽然不专属于PHP，但能解析多种语言的注释结构，包括PHP，并生成详细的API文档。
1、下载并安装Doxygen工具，或使用包管理器如Homebrew：brew install doxygen。
2、在项目目录中运行doxygen -g生成默认配置文件Doxyfile。
3、编辑Doxyfile，设置INPUT为PHP源码路径，FILE_PATTERNS添加*.php，并启用EXTRACT_ALL = YES。
4、执行doxygen Doxyfile命令，系统将根据注释生成HTML或LaTeX格式文档。
三、基于Zircote/swagger-php生成OpenAPI规范文档
该工具允许开发者在PHP代码中使用注释定义RESTful API接口，最终生成符合OpenAPI（Swagger）标准的JSON/YAML文档。
1、安装swagger-php库：composer require zircote/swagger-php。
2、在控制器或路由方法上方添加PHPDoc风格的注释块，例如使用@OA\Get()、@OA\Response()等描述接口行为。
3、执行命令生成OpenAPI文档：./vendor/bin/openapi --bootstrap constants.php -o openapi.yaml ./src。
4、将生成的openapi.yaml文件集成到Swagger UI中进行可视化展示。
