Fractal 已停止维护，官方推荐迁移到 spatie/laravel-fractal（Laravel）或 league/fractal 1.x（需手动处理 PHP 8.2+ 兼容性与安全风险）；安装失败主因是 PHP 版本约束冲突；include 逻辑存在隐式调用陷阱，须显式定义方法或启用白名单；分页 total 字段丢失需自定义序列化器或手动注入 meta。
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）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “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 查询重现。
