PHP/Laravel上传至符号链接目录异常：未指向目标反而新建目录

我之前也踩过这个坑！Laravel环境下上传文件到符号链接目录时，PHP经常会“认死理”——把符号链接当成真实目录，直接在符号链接所在位置新建文件夹，而不是跳转到它指向的真实路径。下面是我总结的几个解决办法，亲测有效：

1. 先确认你的符号链接是正确创建的 #

首先得排查基础问题：你的符号链接是不是真的生效了？

• 如果是Laravel默认的public/storage链接，用php artisan storage:link重新生成一遍，然后在终端执行ls -l public/storage，看输出里的箭头是不是指向../storage/app/public。
• 如果是自定义的符号链接，确保用的是软链接（命令是ln -s 真实目录路径 符号链接路径），硬链接不会有跳转效果，还会导致文件系统混乱。

2. 上传时直接使用真实路径，绕开符号链接 #

这是最稳妥的办法，不要依赖符号链接的路径来写文件：

• 如果你用Laravel的Storage门面，直接用预配置的public磁盘，它默认就是指向storage/app/public的真实路径：

  // 示例：上传到public磁盘的uploads目录
  $uploadedFile->storeAs('uploads', 'user-avatar.jpg', 'public');
  

• 如果是手动处理文件移动，别用public_path('storage/uploads')这种符号链接路径，改用storage_path('app/public/uploads')直接指向真实目录：

  $uploadedFile->move(storage_path('app/public/uploads'), 'user-avatar.jpg');
  

3. 必须用符号链接？手动解析真实路径 #

如果你因为某些原因一定要用符号链接路径来操作，可以用PHP的realpath()函数先解析出它指向的真实目录，再进行上传：

// 假设你的自定义符号链接是public/my-custom-folder
$linkPath = public_path('my-custom-folder');
$realTargetPath = realpath($linkPath);

if ($realTargetPath && is_dir($realTargetPath)) {
    // 解析成功，用真实路径上传
    $uploadedFile->move($realTargetPath . '/uploads', 'document.pdf');
} else {
    // 符号链接无效，抛出错误
    abort(500, '无效的符号链接，请检查配置');
}

4. 检查目录权限，避免写入失败 #

有时候不是符号链接的问题，而是真实目录的权限不对，PHP无法写入，就会退而求其次在符号链接目录下新建文件夹：

• 确保符号链接指向的真实目录（比如storage/app/public）的权限是755，所有者设置为Web服务器的用户（比如www-data或者apache）。
• 可以用终端命令修复权限：

  chmod -R 755 storage/app/public
  chown -R www-data:www-data storage/app/public
  

核心思路就是：尽量不要让PHP直接处理符号链接的写入操作，要么用Laravel已经帮你配置好的磁盘路径，要么手动指向真实目录，这样就能避免它误创建新文件夹的问题。

内容的提问来源于stack exchange，提问作者Ahmed Maher Halima - Semicolon