PHP框架必须用Docker而非一键环境，因其通过镜像固化PHP版本、扩展、Web服务器及依赖库，实现跨Ubuntu/CentOS/macOS三环境一致部署；一键环境共用全局配置，无法隔离多项目且不支持macOS等平台，而Docker镜像可原样运行于M1 Mac、Ubuntu云服务器及WSL2，配合docker-compose一键启停，彻底解决环境差异与配置漂移问题。
你需要把PHP框架应用部署到开发、测试、生产三套环境，且每套环境操作系统不同（Ubuntu、CentOS、macOS），手动配置极易出错，容器化能一次性解决跨平台一致性问题。
为什么PHP框架必须用Docker而不是一键环境
一键环境（如宝塔、XAMPP）直接在宿主机安装服务，多个项目共用同一PHP版本和扩展，切换项目就得改全局配置；而Docker为每个PHP框架应用打包专属运行时，【PHP版本、扩展、Web服务器、依赖库全部固化在镜像里】，换台机器只需docker-compose up -d，不用重装、不改配置、不担心openssl或pdo_mysql漏装。
宝塔面板在CentOS上能跑，在macOS根本装不了；Docker镜像却能在MacBook M1、Ubuntu云服务器、Windows WSL2上原样运行。
构建最小可行PHP-FPM镜像
方法一：基于官方php:8.2-fpm精简构建
立即学习“PHP免费学习笔记（深入）”；
第一步：在项目根目录新建Dockerfile，内容如下：
FROM php:8.2-fpm<br>RUN docker-php-ext-install pdo mysqli opcache<br>COPY . /var/www/html<br>WORKDIR /var/www/html<br>EXPOSE 9000
这一步跳过Apache/Nginx——PHP-FPM只负责处理PHP逻辑，Web服务器交给独立容器，避免臃肿和端口冲突。
方法二：用alpine镜像进一步瘦身
把第一行改成FROM php:8.2-fpm-alpine，体积从320MB压到120MB左右，但注意：alpine用musl libc，某些扩展（如sqlsrv）不兼容，【Laravel/Slim/CodeIgniter等主流框架默认扩展均支持】。
用docker-compose编排Nginx+PHP+MySQL三件套
新建docker-compose.yml，定义三个服务：
version: '3.8'<br>services:<br> nginx:<br> image: nginx:alpine<br> ports:<br> - "80:80"<br> volumes:<br> - ./nginx.conf:/etc/nginx/conf.d/default.conf<br> depends_on:<br> - php<br> php:<br> build: .<br> volumes:<br> - .:/var/www/html<br> mysql:<br> image: mysql:8.0<br> environment:<br> MYSQL_ROOT_PASSWORD: root<br> volumes:<br> - db_data:/var/lib/mysql
其中nginx.conf需明确将.php请求代理到php:9000，否则Nginx只会返回源码不执行——这是新手最常踩的坑。
执行docker-compose up -d后，访问http://localhost即可看到PHP框架首页，数据库连接自动指向mysql服务名（非localhost）。
注入环境变量解耦配置
方法一：通过.env文件注入
在docker-compose.yml的php服务下加：
environment:<br> - APP_ENV=production<br> - DB_HOST=mysql<br> - DB_PORT=3306
再建.env文件写入DB_PASSWORD=secret，然后在php服务中追加：
env_file:<br> - .env
方法二：运行时覆盖（适合CI/CD）
启动时加参数：docker-compose run --rm php php artisan config:cache，此时.env里的值会覆盖容器内默认配置，【.env文件不能提交到Git，必须加入.gitignore】。
多阶段构建压缩镜像体积
步骤一：用builder阶段安装Composer并下载依赖
FROM php:8.2-cli AS builder<br>RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer<br>COPY composer.json composer.lock ./<br>RUN composer install --no-dev --optimize-autoloader
步骤二：用运行阶段仅复制已安装的vendor
FROM php:8.2-fpm-alpine<br>COPY --from=builder /app/vendor /var/www/html/vendor<br>COPY . /var/www/html<br>WORKDIR /var/www/html
最终镜像体积比单阶段减少60%，CI流水线构建时间缩短近一半。
