应将常用函数集中定义在单一PHP文件中，使用require_once引入以防重复声明，并通过function_exists()检测避免命名冲突；文件内仅允许function声明和注释，不可含执行语句或class定义。
怎样把常用函数集中到一个文件里并自动加载
PHP 自定义函数库本质就是把一堆 function 定义收拢到独立的 .php 文件中，再通过 require 或 include 引入。关键不是“能不能放”，而是“什么时候引、怎么引才不冲突、不重复”。
常见错误是直接在多个脚本顶部写 require 'utils.php'，结果某个入口文件被多次包含（比如被其他文件又 require 了一次），触发 Cannot redeclare xxx() 错误。
- 用
require_once替代require，确保同一文件只加载一次 - 函数名必须全局唯一——不要在不同库文件里定义同名的
format_date()或array_flatten() - 推荐把函数库放在项目根目录下的
lib/或src/Helpers/这类明确路径下，避免相对路径出错（比如从子目录 include 时./helpers.php可能找不到）
函数库文件里能写 return、echo 或 class 吗
不能混写。自定义函数库文件（如 helpers.php）应只做一件事：声明函数。任何执行性语句（echo、return、new MyClass()）在被 require_once 时就会立即运行，导致不可控输出或报错。
典型翻车场景：helpers.php 开头写了 echo "Loaded helpers";，结果每次页面打开都多一行输出，还可能破坏 JSON 响应格式。
立即学习“PHP免费学习笔记（深入）”；
- 函数库文件里只允许出现：
function声明、if判断函数是否已存在（用于防御性定义）、注释 -
class应该放进单独的类文件，走 autoloader（如 Composer 的 PSR-4），别塞进函数库 - 如果真需要初始化逻辑（比如设置默认时区），封装成一个函数，比如
init_helpers()，由业务代码显式调用
如何避免函数名冲突又不用写很长的前缀
PHP 没有原生函数命名空间，所以 str_slug() 这种名字极易和 Laravel、Symfony 的辅助函数撞车。硬加前缀（如 myapp_str_slug()）难看，不加又危险。
折中方案是：按模块分组 + 短前缀，同时配合 function_exists() 防御。
// helpers/string.php
if (!function_exists('str_slug')) {
function str_slug($str, $separator = '-') {
return strtolower(preg_replace('/[^A-Za-z0-9]+/', $separator, $str));
}
}
- 检查函数是否存在必须用
function_exists('xxx')，不能用!function_exists('xxx()')（括号会报错） - 前缀控制在 2–4 字母内，比如
fs_（file system）、net_（network）、arr_（array） - 别依赖“别人不会写同名函数”——第三方包、框架更新后可能悄悄引入同名函数
为什么用 Composer autoload 加载函数库反而更麻烦
Composer 官方不支持直接 autoload 函数（只支持 class），想实现得靠 files 字段，但会带来隐式加载风险：只要 Composer autoloader 被引入，你的函数就无条件加载，哪怕当前请求根本用不到。
例如你在 composer.json 里写了："files": ["lib/helpers.php"]，那么 CLI 命令、API 接口、甚至单元测试都会提前加载全部函数，拖慢启动速度，还可能因环境差异（如扩展未启用）直接 fatal error。
- 除非函数库极小（files
- 更可控的做法：在入口文件（如
index.php）顶部统一require_once主函数库；按需在特定模块内再require_once子库（如lib/db_helpers.php） - 如果项目已重度依赖 Composer，可考虑把函数封装成单例类，再用 PSR-4 autoload —— 这样既能复用，又受 autoloader 生命周期管理
函数库看着简单，真正长期维护时最头疼的是“谁在什么时候改了哪个函数的参数顺序”，建议给每个函数加 PHPDoc，哪怕只有 @param 和 @return。没有文档的函数库，半年后你自己都不敢动。
