Laravel项目在Godaddy服务器文件上传失败，本地运行正常

Hey，我碰到过不少Laravel项目部署到Godaddy后文件上传失效的情况，结合你给出的两种上传写法，咱们一步步来排查解决：

1. 先搞定目录权限（最常见的坑） #

Godaddy对服务器目录权限管控比较严格，你直接用public_path()写入文件，大概率是权限问题：

• 先确认public/images目录存在，如果没有，通过FTP或者Godaddy的cPanel文件管理器创建它。
• 把这个目录的权限设置为755，上传后的文件权限设为644。千万别设成777，Godaddy会直接阻止这种高权限目录的写入操作。
• 另外，Laravel的storage目录及其子目录（比如storage/app/public）也要检查权限，PHP上传临时文件有时候会用到这里。

2. 调整PHP上传配置限制 #

Godaddy默认的PHP配置可能卡了文件大小或类型：

• 登录Godaddy的cPanel，找到Select PHP Version或者PHP Options（不同主机版本入口可能略有不同）。
• 重点检查这几个参数：
  • upload_max_filesize：设置成比你要上传的文件更大的值，比如10M。
  • post_max_size：这个值必须大于upload_max_filesize，比如12M，否则会因为POST请求总大小超限失败。
  • max_execution_time：如果上传大文件，把这个值调高到60或者更高，避免上传中途超时。
• 修改后记得保存，大部分Godaddy环境会自动重启PHP生效。

3. 改用Laravel官方文件存储方案（更稳妥） #

你现在用的是直接调用move()方法操作本地路径，其实Laravel自带的Storage门面更适配服务器环境，能自动处理很多权限和路径问题：

• 先打开config/filesystems.php，确保public磁盘的配置正确：

'public' => [
    'driver' => 'local',
    'root' => public_path('images'),
    'url' => env('APP_URL').'/images',
    'visibility' => 'public',
],

• 然后改写你的上传代码，比如第一种方法可以改成：

if ($request->hasFile('avatar_file')) {
    $image = $request->file('avatar_file');
    $imageName = time().'.'.$image->getClientOriginalExtension();
    // 用Storage门面写入文件
    Storage::disk('public')->putFileAs('', $image, $imageName);
    // 后续可以用 asset("images/{$imageName}") 获取访问链接
}

这种写法比直接操作public_path()更符合Laravel的规范，也能避免很多服务器环境带来的问题。

4. 检查PHP临时目录权限 #

PHP上传文件时会先把文件放到临时目录，如果这个目录权限不对，也会导致上传失败：

• 可以在代码里临时打印sys_get_temp_dir()看看临时目录的路径，然后检查这个目录的权限是否为755。
• 如果没法修改系统临时目录的权限，也可以在php.ini里配置upload_tmp_dir指向你自己创建的目录，比如public/tmp（先创建这个目录并设置755权限）。

5. 查看错误日志找精准问题 #

如果以上方法都没解决，去看两个地方的日志：

• Laravel的错误日志：storage/logs/laravel.log，里面会记录上传过程中的具体错误，比如权限不足、文件类型不允许等。
• Godaddy服务器的错误日志：在cPanel里找到Error Logs，查看Apache或者PHP的错误记录，能帮你定位服务器层面的问题。

内容的提问来源于stack exchange，提问作者Utpal Sarma