PHP自定义函数怎么定义？步骤详解

本文深入解析PHP自定义函数定义的核心规则与常见陷阱：必须严格使用小写function关键字，函数名需遵循标识符规范并避开内置函数冲突，默认参数必须置于参数列表末尾且显式传null不会触发默认值，return虽非强制但决定结果能否被获取，跨文件调用时更需手动引入定义文件——每一步都关乎代码能否正确解析和运行，堪称PHP函数开发不可绕过的语法铁律指南。

PHP函数定义必须用 function 关键字，写错、省略或大小写混用（比如 Function 或 func）都会直接报 Parse error: syntax error, unexpected —— 解析失败，根本跑不起来。

function 关键字不能省、不能改、不能大小写混用

PHP解析器只认小写的 function 这个词作为函数声明的起点。它不靠缩进、不靠上下文推断，就靠这个关键字硬匹配。哪怕只是写成 Function sayHello()，也会在解析阶段崩掉。

• 错误示例：func sayHello() { }、def greet() { }、Function init() { }
• 正确写法只有：function sayHello() { }
• 虽然函数名本身不区分大小写（sayhello() 也能调），但 function 关键字必须全小写，这是语法铁律

函数名必须以字母或下划线开头，且不能和内置函数同名

函数名本质是标识符，要符合 PHP 变量命名规则：开头只能是 a-z、A-Z 或 _，后面可跟字母、数字、下划线。但更关键的是——别撞上 echo、count、array_merge 这类内置函数名。

• 非法名：2ndTry()（数字开头）、my-class()（含减号）、echo()（覆盖内置）
• 合法但危险：strlen() 看似能定义成功，但后续调用 strlen("abc") 可能返回你写的逻辑，而不是字符串长度
• 推荐风格：get_user_role()（蛇形）或 validateEmail()（驼峰），保持项目内统一即可

参数默认值必须放末尾，传 null 不会触发默认回退

PHP 的默认参数只在「该位置完全没传参」时生效。如果显式传了 null，那形参就真的是 null，不会自动换成你写的默认值。

• 错误顺序：function foo($a = 1, $b) { } → 直接语法错误，PHP 要求所有带默认值的参数必须靠右
• 正确写法：function greet($name, $prefix = "Hi") { return "$prefix, $name!"; }
• 注意行为：greet("Tom", null) 返回 " , Tom!"，不是 "Hi, Tom!"；想实现 fallback 得手动判断：$prefix = $prefix ?? "Hi"

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

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

• 无返回函数：function logMsg($msg) { error_log($msg); } → $x = logMsg("test") 后 $x 是 NULL
• 有返回函数：function add($a, $b) { return $a + $b; } → $sum = add(2, 3) 得到 5
• return 后代码不再执行，多个 return 在条件分支里没问题，但只会走第一个遇到的

最容易被忽略的一点：跨文件调用函数时，PHP 不会自动加载，必须用 include 或 require 显式引入定义文件——哪怕路径对、文件存在，漏了这一句，调用时就是 Call to undefined function。

本篇关于《PHP自定义函数怎么定义？步骤详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！