关于 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)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年11月8日 13:56:45
下一篇 2025年11月8日 14:28:00

相关推荐

  • HTMLrev 上的免费 HTML 网站模板

    HTMLrev 是唯一的人工策划的库专门专注于免费 HTML 模板,适用于由来自世界各地慷慨的模板创建者制作的网站、登陆页面、投资组合、博客、电子商务和管理仪表板世界。 这个人就是我自己 Devluc,我已经工作了 1 年多来构建、改进和更新这个很棒的免费资源。我自己就是一名模板制作者,所以我知道如…

    2025年12月24日
    300
  • 如何使用 Laravel 框架轻松整合微信支付与支付宝支付?

    如何通过 laravel 框架整合微信支付与支付宝支付 在 laravel 开发中,为电商网站或应用程序整合支付网关至关重要。其中,微信支付和支付宝是中国最流行的支付平台。本文将介绍如何使用 laravel 框架封装这两大支付平台。 一个简单有效的方法是使用业内认可的 easywechat lara…

    2025年12月24日
    000
  • Laravel 框架中如何无缝集成微信支付和支付宝支付?

    laravel 框架中微信支付和支付宝支付的封装 如何将微信支付和支付宝支付无缝集成到 laravel 框架中? 建议解决方案 考虑使用 easywechat 的 laravel 版本。easywechat 是一个成熟、维护良好的库,由腾讯官方人员开发,专为处理微信相关功能而设计。其 laravel…

    2025年12月24日
    500
  • 如何在 Laravel 框架中轻松集成微信支付和支付宝支付?

    如何用 laravel 框架集成微信支付和支付宝支付 问题:如何在 laravel 框架中集成微信支付和支付宝支付? 回答: 建议使用 easywechat 的 laravel 版,easywechat 是一个由腾讯工程师开发的高质量微信开放平台 sdk,已被广泛地应用于许多 laravel 项目中…

    2025年12月24日
    000
  • 使用Laravel框架如何整合微信支付和支付宝支付?

    使用 Laravel 框架整合微信支付和支付宝支付 在使用 Laravel 框架开发项目时,整合支付网关是常见的需求。对于微信支付和支付宝支付,推荐采用以下方法: 使用第三方库:EasyWeChat 的 Laravel 版本 建议直接使用现有的 EasyWeChat 的 Laravel 版本。该库由…

    2025年12月24日
    000
  • 如何将微信支付和支付宝支付无缝集成到 Laravel 框架中?

    如何简洁集成微信和支付宝支付到 Laravel 问题: 如何将微信支付和支付宝支付无缝集成到 Laravel 框架中? 答案: 强烈推荐使用流行的 Laravel 包 EasyWeChat,它由腾讯开发者维护。多年来,它一直保持更新,提供了一个稳定可靠的解决方案。 集成步骤: 安装 Laravel …

    2025年12月24日
    100
  • Web页面中动态内容与页脚重叠的解决方案

    本教程旨在解决使用php `include`功能构建bootstrap网站时,页脚内容与主体内容重叠的问题。核心在于纠正html结构中的多余 “ 和 ` ` 标签,确保每个页面只包含一个完整的html文档结构,并将javascript脚本正确放置在 “ 结束标签之前,从而实现…

    2025年12月23日
    000
  • Laravel Blade模板中DIV元素样式定制指南:字体、间距与最佳实践

    本教程详细介绍了如何在laravel blade模板中为div元素应用自定义字体、调整大小和设置间距。我们将探讨常见的错误、正确的内联样式方法,并强调使用css类的最佳实践,同时指导如何正确集成自定义字体,以实现清晰、可维护的样式控制。 引言:理解Blade模板中的样式需求 在构建Web应用时,我们…

    2025年12月23日
    200
  • 如何正确构建HTML结构以确保Bootstrap页脚自动下沉

    本教程旨在解决使用php `include` 和 bootstrap 5 时页脚与内容重叠的问题。核心在于纠正不正确的html结构,避免重复的“和` `标签,合理放置css和javascript引用,并移除可能导致布局冲突的`vh-100`类,确保页脚能根据内容动态下沉。 在Web开发中…

    2025年12月23日
    000
  • 优化Web页面布局:确保Bootstrap页脚自动适应内容高度

    当使用php `include` 动态构建页面时,不正确的html结构(如重复的 “ 和 ` ` 标签)常导致页脚与主体内容重叠。本文将指导如何通过修正html文档结构,避免冗余标签,并确保javascript脚本正确放置,从而实现页脚自动向下移动,适应动态内容高度,提升页面布局的稳定性…

    2025年12月23日
    000
  • PHP Include与Bootstrap布局:解决动态内容下的页脚重叠问题

    本文探讨了在使用php `include` 和 bootstrap 构建网页时,因不当的html结构和css应用导致的页脚重叠问题。教程将指导您如何通过规范html文档结构、正确放置脚本文件以及移除冲突的css属性,确保页脚能够随主体内容动态调整位置,实现健壮且响应式的页面布局。 问题分析:页脚重叠…

    2025年12月23日
    000
  • 怎么运行.html.tpl_运行.html.tpl文件步骤【指南】

    .html.tpl文件需通过后端模板引擎解析,不能直接运行;首先搭建PHP环境,安装Smarty等模板引擎,配置模板与编译目录,编写PHP脚本加载.tpl文件并分配数据,最后通过访问PHP文件触发渲染,浏览器查看最终HTML。 运行 `.html.tpl` 文件并不是直接像普通 HTML 文件那样在…

    2025年12月23日
    000
  • 解决PHP Include页面中页脚重叠问题的最佳实践

    本文旨在解决使用PHP `include`功能构建网页时,页脚与主体内容重叠的问题。核心在于纠正不规范的HTML结构,确保每个页面只有一个`html>`和` `标签,并合理组织导航、内容和页脚的PHP包含文件,同时优化脚本加载位置和元素间距,以实现稳固且响应式的页面布局。 理解问题根源:不规范…

    2025年12月23日
    000
  • Laravel开发:如何在编辑界面正确预选数据库中的多选标签

    本文旨在解决laravel应用中编辑界面多选(select multiple)标签无法自动预选数据库中已保存数据的问题。通过详细讲解控制器层的数据准备和视图层的条件渲染逻辑,我们将展示如何利用blade模板引擎和eloquent关系,确保用户在编辑时能直观看到并修改此前选择的标签,同时提供最佳实践,…

    2025年12月23日
    000
  • Laravel Blade 条件渲染:根据数据状态控制 HTML 元素显示

    本文将介绍在 laravel blade 模板中如何根据数据变量的值是否为空或不存在,来有条件地渲染 html 元素,例如 ` ` 标签。通过利用 blade 的 `@if` 指令结合 php 的 `empty()` 函数,开发者可以确保只有当数据有效时才显示相关内容,从而避免渲染空标签或不必要的信…

    2025年12月23日
    000
  • JavaScript按钮实现PUT/POST重定向与数据提交:模拟表单行为的教程

    本教程详细讲解如何通过JavaScript动态创建并提交隐藏表单,以实现从按钮点击触发的PUT或POST请求重定向,并携带请求体数据。这种方法无需使用`fetch` API,能够满足浏览器自动处理Cookie的需求,为需要模拟完整表单提交行为的场景提供了有效的解决方案。 引言:理解PUT/POST重…

    2025年12月23日
    000
  • PHP多语言网站:语言切换与内容翻译的最佳实践

    本教程旨在指导开发者如何在php项目中实现健壮的多语言切换功能。文章详细介绍了基于会话(session)的语言状态管理、通过url参数进行语言切换的方法,并提出了一套功能完善的辅助函数来加载和安全地检索翻译内容,从而有效避免常见的“未定义变量”或“非法字符串偏移”错误。通过结构化的代码示例和最佳实践…

    2025年12月23日
    000
  • 优化长HTML属性值:SonarQube警告与实用策略

    本文探讨html表单`action`属性过长导致sonarqube警告的问题,并提供三种解决方案:优化url结构、通过变量预构建url,以及灵活评估代码规范。重点推荐使用变量预构建url,以提升代码可读性和维护性,同时兼顾静态分析工具的建议与实际开发需求。 引言:处理HTML长属性值的挑战 在现代W…

    2025年12月23日
    000
  • 使用JavaScript从按钮触发GET重定向或模拟POST/PUT提交的教程

    本教程详细介绍了如何通过JavaScript从按钮触发客户端重定向,以实现类似表单提交的效果,同时确保浏览器Cookie的正常处理。文章涵盖了两种主要方法:一是使用location.href进行带查询参数的GET重定向,适用于简单的导航或GET请求触发的动作;二是通过动态创建和提交隐藏表单来模拟PO…

    2025年12月23日
    000
  • Mac Valet一键站点,HTML+CSS开发环境王者!

    首先确认Valet服务已安装并运行,通过valet install和valet start初始化;使用valet park将项目目录设为可自动访问的本地根目录,新增项目即享.test域名;对独立项目可用valet link绑定自定义.test域名;为优化静态文件支持,在项目根目录创建.valet/s…

    2025年12月23日
    000

发表回复

登录后才能评论
关注微信