单例类构造函数必须为private以防止外部new创建实例,同时需私有化__clone()和__wakeup()防止克隆与反序列化绕过;并发场景下静态变量不可靠,应使用文件锁或Redis锁;trait中应使用static::而非self::避免实例共享。

单例类的构造函数必须是 private
否则外部能用 new 随意创建新实例,直接破坏单例约束。PHP 不会自动阻止你 new 一个 public 构造函数的类——它只会默默照做,然后你发现 $a === $b 居然返回 false。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 把
__construct()和__clone()都设为private,防止克隆绕过 - 如果用了
__wakeup()(反序列化场景),也得设成private,不然unserialize()会新建对象 - 别在构造函数里写耗时逻辑,单例首次调用才触发,但延迟加载不是万能解药——万一多个地方同时首次访问,可能并发创建多个实例(见下一条)
静态方法 getInstance() 要加双重检查锁(PHP 7.4+ 可用 atomic)
纯静态变量缓存 + 直接 return,在并发请求下大概率生成多个实例。PHP 的 static 变量作用域是请求级,但多线程 SAPI(如 PHP-FPM 多 worker)或协程环境(Swoole)中,static 并不跨进程/协程同步。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 简单脚本或 CLI 单进程场景,用
private static $instance = null;+if (self::$instance === null)判断够用 - Web 环境(尤其高并发),必须加文件锁或 Redis 锁;例如用
flock()包裹实例化逻辑,释放前写入self::$instance - PHP 8.1+ 可考虑
WeakMap存储,但仅限对象生命周期内,不解决跨请求单例问题
不能依赖 __sleep / __wakeup 实现单例保活
反序列化时 __wakeup() 会被调用,但它发生在新对象创建之后——也就是说,即使你在 __wakeup() 里重赋值 self::$instance,当前反序列化出的对象仍是独立实例,跟原单例内存地址不同。
常见错误现象:
-
serialize($obj); $obj2 = unserialize($str); $obj === $obj2返回false - 数据库连接单例被反序列化后,执行查询报
mysqli::query(): Couldn't fetch mysqli
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 在
__wakeup()里直接抛异常,明确禁止反序列化:throw new RuntimeException('Singleton cannot be unserialized'); - 真要支持序列化(极少见),改用
__serialize()+__unserialize(),并在后者中返回self::getInstance()
trait 实现单例容易误用 self:: 和 static::
用 trait 抽取单例逻辑很常见,但 self:: 在 trait 中指向 trait 自身,不是使用它的类——导致 self::$instance 被所有 use 该 trait 的类共享,变成“全局单例”,而非“每个类一个单例”。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 强制用
static::$instance,并要求每个类自己声明protected static $instance = null; - 或者放弃 trait,直接写基类
abstract class Singleton,让子类继承,避免静态属性混用 - PHP 8.2+ 支持只读类(
readonly class),但单例本身需要可变状态,不适用



















