Docker 升级 phpStudy 环境完整教程:镜像拉取到版本切换实操
核心结论
phpStudy这个东西, 它本来就是给Windows系统用的本地集成环境。所以呢, 它并不直接支持你在控制面板里面去升级Docker这个事。


但如果你是真的有需求, 想要把原来放在phpStudy里面的那些个东西, 比方说PHP、MySQL, 还有Apache或者是Nginx这些组件, 都弄成用Docker容器的方式来跑。并且在这个过程中还需要把它们的版本给升级一下的话。
那你就可以按照这篇文章里写的步骤去做事情。适用场景包括, 当需要把PHP的版本进行跨大版本的升级的时候(比如从7.4升级到8.2), 或者在MySQL的版本从5.7升到8.0的时候, 又或者是希望把本地的环境做成为容器化的形式, 以便能够与线上的状态来进行对齐。
前置条件
Docker Desktop这个软件已经被安装好了, 在Windows这个系统里面, 如果需要正常运行的话, 得把WSL2这个后端给开启起来。

原先的站点代码还有数据库, 都已经备份好了, 具体来说就是sql数据库通过导出操作完成了备份, 还有文件压缩包。
你需要确认一下目标版本的 PHP 是不是和这个项目里用到的框架能够互相兼容。比如说 ThinkPHP 6 这个框架, 它就要求用的 PHP 版本必须是 7.1 或者更后面的版本。再比如 Laravel 10 这个品牌的产品, 它要求必须用到 8.1 或更高的 PHP 版本才行。
操作步骤
第一步:拉取目标镜像
你要先打开终端应用程序, 然后再去执行下面这些命令, 目的就是为了获取到与指定版本相对应的那一个来自官方的镜像文件。

# PHP 8.2 + Apache
docker pull php:8.2-apache
# MySQL 8.0
docker pull mysql:8.0
# 若需 Nginx + PHP-FPM 组合
docker pull nginx:1.25
docker pull php:8.2-fpm
第二步:配置容器网络与数据卷
在 phpStudy 原网站目录旁边, 新建出一个文件, 这个文件的名称是 docker-compose.yml。
services:
web:
image: php:8.2-apache
ports:
"8080:80"
volumes:
./project:/var/www/html # 挂载原站点代码
depends_on:
db
db:
image: mysql:8.0
environment:
MYSQL_ROOT_PASSWORD: yourpass
MYSQL_DATABASE: demo_wp
ports:
"3306:3306"
volumes:
dbdata:/var/lib/mysql
volumes:
dbdata:
将 ./project 指向原 phpStudy 的 WWWdemo 目录(Windows 路径在 WSL2 下挂载为 /mnt/d/...,建议将代码复制到 WSL2 文件系统内以规避 I/O 性能问题)。
第三步:导入原数据库并启动
# 启动容器
docker compose up -d
# 将原 phpStudy 导出的 SQL 导入新 MySQL
docker exec -i db mysql -uroot -pyourpass demo_wp < demo_wp_backup.sql
完成启动操作以后, 你需要访问 http://localhost:8080 这个地址, 然后来确认一下站点是不是处于正常运行的状态。
第四步:修改应用配置
你要先进入那个站点的目录里面去, 然后去找数据库连接配置的信息, 这些信息可能是在名为wp-config.php的文件里或者是在名为config/database.php的文件里面找到, 接着你就要把里面填写的主机名字改成 db 这个形式, 因为这是容器服务的名字的意思, 再把端口号设置成是 3306 , 最后还要确保里面的用户密码和之前的 compose 文件里的内容是完全一样的情况出现之后, 你记得先把文件保存好然后再把这个页面进行刷新操作。
验证与常见故障
| 现象 | 排查 |
|---|---|
| 容器启动后 8080 无响应 | docker logs web 查看 Apache 错误日志,确认文档根目录挂载正确 |
| 数据库连接 refused | 确认 compose 中服务名与代码配置一致,非 localhost |
| PHP 扩展缺失 | 镜像默认不含 gd、mbstring、intl,需自定义 Dockerfile 安装 |
| 文件写入 403 | 检查挂载目录权限,chmod 775 或映射当前用户 UID |
注意事项
这个本地的环境呢, 它仅仅是用来进行开发以及联调工作的, 所以是不可以被直接暴露到公网上去的。

在完成升级操作之后, 处于phpStudy面板里的旧的PHP以及MySQL服务是可以选择进行停止动作的, 这样做的目的是为了防止端口冲突的情况发生, 所涉及到的具体端口是80以及3306这两个。
如果往后有需要退回去, 那么只要把原来的那个 phpStudy 的目录给留着就行, 同时呢, 还要把那数据库的备份文件也保留下来。
常见问题
《Docker 升级 phpStudy 环境完整教程:镜像拉取到版本切换实操》主要讲什么?
phpStudy这个东西, 它本来就是给Windows系统用的本地集成环境。所以呢, 它并不直接支持你在控制面板里面去升级Docker这个事。
文章提到了哪些重点?
Docker Desktop这个软件已经被安装好了, 在Windows这个系统里面, 如果需要正常运行的话, 得把WSL2这个后端给开启起来;
文章给出了哪些建议?
你需要确认一下目标版本的 PHP 是不是和这个项目里用到的框架能够互相兼容。
核心结论怎么样?
phpStudy这个东西, 它本来就是给Windows系统用的本地集成环境。所以呢, 它并不直接支持你在控制面板里面去升级Docker这个事。