PHP函数重复定义错误因include无条件执行导致，第二次载入含同名函数的文件即触发Fatal error；require_once可解决但需确保物理路径一致且避免符号链接等问题。
为什么 include 两次就会报 Cannot redeclare function
因为 PHP 不允许同一作用域下重复定义同名函数，include 是无条件载入并执行文件内容，第二次执行时函数体又出现一遍，PHP 直接终止脚本。这不是语法错误，是运行时致命错误（Fatal error），无法用 try/catch 捕获。
常见触发场景包括：
- 一个文件被
include 'utils.php'两次，且utils.php里直接定义了function format_date() { ... } - 多个入口文件各自
include同一个函数库，而它们又被另一个主文件同时引入 - 路径写法不一致导致重复加载，比如
include 'helpers.php'和include './helpers.php'实际指向同一文件，但 PHP 认为是两个不同路径
require_once 和 include_once 真的能彻底解决吗
能，但有前提：它们依赖 PHP 内部的已加载文件列表（realpath cache），只对「物理路径相同」的文件生效。如果项目中存在符号链接、open_basedir 限制或 realpath 缓存未刷新，仍可能失效。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 统一使用
require_once替代require，尤其在加载函数/类定义文件时 - 所有路径尽量用
__DIR__ . '/lib/functions.php'这种绝对路径写法，避免相对路径歧义 - 开发中可临时加一句
var_dump(get_included_files());确认是否真被去重 - OPcache 启用时，
require_once的性能开销几乎可忽略，不必为“怕慢”而退回到include
函数在条件块里定义为什么会重复报错
PHP 函数声明不是“懒执行”的——即使写在 if 或 for 里，只要该代码段被执行过一次，函数就已注册进当前作用域；后续再次进入该分支，就会触发重复定义。
例如这段代码会报错：
for ($i = 0; $i < 2; $i++) {
if ($i === 1) {
function helper() { return 'done'; }
}
}
正确做法只有两种：
- 把函数定义提到循环/条件外（最常用）
- 改用匿名函数赋值给变量：
$helper = function() { return 'done'; };，它每次都是新实例，无冲突 - 用
function_exists('helper')包一层（仅限兼容旧逻辑，不推荐作为常规方案）
第三方扩展或框架自带同名函数怎么办
比如 PHPCMS 的 go() 和 Swoole 的 go() 冲突，或者你引入的 SDK 和 Laravel 辅助函数重名。这类问题 require_once 无效，因为函数来自不同文件，但最终都注册到全局命名空间。
解决路径很实际：
- 优先查文档确认是否已有别名机制（如 Laravel 的
Str::of()替代部分字符串函数） - 没有的话，只能改一方：要么重命名你自己的函数（加前缀如
my_go()），要么修改第三方代码（仅限开源且可控项目） - 切勿用
unset($GLOBALS['go'])或反射删除函数——PHP 不支持运行时卸载函数，这么做无效且危险 - 如果项目已用 Composer，考虑将冲突函数封装进独立命名空间的类方法中，避开全局污染
真正麻烦的从来不是怎么修，而是怎么发现——上线后才暴露的函数名冲突，往往藏在自动加载链深处。建议在 CI 阶段加一道静态扫描：用 php -l 配合自定义脚本检查所有 .php 文件里的 function 声明，提前比对高频短名（go、dd、dump、env）是否重复。
