PHP函数定义必须用function关键字,函数名以字母或下划线开头、区分大小写且不可与内置函数同名;参数默认值须置末位,return可返回值或null,跨文件调用需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免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











