Mac上使用Docker快速搭建WordPress开发环境指南

来自:素雅营销研究院

头像 方知笔记
2025年07月04日 03:56

前言

对于Mac用户来说,Docker提供了一种轻量级、高效的解决方案来搭建WordPress开发环境。相比传统的本地安装方式,Docker容器化部署可以避免环境配置的复杂性,实现快速搭建和销毁,特别适合开发者和初学者使用。

准备工作

  1. 安装Docker Desktop:前往Docker官网下载适合Mac的版本并安装
  2. 确保系统资源:建议至少分配4GB内存给Docker(可在Docker设置中调整)
  3. 基本终端操作知识:需要熟悉基本的命令行操作

详细搭建步骤

第一步:创建项目目录

mkdir wordpress-docker && cd wordpress-docker

第二步:创建docker-compose.yml文件

version: '3'

services:
db:
image: mysql:5.7
volumes:
- db_data:/var/lib/mysql
restart: always
environment:
MYSQL_ROOT_PASSWORD: your_root_password
MYSQL_DATABASE: wordpress
MYSQL_USER: wordpress
MYSQL_PASSWORD: wordpress

wordpress:
depends_on:
- db
image: wordpress:latest
ports:
- "8000:80"
restart: always
environment:
WORDPRESS_DB_HOST: db:3306
WORDPRESS_DB_USER: wordpress
WORDPRESS_DB_PASSWORD: wordpress
WORDPRESS_DB_NAME: wordpress
volumes:
- ./wp-content:/var/www/html/wp-content

volumes:
db_data:

第三步:启动容器

docker-compose up -d

首次运行会自动下载所需的镜像(WordPress和MySQL),这可能需要几分钟时间。

第四步:访问WordPress

在浏览器中打开:

http://localhost:8000

按照WordPress的安装向导完成初始设置。

常见问题解决

  1. 端口冲突:如果8000端口被占用,可以修改docker-compose.yml中的端口映射,如”8080:80”
  2. 权限问题:如果出现文件权限错误,可以尝试:
sudo chmod -R 777 wp-content
  1. 容器启动失败:使用docker-compose logs查看具体错误信息

开发环境优化建议

  1. 使用Xdebug:在docker-compose.yml中添加Xdebug配置,方便调试PHP代码
  2. 配置本地域名:修改hosts文件,为项目绑定本地域名(如wordpress.local)
  3. 定期备份:使用docker-compose down -v会删除数据库,重要数据应定期导出备份

结束语

通过Docker搭建WordPress环境,Mac用户可以轻松获得一个隔离、干净的开发环境,无需担心影响本地系统配置。当项目不再需要时,只需运行docker-compose down -v即可彻底清理,保持系统整洁。这种方法特别适合同时开发多个WordPress项目或需要频繁切换环境的开发者。

希望本指南能帮助您快速在Mac上建立WordPress开发环境,如有任何问题,欢迎查阅Docker官方文档或相关社区资源。