PHP自定义函数完整指南：function定义与调用方法详解
函数定义必须使用 function 关键字，这是PHP语法的核心规则
在PHP编程中，创建自定义函数必须使用function关键字作为标识符。任何拼写错误如func、def或大小写混用如Function都会导致解析错误Parse error: syntax error, unexpected。虽然PHP对关键字大小写不敏感，但遵循行业惯例使用小写function能确保代码的兼容性和可读性。
函数命名规范同样重要：名称必须以字母或下划线开头，不能以数字开头。更重要的是避免与PHP内置函数重名，例如定义名为strlen或echo的函数会导致不可预知的行为——可能静默失败，也可能覆盖原生功能，引发难以调试的错误。
以下是常见的函数定义错误示例：
- 直接写
myFunc() { ... }—— 缺少function关键字，解析器无法识别 - 函数名写成
2ndTry—— 以数字开头，违反命名规则 - 定义
function array_merge(...)—— 覆盖内置函数，导致后续调用结果异常
return 语句虽非强制，但决定函数能否返回值
PHP函数中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是合法且常见的做法，但只有第一个被执行到的return会生效。
参数默认值必须置于末尾，且显式传递 null 不会触发默认值
PHP处理参数默认值的机制非常明确：仅当调用函数时未提供某个参数值，才会使用定义时设置的默认值。如果显式传递null作为参数值，即使形参声明了默认值如$name = "guest"，最终参数值仍为null，不会回退到默认值。
正确的参数顺序是将带默认值的参数放在参数列表末尾：
function greet($name, $prefix = "Hello") {
return "$prefix, $name!";
}
greet("Alice"); // 输出：Hello, Alice!
greet("Bob", "Hi"); // 输出：Hi, Bob!
greet("Charlie", null); // 输出： , Charlie! —— prefix参数值为null而非默认的"Hello"
使用参数默认值时需注意以下常见问题：
- 将带默认值的参数置于前面，如
function foo($a = 1, $b)—— 直接导致语法错误，PHP要求带默认值的参数必须位于参数列表末尾 - 误认为调用
greet("Tom", null)时第二个参数会使用默认值"Hello"—— 实际值为null - 使用
func_get_args()获取参数时，得到的是调用时实际传入的原始值列表，包括显式传入的null，该函数不感知函数定义中的默认值逻辑
跨文件调用函数必须使用 include 或 require，PHP不支持自动加载机制
PHP采用简单直接的设计哲学，没有模块级作用域或自动导入机制。这意味着在一个文件（如utils.php）中定义的函数，要在另一个文件中使用，必须显式引入该文件。include和require是最常用的引入方式，核心区别在于文件不存在时的处理：require会触发致命错误(Fatal Error)并终止脚本；include仅产生警告(Warning)，脚本尝试继续执行。
实际项目开发中建议遵循以下最佳实践：
- 对于函数库、工具类等核心文件，使用
require确保必要功能一定存在 - 使用相对路径如
require 'inc/functions.php';，避免依赖动态函数或硬编码绝对路径，提升代码可移植性 - 在复杂的包含关系中，使用
include_once或require_once防止因重复引入导致的函数重复定义错误(Cannot redeclare) - 注意函数定义只是声明，不会自动执行。通过
require引入包含函数的文件后，必须显式调用函数才会产生输出或执行操作——这是PHP的预期行为而非错误
