docker-compose部署Symfony后修改PHP文件已同步但浏览器不生效怎么办

已确认容器内文件已同步宿主机改动，可排除目录挂载配置问题，以下为高概率触发原因及对应解决方法：

1. PHP OPcache 缓存未更新 #

这是最高频的触发原因：PHP的OPcache扩展会将编译后的PHP脚本缓存到内存中，生产环境默认配置不会实时检查文件修改，导致代码改动不生效。

• 检查php.ini中OPcache相关配置，开发环境建议调整为：

  opcache.enable=1
  ; 开启文件修改时间校验，关闭的话OPcache永远不会读取更新后的文件
  opcache.validate_timestamps=1
  ; 校验间隔，单位秒，开发环境设为1即可实时生效
  opcache.revalidate_freq=1
  opcache.save_comments=1
  opcache.max_accelerated_files=100000
  

• 生产环境如果不希望开启validate_timestamps影响性能，每次代码更新后执行docker-compose restart php-fpm重启PHP服务即可加载新代码。

2. Symfony 应用缓存未更新 #

Symfony默认会将容器、路由、配置、注解等内容缓存到项目var/cache/目录下，不同运行环境缓存相互独立：

• 若运行在prod生产环境，Symfony不会自动检测代码变动，必须手动清理缓存：
  进入php-fpm容器执行：php bin/console cache:clear --env=prod
• 若运行在dev开发环境，自动缓存更新失效时可手动清理：
  执行php bin/console cache:clear --env=dev
• 检查docker-compose的挂载配置，不要将var/cache目录绑定到宿主机目录，容易因权限问题、文件同步延迟导致Symfony无法写入新缓存，建议配置为匿名卷即可。

3. 其他可能原因 #

• 检查Nginx是否配置了fastcgi_cache页面缓存，或者Symfony开启了HTTP缓存组件，开发环境建议关闭所有页面级缓存配置。
• 排除浏览器缓存问题，可使用Ctrl+Shift+R强制刷新无缓存加载，或开启浏览器开发者工具禁用缓存测试。

内容的提问来源于stack exchange，提问作者KodeFor.Me