PHP if语句触发500内部服务器错误的原因排查

问题背景 #

开发基于Twilio的简易短信发送脚本，实现短信发送同步存储消息记录到数据库的功能，未添加if判断语句时全量代码运行正常。
业务流程如下：

• 用户在前端表单填写手机号、短信内容
• 表单数据通过POST方法提交至process.php
• process.php调用Twilio API完成短信发送，同时将短信日志写入数据库

开发者具备丰富PHP开发经验，本次使用的是已经在生产环境应用数千次的基础if判断结构，但添加if包裹代码后持续触发500错误，无法定位根因。出问题的代码片段如下：

if(isset($_POST['phone_number'])) {

    $sms_to = $_POST['phone_number'];
    $sms_body = $_POST['sms_message'];

    require_once '../vendor/autoload.php';

    // ... 其余大量业务代码

} else {
    echo "Sorry, message not sent. No phone number was entered.";
}

已完成的自排查：反复核查全量代码，确认不存在语法问题；移除if结构包裹后代码可正常执行，只要添加该if结构就返回500错误。

排查方向 #

按优先级从高到低逐一验证：

• 优先排查变量作用域问题：当前if块包裹了require_once加载依赖、变量定义的逻辑，要确认if块外部是否存在调用仅在if块内初始化的对象/变量的逻辑——比如Twilio客户端实例、数据库连接对象如果是在if块内创建的，块外的日志写入、响应输出逻辑调用这些未定义的资源时，会直接触发致命错误返回500。
• 校验相对路径的有效性：if判断生效时，请求的执行上下文如果和无if时存在差异（比如文件被其他入口文件include、路由重写改变了当前工作目录），相对路径../vendor/autoload.php会找不到目标文件触发致命错误。可临时替换为__DIR__ . '/../vendor/autoload.php'固定路径基准，排除路径问题。
• 直接输出具体错误信息定位：在process.php最顶部加入以下配置，把500错误对应的具体致命错误信息直接展示，无需盲猜：

ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);

• 补全POST字段校验：当前if仅判断了phone_number字段是否存在，但块内直接读取了$_POST['sms_message']，如果前端提交时漏传该字段，会触发Undefined array key级别的错误，若当前PHP环境配置了警告升级为致命错误，就会直接返回500。
• 排查块外冗余逻辑：确认if块内的短信发送、数据库写入逻辑执行完成后，是否存在块外的重复执行逻辑——比如块外重复加载依赖文件、重复执行数据库插入、重复调用短信接口，触发类重复声明、主键冲突等致命错误。

内容的提问来源于stack exchange，提问作者Eoin H