PHP自定义函数进阶技巧_PHP构建高复用函数模块

高复用函数需控边界、明职责、留余地：参数支持数组/关联键/默认值三合一，返回统一结构+状态码+异常开关，逻辑通过回调插拔，命名规范且自动加载。

写好一个自定义函数不难，但让函数真正“高复用、易维护、可组合、少出错”，需要在设计思路上下功夫。核心不是堆功能，而是控边界、明职责、留余地。

参数灵活：支持数组 + 关联键 + 默认值三合一

别只用固定顺序的参数列表。用 func_get_args() 或更推荐的 ...$args（PHP 5.6+）接收动态参数，再用 array_merge() 合并默认配置与用户传入项。关键点是：把“必填逻辑”和“可选配置”分开处理。

• 用 is_array($args[0]) 判断是否传了配置数组，是则直接解析；否则按传统位置参数处理
• 默认配置用 const DEFAULT_OPTS = [...] 定义，避免硬编码散落
• 对关键参数做 isset() + !== null 双重校验，防止 false/0/'' 被误判为未传

返回健壮：统一结构 + 显式状态码 + 可选异常开关

别让调用方猜函数成功没。返回数组结构如 ['ok' => true, 'data' => ..., 'msg' => '']，比单纯 return $result 更可控。加一个 $throwOnError = false 参数，让使用者决定错误是抛异常还是静默返回失败结构。

• 内部用 try/catch 包裹可能出错逻辑，捕获后根据 $throwOnError 决策行为
• 状态码建议用整数（如 200 成功、400 参数错、500 系统错），比字符串更易判断和日志追踪
• 敏感数据（如密码、token）不在返回数组中透出，需额外字段控制是否包含

行为可插拔：用回调函数预留扩展点

函数内部别写死处理逻辑。比如格式化时间，不要直接写 date('Y-m-d', $ts)，而是接受一个 $formatter = null 参数。若传了 callable，就交由它处理；没传则走默认。

标签： php composer 编码 app 回调函数 状态码 敏感数据