PHP命名参数与构造器提升详解

PHP命名参数与构造器提升详解

PHP8引入了两个非常实用的特性，命名参数和构造器属性提升。这些特性让代码写起来更简洁、更清晰。

命名参数允许在调用函数时指定参数名，不用按顺序传参。这在参数多的时候特别有用。

```php
// PHP8命名参数
function createUser(
string $name,
string $email,
int $age = 0,
string $country = '',
string $city = '',
bool $active = true,
array $roles = ['user'],
): array {
return compact('name', 'email', 'age', 'country', 'city', 'active', 'roles');
}

// 传统方式（按顺序）
$user1 = createUser('张三', 'zhangsan@test.com', 28, '中国', '北京', true, ['user', 'admin']);

// 命名参数（只看需要的参数）
$user2 = createUser(
name: '李四',
email: 'lisi@test.com',
age: 30,
country: '中国',
);

// 跳过中间参数
$user3 = createUser(
name: '王五',
email: 'wangwu@test.com',
roles: ['editor', 'user'],
);

print_r($user2);
print_r($user3);
?>
```

命名参数让代码的可读性大幅提升。不用去数第几个参数是什么，直接看名字就知道传的是什么值。而且在需要跳过可选参数时特别方便。

构造器属性提升把属性声明和构造器参数合并在一起。PHP8之前，你要先声明属性，再在构造器中赋值。现在一行搞定。

```php
// PHP8之前
class UserOld
{
private string $name;
private string $email;
private ?string $phone;
private bool $active;

public function __construct(
string $name,
string $email,
?string $phone = null,
bool $active = true
) {
$this->name = $name;
$this->email = $email;
$this->phone = $phone;
$this->active = $active;
}
}

// PHP8构造器属性提升
class User
{
public function __construct(
public string $name,
public string $email,
private ?string $phone = null,
private bool $active = true,
private \DateTime $createdAt = new \DateTime(),
) {}

public function getInfo(): string
{
return "{$this->name} ({$this->email})" . ($this->active ? ' [活跃]' : ' [不活跃]');
}
}

$user = new User('张三', 'zhangsan@test.com', '13800138000');
echo $user->getInfo() . "\n";
echo $user->name . "\n"; // public属性可以直接访问
?>
```

构造器属性提升加上命名参数，让代码变得非常简洁：

```php
// DTO类
class OrderDTO
{
public function __construct(
public readonly string $orderId,
public readonly int $userId,
public readonly array $items,
public readonly float $total,
public readonly string $status = 'pending',
public readonly ?\DateTime $paidAt = null,
public readonly ?string $couponCode = null,
public readonly array $metadata = [],
) {}
}

class ProductDTO
{
public function __construct(
public readonly int $id,
public readonly string $name,
public readonly float $price,
public readonly int $stock,
public readonly ?string $description = null,
public readonly array $tags = [],
public readonly bool $active = true,
) {}
}

// 使用命名参数创建DTO
$order = new OrderDTO(
orderId: 'ORD-' . uniqid(),
userId: 123,
items: [
['product_id' => 1, 'quantity' => 2, 'price' => 99.99],
['product_id' => 2, 'quantity' => 1, 'price' => 199.99],
],
total: 399.97,
couponCode: 'SAVE20',
metadata: ['source' => 'mobile'],
);

$product = new ProductDTO(
id: 1,
name: 'PHP编程入门',
price: 59.99,
stock: 100,
tags: ['php', '编程', '入门'],
);

echo "订单: {$order->orderId}, 金额: {$order->total}\n";
echo "商品: {$product->name}, 价格: {$product->price}\n";
?>
```

readonly属性可以和构造器提升一起用，创建不可变对象：

```php
readonly class Config
{
public function __construct(
public string $dbHost,
public int $dbPort,
public string $dbName,
public string $dbUser,
public string $dbPass,
public string $appEnv,
public bool $debug,
public int $cacheTtl,
public array $allowedOrigins = [],
) {}
}

$config = new Config(
dbHost: 'localhost',
dbPort: 3306,
dbName: 'test',
dbUser: 'root',
dbPass: 'secret',
appEnv: 'development',
debug: true,
cacheTtl: 3600,
allowedOrigins: ['http://localhost:3000'],
);

// $config->dbHost = 'other'; // 报错，readonly属性不能修改
echo "数据库: {$config->dbHost}:{$config->dbPort}/{$config->dbName}\n";
?>
```

这些特性让PHP代码变得更简洁、更安全、更可读。升级到PHP8后，建议尽快用上这些新特性，它们能实实在在地提高代码质量和开发效率。