在PHP项目里，把重复逻辑封装成自定义函数是最基础的重构手段。但很多脚本在浏览器里直接白屏，并不是语法写错，而是函数调用时机或文件路径有问题。理解PHP解释器如何扫描函数定义、如何在多个文件之间共享代码，是写好可维护程序的前提。下面我们从最原始的单文件写法讲起，逐步扩展到多文件与命名空间场景。
一、单文件中定义与调用的基本顺序
PHP是解释型语言，代码从上往下执行。自定义函数用function关键字声明，解释器在读到定义时把函数名注册进符号表，之后才能被调用。如果在定义之前写调用语句，就会触发Uncaught Error: Call to undefined function。这和类的方法不同，类可以延迟到实例化时才解析，而过程式函数必须先定义。
看一段最简单的例子，我们在文件顶部先写函数，再在后面业务逻辑里使用。注意函数名只能包含字母、数字和下划线，且不能以数字开头。调用时括号里的实参按顺序传给形参，如果声明了默认值，调用方可省略对应参数。
<?php
// 先定义函数
function calc_sum($a, $b = 10) {
return $a + $b;
}
// 后调用函数
$result = calc_sum(5);
echo $result; // 输出 15
?>
上面代码中calc_sum第二个参数有默认值，因此调用时只传一个参数也能运行。若反过来，在function calc_sum那一行之前写$result = calc_sum(5);，脚本会直接终止并报错。这个顺序约束在大型单文件里容易被忽略，尤其是当文件顶部引入了大量配置代码时。
二、跨文件调用与include机制
实际开发中函数通常放在独立文件，比如helpers.php，然后在入口脚本里用include、require、include_once或require_once载入。四者的区别在错误处理级别和重复加载：include失败只警告并继续；require失败直接致命错误；带_once的会检查是否已引入，防止函数重定义冲突。
假设项目结构如下：根目录有index.php和lib/helpers.php。我们在helpers.php里写公共函数，在index.php用相对路径引入。路径写法要相对于当前执行脚本，而非文件自身所在目录，这一点在命令行和Web环境下容易混淆。
<?php
// lib/helpers.php 内容
function format_money($num) {
return number_format($num, 2, '.', ',');
}
?>
<?php
// index.php 内容
require_once __DIR__ . '/lib/helpers.php';
echo format_money(1234.5); // 输出 1,234.50
?>
使用__DIR__常量能拿到当前文件绝对目录，拼接出稳定路径，避免include_path配置不同导致的找不到文件。如果同一函数被两个文件都require且没有_once，PHP会报Cannot redeclare错误。因此公共库一律推荐require_once。
另外，被引入文件里的函数处于全局作用域，不论引入层级多深，调用方都能直接写函数名。但若引入文件在条件语句内，比如if($flag){ include 'a.php'; }，那么其中定义的函数在条件外仍可用，因为函数定义不受块级作用域限制，只是定义动作发生在条件成立时。
三、命名空间下的函数调用规则
从PHP 5.3开始支持命名空间，用来解决不同库之间的名称冲突。在命名空间里定义的普通函数，调用时必须带空间路径，除非用use导入或当前就在同一空间。很多开发者从旧教程复制代码，加了namespace AppUtil;却直接写函数名，结果报未定义，就是因为解析成了AppUtil函数名而非全局。
下面示例展示两种正确调用方式。第一种在调用处写全限定名，第二种用use function导入后再简写。注意use语句必须写在命名空间声明之后、其他代码之前。
<?php
namespace AppUtil;
function slug($str) {
return strtolower(trim(preg_replace('/s+/', '_', $str)));
}
// 同空间内调用
echo slug('Hello World'); // hello_world
?>
<?php
namespace Main;
use function AppUtilslug;
echo slug('Test Case'); // test_case
?>
如果要在命名空间里调用全局函数（比如系统自带的strlen），需要在前面加反斜杠strlen，否则解释器会先在当前空间找。这个细节在写框架底层时非常关键，漏掉反斜杠可能调用到同名的自定义函数而引发逻辑错乱。
综合来看，自定义PHP函数的调用并不复杂，核心就是定义可见、路径正确、空间明确。单文件注意先后顺序，多文件靠require_once打通，命名空间用全限定名或use导入。把这些步骤固化到编码规范里，团队协作时就能大幅减少低级运行时错误。