可通过扩展 Laravel API 资源类返回额外上下文信息。首先重写资源类的 toArray 方法，手动添加 meta、message 等字段，并合并模型数据；其次使用 additional 方法在控制器中动态注入 timestamp、api_version 等元数据；对于资源集合，可创建 ResourceCollection 子类，在 toArray 中定义 data 数组及 links、total_count 等全局元信息；最后，临时需求可用匿名资源类结合 additional 快速封装数据。
如果您正在使用 Laravel 构建 API 并希望通过 API 资源类返回额外的上下文信息，例如分页元数据、请求状态或自定义消息，您可以通过扩展资源类来附加这些数据。以下是实现该功能的具体步骤：
本文运行环境：MacBook Pro，macOS Sonoma
一、在资源类中重写 toArray 方法
通过覆写资源类中的 toArray 方法，您可以完全控制输出的数据结构，并手动添加任意元数据字段。
1、打开已创建的资源类文件，例如 UserResource.php。
2、修改 toArray 方法，在返回数组中加入自定义键值对，如 'meta' 或 'message'。
3、确保调用父类方法或手动构造模型属性，并将其与其他元数据合并返回。
二、使用 additional 方法添加元数据
Laravel 提供了 additional 方法，允许在不修改 toArray 的情况下动态注入额外数据。
1、在控制器中实例化资源类后，链式调用 additional() 方法。
2、传入一个关联数组作为参数，其中包含您希望追加的元数据，例如 'timestamp' 或 'api_version'。
3、该方法会将数据合并到最终响应的顶层，适用于单个资源或资源集合。
三、为资源集合添加全局元数据
当返回多个资源时，可通过继承 ResourceCollection 类并覆写其行为来统一添加元数据。
1、创建或编辑资源集合类，如 UserCollection.php。
2、在 toArray 方法中，显式定义 'data' 字段用于存放资源列表。
3、在同一层级添加其他元数据字段，例如 'links'（分页链接）或 'total_count'（总数）。
4、在控制器中返回该集合类实例，即可输出结构化数据与元信息。
四、利用匿名资源类动态附加数据
对于临时性需求，可直接在控制器中使用匿名资源类快速嵌入元数据，无需预先定义类文件。
1、在路由闭包或控制器方法中，使用 new Resource 包裹模型实例。
2、调用 additional() 方法并传入自定义数组。
3、此方式适合快速原型开发或简单接口的数据包装。
