Laravel和Yii2的文件上传地址一共有哪些区别？-CSDN博客

本文链接：https://blog.csdn.net/qq_36777143/article/details/148124470

第一部分：文件上传地址是什么？

1. 文件上传地址就像玩具工厂的储物柜

生活中的例子：
想象一下，你在一家玩具工厂工作。每次生产出新的玩具，都需要将它们存放到指定的储物柜中。
- 储物柜的位置：每个储物柜都有一个固定的编号（比如 A1、B2），方便工人找到。
- 存放规则：不同类型的玩具可能需要存放在不同的区域（比如小汽车放在 A 区，积木放在 B 区）。
在编程里：
文件上传地址就是服务器上存储文件的路径或目录。它告诉程序把用户上传的文件存放到哪里。

第二部分：文件上传地址包含哪些部分？

1. 主要组成部分

上传路径（Upload Path）
- 文件存储的具体位置（如 public/uploads 或 storage/app/public）。
文件名（File Name）
- 上传文件的名称（可以是原始文件名或自定义名称）。
权限管理（Permissions）
- 确保文件可以被正确访问（如设置文件夹权限为 755 或 775）。
底层实现
- 使用 PHP 的文件操作函数（如 move_uploaded_file()）完成文件存储。

第三部分：背后到底做了哪些事情？

1. 核心思想

接收文件：通过表单接收用户上传的文件。
存储文件：将文件从临时目录移动到目标目录。
返回路径：生成文件的访问路径，供后续使用。
安全性：验证文件类型、大小，防止恶意文件上传。

2. 底层实现

Laravel 和 Yii2 都基于 PHP 的文件操作机制构建。
使用框架提供的工具简化文件上传和存储过程。
最终通过 HTTP 协议提供文件的访问路径。

第四部分：示例代码与详细讲解

1. 示例代码：Laravel 和 Yii2 的文件上传地址对比

场景1：Laravel 的文件上传

<?php
namespace App\Http\Controllers;

use Illuminate\Http\Request;

class ToyController extends Controller {
    public function upload(Request $request) {
        // 验证文件是否上传成功
        if ($request->hasFile('toy_image') && $request->file('toy_image')->isValid()) {
            // 获取上传的文件
            $file = $request->file('toy_image');
            
            // 定义存储路径
            $path = $file->store('uploads/toys', 'public'); // 存储到 storage/app/public/uploads/toys
            
            // 返回文件路径
            return response()->json(['message' => '文件上传成功', 'path' => $path]);
        }
        return response()->json(['error' => '文件上传失败'], 400);
    }
}

为什么要这样写？

$request->hasFile('toy_image')：检查是否有文件上传。
$file->store('uploads/toys', 'public')：将文件存储到 storage/app/public/uploads/toys 目录，并生成唯一的文件名。
response()->json()：返回文件的存储路径。

场景2：Yii2 的文件上传

<?php
namespace app\controllers;

use yii\web\Controller;
use yii\web\UploadedFile;

class ToyController extends Controller {
    public function actionUpload() {
        // 获取上传的文件
        $file = UploadedFile::getInstanceByName('toy_image');
        
        if ($file) {
            // 定义存储路径
            $path = 'uploads/toys/' . uniqid() . '.' . $file->extension; // 自定义文件名
            
            // 移动文件到目标目录
            if ($file->saveAs($path)) {
                return \Yii::$app->response->content = json_encode(['message' => '文件上传成功', 'path' => $path]);
            }
        }
        return \Yii::$app->response->content = json_encode(['error' => '文件上传失败']);
    }
}

为什么要这样写？

UploadedFile::getInstanceByName('toy_image')：获取上传的文件。
$file->saveAs($path)：将文件存储到 web/uploads/toys 目录。
json_encode()：返回文件的存储路径。

第五部分：两者的区别

1. 存储路径

Laravel：
- 默认存储路径是 storage/app/public。
- 可以通过 php artisan storage:link 创建符号链接，使文件可以通过 URL 访问。
Yii2：
- 默认存储路径是 web/uploads 或其他自定义目录。
- 文件直接存储在 Web 根目录下，便于直接访问。

2. 文件名生成

Laravel：
- 自动生成唯一文件名（如 abc123.jpg）。
- 支持自定义文件名，但需要手动处理。
Yii2：
- 需要开发者手动生成文件名（如 uniqid()）。
- 更灵活，但需要更多代码。

3. 权限管理

Laravel：
- 使用 storage 目录存储文件，更安全。
- 需要通过符号链接暴露文件。
Yii2：
- 文件直接存储在 Web 根目录下，便于访问。
- 需要注意权限设置，避免安全隐患。

第六部分：底层原理

1. Laravel 的底层原理

文件存储：
- 使用 Illuminate\Http\UploadedFile 类处理上传文件。
- 调用 move_uploaded_file() 将文件从临时目录移动到目标目录。
路径生成：
- 使用 Storage 类生成存储路径。
- 支持多种磁盘驱动（如本地存储、S3）。
符号链接：
- 使用 php artisan storage:link 创建符号链接，使文件可以通过 URL 访问。

2. Yii2 的底层原理

文件存储：
- 使用 yii\web\UploadedFile 类处理上传文件。
- 调用 move_uploaded_file() 将文件从临时目录移动到目标目录。
路径生成：
- 开发者需要手动拼接路径。
- 文件直接存储在 Web 根目录下。
权限管理：
- 需要确保 Web 根目录下的文件夹有正确的权限。