PHP如何定义和使用自定义函数

本文深入浅出地讲解了PHP中自定义函数的定义与使用全貌——从基础的function语法、参数传递（含默认值、可变参数和严格类型声明）到返回值处理，再到匿名函数、箭头函数等现代特性；同时系统剖析了局部、全局、静态及超全局变量的作用域机制，强调通过合理封装与作用域控制提升代码的模块化、健壮性与可维护性，堪称PHP函数式编程实践的实用指南。

PHP中定义和使用函数，核心在于利用function关键字封装一段可重用的代码逻辑，然后通过函数名和必要的参数来调用执行。这不光能提高代码的模块化程度和可维护性，还能有效避免重复编写相似的代码块，在我看来，这是任何一门编程语言都不可或缺的基础。

解决方案

在PHP里，定义一个函数其实非常直观，它基本上就是给一段操作赋予一个名字。当你需要这段操作的时候，直接叫它的名字就行。

一个最简单的函数定义长这样：

<?php
function sayHello() {
    echo "你好，世界！";
}

// 调用函数
sayHello(); // 输出：你好，世界！
?>

这个sayHello函数没有任何参数，也没有返回值，它只是执行一个简单的输出操作。但大多数时候，我们的函数会更复杂，需要接收一些输入（参数），并返回一个结果。

例如，一个带参数并返回值的函数：

<?php
function addNumbers(int $num1, int $num2): int {
    return $num1 + $num2;
}

// 调用函数并获取返回值
$sum = addNumbers(5, 3);
echo "两数之和是: " . $sum; // 输出：两数之和是: 8
?>

这里，addNumbers函数接收两个整数类型的参数$num1和$num2，并明确声明它会返回一个整数。return语句是关键，它将函数内部计算的结果传递回调用它的地方。

PHP函数定义的基本语法和最佳实践

定义PHP函数，最核心的就是function关键字，紧接着是函数名，然后是一对圆括号()，里面可以放置参数，最后是一对花括号{}，这里面就是函数的具体执行逻辑。

函数命名有一些规矩，比如必须以字母或下划线开头，不能包含空格，也不能是PHP的保留关键字。我个人习惯用驼峰命名法（camelCase），比如getUserProfile，这样看起来很清晰。

<?php
/**
 * 计算两个数的乘积。
 *
 * @param float $a 第一个乘数
 * @param float $b 第二个乘数
 * @return float 乘积结果
 */
function calculateProduct(float $a, float $b): float {
    // 确保参数是数字类型，虽然有类型声明，但显式检查有时也不错
    if (!is_numeric($a) || !is_numeric($b)) {
        trigger_error("calculateProduct() expects numeric arguments", E_USER_WARNING);
        return 0.0; // 或者抛出异常
    }
    return $a * $b;
}

$result = calculateProduct(10.5, 2.0);
echo "乘积是: " . $result; // 输出：乘积是: 21
?>

这里我加了一个PHPDoc风格的注释块，这在实际项目中非常有用，能让其他开发者（包括未来的你）快速理解函数的功能、参数和返回值。同时，也稍微展示了在函数内部做一些简单的参数验证，虽然PHP的类型声明已经提供了不少帮助，但额外的逻辑判断总能让函数更健壮。

如何在PHP中调用函数并处理返回值

调用函数其实就是“使用”函数，很简单，直接写函数名，后面跟一对圆括号，如果函数需要参数，就在括号里按顺序传入。

<?php
function greet(string $name, string $greeting = "你好"): string {
    return $greeting . ", " . $name . "!";
}

// 简单调用
echo greet("张三"); // 输出：你好, 张三!

// 传入所有参数
echo greet("李四", "早上好"); // 输出：早上好, 李四!

// 获取函数返回值并进一步处理
$message = greet("王五");
if (strpos($message, "你好") !== false) {
    echo "\n这是一个友好的问候: " . $message; // 输出：这是一个友好的问候: 你好, 王五!
}
?>

当一个函数通过return语句返回一个值时，你可以在调用它的地方用一个变量来接收这个值，就像上面$message = greet("王五");那样。这个返回值可以是任何PHP支持的数据类型：数字、字符串、布尔值、数组、对象，甚至是null。如果函数没有return语句，或者只有return;，那么它会隐式返回null。

