PHPStudy Pro 详细搭建与使用指南
对于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的开发环境。
二、详细搭建步骤
- 下载与安装PHPStudy Pro
首先进入PHPStudy官方网站(https://www.xp.cn/),点击首页的"下载"按钮,获取最新版的PHPStudy Pro安装包(一般为.exe格式)。
下载完成后,双击安装包启动安装程序:
-
选择安装路径:建议避免安装在C盘(系统盘),可选择D盘或其他非系统盘,如"D:\phpstudy_pro"。
-
勾选"创建桌面快捷方式"(方便后续启动),点击"立即安装"。
-
等待安装完成,点击"立即体验"启动PHPStudy Pro。

注意:安装过程中建议关闭360等杀毒软件,避免误报拦截组件安装,导致环境不完整。
- 启动WNMP服务(Apache+MySQL)
打开PHPStudy Pro后,默认进入"首页"界面。在左侧导航栏选择"服务",可以看到Apache和MySQL的状态显示为"未启动"。
本文选择以下版本组合(兼容性较好,适合新手入门):
-
Apache:2.4.39
-
MySQL:5.7.26
-
PHP:7.2.9nts(非线程安全版)

操作步骤:
-
点击Apache右侧的"启动"按钮,等待几秒钟,状态变为"已启动"(绿色图标)。
-
同样点击MySQL右侧的"启动"按钮,状态变为"已启动"。
-
若启动失败,可点击"日志"查看具体错误信息,常见原因包括端口被占用(如Apache默认80端口被 IIS 占用,MySQL默认3306端口被其他程序占用),可在"配置"中修改端口号。
-
安装对应版本的PHP
如果启动服务时提示PHP版本未安装,需手动安装指定版本:
-
点击左侧导航栏的"软件管理",进入组件安装界面。
-
在"PHP"分类下找到"PHP 7.3.4nts",点击右侧的"安装"按钮。

-
安装完成后,返回"服务"界面,刷新页面,确保PHP版本已正确识别。
-
创建本地网站
服务启动成功后,开始创建第一个本地网站:
-
点击左侧导航栏的"网站",进入网站管理界面。
-
点击右上角的"创建网站"按钮,弹出创建窗口。
-
填写网站信息:
域名:设置为自定义本地域名,如"test6"(无需后缀,本地访问时可直接使用)。
-
端口:默认80(若80端口被占用,可修改为其他端口如8080)。
-
根目录:默认会生成对应域名的目录(如"D:\phpstudy_pro\WWW\test6"),可根据需求修改,捉着查找项目 或者项目 /public 目录。
-
PHP版本:选择已安装的"PHP 7.2.9nts"。
-
填写完成后,点击"确认"按钮,网站创建成功。
-
验证网站创建成功

网站创建后,可通过以下步骤验证:
-
在网站列表中找到刚创建的"test6",点击右侧的"管理"按钮,选择"打开网站"。
-
此时浏览器会自动打开页面,显示"站点创建成功",说明网站配置正常。
-
编写并运行第一个PHP程序(Hello World)或者 绑定根目录为实际项目 路径
接下来编写经典的"Hello World"程序,测试PHP环境是否正常工作:
-
在网站管理界面,点击"test6"右侧的"管理"按钮,选择"打开根目录",此时会打开网站的根目录文件夹(D:\phpstudy_pro\WWW\test6)。
-
在文件夹内右键,选择"新建"→"文本文档",创建一个记事本文件。
-
将文件重命名为"index.php"(注意:后缀必须为.php,而非.txt,若看不到文件后缀,需在Windows文件夹选项中勾选"显示文件扩展名")。
-
右键"index.php",选择"打开方式"→"记事本"(或其他代码编辑器如Notepad++、VS Code)。
-
在文件中输入以下PHP代码:
-
保存文件并关闭记事本。
-
访问PHP程序
打开浏览器,在地址栏输入以下任一地址:
若浏览器页面显示"hello world!",则说明PHP环境搭建成功,第一个PHP程序运行正常!
三、常见问题与解决办法
- Apache/MySQL启动失败怎么办?
最常见原因是端口被占用:
-
查看端口占用:在PHPStudy Pro"服务"界面,点击对应服务的"配置"→"端口检测",可查看端口是否被占用。
-
修改端口:若80端口被占用,可将Apache端口改为8080;3306端口被占用,可将MySQL端口改为3307,修改后重启服务即可。
- 浏览器访问网站时显示"404 Not Found"?
可能原因:
-
根目录错误:检查网站的根目录是否正确指向包含index.php的文件夹。
-
文件名错误:确保入口文件名为index.php(PHPStudy默认优先解析index.php)。
- PHP代码不解析,直接显示源代码?
原因:未正确配置PHP版本,或Apache未加载PHP模块。解决办法:
-
在"网站"管理界面,确认对应网站的"PHP版本"已选择正确的已安装版本。
-
重启Apache服务,确保配置生效。
四、总结
通过以上步骤,我们成功使用PHPStudy Pro搭建了Apache+MySQL+PHP的本地开发环境,并运行了第一个PHP程序。PHPStudy Pro的集成化特性大大简化了环境配置流程,非常适合PHP新手入门。接下来你可以在此基础上开发更复杂的PHP项目,如连接MySQL数据库、搭建CMS系统等。如果在使用过程中遇到其他问题,可查阅PHPStudy官方文档或社区论坛获取帮助。