PHP __construct方法使用详解

PHP 的 `__construct` 方法是类实例化时自动触发的核心构造函数，它既不是可随意调用的初始化别名，也不支持重载或返回值，必须声明为 public 且仅能存在一个；子类继承时须显式调用 `parent::__construct()` 以确保父类关键逻辑不被跳过，而构造函数本身应严格聚焦于对象状态初始化——避免 HTTP 请求、文件 I/O 或全局状态修改等副作用操作；尤其在 PHP 8.2+ 中，它与 `readonly` 类深度绑定，强制所有只读属性必须在构造函数内一次性、显式赋值，为不可变数据结构提供语言级保障。掌握这些规则，才能写出健壮、可测、符合现代 PHP 最佳实践的对象初始化逻辑。

__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 类、自定义异常类、或任何需要扩展已有类行为的场景。

• 父类有参，子类没调 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 对象——每个层级的构造都得严格对齐，少一个参数或类型不对，错误信息不会直接告诉你哪一层崩了，得一层层查。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~