需要注意的是，函数内部定义的变量（局部变量）在函数外部是不可见的。它们只在函数执行期间存在，函数执行完毕后就会被销毁。这确保了函数之间的独立性，避免了不必要的变量冲突。

PHP函数参数的灵活运用：默认值、可变参数与类型声明

PHP在处理函数参数方面提供了很多灵活性，这让我们可以编写出更强大、更适应不同场景的函数。

默认参数值： 你可以为函数的参数设置默认值。这意味着如果调用函数时没有为这个参数提供值，它就会使用预设的默认值。这个特性在我看来非常实用，特别是在构建一些配置项较多的函数时。

<?php
function logMessage(string $message, string $level = "INFO", string $timestamp = null) {
    $ts = $timestamp ?? date('Y-m-d H:i:s'); // 如果timestamp为null，则使用当前时间
    echo "[" . $ts . "] [" . $level . "] " . $message . "\n";
}

logMessage("用户登录成功"); // 使用默认级别INFO和当前时间
logMessage("数据库连接失败", "ERROR"); // 指定级别，使用当前时间
logMessage("任务完成", "DEBUG", "2023-10-27 10:00:00"); // 指定所有参数
?>

这里，$level和$timestamp都有默认值（$timestamp的默认值是null，然后内部用??操作符处理）。默认参数必须放在非默认参数的后面。

可变参数（Variadic Functions）： 有时候，你可能不确定函数会接收多少个参数。PHP 5.6 引入了...操作符，可以用来定义可变参数。它会将所有传入的额外参数收集到一个数组中。

<?php
function sumAll(...$numbers): int {
    $total = 0;
    foreach ($numbers as $number) {
        $total += $number;
    }
    return $total;
}

echo "总和1: " . sumAll(1, 2, 3); // 输出：总和1: 6
echo "\n总和2: " . sumAll(10, 20, 30, 40, 50); // 输出：总和2: 150
?>

...$numbers会把所有传递给sumAll函数的参数打包成一个名为$numbers的数组。

类型声明（Type Declarations）： 从PHP 7开始，我们可以为函数的参数和返回值指定类型。这大大提高了代码的健壮性和可读性，IDE也能更好地进行代码分析和错误提示。在我看来，这是现代PHP开发中一个非常重要的实践。

<?php
class User {
    public string $name;
    public function __construct(string $name) {
        $this->name = $name;
    }
}

function processUser(User $user): string {
    return "处理用户: " . $user->name;
}

function divide(int $numerator, int $denominator): float {
    if ($denominator === 0) {
        throw new InvalidArgumentException("除数不能为零");
    }
    return $numerator / $denominator;
}

$john = new User("John Doe");
echo processUser($john); // 输出：处理用户: John Doe

try {
    echo "\n结果: " . divide(10, 2); // 输出：结果: 5
    echo "\n结果: " . divide(7, 0);
} catch (InvalidArgumentException $e) {
    echo "\n错误: " . $e->getMessage(); // 输出：错误: 除数不能为零
}
?>

这里我们为processUser函数的参数声明了User类型，为divide函数的参数和返回值声明了int和float类型。如果传入的参数类型不匹配，PHP会抛出TypeError。返回值类型声明则强制函数返回指定类型的值。

匿名函数（闭包）与箭头函数：现代PHP的函数式编程特性

PHP不仅支持传统的命名函数，还提供了匿名函数（也称为闭包）和箭头函数，这些特性让PHP在处理回调、短小逻辑时更加灵活和简洁。

匿名函数（闭包）： 匿名函数就是没有名字的函数，它们通常作为参数传递给其他函数，或者存储在一个变量中。它们可以“捕获”其定义环境中的变量，这就是“闭包”的含义。

<?php
$multiplier = 2;

// 定义一个匿名函数并赋值给变量
$double = function(int $number) use ($multiplier): int {
    return $number * $multiplier;
};

echo "双倍结果: " . $double(5); // 输出：双倍结果: 10

// 匿名函数作为回调函数
$numbers = [1, 2, 3, 4, 5];
$squaredNumbers = array_map(function(int $n): int {
    return $n * $n;
}, $numbers);

