## 用户自定义函数

函数的定义是通过使用 `function` 关键字、名称、由逗号（`,`）分隔并用圆括号括起来的参数列表（可能为空），后接包含使用大括号括起来的函数主体，例如以下形式：

示例 #1 声明名为 `foo` 的新函数

`<?php
function foo($arg_1, $arg_2, /* ..., */ $arg_n)
{
echo "Example function.\n";
return $retval;
}
?>`

> 注意:

> 自 PHP 8.0.0 起，参数列表可以包含尾随逗号：

> `<?php
> function foo($arg_1, $arg_2,) { }
> ?>`

任何有效的 PHP 代码都有可能出现在函数主体，甚至包括其它函数和 class 定义。

函数名和 PHP 中的其它标识符命名规则相同。有效的函数名以字母或下划线打头，后面跟字母，数字或下划线。可以用正则表达式表示为 `^[a-zA-Z_\x80-\xff][a-zA-Z0-9_\x80-\xff]*$`。

小技巧

请参见用户空间命名指南。

函数无需在调用之前被定义，除非是下面两个例子中函数是有条件被定义时。

当一个函数是有条件被定义时，必须在调用函数之前定义。

示例 #2 有条件的函数

`<?php
$makefoo = true;
/* 不能在此处调用foo()函数，
因为它还不存在，但可以调用bar()函数。*/
bar();
if ($makefoo) {
function foo()
{
echo "I don't exist until program execution reaches me.\n";
}
}
/* 现在可以安全调用函数 foo()
因为 $makefoo 值为真 */
if ($makefoo) foo();
function bar()
{
echo "I exist immediately upon program start.\n";
}
?>`

示例 #3 函数中的函数

`<?php
function foo()
{
function bar()
{
echo "I don't exist until foo() is called.\n";
}
}
/* 现在还不能调用 bar() 函数，因为它还不存在 */
foo();
/* 现在可以调用 bar() 函数了，因为 foo() 函数
的执行使得 bar() 函数变为已定义的函数 */
bar();
?>`

PHP 中的所有函数和类都具有全局作用域，可以定义在一个函数之内而在之外调用，反之亦然。

PHP 不支持函数重载，也不可能取消定义或者重定义已声明的函数。

> 注意: 从 `A` 到 `Z` 的 ASCII 函数名是大小写无关的，不过在调用函数的时候，使用其在定义时相同的形式是个好习惯。

函数支持 可变数量的参数 和 默认参数。参见 func_num_args()、func_get_arg() 和 func_get_args() 的函数参考以获取更多信息。

在 PHP 中可以调用递归函数。

示例 #4 递归函数

`<?php
function recursion($a)
{
if ($a < 20) {
echo "$a\n";
recursion($a + 1);
}
}
?>`

> 注意: 但是要避免递归函数／方法调用超过 100-200 层，因为可能会使堆栈崩溃从而使当前脚本终止。 无限递归可视为编程错误。

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open