PHP 8.0 构造器属性提升要求参数必须显式带访问修饰符（public/protected/private）、类型声明和参数名三者齐全，否则不提升为属性；禁止与已有属性同名、在抽象类/接口中使用，且对象默认值须用可空类型声明。
PHP 8.0 的构造器属性提升（__construct 参数带访问修饰符）不是“能用就行”，写错会直接报错或引发隐性行为。核心原则是：**访问修饰符 + 类型声明 + 参数名三者必须同时存在，且不能违反 PHP 的语义边界**。
必须显式声明 public / protected / private
只写类型和参数名，不加访问修饰符，就只是普通构造参数，不会提升为属性：
class User {
public function __construct(string $name, int $id) { } // ❌ $name 和 $id 不是类属性
}
正确写法是每个要提升的参数前都加一个访问修饰符：
-
public string $name→ 属性可读可写 -
protected int $id→ 属性仅子类/本类可读写 -
private ?DateTime $created_at→ 属性仅本类可读写，且允许 null
混用也完全合法，比如部分参数提升、部分手动赋值：
立即学习“PHP免费学习笔记（深入）”；
class User {
private $cache;
public function __construct(
public string $name,
public int $id,
$rawCache // 不提升，需手动处理
) {
$this->cache = $rawCache ?: [];
}
}
对象类型默认值必须用可空类型声明
如果你的参数类型是类或接口（比如 UserRepository），不能直接写 = null：
class Service {
public function __construct(UserRepository $repo = null) { } // ❌ Parse error
}
必须用可空类型（?UserRepository）配合 = null：
class Service {
public function __construct(?UserRepository $repo = null) { } // ✅
}
原因：PHP 需要明确知道该属性允许 null 值，否则类型系统无法推断。非对象类型（如 string、int）同理，string $s = '' 合法，但 string $s = null 会报错 —— 必须写成 ?string $s = null。
不能在抽象类、接口里用，但 trait 中可以
抽象类和接口的 __construct 方法不能带构造器属性提升：
abstract class Model {
abstract public function __construct(public int $id); // ❌ Fatal error
}
接口更不行：
interface Loggable {
public function __construct(public string $context); // ❌ Syntax error
}
但 trait 是允许的，且会被正确合并进使用它的类中：
trait Timestampable {
public function __construct(public DateTimeImmutable $created_at) {}
}
class Post {
use Timestampable;
public function __construct(
public string $title,
DateTimeImmutable $created_at
) {
$this->created_at = $created_at; // ✅ 可以，trait 已声明该属性
}
}
注意：如果 trait 和类中同时定义了同名属性（哪怕类型一致），会触发致命错误 —— PHP 不允许重复属性声明。
别和 var 或旧式属性声明共存
var 在 PHP 8 中已彻底废弃，且不能用于构造器属性提升：
class User {
public function __construct(var $name) { } // ❌ Parse error: syntax error
}
更隐蔽的坑是：已有标准属性声明，又在构造器里重复提升同名参数：
class User {
public string $name;
public function __construct(public string $name) { } // ❌ Cannot redeclare property
}
这种写法在 PHP 8.0+ 直接报 Fatal error: Cannot redeclare property。解决办法只有一个：删掉上面那行 public string $name;，全部交给构造器提升管理。
实际项目里 DTO 字段动辄十几个，最容易漏删旧属性声明 —— 建议用 IDE 的“查找所有引用”功能，或者跑一遍 php -l 静态检查提前暴露。
