PhalApi PHP 接口框架

要解决什么问题

PHP 项目里做 HTTP/SOAP/RPC 接口时，常见痛点是：分层边界模糊（Controller 里直接写 SQL）、参数校验重复、接口文档与代码脱节。PhalApi（π 框架）用 ADM（Api-Domain-Model）固定调用方向，并内置参数规则与在线文档生成；本技能把官方开发路径整理成可检索的操作说明，方便在 Agent 对话里按层写代码、查配置。

技能如何帮你落地

• ADM 分层：Api 只做入参校验与调度；Domain 承载业务规则，可调用同级 Domain 与 Model；Model 负责 NotORM 与缓存。禁止 Api→Model、Domain→Api、Model→Domain，跨层报错时应对照这张表排查。
• 参数体系：系统参数（service/s）、应用级 apiCommonRules、接口级 getRules()；支持 string/int/enum/file/callable 等类型及完整校验配置。
• 数据与基础设施：config/dbs.php 配置库表与分表；通过 $di->notorm、$di->cache、$di->logger、$di->filter 使用数据库、缓存、日志与 MD5 签名（SimpleMD5Filter + 白名单）。
• 文档与测试：注释规范驱动 /docs.php 在线文档；phalapi-buildtest 与 TestRunner 支持 BUILD-OPERATE-CHECK 式单测。
• 进阶能力：2.13.0+ 的 DataApi 通用 CRUD、Gearman 队列、多库/分表、sys.debug / enable_sql_log 等 SQL 调试开关。

适用边界与注意点

技能面向 PhalApi v2 风格项目（PSR-4、src/app/{Api,Domain,Model}），不是通用 Laravel/Symfony 教程。NotORM 实例带状态：事务或连续查询宜通过 $this->getORM() 取新实例；全表删除需带 WHERE。生产环境注意日志脱敏、签名密钥一致与 API_MODE（dev/test/prod）对应的环境配置。更完整的 API 以 官方文档 为准。