0

0

如何正确将 WordPress 部署到 XAMPP 的 Apache 服务器中

心靈之曲

心靈之曲

发布时间:2026-03-13 15:19:09

|

976人浏览过

|

来源于php中文网

原创

如何正确将 WordPress 部署到 XAMPP 的 Apache 服务器中

本文详解 xampp 环境下 wordpress “404 not found” 错误的根源与解决方案,重点纠正 zip 文件未解压直传、目录结构错误等常见新手误区,并提供完整部署验证步骤。

本文详解 xampp 环境下 wordpress “404 not found” 错误的根源与解决方案,重点纠正 zip 文件未解压直传、目录结构错误等常见新手误区,并提供完整部署验证步骤。

在使用 XAMPP 搭建本地 WordPress 开发环境时,许多初学者会遇到如下典型错误页面:

Not Found
The requested URL was not found on this server.
Apache/2.4.52 (Win64) OpenSSL/1.1.1m PHP/8.1.4 Server at localhost Port 80

当你访问 http://localhost/wordpress 或 http://localhost:80/wordpress 却看到该提示,核心原因几乎总是:WordPress 安装包未正确解压并部署至 htdocs 目录下——而非 Apache、PHP 或端口配置问题。

✅ 正确部署步骤(以 Windows + XAMPP 为例)

  1. 确认 XAMPP 已正常启动 Apache(且 MySQL 可选)
    打开 XAMPP Control Panel → 启动 Apache(绿色 Running 状态)。确保无端口冲突(如 Skype 占用 80 端口),可通过 http://localhost 访问 XAMPP 欢迎页验证基础服务。

  2. 下载并解压 WordPress 完整源码包

    • 前往 https://www.php.cn/link/18cd1cd589e0558e181846f152da973f 下载最新 .zip 包(例如 wordpress-6.5.3-zh_CN.zip);
    • 关键操作:右键该 ZIP 文件 → 选择「全部解压缩」→ 指定目标文件夹(如桌面临时目录);
    • 解压后你会得到一个名为 wordpress/ 的文件夹,其内部包含 wp-admin/、wp-includes/、index.php、wp-config-sample.php 等数十个文件与子目录。
  3. 将 WordPress 内容 复制到 htdocs,而非 ZIP 文件本身
    ❌ 错误做法:直接把 wordpress.zip 放入 C:\xampp\htdocs\;
    ❌ 错误做法:把整个 wordpress/ 文件夹(含外层目录名)放入 htdocs,导致路径变为 htdocs\wordpress\wordpress\...;
    ✅ 正确做法:

    # 进入解压后的 wordpress/ 目录
    # 全选其中所有文件和子目录(Ctrl+A)
    # 复制(Ctrl+C)
    # 粘贴到 XAMPP htdocs 根目录下
    # 最终结构应为:
    C:\xampp\htdocs\index.php          ← XAMPP 自带
    C:\xampp\htdocs\wordpress\         ← 你手动创建的子目录(可选)
    C:\xampp\htdocs\wp-admin\          ← WordPress 核心文件(若直接放根目录)
    C:\xampp\htdocs\wp-config.php      ← 配置文件(需重命名并编辑)

    ? 提示:推荐将 WordPress 放在子目录(如 htdocs\wordpress\)便于多项目管理。此时访问地址为 http://localhost/wordpress/。

    零沫AI工具导航
    零沫AI工具导航

    零沫AI工具导航-AI导航新标杆,探索全球实用AI工具

    下载
  4. 初始化 WordPress 安装
    浏览器访问 http://localhost/wordpress/(注意末尾 /)→ 将自动跳转至安装向导 wp-admin/install.php;
    若提示“无法创建 wp-config.php”,请手动执行:

    • 将 htdocs\wordpress\wp-config-sample.php 重命名为 wp-config.php;
    • 编辑该文件,修改数据库连接参数(默认 DB_NAME='wordpress', DB_USER='root', DB_PASSWORD='');
    • 保存后刷新页面继续安装。

⚠️ 关于 Tomcat 报错的说明(非 WordPress 必需)

