本文旨在解决 Laravel Valet 在 PHP 8 环境下因 `illuminate/container` 依赖版本过低导致的弃用警告。通过修改全局 `composer.json` 文件，明确指定 `illuminate/container` 为兼容 PHP 8 的版本，并清理 Composer 缓存及依赖文件，可以有效消除这些警告，确保 Valet 正常运行。本教程将详细指导您完成此过程。
问题描述：Laravel Valet 与旧版 Illuminate 依赖的冲突
当在 PHP 8 或更高版本环境下运行 composer global require laravel/valet 命令时，有时会发现 illuminate/contracts 和 illuminate/container 这两个核心依赖被锁定在较旧的版本（例如 v5.4.36）。这通常是由于 Composer 在处理多版本兼容性声明时，默认倾向于选择最低兼容版本所致。
例如，Valet 可能声明其依赖于 illuminate/container 的 ~5.1|^6.0|^7.0|^8.0 版本，而 Composer 在没有明确指示的情况下，可能会选择 v5.4.36。在 PHP 8 环境中，这些旧版本的 illuminate 包包含大量已弃用的方法或不兼容的返回类型声明，导致在执行任何 valet 命令时，终端会输出大量的 Deprecated 警告，例如：
Deprecated: Return type of Illuminate\Container\Container::offsetExists($key) should either be compatible with ArrayAccess::offsetExists(mixed $offset): bool, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in /Users/lluismather/.composer/vendor/illuminate/container/Container.php on line 1159
或者：
立即学习“PHP免费学习笔记（深入）”；
Deprecated: Method ReflectionParameter::getClass() is deprecated in /Users/lluismather/.composer/vendor/illuminate/container/Container.php on line 788
尝试直接升级这些依赖（例如通过 composer global update illuminate/container）通常会导致依赖冲突错误，因为 Valet 自身的依赖声明与您尝试升级的目标版本之间存在间接冲突。
解决方案：强制指定全局 Illuminate 依赖版本
解决此问题的核心在于显式地在全局 composer.json 文件中指定一个与 PHP 8 兼容的 illuminate/container 版本，从而覆盖 Composer 的默认行为。
步骤一：定位并编辑全局 Composer 配置文件
首先，您需要找到并编辑您的全局 composer.json 文件。该文件通常位于您的用户主目录下的 .composer 文件夹中。
- macOS/Linux: ~/.composer/composer.json
- Windows: %APPDATA%\Composer\composer.json
使用您偏好的文本编辑器打开此文件。
步骤二：更新 illuminate/container 依赖版本
在 composer.json 文件的 require 部分，添加或修改 illuminate/container 的版本约束，使其指向一个与 PHP 8 兼容的较新主要版本，例如 ^8.0。如果您的 composer.json 中已经有 laravel/valet 和 laravel/installer 等全局依赖，请确保它们也被包含在内。
示例 composer.json 配置：
{
"require": {
"illuminate/container": "^8.0",
"laravel/installer": "^4.0",
"laravel/valet": "^2.0"
}
}请注意，^8.0 表示 Composer 将安装 illuminate/container 的 v8.x 系列的最新版本，只要它不引入破坏性更改。这确保了与 PHP 8 的兼容性。
步骤三：清理 Composer 缓存和依赖文件
为了确保 Composer 重新解析所有依赖并安装正确版本，您需要删除旧的锁定文件和供应商目录。
-
删除全局 composer.lock 文件：
rm ~/.composer/composer.lock
（Windows 用户请使用 del %APPDATA%\Composer\composer.lock）
-
删除全局 vendor 目录：
rm -rf ~/.composer/vendor
（Windows 用户请使用 rmdir /s /q %APPDATA%\Composer\vendor）
这些操作将强制 Composer 在下一步中从头开始构建依赖树。
步骤四：执行全局 Composer 更新
完成上述清理工作后，运行全局 Composer 更新命令：
composer global update
Composer 将会根据您修改后的 composer.json 文件重新解析依赖，并安装 illuminate/container 的 ^8.0 版本及其兼容的子依赖。这将解决因旧版本 illuminate 包引起的弃用警告。
注意事项与总结
- 版本兼容性： 确保您指定的 illuminate/container 版本与您的 PHP 版本以及其他全局安装的 Laravel 工具（如 laravel/installer）兼容。对于 PHP 8.x，^8.0 或更高版本通常是合适的选择。
- 全局依赖管理： 全局 Composer 依赖的管理需要谨慎。当遇到类似问题时，显式地在全局 composer.json 中定义特定依赖的版本是一个有效的解决方案。
- 问题出现时机： 有时，即使您已经使用 PHP 8 一段时间，此类问题也可能突然出现。这可能是由于某个全局依赖的更新，导致其间接依赖的解析行为发生变化，或 Composer 自身的更新策略调整。
- 其他依赖： 如果您遇到其他类似的弃用警告，且怀疑是由于某个特定包的旧版本引起，可以尝试类似的方法，在全局 composer.json 中明确指定该包的兼容版本。
通过以上步骤，您应该能够成功解决 Laravel Valet 在 PHP 8 环境下因旧版 illuminate/container 依赖导致的弃用警告，确保 Valet 能够稳定、无警告地运行。
