PHP session 切换 Memcached 需确保 memcached 扩展启用、session.save_handler=memcached、save_path 格式正确（如127.0.0.1:11211，多节点逗号分隔无空格），并显式调用 session_write_close() 触发写入，注意 Web 与 CLI 环境配置一致性。
PHP session 存到 Memcached 之前，先确认扩展和配置是否就位
PHP 默认用文件存 session，想切到 memcached，光装好服务端不够，PHP 进程得能连上、能调用、能识别新 handler。常见错误是 session_start() 报错：Failed to initialize storage module，或者压根没报错但 session 就是不持久——大概率是扩展没启用或配置漏了。
-
memcached扩展（注意不是memcache）必须已安装并启用，检查phpinfo()或运行php -m | grep memcached -
session.save_handler = memcached必须写在php.ini或运行时用ini_set('session.save_handler', 'memcached')设置（后者仅对当前请求生效） -
session.save_path要填成127.0.0.1:11211这种格式，多个节点用逗号分隔，不能带tcp://前缀，否则会静默失败 - 如果用了 SASL 认证或 Unix socket，
save_path写法完全不同，普通开发环境基本用不到，别乱加
session.save_path 多节点写法和超时参数怎么配才不丢数据
单机没问题，一上集群就容易出问题：A 服务器存了 session，B 服务器读不到。根本原因常出在 save_path 配置不一致，或没设连接超时导致请求卡住。
- 多节点示例：
ini_set('session.save_path', '10.0.1.10:11211,10.0.1.11:11211')—— 注意逗号后不能有空格，否则 PHP 会把整个字符串当单个地址解析 - Memcached 客户端默认连接超时是 1 秒，网络抖动时
session_start()可能阻塞或失败，建议显式设置：ini_set('memcached.sess_binary_protocol', '1'); ini_set('memcached.sess_connect_timeout', '500'); - session 数据本身不支持过期时间继承，
session.gc_maxlifetime仍控制 TTL，但实际存入 Memcached 的 key 过期时间由这个值决定，不是由 Memcached 自身策略管 - 别用
memcached.set_options()在运行时改全局行为，它不影响 session handler，只影响你手动 new 的Memcached实例
为什么 setcookie() 后 session_id() 没变，但数据就是不写进 Memcached
典型症状：$_SESSION['foo'] = 'bar'; 执行完，用 telnet 127.0.0.1 11211 查不到对应 key。不是 Memcached 没存，而是 session 还没真正写入——PHP 的 session 写入是延迟的，靠脚本结束或 session_write_close() 触发。
Session Reset
下载
安全地重置 OpenClaw agent sessions，支持备份、预览、恢复和批量操作。用于：1) 清理过期的 agent 会话上下文，2) 重置特定 agents 的 session，3) 批量重置六部/秘书 sessions，4) 查看和恢复历史备份。当用户需要"reset session"、"清理 se...
- 如果页面里有重定向（比如
header('Location: /login');），又没在跳转前调session_write_close()，session 数据大概率丢失 -
session_regenerate_id(true)后旧 session 文件/记录不会自动删，但 Memcached 里旧 key 会被覆盖，因为新 ID 对应新 key，旧 key 等 GC 清理，不用手动删 - 调试时别只看
$_SESSION数组内容，用memcached.get($sid)（其中$sid = session_id()）直接查 Memcached，更可靠 - 开启
memcached.sess_consistent_hash可以缓解节点增减时的 key 分布抖动，但对 session 场景收益有限，小集群可不开
PHP-FPM 和 CLI 下 session 行为差异容易踩坑
Web 请求走 FPM，CLI 脚本（比如队列任务、定时脚本）走命令行 SAPI，两者的 php.ini 配置可能不同。经常出现 Web 端能正常登录，CLI 脚本里 session_start() 却报 Unknown session handler。
立即学习“PHP免费学习笔记（深入）”；
- 检查 CLI 的
php --ini输出路径，确认该php.ini里也启用了memcached扩展，并设置了session.save_handler - CLI 默认不启动 session，
session_start()前要确保session_id()已存在或手动设一个，否则会生成新 ID，跟 Web 端完全无关 - FPM 子进程复用可能导致 session handler 缓存残留，极少数情况下需重启 FPM；但多数时候是配置没同步到 CLI，别急着重启服务
- 如果用
opcache.enable_cli=1，注意 opcache 不缓存 CLI 的 session 配置变更，改完php.ini后 CLI 必须重启 PHP 进程才生效
