symfony 7.4 生产环境创建符号链接需确保权限允许、路径动态安全、目标在项目公开范围内且部署时显式重建，否则易致500错误或安全风险。
在 Symfony 7.4 生产环境中使用 Filesystem 组件创建符号链接（symlink），需特别注意权限、路径安全与部署一致性，否则容易引发 500 错误、文件不可访问或 CI/CD 失败。
确保 Web 服务器用户有 symlink 创建权限
Linux 系统默认允许创建符号链接，但部分生产环境（如某些容器镜像、加固的 CentOS/RHEL）会禁用 follow_symlinks 或限制 symlink() 系统调用。验证方式：
- 在目标服务器执行：
php -r "symlink('/tmp/test-src', '/tmp/test-link') && echo 'OK'; unlink('/tmp/test-link');" - 若报错
Operation not permitted，需检查：
– SELinux 是否启用（getenforce，临时设为 permissive 测试）
– 容器是否以--cap-add=SYS_ADMIN启动（Docker/K8s 场景）
– 文件系统挂载参数是否含noexec或nosymfollow
避免绝对路径硬编码，统一用项目根目录相对定位
符号链接的目标路径若写死绝对路径（如 /var/www/releases/20261009/public/uploads），会导致部署切换后链接失效。正确做法是：
Kadence Theme Design System
下载
使用 Kadence 主题作为 WordPress 项目的设计系统，涵盖设计令牌、布局系统、页头/页脚/导航设置以及页面/归档/单篇文章模板。
- 使用
$kernel->getProjectDir()或%kernel.project_dir%动态拼接路径 - 示例（在命令或服务中）：
$fs->symlink($projectDir.'/public/uploads', $projectDir.'/public/media'); - 确保源路径存在且可读，目标路径父目录（如
public/）已存在且 Web 用户有写权限
禁止在 public/ 下创建指向敏感目录的符号链接
符号链接若意外暴露 var/、config/ 或 vendor/，可能造成配置泄露或远程代码执行风险。必须遵守：
- 仅允许链接到明确公开的资源目录（如
public/uploads、public/assets） - 禁止跨项目根目录跳转（如
../../config）——Filesystem::symlink()不做路径规范化校验，需自行防护 - 建议在创建前用
realpath()+str_starts_with()校验目标路径是否在项目安全范围内
CI/CD 部署时需重建符号链接
多数部署流程（如 Capistrano、Deployer、自定义 rsync）不会自动同步符号链接，或会将链接当作普通文件复制导致损坏。应：
- 在部署脚本末尾显式运行创建链接的命令（如 Symfony 命令或 shell 脚本）
- 避免在
cache:warmup或assets:install中隐式依赖未就绪的 symlink - 上线前加健康检查：请求
/media/test.jpg（假设链接指向 media）确认 HTTP 200
