PHP 8.1 构造函数属性提升需在参数前加 public/private/protected，且类型声明、名称匹配、无同名属性；提升参数必须前置，不支持默认值和校验等业务逻辑。
构造函数参数前加 public/private/protected 就生效
PHP 8.1 的构造函数属性提升和 PHP 8.0 语法完全一致，没有新增规则。只要在 __construct() 的参数前加上可见性关键字，且满足类型声明、名称匹配、无冲突这三点，PHP 就自动完成属性声明 + 类型约束 + 赋值三件事。
常见错误现象：Property promotion is not allowed —— 这不是运行时报错，而是解析阶段就拒绝，根本不会执行到函数体。
-
public function __construct(string $name)❌ 缺少可见性关键字 -
public function __construct(public $name)❌ 缺少类型（$name是 mixed） -
class User { private string $name; public function __construct(private string $name) {} }❌ 同名属性已存在 -
public function __construct(var $name)❌var已废弃，PHP 8+ 不支持
__construct() 里混用提升参数和普通参数要注意顺序
PHP 8.1 默认要求所有带可见性修饰的提升参数必须连续出现在参数列表最前面；后面才能跟普通参数（无可见性、无类型或类型为 mixed）。否则会报错。
示例：
立即学习“PHP免费学习笔记（深入）”；
class User {
public function __construct(
public string $name,
public int $age,
string $rawInput // ✅ 普通参数放最后
) {
// $rawInput 不会成为属性，但可在函数体内使用
}
}
反例（PHP 8.1 报错）：
public function __construct(
public string $name,
string $rawInput,
public int $age // ❌ 提升参数不能插在中间
)
注意：PHP 8.2+ 放宽了该限制，允许提升参数穿插，但如果你项目还跑在 8.1 或更低版本，必须前置。
默认值、校验逻辑、parent::__construct() 都得手动写
属性提升只管“声明 + 类型 + 赋值”，不接管业务逻辑。想设默认值、做长度校验、调父类构造函数，都得自己写进函数体里。
- 默认值直接写在参数后：
public string $name = 'guest' - 校验必须在
{}里：if (strlen($name) - 子类继承时，
parent::__construct(...)仍需显式调用，提升不会自动代理 - 父类用了提升，子类构造函数里不能再重复声明同名提升参数，否则冲突
抽象类、接口、callable 和对象类型默认值的坑
这些限制在 PHP 8.1 中依然严格存在，容易被忽略：
- 抽象类或接口的
__construct()不能含提升参数 ——abstract public function __construct(private string $x)直接报错 -
callable类型不支持提升：public callable $cb❌ 即使加了public也不行 - 对象类型参数若设
null为默认值，必须用可空联合类型：public ?DateTime $when = null✅；public DateTime $when = null❌ - trait 中允许使用提升，但最终类中若与 trait 冲突（比如同名提升参数），仍会报错
最常被漏掉的是：提升参数一旦定义，就不可再在类体中重复声明同名属性 —— 这个检查发生在编译期，不运行也报错，调试时容易卡在“为什么连 new 都没执行就挂了”。
