编写 PHP RESTful API 文档的最佳实践如下：
概述：在文档的开头部分提供 API 的概述，包括 API 的功能、用途、支持的 HTTP 方法等。
终端点：列出 API 的所有终端点（endpoints），包括 URL、支持的 HTTP 方法和参数。
认证：说明 API 的认证方式，例如基本认证、OAuth 等。
响应：定义 API 返回的数据格式，包括成功和失败的响应示例。
错误处理：列出可能的错误状态码和错误消息，并说明如何处理这些错误。
请求示例：提供一些常见的请求示例，包括如何发送参数和头部信息。
常见问题：列出一些常见的问题和解决方案，以帮助用户更好地使用 API。
示例代码：提供一些用于调用 API 的示例代码，包括 PHP、JavaScript 等。
版本控制：如果 API 支持版本控制，建议在文档中明确指出 API 的版本号和如何选择版本。
更新日志：在文档中记录 API 的更新历史，包括新增、修改和删除的功能。
通过以上步骤，可以帮助用户更好地理解和使用 PHP RESTful API，提高 API 的可用性和易用性。