先确认 Laravel 主版本，再匹配对应 illuminate/support 版本；Webman 中需手动补全服务绑定；PHP 5.6 环境必须在目标环境下生成 composer.lock；高频场景应避免过度封装导致性能损耗。
composer install 时提示 illuminate/support 版本冲突怎么办
直接 composer require dingo/api 或手动加 illuminate/support 到 composer.json，90% 情况会失败——不是你写错，是 Laravel 主版本和 illuminate 子包之间存在隐性绑定关系。
常见错误信息类似：illuminate/support v11.0.0 requires php ^8.2，但你的项目跑在 PHP 8.1；或更隐蔽的：laravel/framework v10.48.12 conflicts with illuminate/support[v9.52.16]。
- 先用
composer show laravel/framework确认主框架版本，再查对应illuminate/support的兼容范围（例如 Laravel 10.x 只认^10.0，混用v9.x会导致Arr::wrap()、Str::of()等函数行为异常甚至类不存在 - 不要盲目指定
"illuminate/support": "^9.0"—— 如果主项目是 Laravel 11，Composer 会自动拉取高版本依赖，绕过你的锁定 - 执行
composer why-not illuminate/support:9.52.16查清谁在阻断安装，通常暴露的是某个间接依赖（如spatie/laravel-ignition或laravel/sanctum）锁死了illuminate/*版本
webman 中使用 illuminate/support 需要额外注意什么
Webman 不是 Laravel，它只借用了部分 Illuminate 组件，illuminate/support 在这里只是工具集，不参与服务容器启动流程。这意味着很多 Laravel 里“开箱即用”的特性，在 Webman 里得手动补全。
-
Illuminate\Support\Facades\Lang无法直接用 —— Webman 没注册translation服务提供者，需自己加载Translator实例并绑定到容器 -
Illuminate\Support\Str和Illuminate\Support\Arr是安全的，可直接use调用静态方法，但别依赖Str::macro()，因为 Webman 没初始化全局 macro 注册器 - 若用到
Illuminate\Support\Traits\Macroable，必须确保目标类已声明use Macroable并定义了$macros属性，否则__call()会直接报错而不是静默忽略
PHP 5.6 环境下装低版本 illuminate/support 仍失败的原因
你以为指定了 "illuminate/support": "5.8.*" 就万事大吉？错。Composer 锁定的是整个依赖图，哪怕你手写低版本，只要某一个子依赖（比如 symfony/polyfill-php72）内部要求 PHP >=7.2，安装就会中断。
立即学习“PHP免费学习笔记（深入）”；
- 根本问题是：本地执行
composer install的 PHP 版本（如 7.4）会生成composer.lock，其中记录的是该环境下能解析出的最高兼容版本，而非你声明的“理想版本” - 解决路径只有一条：在目标环境（PHP 5.6）下运行
composer install，哪怕用 Docker 或虚拟机临时搭个环境，确保composer.lock里所有包的php约束都满足^5.6 - 验证方式：打开
composer.lock，搜索"php":，确认每个包的require.php值都是^5.6或~5.6.0，而不是^7.2
用 illuminate/support 替代原生函数时的性能陷阱
Str::slug() 比 preg_replace() 多一次正则编译，Arr::dot() 比手写递归多 15% 开销——这些差异单次调用几乎不可测，但在高频循环里会放大。
- 避免在
foreach内反复调用Str::of($str)->limit(50)，改用mb_substr($str, 0, 50)更轻量 -
Arr::first()内部做了 key 类型检查和默认值兜底，如果确定数组非空且结构稳定，直接reset($array)或$array[key($array)]快 2–3 倍 - 不要为省几行代码把
collect()套在小数组（foreach 更稳
最易被忽略的点：illuminate/support 的版本号不等于功能可用性。Laravel 5.8 的 Str::markdown() 在单独引入时因缺少 league/commonmark 依赖而抛出 Class not found，但它不会在 composer install 阶段报错，只在运行时崩。
