__construct 是 PHP 中类的构造方法，实例化时自动调用；它不是初始化函数别名，不可直接调用，无返回值，必须 public，仅一个且不支持重载，参数自由，子类需显式调用父类构造函数，不宜执行副作用操作，PHP 8.2+ 中与 readonly 类配合要求属性在其中初始化。
__construct 是什么，不是什么
__construct 是 PHP 中的构造方法，类实例化时自动调用；它不是“初始化函数”的别名，也不等价于 init() 或其他手动调用的方法。它没有返回值（哪怕写 return 也无效），也不能被直接调用（如 $obj->__construct() 属于非法操作）。
常见错误现象：Fatal error: Cannot call constructor 就是手贱调了它；或者忘记 parent::__construct() 导致父类依赖未初始化，后续调用直接报 Undefined property 或空对象。
- 必须是
public（PHP 5.3.3+ 强制，私有/保护会报致命错误） - 可重载：一个类只能有一个
__construct，不支持像 Java 那样多个同名不同参的版本 - 参数完全自由：可以无参、可以带默认值、可以用类型声明（
string $name）、也可用可变参数（...$args）
子类继承时 parent::__construct() 必须显式调用
PHP 不会自动帮你调父类构造函数。如果父类 __construct 做了关键初始化（比如设置 $this->config、连接数据库、注入依赖），而子类又定义了自己的 __construct，那父类逻辑就彻底失效。
使用场景：写 Laravel Service 类、自定义异常类、或任何需要扩展已有类行为的场景。
立即学习“PHP免费学习笔记（深入）”；
- 父类有参，子类没调
parent::__construct(...)→ 运行时报Warning: Missing argument或更隐蔽的空状态 - 父类无参，子类写了
__construct但没写parent::__construct()→ 看似正常，但父类里写的日志、钩子、资源预加载全丢了 - 参数顺序要对齐：如果父类要求
__construct(array $opts, string $mode)，子类转发时不能只传一个参数
示例：
class BaseService
{
protected $logger;
public function __construct(LoggerInterface $logger)
{
$this->logger = $logger;
}
}
class UserService extends BaseService
{
private $db;
public function __construct(LoggerInterface $logger, PDO $db)
{
parent::__construct($logger); // 必须这句
$this->db = $db;
}
}
__construct 里不该做哪些事
构造函数不是万能启动器。它该专注“让对象处于可用状态”，而不是执行副作用操作。
容易踩的坑：把耗时、不可靠、可能失败的操作塞进 __construct，导致 new 一个对象就抛异常，且难以 mock 或测试。
- 不要发起 HTTP 请求（
file_get_contents、cURL）——改用懒加载或独立load()方法 - 不要读写文件（
fopen、file_put_contents）——路径权限、并发写入、失败无回滚，全在构造里爆雷 - 不要触发全局状态变更（如
set_error_handler、修改ini_set）——违反单一职责，且无法撤销 - 避免复杂依赖注入链：如果
__construct里要 new 十个对象再传进去，说明设计过重，考虑工厂或容器
PHP 8.2+ 的只读类与 __construct 的配合
PHP 8.2 引入 readonly 类，要求所有属性必须在 __construct 中一次性赋值，且之后不可改。这不是语法糖，是强制约束。
使用场景：DTO、配置对象、领域模型中需要强保证不变性的场合。
- 所有
readonly属性必须在__construct中显式赋值，漏一个就报Fatal error: Readonly property ... must be initialized - 不能在
__construct外部赋值，也不能用__set或反射绕过 - 如果用了
__construct(array $data)批量赋值，得挨个写$this->prop = $data['prop'] ?? null;，不能偷懒用foreach+ 反射
示例：
readonly class UserDto
{
public function __construct(
public string $id,
public string $name,
public int $age,
) {}
}
这种写法下，$user = new UserDto('1', 'Alice', 30) 合法，但 $user->name = 'Bob' 会立刻报错。
真正麻烦的是嵌套 readonly 对象——每个层级的构造都得严格对齐，少一个参数或类型不对，错误信息不会直接告诉你哪一层崩了，得一层层查。
