如何在项目中使用Composer加载 Fractal 库实现 API 数据的转换与格式化-composer-PHP中文网

fractal 已停止维护，官方推荐迁移到 spatie/laravel-fractal（laravel）或 league/fractal 1.x（需手动处理 php 8.2+ 兼容性与安全风险）；安装失败主因是 php 版本约束冲突；include 逻辑存在隐式调用陷阱，须显式定义方法或启用白名单；分页 total 字段丢失需自定义序列化器或手动注入 meta。

$如何在项目中使用composer加载 fractal 库实现 api 数据的转换与格式化$

Fractal 已停止维护，官方推荐迁移到 spatie/laravel-fractal（Laravel）或直接用 league/fractal 1.x 版本（需手动处理废弃警告）——但要注意它不支持 PHP 8.2+ 的新特性，且无主动安全更新。

安装 league/fractal 时为什么 composer require 失败？

常见报错是 league/fractal v0.19.2 requires php ^7.2 或与项目 PHP 版本冲突。v1.x 虽标称支持 PHP 8.0，但实际在 8.2+ 下会触发 CreationContext::create() 的弃用警告，且部分 Transformer 方法签名已过时。

若项目用 PHP 8.0–8.1，可强制安装 composer require league/fractal:^1.0.0，但需禁用严格模式：在 composer.json 中加 "minimum-stability": "dev" 和 "prefer-stable": true
若用 Laravel，更稳妥是换 spatie/laravel-fractal，它封装了 v1.x 并屏蔽了多数兼容层问题，安装命令为 composer require spatie/laravel-fractal
别碰 fractal/fractal（旧组织名），那是重定向到 league/fractal 的废弃包，版本混乱

写 Transformer 时 getInclude() 返回空数组却仍触发 include 逻辑？

这是 league/fractal 的隐式 include 行为：只要请求 URL 带 ?include=user,posts，即使 getInclude() 返回空数组，它也会尝试调用 includeUser() 和 includePosts() 方法——哪怕这些方法根本不存在，就会抛出 BadMethodCallException。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

必须显式定义每个要支持的 include 方法，哪怕只返回空数据：public function includeUser($item) { return $this->item($item->user, new UserTransformer()); }
若想跳过未定义的 include，得重写 getManager()，在 Fractal\Manager 实例上设置 setSerializer(new ArraySerializer()) 并捕获 CallToUndefinedMethod 异常
Laravel 版本中可用 spatie/laravel-fractal 的 allowedIncludes(['user', 'posts']) 白名单机制，自动忽略非法 include 参数

用 Fractal 返回分页数据时 total_count 字段丢失？

league/fractal 默认的 PaginationSerializer 只输出 current_page、last_page 等字段，不包含 total（即总记录数），而很多前端分页组件依赖这个字段做页码计算。

不能直接改 toArray()，因为分页元数据由 Fractal\Pagination\IlluminatePaginatorAdapter 注入，它把 $paginator->total() 映射为 total 键，但默认序列化器丢弃了它
解决办法是自定义序列化器，继承 ArraySerializer，重写 collection() 方法，在返回前手动补上 'total' => $resource->getPaginator()->total()
若用 spatie/laravel-fractal，直接配置 config/fractal.php 中的 'serializer' => Spatie\Fractal\ArraySerializer::class，再在 transformer 里用 $this->meta(['total' => $paginator->total()]) 手动注入

真正麻烦的不是装不上，而是 Transformer 的生命周期和 include 解析逻辑藏得太深——比如 includeXxx() 方法的参数类型检查在运行时才发生，IDE 不提示，测试也容易漏掉；还有 Laravel 模型延迟加载（lazy eager loading）和 Fractal 的 item()/collection() 调用顺序稍有偏差，就会导致 N+1 查询重现。