PHPStudy 是什么?

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

phpstudy 配置网站
(图片来源网络,侵删)

第一步:下载与安装 PHPStudy

  1. 下载

    • 访问 PHPStudy 的官方网站:https://www.xp.cn
    • 根据您的 Windows 系统位数(通常是 64 位),下载对应的版本,目前最新版是 PHPStudy 8.1
  2. 安装

    • 双击下载好的安装包(phpstudy_64.zip)。
    • 解压到一个您希望安装的目录,D:\phpstudy建议不要安装在 C 盘,因为后续操作可能会需要管理员权限。
    • 解压后,进入 D:\phpstudy 目录,双击运行 phpstudy.exe

第二步:启动核心服务

安装完成后,启动 PHPStudy,界面通常如下:

  1. 启动 Apache 和 MySQL

    phpstudy 配置网站
    (图片来源网络,侵删)
    • 在软件主界面的右侧,点击 启动 按钮。
    • 您会看到 Apache 和 MySQL 的状态从“未启动”变为“运行中”,并且端口号(Apache 默认 80,MySQL 默认 3306)会显示出来。
  2. 验证是否成功

    • 打开您的浏览器(如 Chrome、Firefox)。
    • 在地址栏输入 http://localhosthttp://127.0.0.1
    • 如果看到 PHPStudy 的欢迎页面,就说明您的 Web 服务器(Apache)已经成功运行了!

第三步:配置网站(核心步骤)

现在我们来创建一个自己的网站项目,假设我们要创建一个名为 myblog 的博客项目。

使用“网站管理”功能(推荐,最简单)

这是 PHPStudy 提供的最便捷的网站管理方式。

  1. 打开“网站管理”

    • 在 PHPStudy 主界面的左侧菜单栏,点击 “网站” -> “管理”
  2. 添加网站

    • 在弹出的窗口中,点击左下角的 “添加站点”
  3. 填写网站信息

    • 域名:输入您想用来访问这个网站的本地域名。myblog.local注意:这里填写的是域名,不是 http:// 开头的网址。
    • 根目录:选择您网站项目的文件存放路径。D:\phpstudy\WWW\myblog,这个目录就是您的网站根目录,所有网页文件都放在这里。
    • 端口:保持默认的 80 即可,80 端口被占用,可以改为其他端口(如 8080),但访问时就需要加上端口号,http://myblog.local:8080
    • 数据库:如果您需要数据库,可以勾选“创建数据库”,并输入数据库名称(myblog_db),PHPStudy 会自动为您创建。
  4. 确认并保存

    • 填写完毕后,点击 “确定”

手动修改 httpd-vhosts.conf 文件(适合需要更复杂配置的用户)

  1. 找到配置文件

    • 在 PHPStudy 主界面,点击 “其他选项菜单” (右上角的小箭头) -> “打开配置文件” -> “httpd-vhosts.conf”
  2. 添加虚拟主机配置

    • 打开的文件里可能已经有一些示例配置,在文件末尾,添加如下配置:
    # 注意:这里的路径和域名需要根据您的实际情况修改
    <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 允许所有访问。
  3. 保存文件


第四步:配置本地域名解析

PHPStudy 和 Apache 都已经知道 myblog.local 这个域名指向哪个文件夹了,但您的操作系统还不知道,为了让系统能将 myblog.local 解析到本机(127.0.0.1),我们需要修改 hosts 文件。

  1. 打开 hosts 文件

    • 在 PHPStudy 主界面,点击 “其他选项菜单” -> “打开hosts文件”,PHPStudy 会自动用管理员权限为您用记事本打开它。
  2. 添加域名映射

    • 在文件的最末尾,添加一行:
      0.0.1 myblog.local
    • 这行代码的意思是:所有发往 myblog.local 的请求,都指向本机的 IP 地址 0.0.1
  3. 保存文件


第五步:测试您的网站

  1. 放置测试文件

    • 进入您设置的网站根目录(D:\phpstudy\WWW\myblog)。
    • 创建一个新的文件,命名为 index.php
    • 用记事本打开 index.php,输入以下代码:
      <?php
          echo "Hello, My Blog!";
          phpinfo(); // 这行可以显示PHP的详细配置信息,方便调试
      ?>
  2. 访问网站

    • 重要:如果之前用的是“方法一”的网站管理功能,请确保在“网站管理”窗口中,您添加的网站是 “启动” 状态(绿色对勾)。
    • 打开浏览器,在地址栏输入您配置的域名:http://myblog.local
    • 如果看到页面显示 "Hello, My Blog!" 和一大片 PHP 配置信息,那么恭喜您,您的网站已经成功配置并运行了!

第六步:管理数据库

您的网站通常需要数据库。

  1. 打开数据库管理工具

    • 在 PHPStudy 主界面,点击 “其他选项菜单” -> “phpMyAdmin”
    • 它会自动在浏览器中打开 phpMyAdmin 的登录页面。
  2. 登录

    • 用户名root
    • 密码root (这是 PHPStudy 的默认密码,如果您在安装时修改过,请使用您自己的密码)。
  3. 创建和管理数据库

    登录后,您就可以在 phpMyAdmin 中创建新的数据库、导入/导出数据库文件、执行 SQL 语句等。


常见问题与解决方案

  • 问题1:http://localhost 可以访问,但 http://myblog.local 访问不了或显示 404。

    • 原因:最可能是 hosts 文件没有配置正确,或者 Apache 的虚拟主机配置有误。
    • 解决
      1. 检查 hosts 文件是否正确添加了 0.0.1 myblog.local
      2. 检查 httpd-vhosts.conf 中的 DocumentRoot 路径是否存在,以及 ServerName 是否和 hosts 文件中的域名一致。
      3. 重启 PHPStudy,让配置生效。
  • 问题2:Apache 启动失败,提示端口 80 被占用。

    • 原因:您的电脑上可能有其他软件正在使用 80 端口,IIS、Skype、迅雷等。
    • 解决
      1. 在 PHPStudy 中切换一个其他空闲的端口(如 8080)。
      2. 或者,找到占用 80 端口的程序并关闭它(可以通过任务管理器或 netstat -ano 命令查找)。
  • 问题3:网站目录无法创建文件或修改文件。

    • 原因:权限问题,PHPStudy 运行时可能没有对您设置的网站目录的写入权限。
    • 解决:右键点击您的网站目录(如 D:\phpstudy\WWW\myblog),选择 “属性” -> “安全” 选项卡,确保您的当前用户账户有“完全控制”权限。

配置 PHPStudy 网站的流程可以总结为以下四步:

  1. 启动服务:运行 PHPStudy,点击“启动”。
  2. 配置网站:通过“网站管理”或手动修改 vhosts.conf 定义域名和根目录。
  3. 解析域名:修改 hosts 文件,让系统知道你的域名指向本地。
  4. 放置代码:在根目录下放置 index.php 等文件进行测试。

希望这个详细的教程能帮助您顺利配置好本地开发环境!祝您编码愉快!