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免费学习笔记(深入)”;
overhang.js 是一款基于 jQuery 和 jQuery UI 的用于显示通知、确认、提示的插件,它以动画的方式从顶部滑出。overhang.js 提供了众多参数,你可以自定义通知的样式,回调函数也能够满足你的更多需求。
- 参数个数不对会触发
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 就得翻半天。










