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本身就是合法业务值
复杂点在于:PHP 的“默认值”语义其实分裂成了两层——声明期字面默认(极窄)和实例期逻辑默认(实际常用)。很多人卡住,是因为盯着第一层想强行覆盖第二层。记住:该进构造函数的,就别在属性声明里硬扛。