PHP 在编译阶段即预处理顶层函数定义，无论其是否被条件语句包裹；因此 include 同一含函数声明的文件多次会触发“重复定义”错误，而将函数声明置于运行时条件分支内可规避该问题。
php 在编译阶段即预处理顶层函数定义，无论其是否被条件语句包裹；因此 `include` 同一含函数声明的文件多次会触发“重复定义”错误，而将函数声明置于运行时条件分支内可规避该问题。
在 PHP 中，函数声明（function f() { ... }）具有特殊的编译行为：只要位于脚本顶层作用域（即不在任何条件、循环或函数体内），PHP 解析器会在编译阶段（compile time）就识别并注册该函数名，而完全忽略其周围的运行时逻辑（如 if 判断）。这意味着：
- 即使函数声明被写在
if (defined('Yes')) return;之后，PHP 仍会在首次include 'b.php'时——甚至在执行if语句前——完成对function f()的注册； - 第二次
include 'b.php'时，PHP 再次尝试注册同名函数f，从而抛出Fatal error: Cannot redeclare f()。
✅ 正确做法：将函数声明置于运行时条件内部
<?php
// b.php —— 安全的条件式声明
if (!defined('Yes')) {
define('Yes', 1);
function f() {
return 0;
}
}
?>此时，function f() 不再是顶层声明，而是嵌套在 if 语句块中。PHP 编译器将其识别为条件函数声明（conditional function declaration），仅在运行时执行到该 if 分支且条件为真时，才实际注册函数。因此第二次 include 不会重复定义，避免错误。
⚠️ 注意事项与最佳实践
-
不要依赖
return提前退出来保护函数声明：if (defined(...)) return;对顶层函数无效，因函数已在return执行前被编译注册。 -
优先使用
include_once或require_once：它们由 PHP 内部保证同一文件仅被加载一次，从根本上避免重复包含和定义问题：// a.php <?php include_once 'b.php'; // ✅ 推荐：安全、简洁、语义明确 include_once 'b.php'; // 无副作用，自动跳过 ?>
-
类声明（
class）同样遵循此规则：顶层class C {}也会被编译时注册，需同样用if (!class_exists('C')) { class C {} }或include_once防护。 - 函数内声明（非顶层）不受影响：若函数定义在另一个函数体内，则属于运行时行为，每次调用外层函数才会重新声明（不推荐，易混淆）。
? 验证示例
// test.php <?php echo "Before first include\n"; include 'b.php'; // 第一次：成功定义 Yes 和 f() echo "After first include\n"; echo "Before second include\n"; include 'b.php'; // 第二次：报错 —— f() 已存在 ?>
运行将输出：
Before first include After first include Before second include Fatal error: Cannot redeclare f() in b.php on line X
这清晰印证了：函数声明的“可见性”由语法位置决定，而非执行流控制。
立即学习“PHP免费学习笔记（深入）”；
总结而言，理解 PHP 的“编译时函数注册”机制，是编写可复用、可安全多次引入的 PHP 公共库代码的关键基础。与其手动维护定义标记（如 define('Yes', 1)），不如善用语言原生设施 include_once —— 简洁、可靠、符合工程惯例。
