关于 laravel-admin 文件上传OSS

下面由laravel教程栏目给大家介绍关于 laravel-admin 文件上传oss,希望对需要的朋友有所帮助!

关于 laravel-admin 文件上传OSS

laravel-admin 文件上传OSS

前言

因为项目需求,需要把图片上传至阿里云 OSS,我的 Api 接口和后台项目是分开的,都使用的 laravel 框架开发,Api 接入 OSS 这里就不做讨论了,这里主要说一下 laravel-admin 上传阿里 OSS 的问题。

网上的一些教程也有非常好的,但只说了使用流程,很少有说碰到的问题之类的情况,这里主要就是讲述我在 laravel-admin 接入阿里 OSS 时所遇到的一些问题,以后还有问题时,也会在这里更新。

开发环境

下面是我的 composer.json 内容(只列出本文需要):

"require": {    "php": ">=7.0.0",    "encore/laravel-admin": "^1.6",    "jacobcyl/ali-oss-storage": "^2.1",    "laravel/framework": "5.5.*",    ...}

具体流程

1、下载合适的第三方包

在 composer.json 文件中的 require 添加 “jacobcyl/ali-oss-storage”: “^2.1″;

或者直接运行 composer require jacobcyl/ali-oss-storage:^2.1 亦可。

2、添加服务提供者

在 config/app.php 文件下增加 JacobcylAliOSSAliOssServiceProvider::class,,如下图所示:

企业微信截图_15998038427442.png

3、在 config/filesystems.php 增加 OSS 配置信息

如下:

