正确做法是先创建项目再修改 docker-compose.yml 中 services.app.image 或 build.context，改完需执行 sail down -v && sail up --build；PHP 扩展应通过复制 .so 文件至 /var/www/docker/php/ext/ 并配 .ini 启用，避免运行时安装。
composer create-project 时怎么指定 Sail 自定义镜像
默认 composer create-project laravel/laravel 用的是官方基础镜像，不支持直接换镜像。Sail 的镜像配置不在 Composer 阶段生效，而是在项目初始化后、首次运行 sail up 时才读取 docker-compose.yml。所以别在 create-project 命令里加参数想换镜像——它根本不管那套。
正确做法是：先拉下项目，再改 docker-compose.yml 里的 build.context 或 image 字段。
- 如果想用自己构建的 PHP 镜像，把
services.app.image改成你的镜像名，比如my-laravel-php:8.2 - 如果想本地定制 Dockerfile，把
services.app.build.context指向你放 Dockerfile 的目录（如./docker/php），并确保该目录下有Dockerfile - 改完必须删掉旧容器和镜像：
sail down -v，否则 Docker 会复用缓存，新配置不生效
如何在 Sail 的 Dockerfile 中安全添加 PHP 扩展
Sail 默认用的是 Laravel 官方维护的 laravelsail/phpXX 基础镜像，它禁用了 pecl install 和部分编译工具。直接写 pecl install redis 会失败，报错类似 command not found: pecl 或 configure: error: unrecognized options: --with-redis。
推荐方式是沿用基础镜像的扩展机制：它预留了 /var/www/docker/php/conf.d/ 和 /var/www/docker/php/ext/ 两个挂载点，支持通过复制预编译好的 .so 文件 + .ini 启用扩展。
立即学习“PHP免费学习笔记（深入）”；
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先确认你要装的扩展是否已在官方镜像中提供：查 laravel/sail runtimes 目录，比如
8.2版本已内置redis、opcache、gd等，只需在docker-compose.yml的environment里加PHP_EXTENSIONS=redis,opcache - 若要装未内置的扩展（如
grpc），得自己编译：基于官方镜像写多阶段 Dockerfile，在 build 阶段装依赖、编译，再 COPY.so到最终镜像的/var/www/docker/php/ext/ - 切勿在运行时用
sail artisan tinker或sail bash里手动apt-get install—— 容器重启就丢，且破坏镜像一致性
修改 sail up 后 PHP 不加载自定义扩展的常见原因
明明改了 Dockerfile、也 COPY 了 .so 和 .ini，但 php -m | grep xxx 就是看不到，大概率卡在这几个地方：
-
.ini文件名必须以.ini结尾，且不能含大写字母或空格；内容里extension=xxx.so的路径要写对，推荐用绝对路径或直接写扩展名（PHP 会自动在extension_dir下找） - 检查
php -i | grep "extension_dir"输出的路径，确认你的.so确实放在那儿；Sail 默认是/usr/lib/php/20220829（PHP 8.2）这类版本号路径，不是/usr/lib/php/extensions/ -
docker-compose.yml里volumes:挂载覆盖了/var/www/docker/php/ext或/etc/php/8.2/cli/conf.d/？挂载会屏蔽镜像内文件，导致你的.ini根本没被读到 - 执行
sail down -v && sail up --build，漏掉--build就不会重新构建镜像，改了 Dockerfile 也白搭
为什么不要在 .env 中用 SAIL_PHP_VERSION 切换镜像版本
SAIL_PHP_VERSION 这个环境变量只在 composer create-project 创建项目时被 Sail 的安装脚本读取一次，用于决定生成哪个 docker-compose.yml 模板。一旦项目建好，它就彻底失效了。
后续你改 .env 里的 SAIL_PHP_VERSION=8.3，sail up 依然用原来生成的 docker-compose.yml，里面的 image: laravelsail/php82 不会自动变成 php83。
- 真要升级 PHP 版本，应该手动编辑
docker-compose.yml，把所有laravelsail/php82替换成laravelsail/php83 - 同时检查
./docker/php/Dockerfile（如果存在）是否仍基于旧版本基础镜像，比如FROM laravelsail/php82:latest得同步改掉 - 注意 PHP 主版本升级可能带来扩展 ABI 不兼容，比如
igbinary在 8.2 和 8.3 编译的.so不能混用
最易被忽略的是：Docker 镜像层缓存会让旧构建残留，哪怕改了所有配置，不清理 docker system prune -a（慎用）或至少 docker builder prune，就可能跑着“看似新实则旧”的环境。
