APMServ 使用教程：快速搭建本地 PHP 开发环境

什么是 APMServ？

APMServ 是一个集成的 PHP、Apache、MySQL、PHPMyAdmin 等服务器软件于一体的绿色软件包，它的最大特点是：

  • 一键安装/卸载：无需手动配置复杂的 httpd.conf, my.ini 等文件。
  • 绿色便携：解压即用，不写入系统注册表，删除文件夹即可完全卸载。
  • 功能集成：内置了 Apache 服务器、MySQL 数据库、PHP 解释器以及数据库管理工具 PHPMyAdmin。
  • 图形化管理：通过一个简单的控制面板，可以轻松启动、停止各个服务，并查看端口状态。

重要提示：APMServ 是一款较老的工具，其内置的软件版本（如 PHP 5.x, MySQL 5.x）也比较陈旧。它不适合用于生产环境，但非常适合用于学习、本地网站开发、测试旧项目或快速搭建一个临时的本地服务器。

下载与安装

  1. 下载：

    • 由于 APMServ 是一款老软件，官网已无法访问，你可以在一些软件下载站（如华军软件园、天空下载站等）搜索 "APMServ 5.2.6" 找到下载链接。
    • 注意：请从可信的来源下载，避免捆绑恶意软件。

  2. 安装：

    • APMServ 的安装过程非常简单，几乎是“傻瓜式”操作。
    • 双击下载的 APMServ5.2.6.exe 文件。
    • 点击 "I Agree" 同意协议。
    • 选择安装路径：这是最关键的一步！强烈建议不要安装在带有中文或空格的路径下，D:\APMServ 或 C:\Program Files\APMServ，推荐安装在纯英文路径下，如 D:\server\APMServ。
    • 点击 "Install" 开始安装，安装程序会自动解压文件到你指定的目录。
    • 安装完成后,会提示你是否运行 APMServ，勾选并点击 "Finish" 即可。

启动与使用

安装完成后,会自动弹出 APMServ 的控制台窗口。

启动服务

  • 在控制台窗口中,你会看到几个按钮：

    • 启动所有服务：一键启动 Apache、MySQL 等所有服务，对于新手，这是最常用的选项。
    • 停止所有服务：一键停止所有正在运行的服务。
    • 重载所有服务：在不重启服务的情况下重新加载配置文件。
    • 安装服务：将 APMServ 的服务安装到 Windows 系统服务中，这样开机后就可以自动启动。
    • 卸载服务：从系统服务中移除。

  • 首次启动：

    • 点击 【启动所有服务】。
    • 稍等片刻,如果窗口中的状态显示为 "Apache/2.0.59 (Win32) PHP/5.2.6 running..." 和 "MySQL 5.0.45 running..."，并且前面的图标是绿色的，说明启动成功！
    • 如果图标是红色的,说明启动失败，请检查端口是否被占用（常见于 80 和 3306 端口），或者查看错误提示。

访问默认网站

  • Apache 启动成功后，你的本地服务器就已经运行了。
  • 打开浏览器,在地址栏输入 http://localhost 或 http://127.0.0.1。
  • 如果能看到 APMServ 的欢迎页面，说明你的 Web 服务器已经正常工作。

访问 PHPMyAdmin

  • PHPMyAdmin 是一个用 PHP 编写的、通过 Web 界面管理 MySQL 数据库的工具。
  • 启动所有服务后,在浏览器地址栏输入 http://localhost/phpmyadmin/。
  • 你会看到登录界面,默认情况下，用户名是 root，密码为空。
  • 点击【执行】或【登录】，即可进入数据库管理界面，在这里你可以创建数据库、数据表，管理用户等。

配置你的网站

你需要在 APMServ 中放置你的网站文件，并配置虚拟主机（可选）。

放置网站文件

  • APMServ 的网站根目录（Web 根目录）位于安装目录下的 WWW 文件夹。
    • 你的安装路径是 D:\server\APMServ，那么网站根目录就是 D:\server\APMServ\WWW。
  • 将你的所有网站文件（如 HTML, PHP, CSS, JavaScript 文件）复制到 WWW 文件夹中。
  • 你将一个名为 my_project 的文件夹放入 WWW，那么你就可以通过 http://localhost/my_project/ 来访问它。

配置虚拟主机（推荐）

