LaravelSail配置PHP版本教程

“纵有疾风来，人生不言弃”，这句话送给正在学习文章的朋友们，也希望在阅读本文《Laravel Sail 指定 PHP 版本配置教程》后，能够真的帮助到大家。我也会在后续的文章中，陆续更新文章相关的技术文章，有好的建议欢迎大家在评论留言，非常感谢！

本文详解如何在 Laravel Sail 中正确指定并使用 PHP 8.0（而非默认的 8.1），包括 docker-compose.yml 与 Dockerfile 的关键配置、镜像重建命令及常见踩坑提示。

Laravel Sail 默认使用 PHP 8.1 运行环境，即使你本地 docker-compose.yml 中指定了 ./docker/8.0 上下文，若该路径并非 Sail 官方维护的运行时目录（如 ./vendor/laravel/sail/runtimes/8.0），Docker 构建仍可能拉取或继承错误的基础镜像，最终导致 php -v 显示为 PHP 8.1.2 —— 这正是你遇到问题的根本原因。

✅ 正确配置步骤

首先，确保 docker-compose.yml 中 laravel.test 服务的 build.context 指向 Sail 官方提供的标准 PHP 8.0 运行时路径：

services:
    laravel.test:
        build:
            context: ./vendor/laravel/sail/runtimes/8.0  # ✅ 关键：必须是此路径
            dockerfile: Dockerfile
            args:
                WWWGROUP: '${WWWGROUP}'
        image: sail-8.0/app  # ✅ 建议同步更新镜像名，避免缓存混淆
        # ... 其余配置保持不变

⚠️ 注意：不要自建 ./docker/8.0 目录并复制官方 Dockerfile —— Sail 的构建逻辑依赖于 vendor/laravel/sail/ 下的运行时结构，且其 Dockerfile 中通过 FROM laravelphp/sail-runtime:8.0 显式声明基础镜像，该镜像由 Laravel 团队持续维护并保证 PHP 版本准确性。

? 重建容器前必做清理

Sail 构建高度依赖 Docker 层级缓存。若此前已用 PHP 8.1 构建过镜像，仅执行 sail build 可能复用旧层，导致版本未更新。请务必执行：

# 彻底清除旧镜像与构建缓存
sail build --no-cache

# 可选：删除旧容器与卷（确保无残留）
sail down -v

# 启动新环境
sail up -d

验证是否生效：

sail php -v
# 输出应为：PHP 8.0.x (cli) (built: ...)

? 补充建议

• 检查 Sail 版本兼容性：运行 composer show laravel/sail，确保你使用的是 Sail v1.19.0+（对 PHP 8.0 支持更稳定）。如版本过低，升级：composer update laravel/sail。
• 避免 .env 干扰：确认 .env 中未设置 SAIL_PHP_VERSION=8.1 等非标准变量 —— Sail 当前不读取该变量，仅依赖 docker-compose.yml 配置。
• IDE 调试注意：若启用 Xdebug，请同步检查 SAIL_XDEBUG_MODE 和 SAIL_XDEBUG_CONFIG 是否与 PHP 8.0 兼容（官方 runtime 已预配置适配）。

通过以上标准化配置与强制重建流程，即可精准锁定 PHP 8.0 运行环境，彻底解决因版本错配导致的应用兼容性问题。

好了，本文到此结束，带大家了解了《LaravelSail配置PHP版本教程》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！