服务器本身知道出错了，但它出于安全考虑，不会把具体的错误信息（比如哪个文件、哪一行代码、是什么错误）直接显示给用户（也就是你）。
（图片来源网络，侵删）
我们的排查思路就是：如何让服务器把“真相”告诉我们。
第一步：也是最关键的一步 —— 开启 PHP 错误报告
这是解决 99% 的 PHP 500 错误的方法，你需要告诉 PHP：“请把所有错误都显示出来，不要藏着掖着！”
方法 1：在 PHP 文件中临时添加代码（推荐）
在你怀疑出错的 PHP 文件的最开头（<?php 下面）添加以下几行代码：
<?php
// 开启所有错误报告
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);
// ... 你原来的代码 ...
ini_set('display_errors', 1);：告诉 PHP 在浏览器上显示错误信息。ini_set('display_startup_errors', 1);：显示 PHP 启动时的错误。error_reporting(E_ALL);：设置报告所有级别的错误。
做完这一步后，刷新你的网页。 如果问题出在这个文件上，你现在应该能看到具体的错误信息了，
（图片来源网络，侵删）
Fatal error: Uncaught Error: Call to undefined function some_function()Parse error: syntax error, unexpected '}' in /path/to/your/file.php on line 20Warning: include_once(...): Failed opening required '.../header.php'
有了这些具体的错误信息,你就可以轻松地定位问题并修复它。
第二步：如果第一步没效果，检查服务器配置
你无法直接修改 PHP 文件（比如在虚拟主机环境中），或者错误发生在 include 或 require 的文件里，这时你需要检查服务器的配置文件。
检查 .htaccess 文件
如果你的网站使用 Apache 服务器，.htaccess 文件是一个常见的罪魁祸首。
- 语法错误：检查
.htaccess文件中是否有语法错误。RewriteRule规则写错了，或者括号不匹配。 - 权限问题：确保
.htaccess文件的权限正确（通常是644）。 - 尝试重命名：将
.htaccess文件临时重命名为.htaccess_old，然后刷新页面，如果错误消失了，说明问题就出在这个文件里，你需要仔细检查它的内容。
检查 php.ini 文件
php.ini 是 PHP 的主配置文件。
（图片来源网络，侵删）
- 找到
php.ini：你可以在 PHP 文件中添加phpinfo();来查看当前使用的php.ini文件路径。 - 检查关键设置：
display_errors：确保它被设置为On，如果设置为Off，你就看不到任何错误信息。error_log：检查错误日志的路径，即使display_errors是Off，错误也会被记录到这个日志文件里，你可以通过查看这个日志来找到错误原因。
第三步：常见的 500 错误原因及解决方案
当你通过第一步看到了具体的错误信息后,可以对照以下常见原因进行排查：
语法错误
这是最常见的原因,比如缺少分号 、括号 或大括号 。
- 错误示例：
$myVar = "hello"(缺少分号) - 解决方案：根据错误提示的行号，检查代码语法。
函数或类未定义
你调用的一个函数或类不存在,或者拼写错误。
- 错误示例：
$result = strolower($string);(应该是strtolower) - 解决方案：检查函数名拼写，或者确认所需的 PHP 扩展是否已加载并启用（使用
mysqli函数需要php-mysql扩展）。
文件包含失败
include 或 require 的文件路径错误，或者文件不存在。
- 错误示例：
require_once '../config.php';(如果当前目录不对，路径就会错) - 解决方案：使用绝对路径（从网站根目录开始的路径）会更安全，
require_once $_SERVER['DOCUMENT_ROOT'] . '/config.php';
内存不足
脚本尝试分配的内存超过了 PHP 的 memory_limit 限制。
- 错误示例：处理一个超大图片或文件时出错。
- 解决方案：
- 在代码中临时增加内存：
ini_set('memory_limit', '256M'); - 在
php.ini中永久修改memory_limit的值。
- 在代码中临时增加内存：
权限问题
PHP 运行的用户（通常是 www-data 或 apache）没有权限写入某个文件或目录。
- 错误示例：尝试上传文件或写入日志时出错。
- 解决方案：使用
chown和chmod命令修改文件/目录的所有者和权限，确保 Web 服务器用户有读写权限。
超时
脚本执行时间超过了 max_execution_time 限制。
- 错误示例：一个复杂的数据库查询或循环耗时过长。
- 解决方案：
- 在代码中临时增加超时时间：
set_time_limit(300);// 设置为 300 秒 - 在
php.ini中修改max_execution_time。
- 在代码中临时增加超时时间：
总结排查流程
- 立即行动：在你的 PHP 文件开头添加
ini_set('display_errors', 1); error_reporting(E_ALL);。 - 刷新页面：查看浏览器中显示的具体错误信息。
- 根据错误信息修复：
- 如果是
Parse error，检查语法。 - 如果是
Fatal error: Call to undefined function，检查函数/扩展。 - 如果是
Warning: include，检查文件路径。
- 如果是
- 如果看不到错误：
- 检查
.htaccess文件是否有误，尝试重命名它。 - 检查服务器的
php.ini文件中display_errors是否为On。 - 查看服务器的错误日志文件。
- 检查
- 修复后：别忘了把你第一步添加的调试代码删除，以免在生产环境中暴露敏感信息。
按照这个流程,绝大多数 PHP 500 错误都能被快速定位和解决。
