PHP自定义函数需在调用前定义，不支持声明提升；调用时注意参数顺序、类型及返回值接收；跨文件使用需用include_once/require_once防重复定义。
函数定义后直接写函数名就能调用
PHP 自定义函数不是“注册”或“导入”后才生效，只要执行流到达定义位置，之后就可以直接用函数名加括号调用。这点和 JavaScript 的函数声明提升（hoisting）不同，PHP 不会把函数定义提前——没定义就调用，直接报 Fatal error: Uncaught Error: Call to undefined function。
常见错误现象：在函数定义前就调用，比如把 my_util() 写在 function my_util() { ... } 上面；或者把函数定义放在 if 分支里，而分支没执行到，结果调用时报错。
- 函数必须在调用前完成定义（非条件式、非延迟加载）
- 如果函数写在文件末尾，但前面逻辑已调用，就会崩
- include/require 引入的文件，也要确保引入语句在调用之前
- 类方法内调用本类自定义函数，需用
$this->funcName()，不能直接写函数名
带参数的函数调用要注意类型和顺序
PHP 默认不严格校验参数类型（除非用了 declare(strict_types=1)），但传错类型可能导致静默失败或意外结果。比如期望接收 int，却传了 string "123"，多数情况能自动转换，但遇到 array_key_exists() 或 JSON 解析等场景就容易出问题。
使用场景常见于封装数据库查询、格式化时间、过滤输入等。参数顺序一旦定下，后续调用就得保持一致，改顺序等于破接口。
立即学习“PHP免费学习笔记（深入）”；
- 参数个数不对会触发
Warning: Missing argument或Too few arguments - 命名参数（PHP 8.0+）可用
my_func(param2: $val)跳过中间参数，但别在老版本上用 - 可变参数用
...$args接收，调用时直接展开数组需用my_func(...$arr) - 默认参数值写在函数定义里，调用时不传该参数即取默认值，但不能跳过中间有默认值的参数再传后面的
返回值没接住，等于白调用
PHP 函数默认返回 null，如果你写了 return $data; 却没用变量接住，那这个值就丢了。这不是语法错误，但逻辑常因此断裂——比如封装了一个从 API 拿数据的函数，调用后没赋值给变量，后面还拿空值去处理。
性能影响不大，但调试时特别难发现：日志没打、页面没输出、var_dump 也没写，最后卡在“为什么 $result 是 null”。
- 确认函数真有
return语句，不是只 echo/print_r - 检查是否在条件分支里漏了 return（比如 if 有 return，else 没写，走到 else 就返回 null）
- 链式调用时注意：自定义函数返回对象才能接着 -> 调方法，返回数组就不能直接 ->
- 用
=== null判断返回值是否为空，避免被0、false、""干扰
include 文件里的函数，在主文件里调用要小心路径和重复定义
多人协作或模块拆分时，常把函数集中写在 functions.php 里，然后用 include 'functions.php' 引入。但若多个地方重复 include，会触发 Fatal error: Cannot redeclare my_func()。
这不是作用域问题，是 PHP 解析器第二次见到同名 function my_func() 定义就拒绝。而且路径写错会导致文件根本没载入，函数还是 undefined。
- 统一用
include_once或require_once，不是include - 路径建议用
__DIR__ . '/functions.php'，避免相对路径随工作目录变化失效 - 不要在循环里 include 函数文件——既没必要，又容易触发重复定义
- 函数名尽量加前缀（如
myproject_format_date()），降低命名冲突风险
函数调用本身很简单，真正卡人的永远是定义时机、参数传递的隐式转换、返回值流向，以及跨文件时的加载秩序——这些地方一松懈，debug 就得翻半天。
