PHP函数默认参数指的是在函数定义时为参数预先指定一个默认值,当调用函数时没有传递该参数或者传递了null时,函数会自动使用预设的默认值参与运算,这种方式可以让函数的使用更加灵活,减少重复的参数传递逻辑。

PHP函数默认参数的基本写法
PHP设置函数默认参数的语法非常简单,只需要在函数定义的参数列表中,给参数赋值即可,赋值的右侧就是该参数的默认值。下面是一个最基础的示例:
<?php
// 定义一个计算两数之和的函数,第二个参数设置默认值为10
function sum($a, $b = 10) {
return $a + $b;
}
// 调用时不传递第二个参数,使用默认值10
echo sum(5); // 输出15
// 调用时传递第二个参数,使用传递的值
echo sum(5, 20); // 输出25
?>
PHP函数默认参数的设置规则
1. 默认参数必须放在非默认参数的后面
PHP规定,带有默认值的参数必须定义在没有默认值的参数之后,否则会触发语法错误。这是因为函数调用时参数是按位置传递的,如果默认参数在前,后面的非默认参数无法被正确识别。
<?php
// 错误写法:默认参数在前,会报错
// function test($a = 1, $b) {
// return $a + $b;
// }
// 正确写法:默认参数在后
function test($b, $a = 1) {
return $a + $b;
}
echo test(2); // 输出3
?>
2. 默认值支持的数据类型
PHP的默认参数支持多种数据类型,包括标量类型(字符串、整数、浮点数、布尔值)、null,以及数组和null。需要注意的是,PHP 5及之前的版本不支持将表达式、变量、函数调用作为默认值,PHP 7及之后版本支持将常量表达式作为默认值。
<?php
// 支持字符串默认值
function sayHello($name = "默认用户") {
echo "你好," . $name;
}
sayHello(); // 输出:你好,默认用户
// 支持数组默认值
function getList($type = ["a", "b", "c"]) {
return $type;
}
print_r(getList()); // 输出Array ( [0] => a [1] => b [2] => c )
// 支持常量作为默认值(PHP 7+)
define("DEFAULT_NUM", 5);
function calc($num = DEFAULT_NUM) {
return $num * 2;
}
echo calc(); // 输出10
?>
3. 传递null时的处理
当调用函数时给默认参数传递null时,PHP会直接使用null作为该参数的值,而不会使用预设的默认值。如果需要区分是未传递参数还是传递了null,可以通过func_num_args()函数判断参数个数。
<?php
function demo($a = "默认值") {
// 判断实际传递的参数个数
if (func_num_args() == 0) {
echo "未传递参数,使用默认值:" . $a;
} else {
echo "传递了参数,参数值为:" . var_export($a, true);
}
}
demo(); // 输出:未传递参数,使用默认值:默认值
demo(null); // 输出:传递了参数,参数值为:NULL
?>
PHP函数默认参数的常见使用场景
默认参数在实际开发中有很多实用场景,比如配置项的默认值设置、可选参数的处理等。下面是一个模拟数据库查询的函数示例,通过默认参数设置默认的查询条数和排序方式:
<?php
function queryData($table, $limit = 10, $order = "id DESC") {
$sql = "SELECT * FROM " . $table . " ORDER BY " . $order . " LIMIT " . $limit;
return $sql;
}
// 使用默认参数
echo queryData("user");
// 输出:SELECT * FROM user ORDER BY id DESC LIMIT 10
// 自定义参数
echo queryData("user", 20, "create_time ASC");
// 输出:SELECT * FROM user ORDER BY create_time ASC LIMIT 20
?>
注意事项
- 不要将可变变量、函数调用、类成员作为默认值,这类写法在PHP中是不支持的,会直接触发语法错误。
- 如果默认值是数组,需要注意数组的内容在定义时就已经确定,不会在每次函数调用时重新计算。
- PHP 8.0之后支持命名参数,使用命名参数调用函数时可以忽略参数的顺序,即使默认参数在前也可以通过命名参数传递后面的参数,但定义时仍然需要遵循默认参数在后规则。
总结:PHP函数默认参数的设置核心是给参数赋值默认值,遵循默认参数在后、支持常量表达式作为默认值的规则,合理使用默认参数可以让函数调用更简洁,减少冗余代码。