Laravel集合宏用于扩展Collection类的可复用方法，需在AppServiceProvider的boot方法中注册，支持独立文件管理、Tinker临时注册、实例调用及存在性校验。
如果您希望在 Laravel 应用中为集合（Collection）添加自定义的、可复用的方法，但又不希望每次都在具体逻辑中重复编写相同逻辑，则可以利用 Laravel 提供的集合宏（Macro）机制进行扩展。以下是实现此目标的具体操作步骤：
一、在服务提供者中注册集合宏
集合宏需在应用启动早期注册，通常选择在 AppServiceProvider 的 boot 方法中完成，确保所有集合实例均可识别该宏方法。
1、打开 app/Providers/AppServiceProvider.php 文件。
2、在 boot 方法内部调用 Collection::macro()，传入宏名称与闭包函数。
3、闭包函数接收当前集合实例作为第一个参数，并可接受额外参数，返回处理后的结果。
4、示例：注册一个名为 isEvenCount 的宏，用于判断集合元素数量是否为偶数：Collection::macro('isEvenCount', function () { return $this->count() % 2 === 0; });
二、使用静态宏方法注册
除在服务提供者中注册外，也可通过 Collection 类的 macro 静态方法在任意位置（如测试文件或命令行 Tinker）临时注册宏，适用于调试或原型验证场景。
1、在 Laravel Tinker 中执行 php artisan tinker 命令进入交互环境。
2、输入 Collection::macro('firstUpper', function () { return $this->map(function ($item) { return ucfirst($item); }); });
3、创建新集合并调用该宏：$collection = collect(['hello', 'world'])->firstUpper();
4、验证结果是否为 ['Hello', 'World']。
三、通过独立宏文件集中管理
当宏方法较多时，可将全部宏定义提取至单独文件（如 app/Macros/CollectionMacros.php），提升可维护性与组织清晰度。
1、新建文件 app/Macros/CollectionMacros.php。
2、在该文件中使用 Collection::macro() 注册多个方法，每个宏保持职责单一。
3、在 AppServiceProvider 的 boot 方法中引入该文件：require_once app_path('Macros/CollectionMacros.php');
4、确保该文件无命名空间声明且不包含类定义，仅含宏注册语句。
四、在集合实例上调用宏方法
宏注册完成后，所有 Collection 实例（包括由辅助函数 collect() 创建的实例）均可直接调用宏名称作为方法使用，语法与原生方法一致。
1、创建一个基础集合：$items = collect([1, 2, 3, 4]);
2、调用已注册的宏，例如 isEvenCount：$items->isEvenCount(); // 返回 true
3、若宏接受参数，按常规方法传参，如 $collection->whereStartsWith('prefix')。
4、注意：宏方法不可链式调用原生方法以外的未注册宏，除非宏本身返回新的 Collection 实例。
五、验证宏是否生效
为避免宏未正确加载导致运行时错误，应在实际使用前进行存在性校验，尤其在动态调用或第三方包集成场景中。
1、使用 method_exists 判断宏是否可用：method_exists($collection, 'yourMacroName')
2、或使用 $collection->hasMacro('yourMacroName') —— 此为 Laravel 5.5+ 提供的内置检测方法。
3、在调用前加入条件判断，防止抛出 BadMethodCallException 异常。
4、示例：if ($collection->hasMacro('sumSquared')) { echo $collection->sumSquared(); }
