PHP用户自定义函数

PHP用户自定义函数

PHP用户自定义函数是开发者根据需求自行创建的代码块，用于执行特定任务。与内置函数不同，这些函数由程序员定义，可重复调用，从而提高代码的模块化和可维护性。

基本语法

用户自定义函数通过function关键字声明，基本结构如下：

function functionName(参数1, 参数2, ...) {
    // 函数体
    return 返回值; // 可选
}

示例1：简单函数

function greet() {
    echo "Hello, World!";
}
greet(); // 输出: Hello, World!

参数传递

PHP支持三种参数传递方式：

• 值传递（默认）
• 引用传递（使用&符号）
• 默认参数值

示例2：带参数的函数

function add($a, $b) {
    return $a + $b;
}
echo add(5, 3); // 输出: 8

示例3：引用传递

function increment(&$value) {
    $value++;
}
$num = 5;
increment($num);
echo $num; // 输出: 6

返回值

函数可通过return返回任意类型数据，包括数组和对象。

示例4：多值返回

function getStats($numbers) {
    return [
        'sum' => array_sum($numbers),
        'avg' => array_sum($numbers) / count($numbers)
    ];
}
print_r(getStats([1, 3, 5])); 
/* 输出:
Array
(
    [sum] => 9
    [avg] => 3
)
*/

可变函数

PHP允许通过变量名动态调用函数：

function sayHello() { echo "Hello!"; }
$func = 'sayHello';
$func(); // 输出: Hello!

匿名函数

也称为闭包（Closures），适用于临时功能：

$greet = function($name) {
    echo "Hello, $name!";
};
$greet('Alice'); // 输出: Hello, Alice!

类型声明

PHP 7+支持参数和返回值的类型声明：

function multiply(float $a, float $b): float {
    return $a * $b;
}
echo multiply(2.5, 4); // 输出: 10.0

实际应用案例

用户输入验证

function validateEmail(string $email): bool {
    return filter_var($email, FILTER_VALIDATE_EMAIL) !== false;
}
var_dump(validateEmail('test@example.com')); // 输出: bool(true)

数据处理管道

graph LR A[原始数据] --> B[清洗函数] B --> C[转换函数] C --> D[输出结果]

对应代码实现：

function processData(array $data, callable $pipeline) {
    return $pipeline($data);
}

$result = processData([1,2,3], function($data) {
    return array_map(fn($n) => $n * 2, $data);
});
print_r($result); // 输出: Array ( [0] => 2 [1] => 4 [2] => 6 )

最佳实践

1. 使用描述性函数名 2. 遵循单一职责原则 3. 合理使用类型声明 4. 限制函数长度（建议不超过20行） 5. 为复杂函数添加文档注释：

/**
 * 计算两个数的加权平均值
 * @param float $a 第一个数
 * @param float $b 第二个数
 * @param float $weight 权重系数 (0-1)
 * @return float 加权平均值
 */
function weightedAverage(float $a, float $b, float $weight): float {
    return $a * $weight + $b * (1 - $weight);
}

数学公式示例

对于涉及数学计算的函数，可使用公式说明： 加权平均值公式： $\overline{x}=x_1\cdot w+x_2\cdot (1-w)$

进阶话题

• 递归函数
• 生成器函数（yield）
• 可变参数函数（...$args）
• 函数存在性检查（function_exists）

通过掌握用户自定义函数，开发者能构建更灵活、可维护的PHP应用程序。建议从简单函数开始，逐步实践复杂场景的应用。