用 require_once 引入自定义函数库最安全，可避免重复加载导致的“Cannot redeclare function”错误；需用绝对路径、文件内仅含函数声明、注意函数名冲突与作用域污染。
PHP 自定义函数库怎么引入？require_once 是最稳的选择
直接说结论：用 require_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 输出。
立即学习“PHP免费学习笔记（深入）”；
- 错误写法：
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错误能及时暴露，而不是等到线上出问题才看到日志
