本文详解如何在 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
验证是否生效：
PowerLib图书馆门户小程序
下载
前后端完整代码包括本馆动态，新书来了，书籍榜单，服务指南，进馆预约，活动讲座预约等功能，采用腾讯提供的小程序云开发解决方案，无须服务器和域名 预约管理：开始/截止时间/人数均可灵活设置，可以自定义客户预约填写的数据项 预约凭证：支持线下到场后校验签到/核销/二维码自助签到等多种方式详尽的 预约数据：支持预约名单数据导出Excel，打印
立即学习“PHP免费学习笔记（深入）”；
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 运行环境，彻底解决因版本错配导致的应用兼容性问题。
