直接 rsync 规则文件会失效，因 PHPWAF 规则需重载才能生效，且受路径硬编码、权限、open_basedir 限制、APCu 缓存及服务器环境差异影响。
为什么直接 rsync 规则文件会失效
PHPWAF（如 mod_security + PHP 脚本版或自研轻量 WAF）的规则通常不是静态生效的，require_once 或 include 加载后会编译进内存，重启 Web 服务前改了文件也不起作用。更常见的是规则路径被硬编码在 phpwaf.php 或配置中，同步到新服务器但路径不一致、权限不对、或未触发 reload，结果看似同步成功，实际请求完全不走新规则。
-
rsync -avz /etc/phpwaf/rules/ user@server2:/etc/phpwaf/rules/只复制文件，不重载逻辑 - 不同服务器的
open_basedir、disable_functions可能禁用file_get_contents或scandir，导致规则目录读取失败 - 部分 PHPWAF 实现依赖
apcu_fetch('phpwaf_rules')缓存，跨服务器无法共享，必须手动清 APCu 或触发规则热加载
用 git + hook 实现自动同步与 reload
把规则目录作为独立 git 仓库管理，所有服务器 clone 同一远程 repo，并通过 post-receive hook 自动拉取 + 重载。这是最可控、可追溯的方式，避免手工误操作。
- 在 Git 服务器建裸库：
git init --bare /var/git/phpwaf-rules.git - 每台 Web 服务器执行：
git clone /var/git/phpwaf-rules.git /etc/phpwaf/rules，并确保 Web 用户（如www-data）有读权限 - 在每台服务器写 reload 脚本
/etc/phpwaf/reload.sh，内容为：#!/bin/sh cd /etc/phpwaf/rules && git pull origin main # 根据你的 WAF 实现选择重载方式： # 如果是 Apache + mod_php：killall -USR2 php-fpm 或 systemctl reload php7.4-fpm # 如果是 Swoole HTTP Server：kill -USR1 $(cat /var/run/phpwaf.pid)
- 给脚本加执行权限：
chmod +x /etc/phpwaf/reload.sh，并在 git hook 中调用它（或用 cron 每分钟git pull && /etc/phpwaf/reload.sh）
用 Redis 做规则中心化存储（适合动态更新场景）
当规则需秒级生效、且服务器数量多于 3 台时，文件同步模型延迟高、易冲突。改用 Redis 存储规则 JSON，PHPWAF 启动时或每个请求前（加缓存）GET phpwaf:rules，比对本地版本号决定是否重载。
- 规则推送到 Redis：
redis-cli SET phpwaf:rules "$(cat rules.json | jq -c .)"，同时SET phpwaf:rules:version "20240520-1" - PHPWAF 中增加检查逻辑：
$remote_ver = $redis->get('phpwaf:rules:version');对比$_SERVER['PHPWAF_RULES_VERSION']，不一致则$rules = json_decode($redis->get('phpwaf:rules'), true) - 注意 Redis 连接超时和 failover：建议用
predis/predis并配置retry_interval，避免 Redis 挂了导致整个 WAF 不可用 - 不要在每次请求都
GET—— 用apcu_store('phpwaf_rules', $rules, 60)缓存 1 分钟，降低 Redis 压力
同步后必须验证的三件事
规则文件落盘 ≠ 规则生效。跳过验证等于没同步。
立即学习“PHP免费学习笔记（深入）”；
- 确认 PHPWAF 实际加载的规则路径：
grep -r 'include.*rules' /var/www/html/ | grep phpwaf，防止代码里写死/opt/waf/rules却同步到了/etc/phpwaf/rules - 模拟攻击请求并查日志：
curl -v "https://test.com/?id=1%20UNION%20SELECT" 2>&1 | grep -i "waf\|blocked"，同时看/var/log/phpwaf/access.log是否记录匹配动作 - 检查 PHP 错误日志：
tail -f /var/log/php_errors.log，常见报错如include(): Failed opening '/etc/phpwaf/rules/sql_inj.php'（路径错）、Undefined index: REQUEST_URI（规则里用了未定义的超全局变量）
规则同步最脆弱的环节不在传输，而在“加载上下文”——同一份规则，在不同 PHP 版本、SAPI 模式（cli/fpm/cgi）、扩展启用状态（json、mbstring）下可能解析失败或行为偏移。上线前务必在目标环境做最小规则集 smoke test。
