可在非 Laravel 项目中通过 Composer 安装 illuminate/collections 包使用 Laravel 集合，推荐用 collect() 工厂函数而非 new Collection()，注意版本兼容性、惰性求值特性、链式调用性能开销及脱离框架后的功能限制。
PHP 原生没有 Collection 类型，所谓“Laravel 集合”是 Laravel 框架提供的 Illuminate\Support\Collection 类，它不是 PHP 扩展，也不能脱离 Laravel 环境直接“安装使用”。想在非 Laravel 项目里用它，必须手动引入 illuminate/collections 包，且需注意自动加载和依赖兼容性。
怎么在非 Laravel 项目中引入 Collection 类
Composer 是唯一可靠方式。运行以下命令安装独立组件：
composer require illuminate/collections
安装后，Collection 类即可通过命名空间使用。但要注意：
-
illuminate/collections不依赖整个 Laravel，但部分方法（如when()、tap()）在低版本（如 v8.x 之前）可能缺失 - PHP 版本需匹配：v9.x 要求 PHP >= 8.0；v8.x 支持 PHP 7.3+；v7.x 已停止维护，不建议新项目使用
- 不要手动 require 或复制类文件——会破坏自动加载，导致
Class 'Illuminate\Support\Collection' not found
new Collection() 和 collect() 的区别
两者都返回 Illuminate\Support\Collection 实例，但行为不同：
立即学习“PHP免费学习笔记（深入）”；
-
new Collection($array)直接构造，不校验输入类型；若传入null或对象，可能引发意外行为（如count()返回 0 而非报错） -
collect($value)是推荐的工厂函数，会对输入做标准化处理：空值转空集合，字符串按字符拆成集合，对象尝试调用toArray()，还能识别 Traversable 实例 - 实际开发中，一律优先用
collect()，避免隐式类型错误
常见集合操作易踩的坑
Laravel 集合是“惰性求值”的，但很多方法（如 filter()、map()）返回新实例而非原地修改，这点和 JS 的 Array.prototype.map 表面相似，但语义更严格：
-
$c->map(...)不改变$c，必须赋值：$c = $c->map(...) -
each()是立即执行的遍历，而map()+filter()组合不会触发计算，直到调用toArray()、first()或count()等终结方法 -
pluck('name')对嵌套数组有效，但对对象属性默认不递归；若对象没定义__get或 public 属性，会返回null，而不是抛异常 -
groupBy()的键名若含特殊字符（如空格、点号），结果数组键可能被 PHP 自动转换或截断，建议预处理键名
性能敏感场景要注意什么
集合封装了数组操作，但每调用一个链式方法都会新建对象，内存开销比原生 foreach 高 2–5 倍。大数据量（>10,000 项）时：
- 避免长链式调用，比如
collect($data)->map()->filter()->values()->merge()->sortBy()，应拆解并复用中间变量 - 不要用
Collection替代数据库查询：该用where条件就别用filter()在 PHP 层筛 -
contains()默认用松散比较（==），检查整数 ID 时可能误匹配字符串"1"；明确需要严格比较请用containsStrict()
Collection 的便利性建立在框架约定之上，脱离 Laravel 后，它不再有服务容器绑定、宏注册、全局辅助函数等支持，很多文档示例里的写法（如直接用 str_slug() 配合 map()）会因缺少辅助函数而报错——得自己补或换实现。
