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(可选组件)
安装与启动
- 前往 Apache Friends 下载对应系统的 XAMPP 安装包。
- 安装后打开 XAMPP Control Panel。
- 点击 Apache、MySQL 旁的 Start 启动服务;状态栏显示 running 即表示成功。
默认访问地址
| 用途 | 地址 |
|---|---|
| 控制面板 / 欢迎页 | http://localhost |
| 备用端口 | http://localhost:8080 |
| phpMyAdmin | http://localhost/phpmyadmin |
网站根目录(htdocs)常见路径:
- Windows:
C:\xampp\htdocs\ - macOS:
/Applications/XAMPP/htdocs/ - Linux:
/opt/lampp/htdocs/
将项目文件夹放入 htdocs,例如 htdocs/blog/,即可通过 http://localhost/blog/ 访问。
与 WordPress 配合
XAMPP 是本地安装 WordPress 的常见选择:
- 在 phpMyAdmin 中新建数据库;
- 下载 WordPress 解压到
htdocs/wordpress; - 浏览器访问 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 即可在本机调试网站。