Laravel本地文件上传教程：解决图片上传难题与最佳实践

// 错误的示例：尝试使用 input() 获取文件
if ($request->input('image') != null) {
    $files = $request->input('image'); // 此时 $files 为 null
    $extension = $files->getClientOriginalExtension(); // 报错：在 null 上调用方法
    // ...
}

<form action="{{ route('register.post') }}" method="POST" enctype="multipart/form-data">
    @csrf
    <div class="form-group row">
        <label for="image" class="col-md-4 col-form-label text-md-right">Profile Picture</label>
        <div class="col-md-6">
            <input id="image" type="file" class="form-control" name="image">
        </div>
    </div>
    <!-- 其他表单字段 -->
    <button type="submit">Upload</button>
</form>

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Storage; // 虽然这里主要用move，但引入Storage是好习惯

class ImageUploadController extends Controller
{
    public function uploadImage(Request $request)
    {
        // 1. 验证文件是否存在
        if (!$request->hasFile('image')) {
            return back()->withErrors(['image' => '请选择要上传的图片文件。']);
        }

        // 2. 获取上传的文件实例
        $file = $request->file('image');

        // 3. 生成唯一文件名
        $extension = $file->getClientOriginalExtension(); // 获取文件原始扩展名
        $filename = time() . '.' . $extension; // 使用时间戳和扩展名生成唯一文件名

        // 4. 定义目标目录 (例如: public/uploads/images)
        // public_path() 辅助函数返回项目 public 目录的绝对路径
        $destinationPath = public_path('uploads/images');

        // 5. 将文件移动到指定目录
        $file->move($destinationPath, $filename);

        // 6. 将文件名保存到数据库 (假设您有一个 Post 模型)
        // $post = Post::find($postId);
        // $post->image = 'uploads/images/' . $filename; // 存储相对路径
        // $post->save();

        return back()->with('success', '图片上传成功！');
    }
}

php artisan storage:link

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Storage;

class ImageUploadController extends Controller
{
    public function uploadImage(Request $request)
    {
        // 1. 验证文件是否存在
        if (!$request->hasFile('image')) {
            return back()->withErrors(['image' => '请选择要上传的图片文件。']);
        }

        // 2. 获取上传的文件实例
        $file = $request->file('image');

        // 3. 生成唯一文件名
        $extension = $file->getClientOriginalExtension();
        $filename = time() . '.' . $extension;

        // 4. 使用 storeAs() 方法存储文件
        // 第一个参数是目标目录（相对于 storage/app/），第二个参数是文件名
        // 'public/images' 意味着文件将存储在 storage/app/public/images 目录下
        $path = $file->storeAs('public/images', $filename);

        // $path 会返回存储的相对路径，例如 'public/images/1678888888.jpg'

        // 5. 将文件路径保存到数据库 (假设您有一个 Post 模型)
        // $post = Post::find($postId);
        // $post->image = $path; // 直接存储返回的路径
        // $post->save();

        return back()->with('success', '图片上传成功！');
    }
}

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use App\Models\Post; // 假设您有一个 Post 模型
use Illuminate\Support\Facades\Storage;

class PostController extends Controller
{
    /**
     * 处理帖子创建或更新请求，包括图片上传。
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  int|null  $postId  如果存在，表示更新现有帖子
     * @return \Illuminate\Http\Response
     */
    public function update(Request $request, $postId = null)
    {
        // 1. 数据验证
        $request->validate([
            'username' => 'required|string|max:255',
            'image' => 'nullable|image|mimes:jpeg,png,jpg,gif,svg|max:2048', // 允许图片为空，但如果存在则验证其类型和大小
        ]);

        // 2. 获取或创建 Post 实例
        $post = $postId ? Post::findOrFail($postId) : new Post();
        $post->username = $request->input('username');

        // 3. 处理图片上传
        if ($request->hasFile('image')) {
            $file = $request->file('image');

            // 生成唯一文件名
            $extension = $file->getClientOriginalExtension();
            $filename = time() . '.' . $extension;

            // 存储到 storage/app/public/images 目录 (推荐方式)
            $path = $file->storeAs('public/images', $filename);

            // 如果存在旧图片，可以考虑删除
            if ($post->image && Storage::exists($post->image)) {
                Storage::delete($post->image);
            }

            // 保存新图片的路径到数据库
            $post->image = $path;
        }

        // 4. 保存帖子数据
        $post->save();

        return redirect()->route('posts.index')->with('success', '帖子已成功保存！');
    }
}