Symfony 7.4 多环境文件路径区分核心是利用 %kernel.project_dir% 与 %kernel.environment% 动态拼接路径，在 services.yaml 中定义 app.upload_dir 等参数，配合 public/media 符号链接实现存储隔离与 Web 访问统一，日志缓存由框架自动按环境分离，运行时需校验路径安全性。
Symfony 7.4 多环境下文件存储路径区分，核心是让上传目录、缓存输出、日志归档等路径随 APP_ENV 动态变化，而不是硬编码或手动切换。关键不在于“写不同代码”，而在于利用框架已有的参数机制和环境感知能力，统一管理、安全隔离。
用 %kernel.project_dir% + 环境变量拼接路径
所有自定义文件路径（如上传目录、导出临时目录）应基于项目根目录动态构建，避免绝对路径。推荐在配置中使用参数占位符：
- 在
config/services.yaml中定义参数：parameters:<br> app.upload_dir: '%kernel.project_dir%/var/uploads/%kernel.environment%'
- 在服务或命令中注入该参数：
#[Autowire('%app.upload_dir%')] private string $uploadDir; - 这样
dev下路径为var/uploads/dev，prod下为var/uploads/prod，天然隔离且可预测
上传目录按环境分物理子目录，但 Web 可访问路径保持一致
上传的文件需被 Web 服务器直接访问（如 /media/avatar.jpg），但实际存储位置要区分环境：
- 在
public/media下不做真实文件，只作为软链接目标 - 部署脚本或命令中，根据
APP_ENV创建指向对应子目录的符号链接：ln -sf ../var/uploads/prod public/media（生产）ln -sf ../var/uploads/dev public/media（开发） - 确保
public/media始终存在且指向当前环境的数据区，前端 URL 不变，后端存储分离
日志与缓存路径由框架自动处理，无需手动配置
var/log/ 和 var/cache/ 已默认按环境分目录（var/log/prod.log、var/cache/prod/），前提是：
-
APP_ENV在.env中正确设置（如APP_ENV=prod） - 未在
config/packages/framework.yaml中覆盖logs_dir或cache_dir参数 - 运行
php bin/console cache:clear --env=prod后，var/cache/prod/内容才真正生成并生效
敏感路径校验必须在运行时执行
即使路径按环境区分，也要防止符号链接逃逸或越权访问：
- 创建上传目录前，用
realpath()+str_starts_with()检查目标是否仍在%kernel.project_dir%/var/范围内 - 在控制器中接收用户传入的文件路径时，禁止直接拼接进
file_get_contents()，先做白名单校验 - 生产环境禁用
open_basedir以外的任意路径访问，Nginx 配置中明确限制location /media/只能访问public/media目录