你提到的 Tomcat Not Found! 是 XAMPP 中 Java 组件的独立问题,与 WordPress 运行完全无关。WordPress 基于 PHP+MySQL,无需 Tomcat(Tomcat 用于 Java Web 应用,如 JSP)。XAMPP 默认不启用 Tomcat,也不影响 Apache/PHP 功能。可忽略此提示,专注 Apache 和 MySQL 服务即可。

✅ 验证与排错清单

检查项 正确状态 说明
http://localhost 能打开 XAMPP 首页 表明 Apache 正常运行
htdocs\wordpress\ 下存在 wp-admin/、wp-includes/、index.php 确认已解压且路径扁平化
URL 中无多余 .zip 或重复目录名(如 localhost/wordpress/wordpress/) 避免路径层级错误
浏览器地址栏显示 http://localhost/wordpress/(结尾有 /) Apache 需目录索引触发 index.php

? 终极提醒:WordPress 不是一个“.exe”或单文件程序,而是一套完整的 PHP Web 应用目录结构。解压是不可跳过的必要步骤。 JDK/JRE、Tomcat 的安装对 PHP 环境毫无帮助,切勿混淆技术栈。

完成上述操作后,刷新浏览器,你将看到熟悉的 WordPress 安装界面——本地开发之旅,正式启程。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
mysql修改数据表名
mysql修改数据表名

MySQL修改数据表:1、首先查看数据库中所有的表,代码为:‘SHOW TABLES;’;2、修改表名,代码为:‘ALTER TABLE 旧表名 RENAME [TO] 新表名;’。php中文网还提供MySQL的相关下载、相关课程等内容,供大家免费下载使用。

686

2023.06.20

MySQL创建存储过程
MySQL创建存储过程

存储程序可以分为存储过程和函数,MySQL中创建存储过程和函数使用的语句分别为CREATE PROCEDURE和CREATE FUNCTION。使用CALL语句调用存储过程智能用输出变量返回值。函数可以从语句外调用(通过引用函数名),也能返回标量值。存储过程也可以调用其他存储过程。php中文网还提供MySQL创建存储过程的相关下载、相关课程等内容,供大家免费下载使用。

513

2023.06.21

mongodb和mysql的区别
mongodb和mysql的区别

mongodb和mysql的区别:1、数据模型;2、查询语言;3、扩展性和性能;4、可靠性。本专题为大家提供mongodb和mysql的区别的相关的文章、下载、课程内容,供大家免费下载体验。

287

2023.07.18

mysql密码忘了怎么查看
mysql密码忘了怎么查看

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql密码忘了怎么办呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

519

2023.07.19

mysql创建数据库
mysql创建数据库

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql怎么创建数据库呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

267

2023.07.25

mysql默认事务隔离级别
mysql默认事务隔离级别

MySQL是一种广泛使用的关系型数据库管理系统,它支持事务处理。事务是一组数据库操作,它们作为一个逻辑单元被一起执行。为了保证事务的一致性和隔离性,MySQL提供了不同的事务隔离级别。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

392

2023.08.08

sqlserver和mysql区别
sqlserver和mysql区别

SQL Server和MySQL是两种广泛使用的关系型数据库管理系统。它们具有相似的功能和用途,但在某些方面存在一些显著的区别。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

542

2023.08.11

mysql忘记密码
mysql忘记密码

MySQL是一种关系型数据库管理系统,关系数据库将数据保存在不同的表中,而不是将所有数据放在一个大仓库内,这样就增加了速度并提高了灵活性。那么忘记mysql密码我们该怎么解决呢?php中文网给大家带来了相关的教程以及其他关于mysql的文章,欢迎大家前来学习阅读。

668

2023.08.14

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

26

2026.03.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
RunnerGo从入门到精通
RunnerGo从入门到精通

共22课时 | 1.8万人学习

尚学堂Mahout视频教程
尚学堂Mahout视频教程

共18课时 | 3.3万人学习

Linux优化视频教程
Linux优化视频教程

共14课时 | 3.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号