Symfony 项目根目录不可直接移动，需通过符号链接、调整 autoload 映射、重定向 var 目录、更新 .env 路径等方式适配新位置。
更换 Symfony 项目根目录路径本身不被框架直接支持，因为很多路径（如 public/ 入口、var/ 运行时目录、自动加载映射）在安装时已硬编码或通过配置绑定到当前项目根。强行移动会导致类找不到、缓存失效、静态资源 404 等问题。真正可行的做法不是“移动整个项目”，而是调整关键路径的指向关系，让 Symfony 在新位置正常运行。
确保 public 目录仍为 Web 服务器 root
Web 服务器（Nginx/Apache）的 document root 必须指向 public/，不能指向项目根目录。如果你希望项目代码放在别处（比如 /opt/myapp/），而 Web 可访问路径是 /var/www/html/，那就用符号链接：
- 在
/var/www/html/下执行：ln -sf /opt/myapp/public/* . - 或更安全地只链入口文件和资源：
ln -sf /opt/myapp/public/index.php index.php，再把assets/软链过去 - Nginx 配置中保持
root /var/www/html;，不改fastcgi_param SCRIPT_FILENAME的解析逻辑
更新 composer autoload 映射（如果 src 移动了）
src 目录若随项目根一起挪动，通常无需改动；但如果你把 src/ 单独移到外部路径（例如 /shared/src/），就必须同步修改 composer.json 中的 PSR-4 映射：
- 把
"App\": "src/"改成"App\": "/shared/src/" - 运行
composer dump-autoload强制刷新自动加载规则 - 检查命名空间是否仍与文件路径一致，比如
/shared/src/Controller/HomeController.php必须声明namespace AppController;
重定向 var 缓存与日志的实际存储位置
var/ 是默认工作区，但它的子目录可被配置覆盖。你想把缓存和日志写到新路径（比如 /data/myapp/cache），就在 config/packages/framework.yaml 或环境专属配置中设置：
framework:→cache:→pool:→default_pool: filesystem，再指定directory: '/data/myapp/cache'monolog:→handlers:→main:→path: '/data/myapp/logs/dev.log'- 也可统一改内核参数：在
config/bootstrap.php或src/Kernel.php的构造函数里加$this->setProjectDir('/opt/myapp');，再覆盖getCacheDir()和getLogDir()方法
检查并更新 .env 中的绝对路径变量
有些自定义服务或第三方包会读取 .env 里的路径，比如数据库 socket、上传目录、密钥文件位置。如果你把项目挪到新磁盘或用户目录下：
- 确认
APP_ENV、APP_SECRET仍有效，它们不依赖路径 - 检查是否有类似
UPLOAD_DIR=/var/www/myapp/uploads这样的变量，按新位置更新 - 运行
php bin/console debug:container --env-vars查看哪些环境变量被实际注入容器
