WampServer 完整教程:从零开始搭建本地 Web 服务器
什么是 WampServer?
WampServer 是一个在 Windows 操作系统上运行的 Web 开发环境,它是一个集成软件包,将搭建一个动态网站所需的所有服务都打包在一起,非常方便。

WampServer 的名字由四个部分组成:
- W (Windows): 表示它只能在 Windows 系统上运行。
- A (Apache): 一个开源的、非常流行的 Web 服务器软件,它的作用是接收用户的请求(比如访问
http://localhost),并将网站的文件(HTML, CSS, JS, 图片等)发送给用户的浏览器。 - M (MySQL / MariaDB): 一个开源的关系型数据库管理系统,用于存储网站的数据,比如用户信息、文章内容、商品列表等,新版 WampServer 默认使用 MariaDB,它是 MySQL 的一个分支,性能和兼容性更好。
- P (PHP): 一种开源的服务器端脚本语言,它是网站的核心逻辑,用于处理 Apache 发来的请求,与 MySQL 数据库进行交互,并生成动态的 HTML 页面发送给浏览器。
WampServer 就是一个“一键式”工具,让你能在自己的电脑上模拟一个真实的网站服务器环境,方便你进行网站和应用的本地开发与测试。
WampServer 的适用人群
- Web 开发初学者:学习 HTML, CSS, JavaScript, PHP, MySQL 等技术的最佳平台。
- PHP 开发者:用于开发、调试 PHP 项目。
- 网站管理员:在将网站部署到正式服务器前,进行本地配置和测试。
- WordPress 等 CMS 用户:本地搭建和测试网站,不影响线上网站。
安装前准备
- 操作系统:Windows 7, 8, 10, 11 (32位或64位)。
- 下载 WampServer:
- 访问官方下载页面:http://www.wampserver.com/en/
- 根据你的 Windows 系统位数(32位或64位)选择下载版本,你可以右键点击“此电脑” -> “属性” 查看。
- 重要提示:PHP 版本选择,对于初学者,建议选择 PHP 7.4.x 或 PHP 8.0.x 的版本,因为它们兼容性好,且社区支持广泛,避免选择过于陈旧(如 PHP 5.6)或过于前沿(如 PHP 8.3)的版本。
- 下载
wampserverX.X.X.X.exe文件。
详细安装步骤
-
运行安装程序
- 找到你下载的
wampserverX.X.X.X.exe文件,双击运行。 - 如果系统弹出“用户账户控制”提示,点击“是”。
- 找到你下载的
-
欢迎界面
(图片来源网络,侵删)点击 "Next"。
-
许可协议
仔细阅读 GNU General Public License,然后勾选 "I accept the agreement",再点击 "Next"。
-
选择安装路径
- 默认路径是
C:\wamp64(64位系统)或C:\wamp(32位系统)。 - 建议:保持默认路径即可,因为很多配置文件和教程都基于此路径,如果你想更改,请确保路径中没有中文字符和空格。
- 点击 "Next"。
- 默认路径是
-
选择快捷方式
- 默认勾选 "Create a shortcut on the desktop"(在桌面创建快捷方式)和 "Add Start Menu shortcuts"(在开始菜单添加快捷方式),方便启动。
- 点击 "Next"。
-
准备安装
点击 "Install" 开始安装过程,安装程序会自动解压并复制文件。
-
配置服务器
- 安装完成后,会弹出一个配置窗口。
- Primary DNS domain: 这是你的本地服务器域名,默认是
localhost,保持不变即可。 - Server Name: 默认是
localhost,保持不变。 - Email Administrator: 填写你的邮箱地址,用于服务器管理。
- 填写完毕后,点击 "Next"。
-
完成安装
- 点击 "Finish"。
- 重要:安装程序会默认勾选 "Launch WampServer now",如果你想让它在安装后立即启动,请保持勾选,然后点击 "Finish"。
验证安装与使用
-
启动 WampServer
- 如果安装后没有自动启动,可以在桌面或开始菜单找到 WampServer 的快捷方式并双击启动。
- 你会注意到任务栏右下角(系统托盘区)多了一个绿色的图标,这就是 WampServer 的状态图标。
-
理解图标颜色
- 绿色:所有服务(Apache, MySQL)都正常运行,这是理想状态。
- 橙色:Apache 服务已启动,但 MySQL 服务未启动,通常是因为 MySQL 端口(3306)被其他程序占用(如 XAMPP, Navicat, MySQL Workbench)。
- 红色:所有服务都未启动,可能 WampServer 没有启动,或者 Apache/MySQL 服务出错。
- 左键点击图标:可以打开 WampServer 的菜单,用于管理服务和项目。
- 右键点击图标:可以快速访问配置文件、日志文件等。
-
第一次验证
- 确保图标变为绿色。
- 打开你的浏览器(推荐 Chrome 或 Firefox),在地址栏输入:
http://localhost - 如果看到 "WampServer Homepage" 的页面,恭喜你,WampServer 已经成功安装并运行!
配置虚拟主机(推荐)
直接使用 http://localhost/项目名 的方式访问项目不太方便,配置虚拟主机可以让你通过自定义域名(如 http://myproject.local)来访问项目,更接近真实环境。
以创建一个名为 myproject 的项目为例:
-
创建项目文件夹
- 在 WampServer 的安装目录下(如
C:\wamp64),找到www文件夹。 - 在
www文件夹内创建一个新的文件夹,命名为myproject。 - 在
myproject文件夹里,创建一个index.php文件,内容如下:<?php echo "你好,我的第一个项目!"; ?>
- 在 WampServer 的安装目录下(如
-
配置 Apache
- 右键点击系统托盘的 WampServer 图标 ->
Apache->httpd.conf。 - 这会打开 Apache 的主配置文件,按
Ctrl + F搜索#Include conf/extra/httpd-vhosts.conf。 - 删除该行前面的 号,取消注释。
- 保存并关闭文件。
- 右键点击系统托盘的 WampServer 图标 ->
-
配置虚拟主机文件
- 再次右键点击 WampServer 图标 ->
Apache->httpd-vhosts.conf。 - 打开这个文件,在文件末尾添加以下内容:
<VirtualHost *:80> ServerName myproject.local DocumentRoot "C:/wamp64/www/myproject" <Directory "C:/wamp64/www/myproject"> Options Indexes FollowSymLinks AllowOverride All Require local </Directory> </VirtualHost>ServerName: 你想访问的域名。DocumentRoot: 你的项目文件夹的绝对路径。Directory: 设置对该目录的访问权限。AllowOverride All允许使用.htaccess文件。
- 再次右键点击 WampServer 图标 ->
-
配置本地 hosts 文件
- 这个文件的作用是将域名
myproject.local解析到你的本地电脑(127.0.0.1)。 - 按
Win + R键,输入drivers/etc并回车,打开etc文件夹。 - 用记事本打开
hosts文件。 - 在文件末尾添加一行:
0.0.1 myproject.local - 保存文件(如果提示无权限,先保存到桌面,再复制替换原文件)。
- 这个文件的作用是将域名
-
重启 Apache
- 右键点击 WampServer 图标 ->
Restart All Services。 - 确保图标变回绿色。
- 右键点击 WampServer 图标 ->
-
访问项目
- 现在在浏览器地址栏输入:
http://myproject.local - 如果看到 "你好,我的第一个项目!",说明虚拟主机配置成功!
- 现在在浏览器地址栏输入:
常用操作
- 启动/停止服务:
- 左键点击托盘图标 ->
Start All Services/Stop All Services。 - 也可以单独控制:
Apache->Start/Stop Service,MySQL->Start/Stop Service。
- 左键点击托盘图标 ->
- 管理数据库:
- 左键点击托盘图标 ->
MySQL->phpMyAdmin。 - 这会打开一个数据库管理网页,默认用户名是
root,密码为空(首次安装)。 - 在这里你可以创建数据库、数据表,执行 SQL 语句等。
- 左键点击托盘图标 ->
- 切换 PHP 版本:
- WampServer 允许你安装多个 PHP 版本。
- 左键点击托盘图标 ->
PHP->Version-> 选择你想要的 PHP 版本。 - 切换后需要
Restart All Services。
- 查看错误日志:
- 如果网站出错,可以查看日志来排查问题。
- Apache 日志:
Apache->Log files->Error log。 - PHP 错误日志:
PHP->Error log。
常见问题与解决方法
-
Q: 图标一直是橙色或红色?
- A:检查是否有其他软件占用了 80 端口(Apache)或 3306 端口(MySQL),常见的有 Skype、XAMPP、其他 Web 服务器等,可以尝试关闭这些软件,或者修改 WampServer 的端口(不推荐新手操作)。
-
Q:
phpMyAdmin访问失败或提示密码错误?- A:首次安装密码为空,如果设置过密码忘记了,可以修改配置文件,右键图标 ->
MySQL->my.ini,找到[mysqld_safe]段落,在下面添加一行skip-grant-tables,保存后重启 MySQL,然后进入phpMyAdmin修改mysql数据库中的user表,将root用户的password字段清空(或使用 MD5 加密后的新密码),改完后记得把skip-grant-tables删除,再重启 MySQL。
- A:首次安装密码为空,如果设置过密码忘记了,可以修改配置文件,右键图标 ->
-
Q: 访问
localhost显示 403 Forbidden?- A:通常是权限问题,检查
www文件夹或你的项目文件夹的权限是否正确,右键文件夹 ->属性->安全,确保你的用户账户有“读取和执行”的权限。
- A:通常是权限问题,检查
卸载 WampServer
- 通过 Windows 的 "控制面板" -> "程序和功能" 找到 WampServer,卸载它。
- 手动删除安装目录(
C:\wamp64或C:\wamp)。 - (可选)清理
hosts文件中你添加的虚拟主机记录。 - (可选)重启电脑,以确保所有服务进程都已终止。
希望这份详细的教程能帮助你顺利上手 WampServer!祝你在 Web 开发的道路上越走越远!
