phpstudy 是 windows 下集成 apache/nginx、php、mysql 的本地开发环境，非必需但便于快速启动；适用于简单脚本调试，但在现代框架开发中易掩盖配置、路径与权限问题。
PHPStudy 不是必须用的工具，它只是把 Apache/Nginx、PHP、MySQL 打包在一起的 Windows 本地开发环境。如果你只需要跑 PHP 脚本或调试小项目，它确实省事；但如果你在开发 Laravel、ThinkPHP 等现代框架，或需要自定义 PHP 扩展、多版本共存、CLI 调试，它反而容易掩盖路径、权限、配置加载顺序等问题。
怎么启动 PHPStudy 并确认服务正常
安装后双击桌面 phpstudy.exe，主界面勾选「Web 服务器」「PHP 版本」「MySQL」，点击「启动」。注意看右下角状态栏：绿色表示成功，红色代表失败。常见失败原因包括：80 或 3306 端口被占用（IIS、Skype、其他 MySQL 实例）、php-cgi.exe 无法启动（VC 运行库缺失）、MySQL data 目录损坏。启动成功后，浏览器访问 http://localhost 应显示 PHPStudy 默认首页；访问 http://localhost/phpmyadmin 应能进数据库管理页。
怎么切换 PHP 版本并让网站生效
PHPStudy 支持多个 PHP 版本共存，但切换不等于全局生效——它只影响通过其内置 Web 服务器（Apache/Nginx）运行的站点。操作路径：主界面顶部菜单「其他选项菜单」→「网站设置」→「网站」→ 选中站点 →「修改」→「PHP 版本」下拉选择。关键点：.user.ini 和 php.ini 文件不会自动同步更新，你需要手动检查所选 PHP 版本对应目录下的 php.ini（如 C:\phpstudy_pro\Extensions\php\php7.4.33nts\php.ini），确认 extension_dir、date.timezone、memory_limit 等是否符合当前项目需求。切完记得重启对应 Web 服务，否则 phpinfo() 显示的仍是旧版本。
怎么让自己的项目被 PHPStudy 正确访问
默认网站根目录是 C:\phpstudy_pro\WWW，把项目放进去就能通过 http://localhost/your-project/ 访问。但要注意三点：
- 入口文件（如
index.php）必须放在子目录顶层，不能藏在src/或public/深层路径里，除非你改了虚拟主机配置； - 伪静态（如 ThinkPHP 的
pathinfo、Laravel 的rewrite）默认不启用，需在「网站设置」→「伪静态」里选择对应规则，或手动编辑.htaccess（Apache）或nginx.conf（Nginx）； - 如果项目依赖 Composer 自动加载，确保命令行终端使用的是 PHPStudy 提供的 PHP（比如
C:\phpstudy_pro\Extensions\php\php7.4.33nts\php.exe），而不是系统 PATH 里的其他 PHP。
立即学习“PHP免费学习笔记（深入）”；
为什么 phpMyAdmin 登录失败或报 #2002 错误
错误信息 #2002 - 无法登录 MySQL 服务器 或 mysqli_real_connect(): (HY000/2002): No such file or directory，本质是 phpMyAdmin 找不到 MySQL socket 或 TCP 连接地址。PHPStudy 默认用 TCP（127.0.0.1:3306），但部分 phpMyAdmin 配置可能硬编码了 socket 路径（如 /tmp/mysql.sock）。解决方法：打开 C:\phpstudy_pro\WWW\phpmyadmin\config.inc.php，找到 $cfg['Servers'][$i]['host']，确保设为 '127.0.0.1'（不是 'localhost'，后者在 Windows 下可能触发命名管道）；同时确认 $cfg['Servers'][$i]['port'] = '3306';。如果 MySQL 服务本身没启动，先回主界面点「启动」再试。
真正麻烦的从来不是点几下启动按钮，而是当 file_get_contents('https://api.example.com') 报 SSL operation failed、或者 composer install 卡在 cloning、又或者 pdo_mysql 扩展明明勾选了却显示 Class 'PDO' not found——这些都不是 PHPStudy 图形界面能点出来的，得去翻日志、查扩展路径、比对 php.ini 加载顺序。
