享元模式适用于高重复轻量对象场景，核心是分离内在状态（只读、可复用）与外部状态（调用方传入），错误地将userId等存入享元会破坏共享；PHP中需注意工厂单例性、键生成效率及外部状态结构化传递。
PHP 实现享元模式不是为了“炫技”，而是当你的应用真正在跑大量轻量、高重复对象（比如千万级用户角色、上万图标实例、弹幕粒子、日志上下文标签）时，内存占用开始线性飙升——这时候才值得引入。否则，加一层工厂、拆内外状态，纯属增加维护成本。
享元核心：区分 intrinsicState 和 extrinsicState
关键不在“怎么写类”，而在“哪些状态该塞进对象里，哪些必须由调用方传进来”。内在状态（$color、$iconType、$roleCode）必须是只读、可跨实例复用的；外部状态（$x、$y、$userId、$timestamp）每次调用都不同，绝不能存在享元对象内部。
常见错误现象：Flyweight 类里出现了 $this->userId 或 $this->position —— 这直接破坏共享前提，对象无法复用。
- 判断标准：如果两个对象仅靠
===比较就返回true，那它们的内在状态必须完全一致 - 性能影响：内在状态越小、越固定（如字符串枚举、整数 ID），享元池越紧凑，
array_key_exists()查找越快 - PHP 注意：不要用
serialize()做 key，开销大；推荐用md5(implode('|', $intrinsicValues))或直接拼接字符串作键
FlyweightFactory 必须是单例且线程安全（PHP-FPM 场景）
在 PHP-FPM 下，每个请求是独立进程，FlyweightFactory 实例天然隔离，但若你在 CLI 或 Swoole 长生命周期环境中使用，就必须确保工厂是单例，且内部享元池（通常是 static array）不会被并发写入污染。
立即学习“PHP免费学习笔记（深入）”；
示例中容易踩的坑：public static $pool = []; 在 Swoole 协程下未加锁，多个协程同时 new 同一个 key 的享元，会创建多份。
- 建议做法：用
static $pool = [];+spl_object_hash($this)辅助去重，或改用WeakMap（PHP 8.0+）管理实例引用 - 不要在工厂里做 heavy 初始化（如查 DB、读文件），内在状态应能快速构造；否则工厂本身成瓶颈
- 调试技巧：在
getFlyweight()中加echo "created: $key\n";，上线前确认相同 key 只输出一次
Client 端必须承担 extrinsicState 传递责任
享元对象自己不存坐标、ID、时间戳等上下文数据，这些全靠客户端在调用 operation($extrinsicState) 时传入。这不是偷懒，是强制解耦——避免享元对象变成“状态黑洞”。
典型反模式：$bullet->fire($x, $y); 看似简洁，但隐藏了状态归属；正确写法是 $bullet->render(['x' => $x, 'y' => $y, 'power' => $power]);，让外部状态结构化、可追踪。
- 参数差异：PHP 中推荐用关联数组传
$extrinsicState，比多个位置参数更易扩展，也方便后续加校验或默认值 - 兼容性影响：如果旧代码已把外部状态混在享元里，强行重构需同步修改所有调用点，风险高；建议先加 deprecation warning，再逐步迁移
- 性能提示：避免在每次
operation()中重复解析或转换$extrinsicState，应在客户端预处理好（如提前转为整数坐标）
真正难的不是写出 Flyweight 类，而是准确识别哪些状态真的“可共享”——业务逻辑稍一变动（比如某角色突然需要差异化图标），内在状态边界就可能崩塌。所以享元模式一旦启用，内在状态契约就得写进文档，甚至加单元测试断言。
