require_once 和 include_once 按归一化绝对路径判断是否已加载，需用 realpath() 确认路径一致；函数定义受编译期 hoisting 影响，条件语句内声明仍会重复报错；变量作用域与 require_once 无关，配置应放顶层或依赖注入。
require_once 和 include_once 不起作用？检查路径是否被解析为不同绝对路径
PHP 的 require_once 和 include_once 是按**归一化后的绝对路径**判断是否已加载，不是简单比对字符串。如果同一文件被不同相对路径引入（如 ./config.php 和 ../includes/config.php），且最终指向相同物理文件，在 PHP 5+ 中通常能正确去重；但在某些旧环境或符号链接混乱时仍可能失败。
常见现象：Fatal error: Cannot redeclare my_function()，但代码里明明只写了 1 次 require_once。
- 用
realpath('your_file.php')打印实际路径，确认所有引入点是否真的归一到同一路径 - 避免混用大小写路径（尤其在 Windows 上）：
Config.php和config.php可能被当作两个文件 - 不要在函数体内调用
require_once加载含函数定义的文件——它虽不会重复包含，但变量作用域受限，容易引发“函数存在但不可见”问题
函数写在 if 里也会报重复声明？PHP 编译期 hoisting 是元凶
即使把 function foo() {} 包在 if (false) { } 里，PHP 在编译阶段仍会扫描并注册该函数——只要它出现在顶层作用域（即没被嵌套在另一个函数内）。所以多次包含这个文件，第二次就会触发 Cannot redeclare。
- 错误写法：
if ($condition) { function helper() { ... } }—— 条件真假不影响函数注册时机 - 正确做法：要么把函数定义移到文件最顶部（确保全局唯一），要么改用运行时创建的 callable，例如
$helper = function() { ... }; - 若必须条件化定义，可用
function_exists('helper')包裹：if (!function_exists('helper')) { function helper() { ... } }
多个文件都定义同名函数，又不能改名？用命名空间隔离（PHP 5.3+）
命名空间不能直接用于函数，但可以配合自动加载 + 文件级封装来规避冲突。更现实的做法是：把函数封装进类的静态方法中，再用命名空间区分。
- 不推荐：
function format_date() { ... }（全局污染，极易撞名） - 推荐：
class DateTimeHelper { public static function format($ts) { ... } }，然后用use App\Utils\DateTimeHelper; - 若坚持用函数，可借助 Composer 自动加载机制，将函数定义放在
src/functions.php，并在composer.json的autoload.files中声明——Composer 会确保它只被 require_once 一次
require_once 放在函数里导致变量丢失？配置类文件别这么干
在函数内部用 require_once 'config.php' 加载含全局变量（如 $db_config）的文件，会导致该变量仅在函数作用域内有效。下次调用函数时，require_once 不执行，变量也不复存在。
- 典型症状：第一次调用正常，第二次返回
undefined variable或空值 - 根本原因：
require_once防止重复包含，但不解决作用域问题 - 正确姿势：把
require_once移到文件顶层；函数内通过global $db_config或依赖注入方式访问 - 更现代方案：用
return [ 'host' => '...', 'port' => 3306 ];方式导出配置数组，函数内接收为参数，彻底解耦
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
