PHPStudy Pro 本地 PHP 环境搭建与使用指南

PHPStudy Pro 本地 PHP 环境搭建与使用指南

对于 PHP 开发者而言，一套稳定、便捷的本地开发环境是提高效率的基础。PHPStudy Pro 作为一款集成化的开发环境工具，能够快速搭建 WNMP（Windows+Nginx/Apache+MySQL+PHP）或 WAMP 环境，省去了单独配置各个组件的繁琐流程。本文将从下载安装到运行第一个 PHP 程序，为你提供一步到位的详细指南，即使是新手也能轻松上手。

一、环境准备：为什么选择 PHPStudy Pro？

在开始搭建前，先简单了解下 PHPStudy Pro 的优势：

• 集成化管理：一键安装 Apache、Nginx、MySQL、PHP 等组件，无需逐个配置，降低入门门槛。
• 多版本切换：支持不同 PHP 版本（如 5.6、7.x、8.x）和 MySQL 版本的快速切换，满足不同项目的环境需求。
• 可视化操作：图形化界面直观易懂，网站创建、服务启停、配置修改等操作均可通过界面完成。
• 稳定性强：经过大量用户验证，组件搭配合理，减少因环境冲突导致的异常问题。

本文将以 Windows 系统为例，搭建 Apache+MySQL+PHP 的开发环境。

二、详细搭建步骤

1. 下载与安装 PHPStudy Pro

首先进入 PHPStudy 官方网站（https://www.xp.cn/），点击首页的'下载'按钮，获取最新版的 PHPStudy Pro 安装包（一般为.exe 格式）。

下载完成后，双击安装包启动安装程序：

• 选择安装路径：建议避免安装在 C 盘（系统盘），可选择 D 盘或其他非系统盘，如'D:\phpstudy_pro'。
• 勾选'创建桌面快捷方式'（方便后续启动），点击'立即安装'。

等待安装完成，点击'立即体验'启动 PHPStudy Pro。

注意：安装过程中建议关闭 360 等杀毒软件，避免误报拦截组件安装，导致环境不完整。

2. 启动 WNMP 服务（Apache+MySQL）

打开 PHPStudy Pro 后，默认进入'首页'界面。在左侧导航栏选择'服务'，可以看到 Apache 和 MySQL 的状态显示为'未启动'。

本文选择以下版本组合（兼容性较好，适合新手入门）：

• Apache：2.4.39
• MySQL：5.7.26
• PHP：7.2.9nts（非线程安全版）

操作步骤：

1. 点击 Apache 右侧的'启动'按钮，等待几秒钟，状态变为'已启动'（绿色图标）。
2. 同样点击 MySQL 右侧的'启动'按钮，状态变为'已启动'。
3. 若启动失败，可点击'日志'查看具体错误信息，常见原因包括端口被占用（如 Apache 默认 80 端口被 IIS 占用，MySQL 默认 3306 端口被其他程序占用），可在'配置'中修改端口号。

3. 安装 PHP 版本

如果启动服务时提示 PHP 版本未安装，需手动安装指定版本：

1. 点击左侧导航栏的'软件管理'，进入组件安装界面。
2. 在'PHP'分类下找到'PHP 7.3.4nts'，点击右侧的'安装'按钮。

安装完成后，返回'服务'界面，刷新页面，确保 PHP 版本已正确识别。

4. 创建本地网站

服务启动成功后，开始创建第一个本地网站：

1. 点击左侧导航栏的'网站'，进入网站管理界面。
2. 点击右上角的'创建网站'按钮，弹出创建窗口。
3. 填写网站信息：
   • 域名：设置为自定义本地域名，如'test6'（无需后缀，本地访问时可直接使用）。
   • 端口：默认 80（若 80 端口被占用，可修改为其他端口如 8080）。
   • 根目录：默认会生成对应域名的目录（如'D:\phpstudy_pro\WWW\test6'），可根据需求修改，直接定位项目 或者项目 /public 目录。
   • PHP 版本：选择已安装的'PHP 7.2.9nts'。
4. 填写完成后，点击'确认'按钮，网站创建成功。

验证网站创建成功

网站创建后，可通过以下步骤验证：

1. 在网站列表中找到刚创建的'test6'，点击右侧的'管理'按钮，选择'打开网站'。
2. 此时浏览器会自动打开页面，显示'站点创建成功'，说明网站配置正常。

5. 编写并运行第一个 PHP 程序（Hello World）

接下来编写经典的'Hello World'程序，测试 PHP 环境是否正常工作：

1. 在网站管理界面，点击'test6'右侧的'管理'按钮，选择'打开根目录'，此时会打开网站的根目录文件夹（D:\phpstudy_pro\WWW\test6）。
2. 在文件夹内右键，选择'新建'→'文本文档'，创建一个记事本文件。
3. 将文件重命名为'index.php'（注意：后缀必须为.php，而非.txt，若看不到文件后缀，需在 Windows 文件夹选项中勾选'显示文件扩展名'）。
4. 右键'index.php'，选择'打开方式'→'记事本'（或其他代码编辑器如 Notepad++、VS Code）。
5. 在文件中输入以下 PHP 代码：

echo 'hello world!';

6. 保存文件并关闭记事本。

6. 访问 PHP 程序

打开浏览器，在地址栏输入以下任一地址：

• http://127.0.0.1/test6/（127.0.0.1 是本地回环地址）
• http://test6/（直接使用自定义的本地域名）

若浏览器页面显示'hello world!'，则说明 PHP 环境搭建成功，第一个 PHP 程序运行正常！

三、常见问题与解决办法

1. Apache/MySQL 启动失败怎么办？

最常见原因是端口被占用：

• 查看端口占用：在 PHPStudy Pro'服务'界面，点击对应服务的'配置'→'端口检测'，可查看端口是否被占用。
• 修改端口：若 80 端口被占用，可将 Apache 端口改为 8080；3306 端口被占用，可将 MySQL 端口改为 3307，修改后重启服务即可。

2. 浏览器访问网站时显示'404 Not Found'？

可能原因：

• 根目录错误：检查网站的根目录是否正确指向包含 index.php 的文件夹。
• 文件名错误：确保入口文件名为 index.php（PHPStudy 默认优先解析 index.php）。

3. PHP 代码不解析，直接显示源代码？

原因：未正确配置 PHP 版本，或 Apache 未加载 PHP 模块。解决办法：

• 在'网站'管理界面，确认对应网站的'PHP 版本'已选择正确的已安装版本。
• 重启 Apache 服务，确保配置生效。

四、总结

通过以上步骤，我们成功使用 PHPStudy Pro 搭建了 Apache+MySQL+PHP 的本地开发环境，并运行了第一个 PHP 程序。PHPStudy Pro 的集成化特性大大简化了环境配置流程，非常适合 PHP 新手入门。接下来你可以在此基础上开发更复杂的 PHP 项目，如连接 MySQL 数据库、搭建 CMS 系统等。如果在使用过程中遇到其他问题，可查阅 PHPStudy 官方文档或社区论坛获取帮助。