WordPress本地环境搭建方法

当前位置：首页 > WordPress建站 > WordPress本地环境搭建方法

详情介绍

WordPress本地环境搭建方法是在个人电脑上安装XAMPP、LocalWP或Laragon等集成Web服务器环境，创建MySQL数据库并放置WordPress程序文件，通过浏览器运行安装向导完成本地站点配置。

使用XAMPP搭建WordPress本地环境

下载与安装XAMPP

访问Apache Friends官网，根据操作系统选择对应版本的XAMPP安装包，下载完成后双击安装程序，在选择组件时至少保留Apache、MySQL、PHP和phpMyAdmin四项，安装路径建议使用默认路径，例如Windows系统中的C:\xampp，这样可以减少后续配置路径出错的可能性，安装过程中如果系统提示端口占用或权限问题，可以暂时忽略，安装完成后在控制面板中统一处理。

启动Apache与MySQL服务

打开XAMPP控制面板,找到Apache和MySQL对应的Start按钮并点击，等待状态指示灯变为绿色，表示服务已经正常启动，如果Apache无法启动，多数情况下是80端口被其他程序占用，可以点击Apache行的Config按钮，选择httpd.conf，将Listen 80修改为Listen 8080，保存后重新启动Apache，此时本地站点访问地址需要加上端口号，例如http://localhost:8080。

WordPress本地环境搭建方法第1张

创建WordPress数据库

浏览器访问http://localhost/phpmyadmin，进入phpMyAdmin管理界面，点击顶部“数据库”选项卡，在“新建数据库”输入框中填写数据库名称，例如wordpress_local，排序规则选择utf8mb4_general_ci，然后点击“创建”，数据库创建成功后，左侧列表会出现对应的数据库名称，WordPress安装时需要使用这个数据库名称。

下载并部署WordPress程序

访问WordPress官方网站下载最新版WordPress压缩包,下载完成后解压，将解压出来的wordpress文件夹内的所有文件复制到XAMPP的网站根目录下的自定义文件夹中，例如在C:\xampp\htdocs中新建一个名为wp-local的文件夹，将WordPress文件全部复制进去，复制完成后目录结构应该包含wp-admin、wp-content、wp-includes等文件夹以及wp-config-sample.php等文件。

修改wp-config.php配置文件

进入C:\xampp\htdocs\wp-local目录，找到wp-config-sample.php文件，复制一份并重命名为wp-config.php，使用代码编辑器打开wp-config.php，找到数据库配置部分，修改为以下内容：

define('DB_NAME','wordpress_local');
define('DB_USER','root');
define('DB_PASSWORD','');
define('DB_HOST','localhost');
$table_prefix='wp_';

XAMPP默认MySQL用户名为root,密码为空，数据库主机为localhost，保存文件时确保编码为UTF-8无BOM格式，避免后续出现字符乱码问题。

运行WordPress安装向导

浏览器访问http://localhost/wp-local，如果修改了Apache端口则访问http://localhost:8080/wp-local，页面会显示语言选择界面，选择简体中文后点击继续，接着WordPress会提示需要数据库信息，点击“开始安装”，在安装表单中填写站点标题、管理员用户名、密码和电子邮件地址，这些信息用于登录WordPress后台，建议使用独立且安全的密码，填写完成后点击“安装WordPress”，安装成功后会出现登录按钮，点击登录进入http://localhost/wp-local/wp-admin，输入管理员账号密码即可进入WordPress后台。

使用LocalWP搭建WordPress本地环境

下载安装LocalWP

访问LocalWP官方网站,根据操作系统下载安装包，LocalWP支持Windows、macOS和Linux，安装完成后启动LocalWP，首次启动可能需要等待环境初始化完成。

创建新站点

在LocalWP主界面点击“Create a new site”按钮，选择站点类型时保持默认的“Standard”环境即可，LocalWP会自动配置PHP、MySQL和Nginx，输入站点名称，例如mysite，然后点击继续。

设置WordPress管理员信息

LocalWP会要求设置WordPress管理员用户名、密码和邮箱，设置完成后点击“Add Site”，LocalWP会自动下载WordPress核心文件、创建数据库并配置虚拟主机，整个过程通常只需要十几秒。

访问站点与后台

站点创建完成后,在LocalWP站点列表中找到对应站点，点击“Open Site”访问前台页面，点击“WP Admin”直接进入WordPress后台，LocalWP还提供一键开启SSL、切换PHP版本、导入导出站点等功能，适合需要频繁创建测试站点的场景。

使用Laragon快速搭建WordPress本地环境

下载安装Laragon

访问Laragon官网下载Windows版本安装包,Laragon体积较小，安装过程简单，安装完成后启动主界面。

使用Quick App创建WordPress

在Laragon主界面点击“Quick app”按钮，选择WordPress选项，输入项目名称，例如myblog，Laragon会自动创建项目目录、下载WordPress核心文件并建立对应数据库。

访问安装向导

Laragon默认使用.test后缀的本地域名，浏览器访问http://myblog.test，根据页面提示选择语言并填写站点信息，完成WordPress安装，Laragon的数据库默认用户名和密码均为root，主机为localhost。

使用Docker Compose搭建WordPress本地环境

Docker方式适合需要统一开发环境的团队,创建一个docker-compose.yml如下：

version:'3'
services:
db:
image:mysql:8.0
environment:
MYSQL_DATABASE:wordpress
MYSQL_USER:wordpress
MYSQL_PASSWORD:wordpress
MYSQL_ROOT_PASSWORD:root
wordpress:
image:wordpress:latest
ports:
-"8000:80"
environment:
WORDPRESS_DB_HOST:db:3306
WORDPRESS_DB_USER:wordpress
WORDPRESS_DB_PASSWORD:wordpress
WORDPRESS_DB_NAME:wordpress
depends_on:
-db

在文件所在目录执行docker-compose up -d命令，等待镜像拉取和容器启动完成，浏览器访问http://localhost:8000即可进入WordPress安装界面，MySQL数据库信息与Compose文件中的环境变量保持一致即可完成连接。

本地环境常见问题与处理

端口冲突解决

Apache默认使用80端口,MySQL默认使用3306端口，如果这两个端口被其他软件占用，服务会启动失败，处理方法是修改Apache监听端口或停止占用端口的程序，XAMPP中修改httpd.conf的Listen指令即可更换端口，访问地址需要同步加上新端口号。

数据库连接错误

安装WordPress时如果提示数据库连接失败,先检查wp-config.php中的数据库名、用户名、密码和主机名是否正确，确认MySQL服务已经启动，再用phpMyAdmin验证数据库是否存在，XAMPP环境默认root密码为空，如果之前修改过root密码，需要同步更新配置文件。

文件权限问题

在macOS或Linux系统中,WordPress的wp-content目录需要可写权限用于上传插件和媒体文件，执行以下命令调整权限：

sudochmod-R755wp-content
sudochown-Rwww-data:www-datawp-content

本地环境如果使用当前用户运行Web服务器,也可以将目录所有者改为当前用户。

上传文件大小限制

WordPress上传主题或插件时如果提示文件超过限制,需要修改php.ini中的upload_max_filesize和post_max_size参数，XAMPP中该文件位于C:\xampp\php\php.ini，将两个参数值改为64M或更大，保存后重启Apache服务生效。