第一步:检查基础运行状态(最常见)

这是最可能的原因,也是最先要检查的。

phpstudy 网站空白
(图片来源网络,侵删)

Apache/Nginx 服务是否启动?

PHPStudy 本身只是一个集成环境,它需要里面的 Web 服务器(Apache 或 Nginx)来运行你的网站。

检查方法:

  • 看图标颜色: 观察 PHPStudy 右下角托盘图标的颜色。
    • 绿色:表示服务已正常启动。
    • 红色:表示服务未启动。
    • 橙色/黄色:表示服务启动异常或有其他问题。
  • 看主界面: 打开 PHPStudy 主程序,在“启动”选项卡下,确保你的 Web 服务器(如 Apache 或 Nginx)的状态是“运行中”。

解决方案: 如果图标是红色或服务未启动,请点击“启动”按钮,启动对应的服务。

浏览器缓存问题

浏览器缓存了旧的错误页面(404 或 500 错误),导致即使服务器修复了,你看到的还是空白。

phpstudy 网站空白
(图片来源网络,侵删)

解决方案:

  • 强制刷新页面: 在浏览器中按 Ctrl + F5 (Windows) 或 Cmd + Shift + R (Mac)。
  • 清除浏览器缓存: 打开浏览器设置,清除缓存和 Cookie,然后再访问网站。
  • 使用无痕/隐私模式: 在无痕模式下访问网站,这样可以排除所有插件和缓存的干扰。

第二步:检查网站配置

如果服务已启动,但网站依然空白,那问题很可能出在网站本身的配置上。

网站根目录是否正确?

网站服务器需要知道去哪个文件夹里找你的网站文件,这个文件夹被称为“网站根目录”。

检查方法:

phpstudy 网站空白
(图片来源网络,侵删)
  1. 打开 PHPStudy 主程序。
  2. 切换到“站点管理”选项卡。
  3. 找到你正在访问的域名(http://localhosthttp://www.test.com)。
  4. 查看对应的“目录”路径是否正确,这个路径应该指向你存放网站代码(如 index.php, index.html)的文件夹。

常见错误:

  • 目录指向了错误的文件夹。
  • 目录指向的文件夹为空,或者里面根本没有 index.php/index.html 这类默认首页文件。

解决方案:

  • 如果路径错误,请点击“修改”按钮,更正到正确的文件夹路径。
  • 确保你的网站文件(特别是首页文件)已经放在了指定的根目录下。

端口是否被占用或冲突?

PHPStudy 默认使用 80 端口(Apache)和 443 端口(HTTPS),如果你的电脑上其他软件(如 IIS、Skype、一些下载工具)也占用了 80 端口,就会导致 Apache 启动失败,从而显示空白。

检查方法:

  • 启动 PHPStudy 时,留意弹出的提示框,看是否有“端口被占用”之类的错误信息。

解决方案:

  1. 更换端口(推荐):
    • 在 PHPStudy 的“其他选项菜单”(齿轮图标)中,选择“端口检测”。
    • 它会自动检测并推荐一个可用的端口(如 8080)。
    • 点击“更换”,然后重启 PHPStudy 服务。
    • 之后,你需要通过 http://localhost:8080 来访问你的网站。
  2. 关闭占用端口的程序:
    • Win + R,输入 cmd,打开命令提示符。
    • 输入 netstat -ano | findstr :80 查看占用 80 端口的进程 ID (PID)。
    • 打开任务管理器,找到对应 PID 的进程并结束它。

第三步:检查代码和PHP环境

如果以上配置都正确,那问题可能出在代码本身或 PHP 环境上。

PHP 错误报告被关闭

如果你的 PHP 代码有语法错误,但 PHP 的错误报告功能被关闭了,浏览器就会显示一个空白页,而不是具体的错误信息。

解决方案: 临时开启 PHP 错误报告,这样你就能看到具体的错误原因了。

  1. 在你的网站根目录下创建一个名为 debug.php 的文件。

  2. 将以下代码复制进去:

    <?php
    // 开启所有错误报告
    error_reporting(E_ALL);
    // 显示所有错误
    ini_set('display_errors', 1);
    // 测试代码,这里故意写一个错误
    $a = b; // 这是一个未定义变量的错误
    echo "如果你看到这句话,说明PHP环境正常,并且错误报告已开启。";
    ?>
  3. 访问 http://localhost/debug.php

    • 如果显示了错误信息:恭喜你,问题找到了!根据错误信息去修改你的代码。
    • 如果依然是空白页:这说明 PHP 环境本身可能有问题,请看下一步。

PHP版本不兼容或环境损坏

你网站使用的 PHP 代码可能与你选择的 PHP 版本不兼容,或者 PHPStudy 的 PHP 环境文件损坏了。

解决方案:

  • 切换 PHP 版本: 在 PHPStudy 的“切换版本”选项卡中,尝试切换到另一个稳定且常用的版本(如 PHP 7.4 或 8.0),然后重启服务,看看问题是否解决。
  • 修复环境: 在“其他选项菜单”中,选择“修复环境”或“重置环境”,这可以修复一些常见的配置问题,操作后需要重启服务。

第四步:检查防火墙和安全软件

Windows 防火墙或第三方杀毒软件会阻止 PHPStudy 的网络访问。

解决方案:

  • 临时关闭防火墙/杀毒软件,然后尝试访问网站,如果能访问,说明就是它们的问题。
  • 如果确认是它们的问题,请不要一直关闭,而是将 PHPStudy 的主程序和 Web 服务器(httpd.exenginx.exe)添加到防火墙的“允许通过”列表中。

排查清单

当你遇到 PHPStudy 网站空白时,请按以下顺序检查:

  1. [ ] 启动服务: 确保 PHPStudy 图标是绿色的,Apache/Nginx 服务正在运行。
  2. [ ] 刷新浏览器:Ctrl + F5 强制刷新,或使用无痕模式。
  3. [ ] 检查根目录: 在“站点管理”中确认网站的“目录”路径是否正确,且里面有首页文件。
  4. [ ] 检查端口: 看是否有端口占用错误,尝试更换一个端口(如 8080)。
  5. [ ] 开启错误报告: 创建 debug.php 文件,看是否能显示具体的 PHP 错误。
  6. [ ] 切换 PHP 版本: 尝试切换到另一个 PHP 版本。
  7. [ ] 检查防火墙: 临时关闭防火墙或添加例外。

按照这个流程,90% 以上的“网站空白”问题都能得到解决,如果问题依旧存在,请提供更详细的信息,

  • 你使用的 PHPStudy 版本。
  • 选择的 PHP 版本。
  • 访问的具体网址。
  • 网站根目录里有哪些文件。
  • 是否有任何错误提示信息。