php函数重复定义会触发编译期致命错误，无法捕获；require_once不能防止同名函数冲突；应优先用function_exists()兜底或改用命名空间/类静态方法。
PHP 函数重复定义会直接报致命错误
PHP 不允许同一作用域内重复 function 声明，一旦触发 Fatal error: Cannot redeclare xxx()，脚本立刻终止。这不是警告，没法靠 @ 抑制，也没法用 try/catch 捕获——它发生在编译阶段，比运行早。
require_once 和 include_once 并不能解决函数重复定义问题
很多人以为只要文件只引入一次就安全了，但现实是：require_once 只保证文件不被重复加载，不保证函数不被重复定义。比如两个不同文件都写了 function helper() { ... }，且都被 require_once 加载，照样报错。
- 多个模块各自封装了同名工具函数（如
log_debug()），又没做命名空间或前缀隔离 - Composer 自动加载 + 手动
require混用，导致类/函数文件被加载两次 - 测试环境里反复
include同一函数库（比如 PHPUnit 的 setup 方法里）
判断函数是否已存在再定义是最稳妥的兜底方式
用 function_exists() 包一层，是 PHP 原生、轻量、兼容所有版本的防御写法。它不改变逻辑，只跳过重复声明，适合工具函数、全局辅助函数等场景。
if (!function_exists('array_flatten')) {
function array_flatten($arr) {
return iterator_to_array(new \RecursiveIteratorIterator(
new \RecursiveArrayIterator($arr)
), false);
}
}-
function_exists()判断的是当前作用域（含包含链）中是否已有该函数名，不是看文件是否加载过 - 不要对业务核心函数用这招——如果真需要多次覆盖，说明设计有问题；它只适用于“谁先定义谁生效”的工具层
- 注意：匿名函数、闭包不能用
function_exists()判断，它们没有函数名
更彻底的解法是放弃全局函数，改用类+静态方法或命名空间
PHP 5.3+ 支持命名空间，5.6+ 支持常量和函数的命名空间导入。把函数收进命名空间，天然避免冲突，也方便 Composer 自动加载管理。
立即学习“PHP免费学习笔记（深入）”；
namespace Utils;
function array_flatten($arr) { /* ... */ }使用时：use function Utils\array_flatten; 或直接 Utils\array_flatten($data)。
- 类静态方法（
Utils::array_flatten()）更易测试和 mock，也符合 PSR-4 规范 - 命名空间函数仍可能因未加
use而意外调用到全局同名函数，注意 IDE 提示和运行时行为 - 老项目迁移时，别忘了检查
autoload.php是否已支持函数自动加载（Composer 2.0+ 默认支持）
函数重复定义的坑不在语法多难懂，而在它往往藏在“看起来没问题”的加载逻辑里——比如一个被 require_once 保护的文件，又被另一个 Composer 包通过自动加载机制悄悄拉进来一次。
