Laravel中高效获取上传文件属性与操作指南

use Illuminate\Http\Request;

public function upload(Request $request)
{
    // 检查是否有文件上传
    if ($request->hasFile('file_upload')) {
        $uploadedFile = $request->file('file_upload');

        // $uploadedFile 现在是一个 Illuminate\Http\UploadedFile 实例
        // 接下来可以访问它的属性和方法
    } else {
        // 没有文件上传的情况
        return back()->with('error', '请选择一个文件进行上传。');
    }
}

$originalName = $uploadedFile->getClientOriginalName(); // 例如："Skin Infections.pdf"
$extension = $uploadedFile->getClientOriginalExtension(); // 例如："pdf"

$mimeType = $uploadedFile->getMimeType(); // 例如："application/pdf"
$fileSize = $uploadedFile->getSize(); // 例如：53388 (字节)

$tempPath = $uploadedFile->getPathname(); // 例如："C:\xampp_php8\tmp\phpDC93.tmp"
$hashedName = $uploadedFile->hashName(); // 例如："abcdef1234567890.pdf" (如果原始文件是pdf)

// 存储到 storage/app/uploads 目录，使用哈希名称
$path = $uploadedFile->store('uploads'); 
// $path 会是 "uploads/hashed_name.ext"

// 存储到 storage/app/avatars 目录，指定文件名
$fileName = time() . '_' . $uploadedFile->getClientOriginalName();
$path = $uploadedFile->storeAs('avatars', $fileName);
// $path 会是 "avatars/timestamp_original_name.ext"

// 存储到配置的 'public' 磁盘 (例如：storage/app/public)，并生成公共可访问的URL
$path = $uploadedFile->store('images', 'public');
// 获取公共可访问的URL
$url = Storage::url($path);

<?php

namespace App\Http\Controllers;

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

class FileUploadController extends Controller
{
    /**
     * 处理文件上传请求。
     *
     * @param  \Illuminate\Http\Request  $request
     * @return \Illuminate\Http\Response
     */
    public function processUpload(Request $request)
    {
        // 1. 文件验证 (重要步骤，确保文件类型和大小符合要求)
        $request->validate([
            'file_upload' => 'required|file|mimes:pdf,jpg,png|max:2048', // 示例：必选、文件、PDF/JPG/PNG、最大2MB
            'name' => 'required|string|max:255',
            'email' => 'required|email',
        ]);

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

        // 3. 获取文件属性
        $originalName = $uploadedFile->getClientOriginalName();
        $extension = $uploadedFile->getClientOriginalExtension();
        $mimeType = $uploadedFile->getMimeType();
        $fileSize = $uploadedFile->getSize(); // 字节

        // 4. 生成唯一的存储文件名 (推荐使用)
        $hashedFileName = $uploadedFile->hashName(); // 例如： "asdfasdfasdf.pdf"

        // 5. 存储文件到指定位置 (例如：'public' 磁盘下的 'documents' 目录)
        // 这会将文件移动到 storage/app/public/documents 目录下
        $filePath = $uploadedFile->store('documents', 'public'); 

        // 6. 获取文件的公共访问URL
        $fileUrl = Storage::url($filePath);

        // 7. 处理其他表单数据
        $name = $request->input('name');
        $email = $request->input('email');
        $description = $request->input('description');
        $birthYear = $request->input('birth_year');

        // 8. 可以在这里将文件信息和表单数据保存到数据库
        // 例如：
        // Document::create([
        //     'user_id' => auth()->id(),
        //     'original_name' => $originalName,
        //     'stored_path' => $filePath,
        //     'mime_type' => $mimeType,
        //     'size' => $fileSize,
        //     'url' => $fileUrl,
        //     'related_name' => $name,
        //     'related_email' => $email,
        // ]);

        return back()->with('success', "文件 {$originalName} 上传成功！存储路径：{$filePath}，公共URL：{$fileUrl}");
    }
}