PHP自定义函数怎么定义和调用？

本文深入解析了PHP自定义函数从定义到调用的完整规范与常见陷阱：强调必须使用小写`function`关键字声明，函数名需以字母或下划线开头、严禁与内置函数同名；详解参数默认值必须置于末位且`null`不会触发回退、`return`虽非强制但决定结果能否被获取、跨文件调用必须依赖`include`/`require`显式引入——每一条规则背后都对应着真实开发中极易踩坑的语法错误、静默覆盖、逻辑异常和加载失效问题，帮你避开看似简单却让项目崩溃的底层雷区。

函数定义必须用 function 关键字，不能省略或写错拼写

PHP 解析器只认 function 这个关键字来识别函数声明，写成 func、def 或大小写混用如 Function 都会报 Parse error: syntax error, unexpected。它不区分大小写，但统一小写是行业惯例，也避免在某些配置下出问题。

函数名必须以字母或下划线开头，不能数字开头；不能和已有的内置函数重名（比如叫 strlen 或 echo），否则运行时可能静默失败或覆盖原行为。

常见错误现象：

• 直接写 myFunc() { ... } —— 缺 function，报解析错误
• 函数名写成 2ndTry —— 开头是数字，解析失败
• 定义了 function array_merge(...) —— 覆盖内置函数，后续调用 array_merge() 可能返回意外结果

return 不是必须的，但没它就拿不到计算结果

函数体里不写 return，执行完自动返回 NULL。这在只做输出、写日志、修改全局变量等场景下可行，但一旦你想把结果传给别的变量或参与运算，就必须显式 return。

示例对比：

function logMsg($msg) {
    error_log($msg);
} // 没 return，调用 $x = logMsg('test') 时 $x 是 NULL

function add($a, $b) {
    return $a + $b;
} // 有 return，$x = add(2, 3) 得到 5

注意：return 后面的表达式会被立即求值并退出函数，后面代码不再执行。多个 return 是合法的（比如条件分支中），但只会触发第一个遇到的。

参数默认值要放最后，且 null 不会触发默认值回退

PHP 的默认参数机制只在「该位置完全未传参」时生效。如果传了 null，哪怕形参声明了 $name = "guest"，$name 也会被设为 null，而不是 "guest"。

正确写法示例：

function greet($name, $prefix = "Hello") {
    return "$prefix, $name!";
}
greet("Alice");        // Hello, Alice!
greet("Bob", "Hi");    // Hi, Bob!
greet("Charlie", null); // " , Charlie!" —— 注意 prefix 是 null，不是默认值

容易踩的坑：

• 把带默认值的参数放在前面，比如 function foo($a = 1, $b) —— 语法错误，PHP 要求所有带默认值的参数必须位于参数列表末尾
• 误以为 greet("Tom", null) 会 fallback 到 "Hello" —— 实际不会
• 用可变参数 func_get_args() 时，它拿到的是实际传入的全部值，包括 null，不感知默认值逻辑

跨文件调用必须用 include 或 require，不能靠“自动加载”

PHP 不像 Python 或 Node.js 有模块级作用域或自动导入机制。自定义函数定义在另一个文件里，当前文件想用，必须显式引入。最常用的是 include 和 require，区别在于失败时是否中止脚本：require 找不到文件直接 fatal error，include 只 warning 并继续执行。

使用建议：

• 函数库文件（如 utils.php）用 require 引入，确保必要功能一定存在
• 路径写相对路径即可，比如 require 'inc/functions.php';，不要依赖 getcwd() 或硬编码绝对路径
• 避免重复引入：用 include_once 或 require_once，尤其在复杂包含链中
• 别在函数体内动态 include 同一个文件多次 —— 函数重复定义会报 Cannot redeclare

真正容易被忽略的一点：函数定义本身不执行，只有调用才运行。所以即使你 require 了一个含函数定义的文件，但没调用它，页面上也不会有任何输出或副作用 —— 这不是 bug，是设计如此。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP自定义函数怎么定义和调用？》文章吧，也可关注golang学习网公众号了解相关技术文章。