PHPStudy 是什么?
PHPStudy 是一款非常流行的 Windows 环境下集成软件包,它将 Apache (Web 服务器)、MySQL (数据库)、PHP (编程语言) 以及一些常用扩展打包在一起,您只需要安装这一个软件,就能快速搭建一个功能完善的本地 PHP 开发环境,无需手动配置复杂的依赖关系。

(图片来源网络,侵删)
第一步:下载与安装 PHPStudy
-
下载
- 访问 PHPStudy 的官方网站:https://www.xp.cn
- 根据您的 Windows 系统位数(通常是 64 位),下载对应的版本,目前最新版是 PHPStudy 8.1。
-
安装
- 双击下载好的安装包(
phpstudy_64.zip)。 - 解压到一个您希望安装的目录,
D:\phpstudy。建议不要安装在 C 盘,因为后续操作可能会需要管理员权限。 - 解压后,进入
D:\phpstudy目录,双击运行phpstudy.exe。
- 双击下载好的安装包(
第二步:启动核心服务
安装完成后,启动 PHPStudy,界面通常如下:
-
启动 Apache 和 MySQL:
(图片来源网络,侵删)- 在软件主界面的右侧,点击 启动 按钮。
- 您会看到 Apache 和 MySQL 的状态从“未启动”变为“运行中”,并且端口号(Apache 默认 80,MySQL 默认 3306)会显示出来。
-
验证是否成功:
- 打开您的浏览器(如 Chrome、Firefox)。
- 在地址栏输入
http://localhost或http://127.0.0.1。 - 如果看到 PHPStudy 的欢迎页面,就说明您的 Web 服务器(Apache)已经成功运行了!
第三步:配置网站(核心步骤)
现在我们来创建一个自己的网站项目,假设我们要创建一个名为 myblog 的博客项目。
使用“网站管理”功能(推荐,最简单)
这是 PHPStudy 提供的最便捷的网站管理方式。
-
打开“网站管理”:
- 在 PHPStudy 主界面的左侧菜单栏,点击 “网站” -> “管理”。
-
添加网站:
- 在弹出的窗口中,点击左下角的 “添加站点”。
-
填写网站信息:
- 域名:输入您想用来访问这个网站的本地域名。
myblog.local。注意:这里填写的是域名,不是http://开头的网址。 - 根目录:选择您网站项目的文件存放路径。
D:\phpstudy\WWW\myblog,这个目录就是您的网站根目录,所有网页文件都放在这里。 - 端口:保持默认的
80即可,80 端口被占用,可以改为其他端口(如 8080),但访问时就需要加上端口号,http://myblog.local:8080。 - 数据库:如果您需要数据库,可以勾选“创建数据库”,并输入数据库名称(
myblog_db),PHPStudy 会自动为您创建。
- 域名:输入您想用来访问这个网站的本地域名。
-
确认并保存:
- 填写完毕后,点击 “确定”。
手动修改 httpd-vhosts.conf 文件(适合需要更复杂配置的用户)
-
找到配置文件:
- 在 PHPStudy 主界面,点击 “其他选项菜单” (右上角的小箭头) -> “打开配置文件” -> “httpd-vhosts.conf”。
-
添加虚拟主机配置:
- 打开的文件里可能已经有一些示例配置,在文件末尾,添加如下配置:
# 注意:这里的路径和域名需要根据您的实际情况修改 <VirtualHost *:80> DocumentRoot "D:/phpstudy/WWW/myblog" # 您的网站根目录 ServerName myblog.local # 您的本地域名 ServerAlias myblog.local # 可选,用于匹配其他别名 <Directory "D:/phpstudy/WWW/myblog"> Options Indexes FollowSymLinks AllowOverride All Require all granted </Directory> </VirtualHost>- DocumentRoot: 指向您的网站文件夹。
- ServerName: 您的本地域名。
- Directory: 这部分非常重要,它定义了对网站根目录的访问权限。
AllowOverride All允许使用.htaccess文件,Require all granted允许所有访问。
-
保存文件。
第四步:配置本地域名解析
PHPStudy 和 Apache 都已经知道 myblog.local 这个域名指向哪个文件夹了,但您的操作系统还不知道,为了让系统能将 myblog.local 解析到本机(127.0.0.1),我们需要修改 hosts 文件。
-
打开
hosts文件:- 在 PHPStudy 主界面,点击 “其他选项菜单” -> “打开hosts文件”,PHPStudy 会自动用管理员权限为您用记事本打开它。
-
添加域名映射:
- 在文件的最末尾,添加一行:
0.0.1 myblog.local - 这行代码的意思是:所有发往
myblog.local的请求,都指向本机的 IP 地址0.0.1。
- 在文件的最末尾,添加一行:
-
保存文件。
第五步:测试您的网站
-
放置测试文件:
- 进入您设置的网站根目录(
D:\phpstudy\WWW\myblog)。 - 创建一个新的文件,命名为
index.php。 - 用记事本打开
index.php,输入以下代码:<?php echo "Hello, My Blog!"; phpinfo(); // 这行可以显示PHP的详细配置信息,方便调试 ?>
- 进入您设置的网站根目录(
-
访问网站:
- 重要:如果之前用的是“方法一”的网站管理功能,请确保在“网站管理”窗口中,您添加的网站是 “启动” 状态(绿色对勾)。
- 打开浏览器,在地址栏输入您配置的域名:
http://myblog.local - 如果看到页面显示 "Hello, My Blog!" 和一大片 PHP 配置信息,那么恭喜您,您的网站已经成功配置并运行了!
第六步:管理数据库
您的网站通常需要数据库。
-
打开数据库管理工具:
- 在 PHPStudy 主界面,点击 “其他选项菜单” -> “phpMyAdmin”。
- 它会自动在浏览器中打开 phpMyAdmin 的登录页面。
-
登录:
- 用户名:
root - 密码:
root(这是 PHPStudy 的默认密码,如果您在安装时修改过,请使用您自己的密码)。
- 用户名:
-
创建和管理数据库:
登录后,您就可以在 phpMyAdmin 中创建新的数据库、导入/导出数据库文件、执行 SQL 语句等。
常见问题与解决方案
-
问题1:
http://localhost可以访问,但http://myblog.local访问不了或显示 404。- 原因:最可能是
hosts文件没有配置正确,或者 Apache 的虚拟主机配置有误。 - 解决:
- 检查
hosts文件是否正确添加了0.0.1 myblog.local。 - 检查
httpd-vhosts.conf中的DocumentRoot路径是否存在,以及ServerName是否和hosts文件中的域名一致。 - 重启 PHPStudy,让配置生效。
- 检查
- 原因:最可能是
-
问题2:Apache 启动失败,提示端口 80 被占用。
- 原因:您的电脑上可能有其他软件正在使用 80 端口,IIS、Skype、迅雷等。
- 解决:
- 在 PHPStudy 中切换一个其他空闲的端口(如 8080)。
- 或者,找到占用 80 端口的程序并关闭它(可以通过任务管理器或
netstat -ano命令查找)。
-
问题3:网站目录无法创建文件或修改文件。
- 原因:权限问题,PHPStudy 运行时可能没有对您设置的网站目录的写入权限。
- 解决:右键点击您的网站目录(如
D:\phpstudy\WWW\myblog),选择 “属性” -> “安全” 选项卡,确保您的当前用户账户有“完全控制”权限。
配置 PHPStudy 网站的流程可以总结为以下四步:
- 启动服务:运行 PHPStudy,点击“启动”。
- 配置网站:通过“网站管理”或手动修改
vhosts.conf定义域名和根目录。 - 解析域名:修改
hosts文件,让系统知道你的域名指向本地。 - 放置代码:在根目录下放置
index.php等文件进行测试。
希望这个详细的教程能帮助您顺利配置好本地开发环境!祝您编码愉快!
