PHP文件不能直接转为镜像，必须通过Dockerfile定义PHP版本、安装扩展、复制代码至/var/www/html、暴露80端口并启动Apache服务。
PHP文件怎么用Dockerfile打包成镜像
直接说结论：PHP 文件本身不能“转成”镜像，必须靠 Dockerfile 描述运行环境 + 复制代码 + 启动服务，最终构建出可运行的镜像。别想着一键转换，核心是定义好 PHP 版本、扩展、Web 服务器（如 Apache 或 Nginx + PHP-FPM）、以及你的代码如何挂载或复制进去。
写 Dockerfile 要包含哪几块关键内容
一个最小可用的 PHP 镜像 Dockerfile 必须覆盖这四件事：
- 基础镜像选对：优先用官方
php:8.2-apache或php:8.2-fpm，别从debian从零编译——费时、易错、镜像臃肿 - 装扩展要显式：比如需要 MySQL 支持，就得加
RUN docker-php-ext-install mysqli pdo pdo_mysql；ext-opcache建议开启，但得配opcache.revalidate_freq=0开发时才不缓存 PHP 文件 - 代码放对位置：Apache 镜像默认 Web 根目录是
/var/www/html，用COPY . /var/www/html/把当前目录 PHP 文件复制进去；注意.包含Dockerfile自身，建议加.dockerignore排除node_modules、vendor（如果本地已装）、.git - 暴露端口 & 启动服务：Apache 镜像默认监听
80，所以EXPOSE 80是声明，不是必须；但如果你换用php:fpm，就得配 Nginx 反向代理，且EXPOSE 9000才有意义
常见报错和对应改法
构建或运行时报错，八成卡在这几个点：
-
Fatal error: Uncaught Error: Call to undefined function mysqli_connect()→ 没装mysqli扩展，补上RUN docker-php-ext-install mysqli并RUN docker-php-ext-enable mysqli（后者在新版 PHP 镜像里通常自动） -
Warning: require(/var/www/html/vendor/autoload.php): failed to open stream→ 你把本地vendor复制进去了，但 Composer 依赖没在容器内装；要么删掉vendor，改用RUN composer install --no-dev（需先COPY composer.json composer.lock .），要么用多阶段构建分离构建与运行环境 -
Forbidden You don't have permission to access this resource.→ Apache 默认拒绝访问非index.php或无权限目录；检查COPY后文件权限（Linux 下www-data用户需有读权限），或加RUN chown -R www-data:www-data /var/www/html - 本地改了 PHP 文件，容器里没更新 → 没用
docker run -v $(pwd):/var/www/html挂载，而是用COPY构建的静态镜像；开发阶段推荐挂载，生产再 COPY
build 和 run 的命令怎么写才不踩坑
构建和启动命令看着简单，参数错一个就白忙：
立即学习“PHP免费学习笔记（深入）”；
- 构建：
docker build -t my-php-app .—— 注意最后的.是上下文路径，不是当前目录下某个文件；如果Dockerfile不叫这个名字，得加-f MyDockerfile - 运行：
docker run -d -p 8080:80 --name php-test my-php-app—— 端口映射顺序是宿主机:容器，别写反；-d后台运行，方便后续docker logs php-test查 Apache 启动日志 - 验证是否真跑起来：
curl -I http://localhost:8080看返回HTTP/1.1 200 OK，而不是Connection refused；后者大概率是容器没启动成功，或者 Apache 进程崩了（查docker logs php-test） - 临时进容器调试：
docker exec -it php-test bash，然后手动执行ps aux | grep apache或php -v确认环境
最常被忽略的是：PHP 镜像里的时区默认是 UTC，date() 输出会错；要在 Dockerfile 加一句 ENV TZ=Asia/Shanghai && ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone。还有就是 session 存储路径权限问题——/var/lib/php/sessions 目录得让 www-data 可写，否则登录态总丢。
