这篇指南将从零开始,分为以下几个部分：
- 什么是 PHPStudy？ —— 了解它的核心作用。
- 下载与安装 —— 如何获取并安装 PHPStudy。
- 环境配置 —— 启动、管理你的网站服务器。
- 创建你的第一个网站 —— 从零开始搭建一个本地网站。
- 常用操作 —— 数据库管理、多网站配置等。
- 常见问题与高级玩法 —— 解决你可能遇到的问题。
什么是 PHPStudy？
PHPStudy 是一个集成了多种 Web 开发软件的 Windows 环境打包工具。
当你开发一个网站（特别是 PHP 网站）时,通常需要安装和配置一堆复杂的软件：
- Web 服务器: 用来处理用户请求，返回网页文件，最常用的是 Apache 或 Nginx。
- PHP 解释器: 用来运行 PHP 代码,让网页能动态生成内容。
- 数据库: 用来存储网站数据，比如用户信息、文章内容等，最常用的是 MySQL 或 MariaDB。
手动安装和配置这些软件，版本之间还可能存在兼容性问题,非常繁琐。
PHPStudy 的出现就是为了解决这个问题，它把这些软件以及它们之间的依赖关系都打包好了，你只需要下载一个安装包，一键安装，就能拥有一个完整的、可用的本地开发环境。
主要特点：
- 集成化: Apache/Nginx + PHP + MySQL 一键切换和管理。
- 多版本支持: 可以轻松切换不同版本的 PHP、MySQL,方便项目兼容性测试。
- 管理方便: 提供图形化界面，一键启动、停止、重启服务。
- 功能丰富: 内置了数据库管理工具（phpMyAdmin）、FTP 工具、文件管理等。
- 免费开源: 对个人用户完全免费。
下载与安装
第一步：下载
- 访问 PHPStudy 的官方网站或可靠的下载源。
- 官方网址:
https://www.xp.cn/(注意：新版的 PHPStudy 已改名为 "小皮面板"，但核心功能不变,界面更现代化) - 在官网下载 "Windows 版" 的安装包。
- 官方网址:
第二步：安装
- 双击下载好的安装包（
phpstudy_pro.zip或Xp.exe）。 - 解压或直接运行安装程序。强烈建议解压到一个不含中文和空格的路径，
D:\phpstudy_pro。 - 按照安装向导的提示进行操作，通常只需要一路点击“下一步”即可。
- 安装完成后，桌面上会出现一个名为 "小皮面板" 或 "PHPStudy" 的快捷方式。
环境配置
第一步：启动 PHPStudy
- 双击桌面上的快捷图标，打开 PHPStudy。
- 你会看到一个简洁的控制面板界面，默认情况下，它可能已经为你启动了服务（Apache + MySQL + PHP）。
第二步：认识控制面板
- 启动/停止/重启: 你可以在这里控制 Apache 和 MySQL 服务。
- 切换版本: 这是 PHPStudy 的核心功能之一，你可以点击顶部的版本号（如
PHP 7.4.33），在弹出的窗口中选择你需要的 PHP 版本和 MySQL 版本，然后点击“切换版本并重启服务”。 - 网站管理: 这里可以管理你本地所有的网站。
- 数据库管理: 快速进入数据库管理工具。
- 文件管理: 快速访问网站根目录。
第三步：确认环境是否正常
- 确保 Apache 和 MySQL 的状态是“运行中”（通常是绿色的）。
- 打开你的浏览器，在地址栏输入
http://localhost或http://127.0.0.1。 - 如果能看到 PHPStudy 的欢迎页面（或类似页面），说明你的 Web 服务器已经成功运行了。
- 打开 PHPStudy 控制面板，点击“数据库管理”，如果能看到 phpMyAdmin 登录界面,说明数据库也运行正常。
创建你的第一个网站
假设我们要创建一个名为 my-first-site 的本地网站。
第一步：创建网站根目录
- 在你的电脑上创建一个文件夹，作为你网站的根目录，同样，路径最好不含中文和空格。
- 在
D:\phpstudy_pro\WWW目录下创建一个名为my-first-site的文件夹。 D:\phpstudy_pro\WWW\my-first-siteWWW是 PHPStudy 默认的网站根目录，所有放在这里的网站都可以通过http://localhost/站点名访问。
- 在
第二步：创建网站配置文件
-
在 PHPStudy 控制面板中，找到 “网站” -> “创建站点”。
-
在弹出的窗口中填写以下信息：
- 域名:
my-first-site(我们使用一个简单的域名,无需后缀) - 根目录:
D:\phpstudy_pro\WWW\my-first-site(选择你刚刚创建的文件夹) - 端口: 默认
80,通常无需修改。 - 数据库: 勾选“创建数据库”，它会自动为你创建一个同名的数据库（
my-first-site），并生成一个随机的用户名和密码。请务必记下这个密码！ - 其他选项可以保持默认。
- 域名:
-
点击“提交”，PHPStudy 会自动配置 Apache/Nginx 的虚拟主机配置文件,并重启服务。
第三步：创建网站文件
-
打开你刚才创建的网站根目录：
D:\phpstudy_pro\WWW\my-first-site。 -
在里面创建一个简单的
index.php文件，用记事本或 VS Code 打开,并输入以下代码：<!DOCTYPE html> <html lang="zh-CN"> <head> <meta charset="UTF-8"> <title>我的第一个 PHP 网站</title> </head> <body> <h1>你好，世界！</h1> <p>这是由 PHPStudy 搭建的本地网站。</p> <?php echo "<p>当前 PHP 版本: " . phpversion() . "</p>"; echo "<p>数据库连接成功！</p>"; ?> </body> </html>
第四步：访问你的网站
- 打开浏览器，在地址栏输入你刚才设置的域名：
http://my-first-site - 如果一切正常，你应该能看到你创建的网页内容，包括 PHP 代码执行后输出的 PHP 版本信息。
恭喜！你已经成功用 PHPStudy 搭建并运行了第一个本地网站！
常用操作
管理数据库
- 在 PHPStudy 控制面板，点击 “数据库管理”。
- 它会自动跳转到
phpMyAdmin页面。 - 使用你创建站点时生成的数据库用户名和密码登录。
- 你可以创建新的数据库、数据表，执行 SQL 语句，导入/导出数据库等。
配置多站点
如果你想同时开发多个项目，blog 和 shop，只需重复 “创建你的第一个网站” 中的步骤：
- 创建新的根目录，如
D:\phpstudy_pro\WWW\blog。 - 在 PHPStudy 中创建新站点，域名为
blog，根目录指向D:\phpstudy_pro\WWW\blog。 - 之后就可以通过
http://blog和http://shop分别访问你的不同项目了。
使用 FTP
如果你需要从远程服务器下载代码到本地，或者上传本地代码到服务器，可以使用 FTP 客户端（如 FileZilla）。
- 在 PHPStudy 控制面板，点击 “FTP” 按钮。
- 它会显示一个 FTP 地址、用户名和密码。
- 在 FileZilla 中填写这些信息，连接后你就可以直接访问网站根目录 (
WWW) 了。
常见问题与高级玩法
问题1：端口被占用
如果启动 Apache 时提示端口被占用（通常是 80 端口），意味着你电脑上可能有其他软件（如 IIS、Skype、其他 Web 服务器）在使用这个端口。
- 解决方法：在 PHPStudy 控制面板，点击“设置” -> “端口设置”，将 Apache 的端口修改为其他未被占用的端口（如
8080），之后访问网站时就需要加上端口号，http://my-first-site:8080。
问题2：本地无法访问，但 localhost 可以
这通常是防火墙或杀毒软件拦截了，请检查你的 Windows 防火墙设置，确保允许 PHPStudy 相关的程序通过。
高级玩法：配置 SSL (HTTPS)
为了模拟生产环境，你可以为本地网站启用 HTTPS。
- 在 PHPStudy 的 “网站” 列表中，找到你的站点，点击右侧的 “SSL” 按钮。
- 它会自动为你生成一个免费的本地 SSL 证书。
- 启用后，你就可以通过
https://my-first-site访问你的网站了，浏览器可能会提示“不安全”，因为这是自签名证书,但在本地开发中这是正常的。
高级玩法：使用 Nginx
PHPStudy 默认使用 Apache，但 Nginx 在处理高并发静态资源时性能更好。
- 在 PHPStudy 控制面板的右上角，有一个切换按钮，可以在 Apache 和 Nginx 之间切换。
- 对于大多数初学者来说，使用 Apache 即可,配置更简单。
PHPStudy 是 PHP 开发者入门和日常开发的利器，通过以上步骤,你应该已经掌握了：
- 安装与启动：快速搭建环境。
- 创建站点：管理多个项目。
- 文件与数据库：进行核心开发工作。
- 基础排错：解决常见问题。
希望这份详细的指南能帮助你顺利开启网站开发之旅！祝你编码愉快！
