PHP自定义函数需严格遵循命名规范、作用域隔离、参数校验和错误处理；必须避免命名冲突、正确使用引用传参与可变参数、优先采用类型声明、明确异常处理而非返回模糊值。
PHP 自定义函数不是“写个 function 就完事”，关键在命名规范、作用域隔离、参数校验和错误处理——没做这几步，函数越用越像定时炸弹。
function 声明语法和必须避开的命名冲突
PHP 函数用 function 关键字声明，名字不能和内置函数（如 array_merge、json_encode）或已声明的函数重名，否则会报 Fatal error: Cannot redeclare xxx()。
- 函数名区分大小写，但建议全小写 + 下划线（如
format_phone_number），避免和类方法风格混淆 - 不要用 PHP 保留字作函数名，比如
echo、return、namespace—— 即使没立刻报错，后续升级可能崩 - 函数必须在调用前定义；若放在
include或require文件里，确保加载顺序正确，否则触发Call to undefined function
参数传递：值传、引用传、可变参数怎么选
默认是值传递，大数组或对象传参时容易无意中复制大量内存。想改原变量，得显式加 & 声明引用传参；需要接收不确定数量参数，用 ...（PHP 5.6+）或 func_get_args()。
- 引用传参只对变量有效，不能对字面量或表达式用，比如
my_func(&$arr[0])合法，但my_func(&123)直接报Only variables can be passed by reference - 用
...接收可变参数时，它必须是参数列表最后一个，且类型无法在函数签名里约束（需手动is_string()等判断） - 推荐优先用类型声明（如
function calc(int $a, string $b): float），PHP 7+ 支持，能提前暴露类型错误，比运行时gettype()判断更可靠
返回值处理：null、false、异常，哪一种更安全
返回 null 或 false 容易引发隐式类型转换陷阱（比如 if (my_func() == false) 可能误判 0 或空字符串）。真出错了，该抛异常就抛异常。
立即学习“PHP免费学习笔记（深入）”；
- 函数职责要单一：成功就返回预期类型（如
string、array），失败就明确抛InvalidArgumentException或自定义异常，别靠返回码糊弄 - 如果必须返回布尔值，确保文档写清“
false表示什么”，并在调用处用严格比较=== false，避免松散比较翻车 - 不要在函数里直接
die()或exit()—— 这会让调用方彻底失去控制权，调试和单元测试都无从下手
真正难的不是写出能跑的函数，而是让别人（包括三个月后的你自己）能快速看懂边界条件、知道什么输入会触发什么分支、明白错误时该怎么捕获。类型声明、参数校验、异常路径覆盖，这些不是“可选项”，是函数上线前的必检项。
