用 require_once 引入自定义函数库最安全，可避免重复加载导致的“Cannot redeclare function”错误；需用绝对路径、文件内仅含函数声明、注意函数名冲突与作用域污染。

PHP 自定义函数库怎么引入？require_once 是最稳的选择

直接说结论：用 r

equire_once 引入自定义函数文件，比 include 或 require 更安全，能避免重复加载导致的“Cannot redeclare function”错误。

常见错误现象是：多个文件都 require 同一个函数库，第二次加载时 PHP 报错 Fatal error: Cannot redeclare my_helper_func()。

• require_once 会检查该文件是否已被加载过，已加载则跳过，天然防重定义
• 不要用 include —— 它失败只发警告，函数没载入却继续执行，后续调用直接报 Call to undefined function
• 路径建议用绝对路径，避免相对路径在不同入口文件中失效；可用 __DIR__ . '/lib/functions.php'

函数库文件里不能有输出或执行逻辑

自定义函数库（比如 helpers.php）本质只是“声明容器”，里面只放 function 定义，不能有 echo、print_r、header() 或直接执行的代码。

否则一旦被引入，就会立刻触发输出或报错，破坏响应头或干扰 JSON 输出。

• 错误写法：echo 'Loading helpers...'; function format_date() { ... }
• 正确写法：纯函数定义，顶部可加 开标签，但不加 ?> 闭标签（避免意外空白输出）
• 如果真需要初始化逻辑（如设置默认时区），应封装成函数，由业务代码显式调用

命名空间和自动加载更适合中大型项目

当函数越来越多、开始跨模块复用时，光靠 require_once 会越来越难维护。这时候得考虑升级方案。

PHP 5.3+ 支持命名空间，但函数本身不支持命名空间（类才支持），所以常见做法是：把函数包装进工具类的静态方法里，再配合 autoload 或 Composer。

• 例如：定义 class StrHelper { public static function slug($str) { ... } }，然后用 StrHelper::slug()
• 若用 Composer，把函数库打包成包，在 composer.json 中配置 "autoload": {"files": ["src/helpers.php"]}，运行 composer dump-autoload 即可全局可用
• 注意：Composer 的 files 自动加载仍是一次性载入，函数名冲突风险仍在，所以函数名要带前缀（如 myapp_array_flatten()）或彻底转向类封装

别忽略函数名冲突和作用域污染

自定义函数库最大的隐患不是“引不进来”，而是“引进来后悄悄覆盖了别人的东西”。PHP 函数是全局的，没有作用域隔离。

比如你写了 function dd($v) { var_dump($v); exit; }，恰好 Laravel 也用 dd() —— 如果两个库都被加载，后加载的会直接报错或静默覆盖。

• 上线前务必 grep 检查函数名是否与框架、扩展或常用包冲突（如 env、retry、tap）
• 团队协作时，统一前缀规范（如 proj_、util_），比“靠文档约定”靠谱得多
• 开发环境开启 display_errors = On，确保 Cannot redeclare 错误能及时暴露，而不是等到线上出问题才看到日志