php类属性默认值仅支持编译期常量,如标量和null;动态值须在__construct()中初始化,readonly属性也必须通过构造函数赋值。

PHP类属性默认值只能是编译期常量
PHP类的属性($property)不能用函数调用、变量、数组字面量或对象实例作为默认值——哪怕只是date('Y')或[]都会报错Parse error: syntax error, unexpected '['。这是因为属性声明在类定义时就被解析,而运行期表达式此时不可用。
能用的只有:标量(int/float/string/bool)、null、以及 PHP 7.4+ 支持的类型化属性默认值(如private int $count = 0;)。
-
public $name = 'default';✅ -
private array $items = []; // PHP 7.4+ 才允许✅(但注意:这是语法糖,底层仍受限) protected $now = time(); // ❌ Parse errorpublic $config = CONFIG_PATH; // ❌ 即使 CONFIG_PATH 是 const,也必须显式用 const 关键字
需要动态默认值?用构造函数初始化
绝大多数“想设默认值”的场景,其实真正要的是「实例创建时自动赋值」,而不是字面意义的“声明时默认”。这时候别硬塞到属性声明里,直接进__construct()。
比如想让$created_at每次新建对象都自动填当前时间戳:
立即学习“PHP免费学习笔记(深入)”;
class User {
public $created_at;
public function __construct() {
$this->created_at = time(); // ✅ 运行期安全
}
}
- 避免在构造函数里重复初始化已声明默认值的属性(比如
public $status = 'active';又在__construct()里再赋一次) - 如果属性有类型声明(如
private string $name;),且没设默认值,PHP 8.2+ 会警告未初始化;此时必须在__construct()中显式赋值,或改用private string $name = ''; - 多个依赖项(如数据库连接、配置对象)也应在此处注入,而非试图在属性声明里“预加载”
PHP 8.1+ 的只读属性 + 默认值组合更安全
如果你希望属性初始化后不可变,又想带默认值,readonly属性配合构造函数是最干净的解法。它把「设默认值」和「防误改」一次写清楚。
例如一个不可变的用户 ID 配置:
class UserId {
public readonly string $prefix;
public readonly int $seq;
public function __construct(string $prefix = 'USR') {
$this->prefix = $prefix;
$this->seq = rand(1000, 9999);
}
}
-
readonly属性不允许在构造函数外赋值,也不允许后续修改,比注释或文档约束可靠得多 - 不能给
readonly属性设声明期默认值(如public readonly string $x = 'a';),PHP 会报错;必须通过__construct()赋值 - PHP 8.2 起支持
readonly与array、object等复合类型,但默认值依然只能靠构造函数给
静态属性默认值同样受编译期限制
别以为static就能绕过限制——public static $cache = new ArrayObject();照样报错。静态属性默认值规则和普通属性完全一致:只接受常量表达式。
真要初始化静态资源(如单例、缓存容器),得用静态构造逻辑:
class Cache {
private static ?ArrayObject $instance = null;
public static function getInstance(): ArrayObject {
if (self::$instance === null) {
self::$instance = new ArrayObject();
}
return self::$instance;
}
}
- 不要在类外提前调用初始化方法(如
Cache::init();),容易因加载顺序出问题 - PHP 8.1+ 可用
static返回类型和??=简化:self::$instance ??= new ArrayObject(); - 静态属性默认值为
null是安全的,但别依赖它“表示未初始化”——有些场景null本身就是合法业务值











