PHPStudy v8.x是Windows下推荐的PHP集成环境，需从官网下载、避免中文路径，启动时解决端口冲突并支持多PHP版本切换，配置虚拟主机需修改hosts文件，常见问题需检查服务状态、PHP模块加载及重启生效。
PHPStudy 是一款 Windows 下集成的 PHP 开发环境工具，一键安装 Apache/Nginx、PHP、MySQL 等组件，适合新手快速搭建本地开发环境。安装和设置其实很直接，关键在于选对版本、避开常见坑（比如端口冲突、服务未启动、PHP 版本不匹配）。
下载与安装：选对版本，避免兼容问题
官方已停止更新旧版（如 PHPStudy 2016/2018），当前推荐使用 PHPStudy v8.x（新版，基于小皮面板），官网地址为 https://www.xp.cn。注意：
- 务必从官网下载，第三方渠道可能捆绑软件或修改版；
- 安装路径不要含中文或空格（例如
D:\phpstudy_pro更稳妥）； - 安装时取消勾选“开机自启”和“创建桌面快捷方式”等非必要选项，减少干扰；
- 安装过程无需手动配置，点击“下一步”即可完成基础部署。
启动服务与切换运行环境
安装完成后打开主程序，界面左侧是服务控制区。首次使用需手动启动：
- 点击“启动”按钮，等待 Apache（或 Nginx）+ MySQL + PHP 同时显示绿色“已启动”；
- 若某个服务启动失败（如 Apache 显示红色），大概率是端口被占用（如 80 端口被 IIS、Skype 或其他软件占用了），可点击对应服务右侧的“设置”→ 修改端口（如改成 8080）；
- 支持多版本 PHP 切换：在“软件管理”→“PHP”中，可安装多个版本（如 7.4、8.0、8.2），然后在网站根目录右键 → “设置”→ 指定该站点使用的 PHP 版本；
- 默认网站根目录为
D:\phpstudy_pro\WWW，把项目放进去，访问http://localhost即可看到首页。
配置虚拟主机与域名（可选但实用）
本地开发常需多个项目，用不同域名区分更清晰（如 test.local、api.dev）：
立即学习“PHP免费学习笔记（深入）”；
- 在“网站”→“创建网站”，填写域名（如
test.local）、根目录（如D:\phpstudy_pro\WWW\test）、PHP 版本； - 创建后，需手动修改系统 hosts 文件（
C:\Windows\System32\drivers\etc\hosts），追加一行：127.0.0.1 test.local； - 保存 hosts 后刷新浏览器，访问
http://test.local即可加载对应项目； - 如需 HTTPS 测试，可在网站设置中开启“SSL”，PHPStudy 会自动签发本地证书（Chrome 可能提示不安全，点“高级”→“继续访问”即可）。
常见问题快速处理
遇到打不开、502、空白页等问题，优先检查这几项：
- MySQL 启动失败：查看日志（“软件管理”→ MySQL → “错误日志”），常见原因是 data 目录损坏，可尝试“初始化数据库”重置；
- PHP 页面不解析，直接下载或显示源码：确认当前网站绑定的 PHP 版本已正确启用，且 Apache/Nginx 配置中已加载 PHP 模块（新版通常默认 OK）；
-
phpinfo() 不生效：在 WWW 目录新建
info.php，内容为<?php phpinfo(); ?>，通过浏览器访问确认 PHP 是否正常工作； - 修改 php.ini 无效：在“软件管理”→ PHP → 点击对应版本右侧的“设置”→ 打开 php.ini，修改后必须重启 Apache/Nginx 才生效。
