PHP自定义函数：从基础定义到实战优化指南

一、为什么需要自定义函数？

在PHP开发中，重复编写相同逻辑的代码会导致冗余、可读性差和维护困难。自定义函数通过封装独立功能，实现代码复用、逻辑分离和维护简化，是提升开发效率的核心手段之一。

二、基础定义与调用

函数的核心是“输入-处理-输出”，PHP中通过function关键字定义函数，语法如下：

<?php
/**
 * 计算两数之和（基础函数示例）
 * @param int $a 第一个整数
 * @param int $b 第二个整数
 * @return int 两数之和
 */
function getSum(int $a, int $b): int {
    return $a + $b;
}

// 调用函数
$result = getSum(10, 20);
echo "Sum: {$result}"; // 输出：Sum:30
?>

三、参数传递技巧

1. 必选与可选参数

函数参数可设置默认值，实现可选参数（默认参数需放在末尾）：

<?php
// 计算商品总价：默认数量1
function getTotal(float $price, int $num = 1): float {
    return $price * $num;
}

// 调用：仅传价格（使用默认数量）
echo getTotal(99.9); // 输出：99.9
// 调用：传价格和数量
echo getTotal(99.9, 3); // 输出：299.7
?>

2. 引用传递

默认参数是值传递，若需修改原变量，用&实现引用传递：

<?php
// 增加用户积分（引用传递）
function addPoints(int &$points, int $add): void {
    $points += $add;
}

$userPoints = 100;
addPoints($userPoints, 50); // 修改原变量
echo "New Points: {$userPoints}"; // 输出：New Points:150
?>

四、灵活返回值处理

1. 单个返回值

直接用return返回，支持所有数据类型：

<?php
// 判断是否为偶数
function isEven(int $num): bool {
    return $num % 2 === 0;
}

echo isEven(4) ? "Even" : "Odd"; // 输出：Even
?>

2. 多个返回值

PHP不支持直接返回多个值，但可通过数组或list()解构实现：

<?php
// 获取用户信息（多值返回）
function getUserInfo(): array {
    return [
        'name' => 'Alice',
        'age' => 25,
        'email' => 'alice@example.com'
    ];
}

// 解构数组获取多值
[$name, $age, $email] = getUserInfo();
echo "Name: {$name}, Age: {$age}"; // 输出：Name:Alice, Age:25
?>

五、实战案例：数据验证函数

封装通用数据验证逻辑，提升代码复用性：

<?php
/**
 * 验证邮箱格式
 * @param string $email 待验证邮箱
 * @return bool 验证结果
 */
function isValidEmail(string $email): bool {
    return filter_var($email, FILTER_VALIDATE_EMAIL) !== false;
}

/**
 * 验证手机号（中国大陆）
 * @param string $phone 待验证手机号
 * @return bool 验证结果
 */
function isValidPhone(string $phone): bool {
    $pattern = '/^1[3-9]\d{9}$/';
    return preg_match($pattern, $phone) === 1;
}

// 测试验证
$email = "test@example.com";
$phone = "13812345678";
echo isValidEmail($email) ? "Valid Email" : "Invalid Email";
echo isValidPhone($phone) ? "Valid Phone" : "Invalid Phone";
?>

六、优化技巧：写出高质量函数

1. 避免全局变量

函数内优先用参数传递数据，减少全局变量依赖：

<?php
// 错误：依赖全局变量
$taxRate = 0.1;
function calculateTax(float $price): float {
    global $taxRate; // 不推荐
    return $price * $taxRate;
}

// 正确：通过参数传递
function calculateTaxV2(float $price, float $taxRate): float {
    return $price * $taxRate;
}
?>

2. 规范命名与注释

遵循PSR-12规范：函数名用小驼峰（如getUserInfo），添加文档注释（便于IDE提示和维护）。

3. 抛出异常处理错误

用异常替代直接输出错误，提升代码健壮性：

<?php
function divide(int $a, int $b): float {
    if ($b === 0) {
        throw new InvalidArgumentException("Division by zero");
    }
    return $a / $b;
}

// 捕获异常
try {
    echo divide(10, 0);
} catch (InvalidArgumentException $e) {
    echo "Error: {$e->getMessage()}"; // 输出：Error:Division by zero
}
?>

七、总结

自定义函数是PHP开发的核心工具，合理使用可显著提升代码质量。从基础定义到参数优化，再到实战案例，掌握这些技巧能让你写出更简洁、易维护的代码。建议在项目中多封装通用功能，让开发更高效！