PHP重复include脚本时函数重定义报错问题解析

问题场景 #

出错的代码文件 #

File b.php

<?php
if(defined('Yes')) return;
define('Yes', 1);
function f(){
     return 0;
}
?>

File a.php

<?php
    include 'b.php';
    include 'b.php';
?>

运行a.php时，会触发**“函数f已定义”**的错误，但按预期应该不会报错。将b.php修改为以下代码后，即可正常运行：

修改后的b.php

<?php
if(!defined('Yes')){
define('Yes',1);
function f(){
     return 0;
}
}?>

原因解析 #

核心在于PHP的编译阶段和执行阶段分离的特性：

• 第一个版本的b.php问题：
  PHP处理脚本时，先做编译扫描，再执行代码。全局作用域下的function f()定义会在编译阶段就被识别并尝试注册到全局函数表，完全不受执行阶段的if(defined('Yes')) return;控制。
  第一次include时，编译+执行都正常，函数f被注册；第二次include时，编译阶段扫描到b.php里的function f()，不管后面的return会不会执行，都会直接尝试重复注册函数，触发报错。

• 修改后的b.php为什么正常：
  把函数定义放到if(!defined('Yes'))的代码块内部后，PHP会将这种“条件包裹的函数定义”延迟到执行阶段处理。只有当代码块被执行时，才会注册函数。
  第二次include时，defined('Yes')为true，不会进入代码块，自然不会执行函数定义的逻辑，也就不会触发重复定义错误。

额外提示 #

PHP里的函数定义规则：

• 全局作用域的函数定义，编译阶段就会处理，和执行流程无关；
• 条件语句（if/switch等）内部的函数定义，执行到对应代码块时才会注册函数。

内容的提问来源于stack exchange，提问作者Chalam S Chetti