XAMPP 本地开发环境指南

使用 XAMPP 在 Windows、macOS 或 Linux 上搭建 Apache、MariaDB、PHP 本地环境,通过 localhost 访问站点。


XAMPP 是一套跨平台的本地 Web 开发环境,名称来自 X(跨平台)+ Apache + MariaDB + PHP + Perl。它安装简单、文档丰富,是初学者和 WordPress / PHP 开发者常用的 localhost 方案。

XAMPP 包含什么

  • Apache:HTTP 服务器
  • MariaDB(替代 MySQL):数据库
  • PHP:服务端语言
  • phpMyAdmin:Web 数据库管理工具
  • Perl(可选组件)

安装与启动

  1. 前往 Apache Friends 下载对应系统的 XAMPP 安装包。
  2. 安装后打开 XAMPP Control Panel
  3. 点击 Apache、MySQL 旁的 Start 启动服务;状态栏显示 running 即表示成功。

默认访问地址

用途地址
控制面板 / 欢迎页http://localhost
备用端口http://localhost:8080
phpMyAdminhttp://localhost/phpmyadmin

网站根目录(htdocs)常见路径:

  • Windows:C:\xampp\htdocs\
  • macOS:/Applications/XAMPP/htdocs/
  • Linux:/opt/lampp/htdocs/

将项目文件夹放入 htdocs,例如 htdocs/blog/,即可通过 http://localhost/blog/ 访问。

与 WordPress 配合

XAMPP 是本地安装 WordPress 的常见选择:

  1. 在 phpMyAdmin 中新建数据库;
  2. 下载 WordPress 解压到 htdocs/wordpress
  3. 浏览器访问 http://localhost/wordpress 完成安装向导。

常见问题

Apache 启动失败(端口冲突)
80 或 443 端口可能被占用。可在 httpd.conf 中将 Listen 80 改为 Listen 8080,之后使用 http://localhost:8080 访问。

MySQL 无法启动
检查是否已有其他 MySQL 实例在运行;查看 XAMPP 日志面板中的错误信息。

localhost 显示 XAMPP 欢迎页而非自己的项目
确认项目文件在 htdocs 下,且 URL 路径与文件夹名称一致。

小结

XAMPP 跨平台、上手快,适合 PHP 与 CMS 本地开发。启动 Apache 与 MySQL 后,用 http://localhost 即可在本机调试网站。

访客计数:------ Best viewed in Netscape Navigator · 800×600 © LocalHost Run