scrapbook 在 composer 中的正确包名是 scrivo/scrapbook，vendor 必须为 scrivo（与 packagist 账号一致），package 为 scrapbook，全小写、无下划线或大写；错误写成 scrapbook/scrapbook 会导致“could not find package”错误。
Scrapbook 在 Composer 中的正确包名是什么？
Scrapbook 的官方 Composer 包名是 scrivo/scrapbook，不是 scrapbook/scrapbook 或其他变体。很多用户执行 composer require scrapbook/scrapbook 会报错 Could not find package scrapbook/scrapbook，就是因为用错了命名空间。
实际安装命令应为：
composer require scrivo/scrapbook
安装后，自动加载机制会注册 Scrivo\Scrapbook 命名空间 —— 注意大小写和反斜杠方向，类名如 Scrivo\Scrapbook\MemoryStore 必须严格按此书写，否则 Class not found。
如何用 Scrapbook 实现跨驱动的统一缓存接口？
Scrapbook 的核心价值在于把不同后端（内存、Redis、APCu、File）抽象成同一套操作逻辑。关键不是直接 new 某个 Store，而是通过 Scrivo\Scrapbook\Psr6\Pool 或 Scrivo\Scrapbook\Store 接口统一调用。
-
Scrivo\Scrapbook\Store是底层键值对接口，支持get()/set()/delete()，适合简单场景 -
Scrivo\Scrapbook\Psr6\Pool实现 PSR-6 标准，返回CacheItemInterface实例，适合需要 TTL、延迟写入或批量操作的项目
例如使用 Redis 驱动：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
$redis = new Redis();
$redis->connect('127.0.0.1', 6379);
$store = new Scrivo\Scrapbook\RedisStore($redis);
// 或 PSR-6 方式
$pool = new Scrivo\Scrapbook\Psr6\Pool(new Scrivo\Scrapbook\RedisStore($redis));
为什么 set() 后 get() 返回 null？常见驱动初始化陷阱
最常踩的坑是：Redis 或 Memcached 驱动未正确传入客户端实例，或客户端本身未连接成功，但 Scrapbook 不抛异常，set() 静默失败，get() 永远返回 null。
排查步骤：
- 确认 Redis 扩展已启用：
php -m | grep redis - 检查
Redis实例是否 connect 成功，建议加if (!$redis->isConnected()) { throw new RuntimeException('Redis not connected'); } - MemoryStore 仅用于测试，重启进程即丢失数据，别误以为“缓存没生效”是代码问题
- FileStore 默认写入
/tmp，注意目录权限和磁盘空间，file_put_contents失败时也静默忽略
Scrapbook 和原生 PHP 缓存扩展（如 APCu）性能差异在哪？
Scrapbook 对 APCu 的封装是 Scrivo\Scrapbook\ApcuStore，它不直接调用 apcu_fetch()，而是包装了一层序列化/反序列化逻辑。这意味着：
- 存取小字符串（如 flag、token）时，比原生
apcu_fetch()慢 15–20%，因为多了 serialize/unserialize 开销 - 存对象或数组时反而更安全 —— 原生 APCu 要求
apc.serializer=php，而 Scrapbook 强制使用 PHP 序列化，避免配置遗漏导致的 false 返回 - 所有 Store 都默认启用
serialize，无法关闭；若你明确只存字符串且追求极致性能，直接用原生扩展更合适
真正值得用 Scrapbook 的地方，是项目需在开发（MemoryStore）和生产（RedisStore）间无缝切换，且不愿为每种后端重写缓存逻辑。
记住：Scrapbook 不是性能优化工具，它是抽象一致性工具。它的价值藏在 new MemoryStore() 和 new RedisStore($redis) 可以互换而不改业务代码这点上 —— 这点容易被忽略，但恰恰是它存在的全部理由。