'disks' => [        'local' => [            'driver' => 'local',            'root' => storage_path('app'),        ],        'public' => [            'driver' => 'local',            'root' => storage_path('app/public'),            'url' => env('APP_URL').'/storage',            'visibility' => 'public',        ],                's3' => [            'driver' => 's3',            'key' => env('AWS_ACCESS_KEY_ID'),            'secret' => env('AWS_SECRET_ACCESS_KEY'),            'region' => env('AWS_DEFAULT_REGION'),            'bucket' => env('AWS_BUCKET'),        ],                // 这里是新增        'oss' => [            'driver' => 'oss',            'access_id' => // 这里是你的 OSS 的 accessId,            'access_key' => // 这里是你的 OSS 的 accessKey,            'bucket' => // 这里是你的 OSS 自定义的存储空间名称,            'endpoint' => 'oss-cn-hangzhou.aliyuncs.com', // 这里以杭州为例            'cdnDomain' => '', // 使用 cdn 时才需要写, https://加上 Bucket 域名            'ssl' => true, // true 使用 'https://' false 使用 'http://'. 默认 false,            'isCName' => false, // 是否使用自定义域名,true: Storage.url() 会使用自定义的 cdn 或域名生成文件 url,false: 使用外部节点生成url            'debug' => false,        ],    ],

4、在 config/filesystems.php 更改 ‘default’ 配置信息

如下:

'default' => env('FILESYSTEM_DRIVER', 'oss'),

也可以在 env 文件中定义 FILESYSTEM_DRIVER = oss 也可。

5、在 config/admin.php 修改 upload 配置

如下:

'upload' => [    // Disk in `config/filesystem.php`.    'disk' => 'oss', // 这里就是指向 disks 下面的 oss 配置    // Image and file upload path under the disk above.    'directory' => [        'image' => 'images',        'file'  => 'files',    ],],

网上的步骤一般就是到这里了,上面的流程参考:laravel-admin 文件上传 oss;

问题出现

文心智能体平台 文心智能体平台

百度推出的基于文心大模型的Agent智能体平台,已上架2000+AI智能体

文心智能体平台 0 查看详情 文心智能体平台

但是这时候问题就出现了, laravel-admin 本身为了开发者快速开发,本身就完成了一部分功能,当我们使用默认账号 admin 登录进去后,在后台的页面右上角和左上角都有默认的头像显示,这个默认头像是存放在本地 local 下的,在 vendor/encore/laravel-admin/resources/views/partials 下 header.blade.php 和 sidebar.blade.php 两个视图文件中显示,请看下图:

header.blade.php

企业微信截图_15998038579003.png

sidebar.blade.php

企业微信截图_15998038673947.png

而我们在 具体流程 的 5个步骤中已经把上传的配置改成了 oss 了,这时访问后台时,就会抛出一个异常:

企业微信截图_15998038779834.png

一开始我以为是 config/filesystems.php 的 default 还写成 local 会解决,但结果并没有。由于时间的原因,我还没有深入去研究,对于 laravel 框架文件上传的原理,我还是个新手,不过这里放上我的解决方法,如果有更好的解决方案,欢迎下方指正,谢谢!

解决

把 header.blade.php 和 sidebar.blade.php 两个视图文件中的图片的 src 改成阿里云 OSS 存放图片的路径,比如: https://xxx.oss-cn-hangzhou.aliyuncs.com/xxx/xxx/5c77a20012963.jpg ,这张图片就是你想要上传的头像图片地址。

这里只是举个例子,当然这样写还是不方便,万一以后更改,还是需要找到这两个文件手动改,很麻烦,可根据自身需求进行解耦优化,这里就不做讨论了。

重新梳理问题

之前遇到这个问题后一直没细研究,直到最近两天突然发现 laravel-admin 中的原有的管理员列表打开报错,报错信息如下(主要是这句报错信息):

企业微信截图_15998038906534.png

突然看到这个错,我心里一慌,为什么会报文件异常类没有找到,我首先想到的是不是我之前上传文件的配置有问题,但是回想一下我的程序后排除这个可能性。因为在上述配置完毕后,我已经成功把图片上传至阿里 OSS 上了,这就说明配置是成功的,那为什么还会报错呢,我就在想是不是有些细节是我没注意到的,经过测试,果然如此:

laravel-admin 在安装完成后就已经有了系统设置这些板块,包括权限管理;

数据库的迁移文件中也有了部分数据,其中 admin_users 数据表中就有一条数据;表结构如下:

CREATE TABLE `admin_users` (  `id` int(10) unsigned NOT NULL AUTO_INCREMENT,  `username` varchar(190) COLLATE utf8mb4_unicode_ci NOT NULL,  `password` varchar(60) COLLATE utf8mb4_unicode_ci NOT NULL,  `name` varchar(255) COLLATE utf8mb4_unicode_ci NOT NULL,  `avatar` varchar(255) COLLATE utf8mb4_unicode_ci DEFAULT NULL,  `remember_token` varchar(100) COLLATE utf8mb4_unicode_ci DEFAULT NULL,  `created_at` timestamp NULL DEFAULT NULL,  `updated_at` timestamp NULL DEFAULT NULL,  PRIMARY KEY (`id`),  UNIQUE KEY `admin_users_username_unique` (`username`)) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

其中头像 avatar 字段的值,也就是 URL 地址是本地的路径,因为 laravel-admin 默认文件上传的磁盘是 local,但此时我已经把上传路径改为 OSS 了,这就导致文件系统加载不到原有的这张图,从而报的文件系统异常。

更新解决

之前我把上述的 header.blade.php 和 sidebar.blade.php 两个视图文件中的图片地址改了,只是解决一时问题,其实这两个文件并没有什么问题,我把两个视图文件还原(上面有图片),其中 {{ Admin::user()->avatar }} 就是从 admin_users 表中获取头像的 URL,只要表中这个 URL 是真实正确的(也就是 OSS 上的图片路径),那就可以成功加载!

总结

其实这个问题是一个非常简单的问题,上传文件的磁盘都已经改了,原先的路径自然就失效了,肯定加载失败!从管理员列表打开报错,到解决,只花费了不到5分钟的时间,可能就是之前没有冷静梳理:我要做的是什么?得到的结果是什么?过程中会遗漏什么?

原文地址:https://segmentfault.com/a/1190000018384162?utm_source=sf-related

以上就是关于 laravel-admin 文件上传OSS的详细内容,更多请关注创想鸟其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/487375.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
USB无法被识别的解决技巧
上一篇 2025年11月8日 13:57:17
linux安装.net8.0(极简版)+ .net多版本选择切换方法
下一篇 2025年11月8日 13:57:19

相关推荐

  • laravel怎么写接口

    如何使用 Laravel 编写 API 接口在 Laravel 中编写 API 接口需要以下步骤:完成 Laravel 的安装和配置。在 routes/api.php 中注册 API 路由。在 app/Http/Controllers 中创建控制器并定义方法来处理 API 请求。使用 respons…

    2026年8月30日
    100
  • laravel有什么用

    Laravel 是一种免费开源的 PHP 框架,用于简化 Web 应用程序开发。其主要用途包括:路由和 URL 生成模板引擎Eloquent ORM认证和授权队列处理异常处理测试工具社区支持 Laravel 的用途 Laravel 是一个免费且开源的 PHP 框架,旨在使 Web 应用程序的开发变得…

    2026年8月30日
    200
  • laravel的orm是什么

    Laravel 的 ORM 是一个称为 Eloquent 的优雅接口,它使用对象来表示数据库表和数据,简化了与数据库的交互。它包括:类型安全:确保模型属性的数据类型。关系处理:轻松定义数据库表之间关系。查询构造器:构建复杂有效的查询。懒加载:按需加载数据,优化性能。事件和监听器:注册事件和监听器,实…

    2026年8月30日
    300
  • laravel适合开发什么

    Laravel 适用于开发各种 Web 应用程序,包括:企业应用程序:模块化架构和 RESTful API 支持开发复杂应用程序。电子商务:强大的 eCommerce 功能,包括购物车管理和支付网关集成。社交媒体平台:社交认证和社交媒体 API 集成,可开发社交媒体平台。API 开发:内置工具,可简…

    2026年8月30日
    000
  • laravel中间件有哪些

    Laravel 中间件分为五种类型:全局、路由、组、终止和自定。全局中间件适用于所有请求,路由中间件仅适用于特定路由,组中间件应用于一组路由,终止中间件在所有其他中间件和处理程序执行后执行,自定中间件由开发者创建并扩展 BaseMiddleware 类。 Laravel 中间件的类型 Laravel…

    2026年8月30日
    000
  • 如何解决Laravel查询序列化问题?laravie/serialize-queries助你实现高效队列处理

    在使用Laravel开发项目时,我常常需要将复杂的查询操作放入队列中执行。然而,如何将这些查询序列化,以便在队列中使用,却一直是一个挑战。最初,我尝试了多种方法,但效果都不理想,直到我发现了laravie/serialize-queries这个库。 可以通过以下地址学习composer:学习地址 l…

    用户投稿 2026年8月30日
    000
  • laravel和thinkphp哪个快

    性能比较:Laravel通常比ThinkPHP更快。原因包括:分层架构:Laravel采用分层架构,提高可维护性但可能增加开销,而ThinkPHP采用模块化架构,更轻量但可扩展性较低;缓存:Laravel提供强大的缓存机制,而ThinkPHP的缓存功能相对受限;ORM:Laravel的Eloquen…

    2026年8月30日
    100
  • laravel有哪些特性

    Laravel是一款流行的PHP框架,其主要特性有:基于RESTful的路由系统,ORM Eloquent,Blade模板引擎,事件和监听器,服务容器,中间件,队列系统,测试工具,预定义验证规则,以及广泛的社区支持。 Laravel 拥有的特性 Laravel 作为一款流行的 PHP 框架,拥有以下…

    2026年8月30日
    000
  • laravel用了哪些设计模式

    Laravel 框架采用了以下设计模式:单例模式:管理服务容器中的单例实例外观模式:简化与复杂服务的交互工厂方法模式:创建模型实例依赖注入模式:管理依赖项观察者模式:处理事件和通知策略模式:控制模型授权合成模式:组织表单构建器系统适配器模式:集成 Eloquent ORM 和不同数据库系统 Lara…

    2026年8月30日
    000
  • laravel开发过哪些网站

    Laravel 是一种用于开发各种 web 应用程序的流行 PHP 框架。使用 Laravel 开发的知名网站包括:新闻网站和博客:The New Digital、Laravel News、Vue.js Developers社交媒体平台:Laracasts、Axentria、Travelouge电子…

    2026年8月30日
    100
  • laravel中间件用来做什么

    Laravel 中间件被用于:1. 认证和授权;2. 处理 HTTP 请求和响应;3. 过滤响应;4. 记录和监控;5. 自定义应用程序行为。通过中间件,开发人员可以在路由控制器之外轻松地为应用程序添加功能和限制。 Laravel 中间件的用途 Laravel 中间件是一种在路由执行之前或之后运行的…

    2026年8月30日
    000
  • laravel中间件是什么意思

    Laravel 中间件是 HTTP 请求和响应处理中的拦截器组件,用于通过自定义逻辑扩展应用程序功能。中间件会验证请求、修改数据、执行应用程序操作、重定向请求、处理错误和异常。Laravel 提供内置中间件,如 Auth 和 Throttle,也可创建自定义中间件。可通过全局中间件或路由中间件使用中…

    2026年8月30日
    000
  • laravel框架支持的几种数据库系统

    Laravel框架支持MySQL、PostgreSQL、MariaDB、SQL Server、SQLite和Oracle Database等数据库系统。选择数据库系统取决于特定应用程序的规模、性能、特性、成本和支持需求。 Laravel 框架支持的数据库系统 Laravel 是一个 PHP Web …

    2026年8月30日
    100
  • laravel支持几种数据库

    Laravel 支持多种数据库连接,包括:MySQL、PostgreSQL、SQLite、SQL Server、MariaDB、MongoDB 和 Redis。要连接到数据库,您需要在 .env 文件中设置配置并使用 DB 外观进行连接。 Laravel 支持的数据库 Laravel 是一个 PHP…

    2026年8月30日
    100
  • 如何在Laravel中使用JSON键解决Eloquent关系问题?staudenmeir/eloquent-json-relations助你提升数据库查询效率

    最近在开发一个 laravel 项目时,我遇到一个挑战:需要在用户和角色之间建立多对多关系,但角色信息存储在用户模型的 json 字段中。传统的 eloquent 关系无法直接处理这种情况,导致我在实现关系时遇到了诸多困难。经过一番探索,我找到了 staudenmeir/eloquent-json-…

    用户投稿 2026年8月30日
    000
  • laravel有哪些版本 laravel新手版本选择方法

    在面向初学者的 Laravel 框架版本选择指南中,本文深入探討了 Laravel 的版本差異,旨在協助初學者在眾多版本之間做出明智的選擇。我們將重點介紹每個版本的關鍵特徵、比較它們的優缺點,並提供有用的建議,幫助新手根據他們的技能水準和項目需求挑選最合適的 Laravel 版本。對於初學者來說,選…

    2026年8月30日
    000
  • laravel怎么查看版本号 laravel查看版本号方法

    Laravel框架内置了多种方法来方便地查看其版本号,满足开发者的不同需求。本文将探讨这些方法,包括使用Composer命令行工具、访问.env文件或通过PHP代码获取版本信息。这些方法对于维护和管理Laravel应用程序的版本控制至关重要。 如何查看 laravel 版本号 Laravel 是一个…

    2026年8月30日
    000
  • php框架laravel使用最新方法

    Laravel 是一个基于 PHP 的流行 Web 应用程序框架,因其优雅的语法和强大的功能而广受开发人员欢迎。它的最新版本引入了许多改进和新功能,旨在提升开发体验和应用程序性能。本文将深入探讨 Laravel 的最新方法,重点介绍如何利用这些更新来构建更强大、更高效的 Web 应用程序。 lara…

    2026年8月30日
    000
  • laravel框架安装方法

    文章摘要:本文提供了详细分步说明,指导读者如何轻松安装 Laravel 框架。Laravel 是一个功能强大的 PHP 框架,它 упростил 和加快了 web 应用程序的开发过程。本教程涵盖了从系统要求到配置数据库和设置路由等各个方面的安装过程。通过遵循这些步骤,读者可以快速高效地为他们的 L…

    2026年8月30日
    000
  • Laravel如何学习 怎么免费学习Laravel

    想要学习 Laravel 框架,但苦于没有资源或经济压力?本文为你提供了免费学习 Laravel 的途径,教你如何利用网络平台、文档和社区论坛等资源,从入门到掌握,为你的 PHP 开发之旅奠定坚实基础。 如何免费学习 laravel Laravel 是一款功能强大且流行的 PHP 框架,用于构建现代…

    2026年8月30日
    000

发表回复

登录后才能评论
关注微信