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

发布流程的三个动作

  1. 先备份:数据库和代码目录,出问题能回滚;
  2. 再发布:建议用软链接切换版本目录,避免文件在替换过程中被读到半截;
  3. 后重载:清 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 版本与服务器配置调整;涉及生产环境的变更,建议先备份并在测试环境验证。