虚拟主机可以让你在本地通过域名（如 http://mytest.com）访问不同的项目，而不是用文件夹名。

  • 修改 Hosts 文件：

    1. 在 C 盘找到 C:\Windows\System32\drivers\etc\ 目录下的 hosts 文件。
    2. 用记事本（以管理员身份运行）打开它。
    3. 在文件末尾添加一行：0.0.1 mytest.com （这里的 mytest.com 可以是你自己定义的任何域名）。
    4. 保存文件。

  • 配置 Apache 配置文件：

    1. 在 APMServ 控制台窗口，点击 【配置文件】 -> 【Apache 配置文件】。

    2. 这会打开 httpd.conf 文件。

    3. 在文件末尾,添加以下配置（将 D:/server/APMServ/WWW/my_project 替换成你自己的项目路径）：

      # 配置虚拟主机 mytest.com
<VirtualHost *:80>
    ServerAdmin webmaster@dummy-host.example.com
    DocumentRoot "D:/server/APMServ/WWW/my_project"  # 你的项目根目录
    ServerName mytest.com                           # 你在 hosts 文件中定义的域名
    ErrorLog "logs/dummy-host.example.com-error_log"
    CustomLog "logs/dummy-host.example.com-access_log" common
</VirtualHost>

    4. 保存 httpd.conf 文件。

  • 生效配置：

    • 回到 APMServ 控制台，点击 【重载所有服务】。
    • 在浏览器中输入 http://mytest.com，就可以直接访问你的 my_project 项目了。

常见问题与解决方法

Q: 启动 Apache 时提示 "端口 80 被占用" 怎么办？

  • 原因：端口 80 是 Apache 的默认端口，可能是 IIS、其他 Web 服务器（如 Nginx, Tomcat）或者某些软件（如 Skype、迅雷）占用了它。
  • 解决：
    1. 关闭占用端口的程序：打开任务管理器，查看是否有可疑进程，或者关闭可能使用 80 端口的软件。
    2. 修改 APMServ 的端口：
      • 在 APMServ 控制台，点击 【配置文件】 -> 【Apache 配置文件】。
      • 在 Listen 80 这一行，将 80 修改为一个未被占用的端口号，8080。
      • 同样,找到 NameVirtualHost *:80 这一行，也修改为 NameVirtualHost *:8080。
      • 保存文件,【重载所有服务】。
      • 之后访问网站就需要使用 http://localhost:8080 了。

Q: PHP 文件无法执行，直接显示源代码。

  • 原因：PHP 模块没有被正确加载到 Apache 中。
  • 解决：
    1. 打开 Apache 配置文件 (httpd.conf)。
    2. 确保 LoadModule php5_module "D:/server/APMServ/php/php5apache2_2.dll" 这一行没有被注释（即前面没有 号）。
    3. 确保 AddType application/x-httpd-php .php .phtml 这一行也没有被注释。
    4. 保存文件,【重载所有服务】。

Q: 忘记 MySQL 密码怎么办？

  • 解决：
    1. 先在 APMServ 控制台 【停止所有服务】。
    2. 打开 MySQL 的配置文件，通常在安装目录的 MySQL/my.ini。
    3. 在 [mysqld] 部分，添加一行：skip-grant-tables，这会让 MySQL 在启动时跳过权限检查。
    4. 保存文件,【启动所有服务】（只启动 MySQL 也可以）。
    5. 打开 PHPMyAdmin (http://localhost/phpmyadmin/)，此时无需密码即可登录。
    6. 在左侧选择 mysql 数据库，然后在右侧的 SQL 查询框中执行以下命令来重置 root 密码（将 'your_new_password' 替换成你的新密码）：
      UPDATE user SET password = PASSWORD('your_new_password') WHERE user = 'root';
FLUSH PRIVILEGES;
    7. 关闭所有服务和浏览器。
    8. 再次打开 my.ini 文件，删除之前添加的 skip-grant-tables 这一行。
    9. 保存文件,然后重新启动所有服务。
    10. 现在你就可以用新密码登录 MySQL 了。

卸载

由于 APMServ 是绿色软件，卸载非常简单：

  1. 在 APMServ 控制台点击 【停止所有服务】。
  2. 点击 【卸载服务】。
  3. 直接删除你当初安装 APMServ 的整个文件夹即可。

总结与现代化替代方案

APMServ 对于快速搭建一个旧版本的 PHP 环境非常方便，但它的时代已经过去，如果你现在开始学习 PHP 开发，更推荐使用现代化的集成环境，它们更稳定、功能更强大、社区支持更好：

  • XAMPP：最流行、跨平台（Windows, macOS, Linux）的集成环境，非常稳定。
  • WampServer：Windows 平台下非常流行，配置简单，界面友好。
  • 宝塔面板：如果你想在本地或服务器上搭建更复杂的环境（不仅仅是 PHP），宝塔面板是一个极佳的选择，它不仅能一键部署 LAMP/LNMP 环境，还能管理网站、FTP、数据库、文件等，功能非常强大。

希望这份教程能帮助你顺利使用 APMServ！