PHP默认参数

PHP默认参数

PHP默认参数（Default Arguments）是PHP函数中一个重要的特性，允许在定义函数时为某些参数指定默认值。如果调用函数时未提供该参数的值，PHP会自动使用默认值。这一特性提高了代码的灵活性，减少了冗余的函数重载需求。

基本语法

默认参数的语法如下：

function functionName($param1, $param2 = "default_value") {
    // 函数体
}

其中：

• $param1 是必选参数，调用时必须提供值。
• $param2 是可选参数，如果未提供值，则使用 "default_value"。

详细说明

默认参数的位置

默认参数必须放在参数列表的右侧，即所有必选参数之后。否则会导致语法错误。

错误示例：

function example($a = 1, $b) {  // 错误：默认参数不能在必选参数之前
    return $a + $b;
}

正确示例：

function example($b, $a = 1) {  // 正确：默认参数在右侧
    return $a + $b;
}

默认值类型

默认值可以是：

• 标量类型（整数、浮点数、字符串、布尔值）
• 数组
• NULL
• 常量表达式（但不能是变量或函数调用）

示例：

function greet($name, $greeting = "Hello", $punctuation = "!") {
    return "$greeting, $name$punctuation";
}

echo greet("Alice");  // 输出：Hello, Alice!
echo greet("Bob", "Hi");  // 输出：Hi, Bob!
echo greet("Charlie", "Welcome", ".");  // 输出：Welcome, Charlie.

实际应用案例

配置函数

默认参数常用于配置函数，允许用户仅覆盖他们需要更改的设置。

function connectToDatabase($host = "localhost", $user = "root", $password = "", $db = "test") {
    // 连接数据库的逻辑
    return "Connected to $db on $host as $user";
}

echo connectToDatabase();  // 使用所有默认值
echo connectToDatabase("db.example.com", "admin", "secure123", "production");  // 覆盖所有参数

分页功能

在分页功能中，默认参数可以简化常见情况下的调用。

function paginate($totalItems, $itemsPerPage = 10, $currentPage = 1) {
    $totalPages = ceil($totalItems / $itemsPerPage);
    return "Showing page $currentPage of $totalPages";
}

echo paginate(150);  // 输出：Showing page 1 of 15
echo paginate(150, 20);  // 输出：Showing page 1 of 8
echo paginate(150, 25, 3);  // 输出：Showing page 3 of 6

高级用法

类型声明与默认参数

PHP 7.0+ 支持类型声明，可以与默认参数结合使用。

function calculateArea(float $width, float $height = 1.0): float {
    return $width * $height;
}

echo calculateArea(5);  // 输出：5.0
echo calculateArea(3, 4);  // 输出：12.0

NULL 作为默认值

当需要区分"未提供值"和"提供NULL值"时，可以使用NULL作为默认值。

function logMessage(string $message, ?string $timestamp = null) {
    $time = $timestamp ?? date('Y-m-d H:i:s');
    return "[$time] $message";
}

echo logMessage("System started");  // 使用当前时间
echo logMessage("Error occurred", "2023-01-01 12:00:00");  // 使用指定时间

注意事项

1. 默认值必须是常量表达式，不能是变量或函数调用结果。

  * 错误：function test($a = time())
  * 正确：function test($a = null) { $a = $a ?? time(); }

2. 默认参数的值在函数定义时计算，而不是调用时。

3. 使用引用参数（&$param）作为默认参数时需特别注意行为差异。

总结

PHP默认参数是一个强大的特性，它：

• 减少需要编写的重载函数数量
• 使API更清晰易用
• 提供合理的默认行为同时保持灵活性

通过合理使用默认参数，可以创建更简洁、更易维护的代码库。初学者应从简单示例开始，逐步掌握在各种场景下的应用方式。