宝塔面板暂不原生支持PHP 8.4的Docker镜像，需通过官方PHP镜像自定义构建：可选用php:8.4-cli或php:8.4-fpm-alpine基础镜像，安装扩展、配置时区与opcache，结合Nginx/MySQL用Docker Compose编排，或挂载至宝塔站点目录实现混合部署。
如果您希望在Docker环境中运行宝塔面板所支持的PHP 8.4版本，需注意宝塔官方目前尚未原生提供PHP 8.4的Docker镜像，且宝塔面板本身并非为容器化场景深度优化。以下是基于Docker容器化部署PHP 8.4并模拟宝塔常用运行环境的操作说明：
一、使用官方PHP 8.4-cli基础镜像构建运行环境
该方法跳过宝塔面板依赖，直接以轻量方式运行PHP 8.4，适用于仅需执行PHP脚本或搭建简单Web服务的场景。镜像源自php:8.4-cli官方源，具备完整扩展编译能力。
1、创建Dockerfile文件，内容如下：
FROM php:8.4-cli
立即学习“PHP免费学习笔记（深入）”；
2、安装常用扩展与工具：
RUN apt-get update && apt-get install -y libpng-dev libjpeg-dev libfreetype-dev libxml2-dev libzip-dev zip unzip curl git && rm -rf /var/lib/apt/lists/*
3、启用核心扩展：
RUN docker-php-ext-configure gd --with-freetype --with-jpeg && docker-php-ext-install -j$(nproc) gd mbstring pdo pdo_mysql mysqli opcache xml zip
4、复制项目代码至容器内/public目录：
COPY ./src /var/www/public
5、设置工作目录并暴露端口：
WORKDIR /var/www/public
EXPOSE 9000
二、基于Alpine Linux构建精简PHP 8.4-FPM镜像
该方案面向Nginx反向代理场景，采用alpine基础镜像降低体积，适合资源受限环境。PHP以FPM模式运行，可与宿主机Nginx或Docker内Nginx容器协同工作。
1、拉取php:8.4-fpm-alpine官方镜像：
docker pull php:8.4-fpm-alpine
2、编写自定义php.ini配置片段并挂载：
echo "date.timezone = Asia/Shanghai" > /tmp/php.ini
3、启动容器并绑定配置与代码目录：
docker run -d --name php84-fpm \
-v $(pwd)/src:/var/www/html \
-v $(pwd)/php.ini:/usr/local/etc/php/conf.d/timezone.ini \
-p 9000:9000 \
php:8.4-fpm-alpine
4、确认PHP进程状态：
docker exec php84-fpm ps aux | grep php-fpm
三、通过Docker Compose整合Nginx + PHP 8.4-FPM + MySQL
该方法构建完整LAMP-like栈，模拟宝塔中网站、数据库、PHP服务共存的典型结构，各组件隔离运行，便于调试与复用。
1、创建docker-compose.yml文件，定义三个服务：
version: '3.8'
services:
image: nginx:alpine
ports: ["80:80"]
volumes: [./src:/var/www/html, ./nginx.conf:/etc/nginx/nginx.conf]
php:
image: php:8.4-fpm
volumes: [./src:/var/www/html]
mysql:
image: mysql:8.0
environment: [MYSQL_ROOT_PASSWORD=root123]
volumes: [./mysql-data:/var/lib/mysql]
2、准备最小化nginx.conf，启用fastcgi_pass指向php服务：
location ~ \.php$ {
fastcgi_pass php:9000;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME /var/www/html$fastcgi_script_name;
}
3、执行启动命令：
docker-compose up -d
4、验证PHP信息页是否可访问：
echo "" > ./src/index.php
四、在现有宝塔宿主机上运行PHP 8.4容器并挂载站点目录
该方法保留宝塔面板作为管理入口，仅将PHP解析交由独立容器处理，实现“面板托管+容器执行”的混合模式，避免直接修改宝塔内置PHP环境。
1、确认宝塔站点根目录路径（如/www/wwwroot/example.com）：
2、启动PHP 8.4容器并映射该目录：
docker run -d --name bt-php84 \
-v /www/wwwroot/example.com:/var/www/html \
-v /www/server/php/84/etc/php.ini:/usr/local/etc/php/php.ini:ro \
-p 9001:9000 \
php:8.4-fpm
3、进入宝塔面板，编辑对应站点的PHP版本设置：
在“网站”→“设置”→“PHP版本”中选择纯静态（手动指定PHP-FPM地址），填入127.0.0.1:9001
4、重启该站点服务使配置生效：
宝塔后台点击“重载配置”按钮
五、使用自定义构建脚本一键生成含宝塔兼容配置的PHP 8.4镜像
该方法通过shell脚本自动化集成宝塔常用PHP扩展参数、opcache预设、错误日志路径等，生成专用于宝塔容器化迁移的定制镜像。
1、创建build_php84.sh脚本：
#!/bin/bash
docker build -t my-php84:latest \
--build-arg PHP_VERSION=8.4 \
-f Dockerfile.php84 .
2、Dockerfile.php84中声明构建参数并加载宝塔风格配置：
ARG PHP_VERSION
FROM php:${PHP_VERSION}-fpm
3、复制宝塔默认php.ini模板并覆盖关键项：
COPY php.ini.template /usr/local/etc/php/php.ini
RUN sed -i 's/memory_limit =.*/memory_limit = 512M/' /usr/local/etc/php/php.ini &&
sed -i 's/max_execution_time =.*/max_execution_time = 300/' /usr/local/etc/php/php.ini
4、启用宝塔常用扩展（如fileinfo、imap、exif）：
RUN docker-php-ext-install fileinfo imap exif
5、执行构建命令：
chmod +x build_php84.sh && ./build_php84.sh
