PHP 每次请求都要解析、编译脚本,开销不小。OPcache 把编译后的字节码存在共享内存里,能显著降低 CPU 占用。但配置不当,就会出现”改了代码没生效”这种让人抓狂的问题。
基础配置
; php.ini
opcache.enable = 1
opcache.memory_consumption = 128
opcache.interned_strings_buffer = 8
opcache.max_accelerated_files = 20000
; 生产环境:不检查文件时间,性能最好
opcache.validate_timestamps = 0
; 或者:每 60 秒检查一次(开发/测试环境建议 0 或 2)
; opcache.validate_timestamps = 1
; opcache.revalidate_freq = 60
发布流程的三个动作
- 先备份:数据库和代码目录,出问题能回滚;
- 再发布:建议用软链接切换版本目录,避免文件在替换过程中被读到半截;
- 后重载:清 OPcache、重启 PHP-FPM,确认新代码生效。
# 清理 OPcache(CLI 与 FPM 是两套缓存,必须分开处理)
# 方式一:重启 PHP-FPM
systemctl reload php-fpm-71
# 方式二:用脚本清理(需在 Web 环境执行,且要加访问限制)
# opcache_reset();
# 方式三:宝塔环境
/etc/init.d/php-fpm-71 reload
注意:CLI 下执行 opcache_reset() 清的是命令行进程的缓存,对 FPM 无效。这是很多人”清了缓存还是没生效”的原因。
软链接发布法
/www/wwwroot/site/
├── releases/
│ ├── 20261120_1030/
│ └── 20261120_1545/
└── current -> releases/20261120_1545
# 发布
ln -sfn /www/wwwroot/site/releases/20261120_1545 /www/wwwroot/site/current
# 重载
systemctl reload php-fpm-71
Nginx 的 root 指向 /www/wwwroot/site/current。切换是原子的,回滚只需把软链接指回上一个版本,几秒完成。
发布检查清单
- 语法检查:
php -l或find . -name "*.php" -exec php -l {} ;; - 依赖检查:
composer install --no-dev --optimize-autoloader; - 权限检查:文件属主与权限是否正确;
- 冒烟测试:首页、登录、核心接口各访问一次;
- 日志检查:
tail一下 error.log,确认没有新报错。
本文为 PHP 学习与排错的经验整理。示例代码以通用环境为前提,请结合自身 PHP 版本与服务器配置调整;涉及生产环境的变更,建议先备份并在测试环境验证。