symfony 4.4 中 filesystem::symlink() 报错分两类：一是 php 配置禁用 symlink() 函数（查 disable_functions 并重启服务），二是系统权限不足或 windows/容器限制导致操作被拒，此时应改用命令行 ln -s 手动创建或配置 symlink: false 退化为复制。

在 Symfony 4.4 中调用 Filesystem::symlink() 报错，常见于执行 php bin/console assets:install 或手动创建 storage 链接时，错误提示类似：

Call to undefined function symlink() 或 symlink(): Operation not permitted

这不是 Symfony 自身缺陷，而是底层 PHP 环境或操作系统限制导致。关键要区分“函数未定义”和“操作被拒绝”两类问题，对应不同解决路径。

检查 symlink() 是否被禁用

PHP 配置中可能通过 disable_functions 明确禁用了该函数，尤其在共享主机或安全加固环境中。

Kadence Theme Design System

使用 Kadence 主题作为 WordPress 项目的设计系统，涵盖设计令牌、布局系统、页头/页脚/导航设置以及页面/归档/单篇文章模板。

下载

• 运行 php -i | grep disable_functions 查看输出中是否含 symlink
• 若被禁用，需修改 php.ini，从 disable_functions 列表中移除 symlink，然后重启 Web 服务（如 Apache/Nginx + PHP-FPM）
• 若无权修改 php.ini（如虚拟主机），跳过此方法，改用命令行手动创建

确认当前用户有符号链接权限（Linux/macOS）

即使函数可用，系统级权限不足也会触发 Operation not permitted。

• 确保运行 PHP 进程的用户（如 www-data、nginx 或你的 CLI 用户）对目标目录有写权限
• 检查是否启用了 noexec 或 nosymfollow 挂载选项（用 mount | grep "$(pwd)" 查看）
• 某些容器或云环境（如 Docker 默认 rootless 模式、AWS ECS Fargate）默认禁止 symlink，需显式启用 cap_add: [SYS_ADMIN] 或改用 bind mount

Windows 系统下特别处理

Symfony 4.4 的 Filesystem::symlink() 在 Windows 上默认尝试调用 mklink，但需要管理员权限且 CMD/PowerShell 必须以“管理员身份运行”——而 PHP 进程通常不具备。

• 不建议在开发环境反复提权运行 PHP；推荐改用 copy 模式替代软链
• 在 config/packages/framework.yaml 中设置：
  framework:
    assets:
      strict_mode: false
    filesystem:
      # 强制退化为复制而非链接
      symlink: false
• 或在命令中加参数绕过：
  php bin/console assets:install --symlink=0

终极可靠方案：跳过 PHP，直接用 shell 创建

当上述均不可行时，手动创建是最稳定的做法，尤其适用于部署脚本或 CI/CD 流程。

• 进入项目根目录：cd /var/www/my-symfony-app
• 删除旧链接（如有）：rm -f public/bundles
• 创建新链接：ln -s ../vendor/symfony/ux-twig-component/src/Resources/public/bundles public/bundles（按实际路径调整）
• 验证：ls -l public/bundles 应显示正确指向，且 readlink public/bundles 返回目标路径