定位与用途
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)的具体内容暂未提供。