SuperAPI AI 工具集

php-ecosystem-reference

编程与开发

查看项目

更新于 10-26 16:21

技能介绍

定位与用途

PHP Ecosystem Reference 是一个“定位与路由地图”,不是实现专家。它回答“某个问题适合用哪个 PHP 工具,以及下一步该去哪里”,用于在非 Laravel 的 PHP 技术选型中提供方向判断,并把任务路由到合适的后续资源。

官方说明明确其不携带针对 Symfony 全栈、API Platform 或 Slim 的深入、版本相关的操作方法知识。需要实现细节时,交给 research-expert 代理,框架无关的 HTTP 部分交给 php-http-psr。

覆盖范围

  • Symfony 组件:可独立安装的 PHP 库,每个都能通过 Composer 单独引入,无需完整框架。
  • API Platform 5.0:构建在 Symfony 之上的 API-first 框架,可从资源类生成 REST、GraphQL、OpenAPI。
  • Slim 4.15:基于 PSR-7/PSR-15 的微框架,适合小型 API 与服务。
  • 边界说明:指出该技能的能力终点以及应路由到何处。

使用方式

按资料要求,在依赖任何细节前,需并行启动两个代理,每个 Agent 调用各带一个名称:

  • fuse-ai-pilot:research-expert:在 symfony.com、api-platform.com、slimframework.com 核实当前版本与 API。
  • fuse-ai-pilot:explore-codebase:检测 composer.json 中已存在的相关依赖。

技能只负责定向,具体代码前由研究代理提供经过核实的细节。

独立组件的安装示例:

composer require symfony/console       # CLI apps
composer require symfony/process       # run sub-processes
composer require symfony/event-dispatcher
composer require symfony/validator
composer require symfony/serializer

决策捷径:完整 Laravel 应用交给 laravel-expert 代理;框架无关的 HTTP 消息/中间件使用 php-http-psr;无需框架的单一工具(CLI、事件、校验)选择对应 Symfony 组件;Symfony 上的 API-first 产品选 API Platform;小型 PSR-7 API/服务选 Slim;深度 Symfony 全栈 MVC 没有专属专家,需向用户说明(见 boundaries.md)。

关键规则

  • 仅作定向:不得把生态细节当作权威内容呈现,写代码前由研究代理核实。
  • 独立组件不等于框架:Symfony 组件可在没有 Symfony 框架的情况下运行,执行 composer require symfony/console 即可。
  • HttpFoundation 不是 PSR-7:Symfony 的 HTTP 模型与 PSR-7 不同,需通过 symfony/psr-http-message-bridge 桥接(见 php-http-psr)。
  • Laravel 不在范围内:任何 Laravel 任务都路由到 laravel-expert。
  • 没有深入的 Symfony 专家:面对全栈 Symfony 深度需求,应明确告知用户,而不是自行发挥。

适用场景与限制

适用场景:为非 Laravel 的 PHP 项目做工具选型;判断某需求应使用独立 Symfony 组件、API Platform 还是 Slim;明确任务是否超出既有专家能力范围。

限制:不提供版本相关的实现细节;不处理 Laravel;全栈 Symfony 深度实现无专属代理支持;不应假定 Symfony HttpFoundation 与 PSR-7 可以互换。各参考文件(symfony-components.md、api-platform.md、slim-framework.md、boundaries.md)的具体内容暂未提供。