ThinkPHP 5.1 分布式改造需保持业务代码零修改，仅在Session（切Redis/Memcached）、数据库读写分离、配置解耦（.env）、跨服务调用（Service封装）四层适配。
ThinkPHP 5.1 分布式改造不是推倒重来，而是让单体架构具备横向扩展能力，同时不破坏已有业务逻辑。关键在于“隔离变化、保留契约、渐进替换”——原有控制器、模型、验证器等核心业务代码基本不动，只在数据访问、会话管理、配置加载和跨节点通信层做适配。
Session 必须统一托管，但无需改登录逻辑
原有基于文件或数据库的 Session 无法跨服务器共享，必须切换为 Memcached 或 Redis 驱动：
- 确认 PHP 已启用 ext-memcached（≥3.0.0） 或 ext-redis，不能用 ext-memcache
- 修改 config/session.php：
– type 必须小写，如'memcached'或'redis'（'Memcached'会静默回退到 file）
– memcached 列表必须是纯数字索引数组：[['host' => '10.0.1.5', 'port' => 11211]]
– 显式设置'expire' => 7200、'cookie.domain' => '.yourdomain.com' - 登录、登出、
$this->request->session()等调用方式完全不变，业务层无感知
数据库读写分离可透明接入，模型代码零修改
TP5.1 原生支持多数据库连接，只需配置不改模型：
- 在 config/database.php 中定义
'connections'，例如：'read' => [...]、'write' => [...] - 给模型指定连接：
protected $connection = 'write';（仅写操作） - 读操作默认走
'read'，或显式调用：Db::connect('read')->table('user')->select(); - 事务必须显式指定连接：
Db::connect('write')->transaction(function () { ... });，避免跨库失败
配置与环境变量解耦，旧 config() 调用照常可用
分布式环境下，不同节点可能需差异化配置（如缓存前缀、API网关地址），但业务代码仍用原方式读取：
立即学习“PHP免费学习笔记（深入）”；
- 把动态配置项（如
cache.prefix、api.base_url）移入 .env 文件，而非硬编码在 config/*.php 中 - 在 config/app.php 中通过
env('CACHE_PREFIX', 'tp5')获取，再赋值给'cache' => ['prefix' => ...] - 所有
config('database.hostname')、config('app.debug')等调用保持原样，框架自动合并 .env 与 config/ 的值
跨节点调用建议封装为 Service 接口，不侵入 Controller
当需要调用其他服务（如用户中心、订单中心）时，避免在 Controller 里直接发 HTTP 请求：
- 新建 app/common/service/UserService.php，封装
getUserById($id)方法，内部用 Guzzle 或 curl 实现 - Controller 中仍调用
$this->userService->getUserById($id)，与本地模型调用风格一致 - 后续可平滑替换成 RPC（如 Swoole RPC）或消息队列，只需重写 Service 实现，Controller 不动
