ThinkPHP 5.1 分布式部署需确保配置强一致：用 Ansible 或 rsync 同步 config/（排除 runtime/ 和 uploads/），敏感项抽离至 .env 并通过 env() 注入，Session/DB 等配置须去节点化、指向统一中间件或 DNS VIP，上线前验证配置生效与 Session 跨节点一致性。
ThinkPHP 5.1 分布式部署时，统一配置文件的核心目标是确保所有应用节点行为一致、避免因配置差异引发 Session 失效、数据库连接错乱或缓存不一致等问题。关键不在于“集中存储配置”，而在于“部署时强一致性同步”与“运行时环境解耦”。
用 Ansible 或 Rsync 实现配置批量分发
多台服务器上手动改 config/database.php 或 config/session.php 极易出错。推荐自动化工具：
-
Ansible：适合中大型集群，通过 inventory 定义节点组，playbook 统一推送配置文件，并可校验权限（如
owner: www-data）、检查路径是否存在 -
Rsync + SSH：轻量级方案，例如：
rsync -avz --delete ./config/ user@192.168.1.2:/var/www/html/config/
配合 shell 脚本循环多台服务器，适合小规模或 CI/CD 流水线中调用 - 注意：不要覆盖 runtime/ 目录下的缓存或日志文件，同步时应排除
runtime/和public/uploads/等动态目录
把敏感配置抽离到环境变量
数据库密码、Redis 地址、Memcached 列表等易变项，不应硬编码在 config/*.php 中。可通过 .env 文件 + topthink/think-env 扩展实现运行时注入：
- 在项目根目录放
.env（不提交 Git），内容如：DATABASE_HOST=10.0.1.10<br>DATABASE_PASSWORD=abc123<br>MEMCACHED_SERVERS=[{"host":"10.0.1.5","port":11211}] - 修改
config/database.php中的'hostname' => env('DATABASE_HOST', '127.0.0.1')
同理处理 session 配置中的服务器列表（需用json_decode(env('MEMCACHED_SERVERS'), true)解析） - 各服务器只需维护各自独立的
.env，代码层配置保持完全一致
配置文件本身要“去节点化”
避免写死本地路径或 IP，让配置天然适配分布式环境：
立即学习“PHP免费学习笔记（深入）”；
- 数据库配置：所有节点指向同一个主库或读写分离中间件（如 ProxySQL），而非各自连本地 MySQL
-
Session 配置：必须使用 Memcached/Redis，且
'memcached' => [['host' => 'cache-cluster', 'port' => 11211]]—— 这里的cache-cluster是内网 DNS 名或负载均衡 VIP，不是某台具体机器的 IP -
Cookie 域名：设为
'cookie_domain' => '.example.com'（带前导点），确保 www、api、admin 子域名共享 Session ID -
Runtime 路径：确保
runtime_path()返回的目录在每台机器上都存在、可写，且不跨节点共享（即不 NFS 挂载）—— 日志和模板缓存本就该本地化
上线前必做三件事
配置同步后，不能只看“文件有没有传过去”，要验证是否真正生效：
- 登录任意一台服务器，执行
php think run或访问一个输出config('session')的调试接口，确认type是'memcached'、memcached数组格式正确、cookie_domain带点 - 在浏览器开发者工具中查看响应头
Set-Cookie，确认Domain=.example.com和HttpOnly存在 - 用两台不同机器发起连续请求，检查 Session ID 是否不变、数据是否可读写（比如登录后跳转，再刷新仍保持登录态）
