前端Vue3+vant實(shí)現(xiàn)OSS上傳圖片全過(guò)程
首先,下面這些信息從阿里云服務(wù)器OSS管理中獲取
aliyun: oss: file: endpoint: "oss-cn-beijing.aliyuncs.com" keyid: "xxxxxxxxx" keysecret: "xxxxxxxxxxxx" bucketname: "xxxx"
一、安裝OSS
npm install ali-oss
二、以下步驟中解決引入ts校驗(yàn)的,有些地方比較多余,想試試也行,直接跳過(guò)吧
在 TypeScript 中,如果你遇到“無(wú)法找到模塊 'ali-oss' 的聲明文件”的錯(cuò)誤,通常是因?yàn)樵撃K沒(méi)有提供類(lèi)型定義文件
解決方法:
1.安裝類(lèi)型定義:
如果 ali-oss 沒(méi)有提供類(lèi)型定義文件,你可以嘗試安裝 @types/ali-oss,但目前可能沒(méi)有可用的類(lèi)型定義。
npm install --save-dev @types/ali-oss
pnpm add -D @types/ali-oss
如果沒(méi)有這個(gè)包,你可以手動(dòng)創(chuàng)建一個(gè)類(lèi)型定義文件。
2.手動(dòng)創(chuàng)建類(lèi)型定義:
- 在你的項(xiàng)目中創(chuàng)建一個(gè)類(lèi)型定義文件,例如 src/types/ali-oss.d.ts,并添加以下內(nèi)容:
declare module 'ali-oss' { export interface OSSClient { put(object: string, file: any, options?: any): Promise<any>; // 添加其他需要的方法和屬性 } export default function OSS(options: { region: string; accessKeyId: string; accessKeySecret: string; bucket: string; }): OSSClient; }
更新 tsconfig.json:
- 確保 TypeScript 配置文件 (tsconfig.json) 中包含了類(lèi)型定義文件的路徑:
{ "compilerOptions": { "typeRoots": [ "./node_modules/@types", "./src/types" // 添加自定義類(lèi)型位置 ] } }
3.擴(kuò)展:
使用 require:
- 如果你不想定義類(lèi)型,可以使用 require 來(lái)引入模塊,這樣 TypeScript 不會(huì)檢查類(lèi)型:
const OSS = require('ali-oss');
總結(jié):通過(guò)手動(dòng)創(chuàng)建類(lèi)型定義文件或使用 require,可以解決無(wú)法找到模塊聲明文件的問(wèn)題。
擴(kuò)展:
endpoint
- oss-cn-beijing.aliyuncs.com:
- oss:表示這是 OSS 服務(wù)。
- cn:表示中國(guó)區(qū)域。
- beijing:表示具體的地理區(qū)域,即北京。
其他區(qū)域示例
如果你有其他的 endpoint,可以根據(jù)以下格式進(jìn)行解析:
- 上海:
oss-cn-shanghai.aliyuncs.com -> region: 'cn-shanghai'
- 廣州:
oss-cn-guangzhou.aliyuncs.com -> region: 'cn-guangzhou'
- 香港:
oss-ap-hongkong.aliyuncs.com -> region: 'ap-hongkong'
確認(rèn)區(qū)域:
如果不確定,可以在阿里云控制臺(tái)中查看你的 Bucket 的具體區(qū)域,或者查閱阿里云的官方文檔,以獲取更詳細(xì)的信息。
三、配置阿里云 OSS:
// 配置阿里云 OSS // Bucket名稱(chēng),用于標(biāo)識(shí)OSS存儲(chǔ)空間 const BUCKET_NAME = 'xxxxx'; // OSS的地域節(jié)點(diǎn),用于訪問(wèn)OSS服務(wù)的域名 const ENDPOINT = 'oss-cn-beijing.aliyuncs.com'; // 創(chuàng)建OSS客戶端實(shí)例 const client = new OSS({ region: 'oss-cn-beijing', // 地域,例如:華北2(北京) accessKeyId: 'xxxxxxxxx', // 訪問(wèn)密鑰ID,用于身份驗(yàn)證 accessKeySecret: 'xxxxxxxx', // 訪問(wèn)密鑰密碼 bucket: BUCKET_NAME, // 指定操作的Bucket secure: true, // 使用HTTPS協(xié)議 cname: false, // 是否使用自定義域名,false表示使用阿里云默認(rèn)域名 });
- secure : 默認(rèn)為 false ,表示使用 HTTP 協(xié)議。不寫(xiě)的話可能會(huì)存在安全風(fēng)險(xiǎn),建議在生產(chǎn)環(huán)境中設(shè)置為 true 使用 HTTPS。
- cname : 默認(rèn)為 false ,表示使用阿里云默認(rèn)域名。如果不需要自定義域名,可以不寫(xiě)這個(gè)配置。
- timeout : 默認(rèn)為 60000 (60秒)。如果不寫(xiě),上傳超時(shí)時(shí)間就是默認(rèn)的 60 秒,對(duì)于大多數(shù)場(chǎng)景來(lái)說(shuō)已經(jīng)足夠。
Bucket 名稱(chēng):
這個(gè)一般是未公開(kāi)的,所以需要再定一一個(gè)在外面,OSS里面那個(gè)刪除即可,不需要,也無(wú)法使用
- 在對(duì)象的外面定義:
const BUCKET_NAME = 'xxxxx'; // 定義 Bucket 名稱(chēng),這里換成你自己的
2.并在需要生成文件 URL 時(shí)使用該常量,ENDPOINT同理:
// 生成文件的在線鏈接 const url = `https://${BUCKET_NAME}.${ENDPOINT}/${fileName}`;
ENDPOINT:
在生成 URL 時(shí),client.options.endpoint 是用于獲取 OSS 訪問(wèn)地址的一部分。然而,client.options 本身可能并不包含 endpoint 屬性。通常,endpoint 是在創(chuàng)建 OSS 客戶端時(shí)指定的配置選項(xiàng)之一,但它并不會(huì)直接暴露在 options 中。
可以在創(chuàng)建 OSS 客戶端時(shí)直接保存 endpoint,然后在生成 URL 時(shí)使用這個(gè)值。以下是如何實(shí)現(xiàn)的示例代碼:
const ENDPOINT = 'oss-cn-beijing.aliyuncs.com'; // 替換為實(shí)際 Endpoint
四、上傳文件總流程:
<script setup lang="ts"> import { ref } from 'vue'; import { showToast } from 'vant'; // 導(dǎo)入 Vant 的類(lèi)型 import type { UploaderFileListItem } from 'vant'; // 正確導(dǎo)入類(lèi)型 import OSS from 'ali-oss'; // 聲明 fileList,類(lèi)型為 UploaderFilelistItem[] const fileList = ref<UploaderFileListItem[]>([]); // oversize 事件處理函數(shù) const maxFileSize = 50 * 1024 * 1024; // 50MB const onOversize = (file: File) => { if (file.size > maxFileSize) { showToast(`文件大小不能超過(guò) ${maxFileSize / (1024 * 1024)}MB`); return false; } return true; }; // 配置阿里云 OSS // Bucket名稱(chēng),用于標(biāo)識(shí)OSS存儲(chǔ)空間 const BUCKET_NAME = 'xxxxx'; // 替換成實(shí)際的 // OSS的地域節(jié)點(diǎn),用于訪問(wèn)OSS服務(wù)的域名 const ENDPOINT = 'oss-cn-beijing.aliyuncs.com'; // 創(chuàng)建OSS客戶端實(shí)例 const client = new OSS({ region: 'oss-cn-beijing', // 地域,例如:華北2(北京) accessKeyId: 'xxxxxxxx', // 訪問(wèn)密鑰ID,用于身份驗(yàn)證 accessKeySecret: 'xxxxxxx', // 訪問(wèn)密鑰密碼 bucket: BUCKET_NAME, // 指定操作的Bucket secure: true, // 使用HTTPS協(xié)議 cname: false, // 是否使用自定義域名,false表示使用阿里云默認(rèn)域名 timeout: 60000 // 超時(shí)時(shí)間,單位:毫秒(這里設(shè)置為60秒) }); // - secure : 默認(rèn)為 false ,表示使用 HTTP 協(xié)議。不寫(xiě)的話可能會(huì)存在安全風(fēng)險(xiǎn),建議在生產(chǎn)環(huán)境中設(shè)置為 true 使用 HTTPS。 // - cname : 默認(rèn)為 false ,表示使用阿里云默認(rèn)域名。如果不需要自定義域名,可以不寫(xiě)這個(gè)配置。 // - timeout : 默認(rèn)為 60000 (60秒)。如果不寫(xiě),上傳超時(shí)時(shí)間就是默認(rèn)的 60 秒,對(duì)于大多數(shù)場(chǎng)景來(lái)說(shuō)已經(jīng)足夠。 // 上傳文件的函數(shù) const uploadFile = async (file: File) => { try { // 生成唯一文件名,包含文件夾路徑 // 獲取當(dāng)前日期 const timestamp = new Date(); const year = timestamp.getFullYear(); const month = String(timestamp.getMonth() + 1).padStart(2, '0'); const day = String(timestamp.getDate()).padStart(2, '0'); const randomString = Math.random().toString(36).substring(2, 8); // 指定上傳路徑 let filePath: string; // 添加變量聲明 // 判斷文件類(lèi)型 const isImage = file.type.startsWith('image/'); if (isImage) { // 添加隨機(jī)字符串 filePath = `png/${year}/${month}/${day}/${randomString}_${file.name}`; } else { filePath = `video/${year}/${month}/${day}/${randomString}_${file.name}`; } // 上傳文件到 OSS // client.put() 方法會(huì)將文件上傳到 OSS,其中: // - filePath 參數(shù)指定了文件在 OSS 中的存儲(chǔ)路徑 // - file 參數(shù)是要上傳的文件對(duì)象 const result = await client.put(filePath, file); // 生成文件的在線鏈接 const url = `https://${BUCKET_NAME}.${ENDPOINT}/${filePath}`; console.log('上傳成功:', result); console.log('文件在線鏈接:', url); return url; } catch (error) { console.error('上傳失敗:', error); return null; // 或者返回一個(gè)默認(rèn)的錯(cuò)誤鏈接 } }; const handleSubmit = async () => { fileList.value.forEach(item => { // 使用類(lèi)型斷言將 item.file 轉(zhuǎn)換為 File 類(lèi)型 const file = item.file as File; uploadFile(file) }); }; // 提交文件函數(shù) const submitFile = async () => { handleSubmit() }; </script> <template> <div> <van-uploader ref="mediaUploader" v-model="fileList" multiple class="uploader-container" accept="image/*,video/*" max-count="6" @oversize="onOversize" /> <button @click="submitFile">點(diǎn)擊上傳</button> </div> </template> <style scoped> /* 添加必要的樣式 */ </style>
上傳可能出現(xiàn)的問(wèn)題:
- 如果跨域,這個(gè)時(shí)候要去服務(wù)器配置允許訪問(wèn)的IP地址,防止出現(xiàn)跨域報(bào)錯(cuò),這個(gè)是需要去官網(wǎng)到自己的服務(wù)器去配置的
關(guān)鍵點(diǎn)總結(jié):
- 獲取服務(wù)器相關(guān)配置信息
- 安裝OSS
- 使用自帶的put方法上傳圖片
const result = await client.put(filePath, file);
- 圖片路徑就是倉(cāng)庫(kù)路徑拼接的,使用put方法上傳會(huì)自動(dòng)到那個(gè)倉(cāng)庫(kù)路徑下去存
- 服務(wù)器需要配置跨域
總結(jié)
到此這篇關(guān)于前端Vue3+vant實(shí)現(xiàn)OSS上傳圖片的文章就介紹到這了,更多相關(guān)Vue3 vant實(shí)現(xiàn)OSS上傳圖片內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
快速搭建vue2.0+boostrap項(xiàng)目的方法
這篇文章主要介紹了快速搭建vue2.0+boostrap項(xiàng)目的方法,小編覺(jué)得挺不錯(cuò)的,現(xiàn)在分享給大家,也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧2018-04-04如何利用Vue3管理系統(tǒng)實(shí)現(xiàn)動(dòng)態(tài)路由和動(dòng)態(tài)側(cè)邊菜單欄
通常我們?cè)趘ue項(xiàng)目中都是前端配置好路由的,但在一些項(xiàng)目中我們可能會(huì)遇到權(quán)限控制,這樣我們就涉及到動(dòng)態(tài)路由的設(shè)置了,下面這篇文章主要給大家介紹了關(guān)于如何利用Vue3管理系統(tǒng)實(shí)現(xiàn)動(dòng)態(tài)路由和動(dòng)態(tài)側(cè)邊菜單欄的相關(guān)資料,需要的朋友可以參考下2022-02-02詳解vue數(shù)據(jù)渲染出現(xiàn)閃爍問(wèn)題
本篇文章主要介紹了vue數(shù)據(jù)渲染出現(xiàn)閃爍問(wèn)題,小編覺(jué)得挺不錯(cuò)的,現(xiàn)在分享給大家,也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧2017-06-06html+vue實(shí)現(xiàn)分頁(yè)功能的示例代碼
這篇文章主要為大家詳細(xì)介紹了如何使用html+vue實(shí)現(xiàn)簡(jiǎn)單的分頁(yè)功能,文中的示例代碼簡(jiǎn)潔易懂,感興趣的小伙伴可以跟隨小編一起學(xué)習(xí)一下2024-04-04詳解基于element的區(qū)間選擇組件校驗(yàn)(交易金額)
這篇文章主要介紹了詳解基于element的區(qū)間選擇組件校驗(yàn)(交易金額),文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2021-01-01vue+element實(shí)現(xiàn)手機(jī)號(hào)驗(yàn)證碼注冊(cè)的示例
本文主要介紹了vue+element實(shí)現(xiàn)手機(jī)號(hào)驗(yàn)證碼注冊(cè)的示例,文中通過(guò)示例代碼介紹的非常詳細(xì),具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2022-01-01