echo "\n平方数: " . implode(", ", $squaredNumbers); // 输出：平方数: 1, 4, 9, 16, 25
?>

在$double的例子中，use ($multiplier)允许匿名函数访问外部作用域的$multiplier变量。这在处理一些需要外部上下文的逻辑时非常有用。

箭头函数（Arrow Functions）： PHP 7.4 引入了箭头函数，它是匿名函数的一种更简洁的语法，特别适用于只有一个表达式的简单闭包。

<?php
$factor = 3;

// 使用箭头函数
$triple = fn(int $number): int => $number * $factor;

echo "\n三倍结果: " . $triple(5); // 输出：三倍结果: 15

// 箭头函数在array_map中的应用
$cubedNumbers = array_map(fn(int $n): int => $n * $n * $n, $numbers);
echo "\n立方数: " . implode(", ", $cubedNumbers); // 输出：立方数: 1, 8, 27, 64, 125
?>

箭头函数隐式地从父作用域捕获变量，所以你不需要像匿名函数那样显式地使用use关键字。这让代码更加紧凑。我个人觉得，对于简单的回调，箭头函数写起来确实更舒服。

函数的生命周期与作用域：理解变量可见性

理解变量的作用域是编写健壮PHP代码的关键。简单来说，作用域决定了你在代码的哪个位置可以访问到某个变量。

局部作用域： 在函数内部定义的变量，只在该函数内部可见和有效。函数执行结束后，这些局部变量就会被销毁。

<?php
function calculateArea(float $length, float $width): float {
    $area = $length * $width; // $area 是局部变量
    return $area;
}

$result = calculateArea(10, 5);
echo "面积: " . $result; // 输出：面积: 50

// echo $area; // 这行会报错，因为 $area 在函数外部是不可见的
?>

全局作用域： 在所有函数外部定义的变量，拥有全局作用域。理论上，它们可以在脚本的任何地方被访问。然而，在函数内部直接访问全局变量是有限制的。

<?php
$globalVar = "我是一个全局变量";

function accessGlobalVar() {
    // 尝试直接访问 $globalVar 会失败，因为它不在当前函数的局部作用域
    // echo $globalVar; // 这行会报错或者输出空值（取决于PHP配置）

    // 正确的方式是使用 global 关键字
    global $globalVar;
    echo "\n函数内部访问: " . $globalVar;
}

accessGlobalVar(); // 输出：函数内部访问: 我是一个全局变量
echo "\n函数外部访问: " . $globalVar; // 输出：函数外部访问: 我是一个全局变量
?>

虽然global关键字允许你在函数内部修改全局变量，但我个人建议尽量少用它。过度依赖全局变量会使代码难以理解和维护，因为函数之间的依赖关系变得不透明。更好的做法是通过参数传递需要的数据。

超全局变量： PHP提供了一系列特殊的“超全局”变量，比如$_GET, $_POST, $_SESSION, $_SERVER等。这些变量在脚本的任何地方（包括函数内部）都可以直接访问，不需要global关键字。它们是PHP为了方便处理HTTP请求、会话等而设计的。

<?php
function processRequest() {
    if (isset($_GET['action'])) {
        echo "\n请求动作: " . htmlspecialchars($_GET['action']);
    }
}

// 假设URL是 script.php?action=view
$_GET['action'] = 'view'; // 模拟一个GET请求参数
processRequest(); // 输出：请求动作: view
?>

静态变量（Static Variables）： 在函数内部，你可以声明一个静态变量。与局部变量不同，静态变量在函数执行结束后不会被销毁，它的值会保留下来，在下次函数调用时依然可用。

<?php
function counter() {
    static $count = 0; // 静态变量，只在第一次调用时初始化
    $count++;
    echo "\n计数: " . $count;
}

counter(); // 输出：计数: 1
counter(); // 输出：计数: 2
counter(); // 输出：计数: 3
?>

静态变量在某些需要保持状态的场景下很有用，比如统计函数被调用的次数。

理解这些作用域规则，能让你更好地组织代码，避免一些难以调试的错误，尤其是在大型项目中，清晰的变量流转路径是至关重要的。

到这里，我们也就讲完了《PHP如何定义和使用自定义函数》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于php,php格式的知识点！