如何在本地环境正确运行 WordPress 网站-php教程-PHP中文网

如何在本地环境正确运行 WordPress 网站

仅凭 wp-content 文件夹、.htaccess 和一个自定义 site.php 文件无法直接运行 wordpress；必须补全核心文件（如 wp-admin、wp-includes、wp-config.php 等），并完成数据库配置与服务器环境搭建。

仅凭 wp-content 文件夹、.htaccess 和一个自定义 site.php 文件无法直接运行 wordpress；必须补全核心文件（如 wp-admin、wp-includes、wp-config.php 等），并完成数据库配置与服务器环境搭建。

WordPress 是一个完整的 PHP 内容管理系统，其运行依赖于严格组织的目录结构和初始化流程。你朋友提供的 wp-content（存放主题、插件、上传文件）、.htaccess（Apache 重写规则）和 site.php（非标准文件，可能是她自行编写的前端入口或静态页面）仅是网站的部分资产，并不构成可执行的 WordPress 实例。

✅ 正确搭建本地 WordPress 环境的步骤如下：

下载并部署官方 WordPress 核心
访问 wordpress.org/download/ 下载最新版 ZIP 包，解压至 XAMPP 的 htdocs 目录下（例如：C:\xampp\htdocs\my-site\）。确保目录中包含以下关键文件/夹：

wp-admin/
wp-includes/
wp-content/      ← 替换为你朋友提供的此文件夹（保留主题、插件、uploads）
wp-config.php    ← 必须新建并配置数据库连接
index.php
wp-load.php
.htaccess        ← 覆盖为你朋友提供的版本（如有自定义伪静态规则）

配置数据库与 wp-config.php
启动 XAMPP → 打开 https://www.php.cn/link/b6e61f3a46000af53590f293dcf35c20 → 创建新数据库（如 my-site-db，编码选 utf8mb4_unicode_ci）。
复制 wp-config-sample.php 为 wp-config.php，编辑以下字段：
```
define('DB_NAME', 'my-site-db');
define('DB_USER', 'root');
define('DB_PASSWORD', '');
define('DB_HOST', 'localhost');
```
⚠️ 若你朋友的网站使用了自定义表前缀（如 wp_abc_），请同步修改 table_prefix 值，并确保数据库中表名匹配。
迁移数据（关键！）
仅替换 wp-content 不足以还原网站——你还需导入原始数据库导出文件（通常是 .sql）。若朋友未提供，请提醒她导出 phpMyAdmin 中的完整数据库（含所有 wp_* 表）。导入后，检查 wp_options 表中的 siteurl 和 home 字段，将其更新为本地地址：
```
UPDATE wp_options SET option_value = 'http://localhost/my-site' WHERE option_name IN ('siteurl', 'home');
```
处理 site.php（非标准文件）
site.php 不属于 WordPress 核心，极可能是她绕过 WordPress 主循环的定制页面。如需保留，可将其重命名为 index-custom.php 并放入主题目录，再通过 WordPress 页面模板调用；或直接删除，确保 index.php 作为主入口正常加载 WordPress。

Publish Passwords
本地凭据保险库，集成操作系统密钥链，支持加密存储与会话级访问控制。

下载

? 注意事项总结：

XAMPP 版本建议 ≥ 8.0（兼容 PHP 8.0+ 的 WordPress 6.x）；
检查 wp-content/themes/ 下是否有激活主题，且 style.css 中 Template: 声明正确；
首次访问 http://localhost/my-site 将触发 WordPress 安装向导——若跳过该页却报错，请确认 wp-config.php 无语法错误且数据库已导入；
开启 Apache/MySQL 服务后，务必通过浏览器访问 http://localhost/my-site/wp-admin/ 验证后台是否可登录。

完成上述步骤后，你即可在本地安全编辑、调试并交付修改后的 WordPress 网站。