Yii2 Active Record用PHP8语法声明属性后字段为何无法访问？

问题根源 #

Yii2的ActiveRecord（AR）核心依赖__get()和__set()魔术方法管理数据库字段的属性访问，所有数据库字段都是AR的「虚拟属性」，而非类的真实属性。当你显式声明同名的public类属性后，直接访问这些属性会绕过魔术方法，导致AR无法追踪属性的修改状态——AR会判定这些字段不属于模型的可保存属性，最终插入/更新时不会将它们加入SQL语句，这就是你看到user_id字段缺失错误的原因。

正确的PHP8语法适配方案 #

方案1：用@property注解提供类型提示（推荐） #

移除显式声明的类属性，转而在类注释中通过@property添加PHP8风格的类型声明，既能让IDE识别属性类型，又不破坏AR的魔术方法机制：

/**
 * @property ?int $id
 * @property int $user_id
 * @property string $slug
 * @property ?string $title
 * @property ?string $content
 * @property ?string $created_at
 * @property ?string $updated_at
 * @property ?string $published_at
 */
final class Post extends ActiveRecord
{
    public static function tableName(): string
    {
        return 'posts';
    }

    public function rules(): array
    {
        return [
            [['user_id', 'title', 'content'], 'required'],
            [['user_id'], 'integer'],
            [['content'], 'string'],
            [['slug', 'created_at', 'updated_at', 'published_at'], 'safe'],
            [['title'], 'string', 'max' => 512],
        ];
    }
}

方案2：给Getter/Setter添加PHP8类型声明 #

如果需要更严格的类型校验，可以给属性的Getter/Setter方法加上PHP8类型提示，增强代码的类型安全性：

final class Post extends ActiveRecord
{
    public static function tableName(): string
    {
        return 'posts';
    }

    public function rules(): array
    {
        return [
            [['user_id', 'title', 'content'], 'required'],
            [['user_id'], 'integer'],
            [['content'], 'string'],
            [['slug', 'created_at', 'updated_at', 'published_at'], 'safe'],
            [['title'], 'string', 'max' => 512],
        ];
    }

    public function getId(): ?int
    {
        return $this->id;
    }

    public function setUser_id(int $user_id): void
    {
        $this->user_id = $user_id;
    }

    public function getUser_id(): int
    {
        return $this->user_id;
    }

    // 其他属性的Getter/Setter可按需添加
}

注意事项 #

1. 不要给未初始化的非空类型属性留空（比如你之前写的public string $slug;），PHP8严格类型模式下，未初始化的非空属性会触发致命错误，建议在init()方法中初始化这类属性：

public function init(): void
{
    parent::init();
    $this->slug = '';
}

2. 若一定要用PHP8原生类属性，需使用Yii2的PHP8兼容扩展，通过#[Column]注解标记属性让AR识别，但这种方式需要额外安装扩展，适配成本略高。

内容的提问来源于stack exchange，提问作者Bohdan Vorona