OSS文件上傳與簽名
相信大家日常開發中，經常使用到雲文件的上傳與下載等功能，而國內常用的阿里雲和華為雲，laravel 自帶的Storage 預設並未進行友善支援。
剛好最近雲端遷移過程中的各種噁心，主要涉及上傳與簽章介面。特地記錄下 OSS 雲端環境文件上傳與簽署的重點代碼，以供參考。
相關套件安裝指令：
// 阿里云oss composer require aliyuncs/oss-sdk-php // 华为云obs composer require obs/esdk-obs-php
需注意套件版本，是否與 php 版本適用。
.env 設定項目：
# OSS相关配置 OSS_DRIVER=HW_OBS #华为OBS OSS_HW_ENDPOINT=https://obs.cn-east-3.myhuaweicloud.com OSS_HW_KEY=ME0AVBTNJTSJB2LH0EGI OSS_HW_SECRET=eCGffrwdx3Rt5QEmKbtEvruvGgg1mCUjMsnHfjWo OSS_HW_BUCKET=pub-obs-test-1 #阿里云 OSS_ENDPOINT=https://oss-cn-hangzhou.aliyuncs.com OSS_KEYID=LTAI4Ftno9DsfiVHADX73osa OSS_KEYSECRET=vo9KuqgaDN727eOOz1tDg77Egeg7wE OSS_BUCKET=xgimi-ipr
##程式碼：
1. 介面宣告
<?php
namespace App\Service\OSS;
interface IOSS
{
/**
* 上传
*
* @param $fullFileName
* @param $filePath
* @return mixed
*/
public function publicUpload($fullFileName, $filePath);
/**
* url验签、下载
*
* @param $fullFileName | 含前缀的完整url文件名
* @param $expires | 过期时效
* @return mixed
*/
public function getUrl($fullFileName, $expires);
/**
* 可替换url域名
*
* @param $url
* @return mixed
*/
public function replaceUrl($url);
}2 . 阿里OSS 實作
<?php
namespace App\Service\OSS;
use OSS\OssClient;
class AliOSS implements IOSS
{
private $endPoint;
private $keyId;
private $secret;
private $bucket;
private $ossClient;
private $expires = 3 * 24 * 3600;
private $aliHost = '';
private $myHost = '';
public function __construct()
{
$this->endPoint = env("OSS_ENDPOINT");
$this->keyId = env("OSS_KEYID");
$this->secret = env("OSS_KEYSECRET");
$this->bucket = env("OSS_BUCKET");
try {
$this->ossClient = new OssClient($this->keyId, $this->secret, $this->endPoint);
} catch (\Exception $e) {
}
}
/**
* 上传
*
* @param $fullFileName
* @param $filePath
* @return mixed
* @throws \Exception
*/
public function publicUpload($fullFileName, $filePath)
{
return $this->ossClient->uploadFile($this->bucket, $fullFileName, $filePath);
}
/**
* url验签、下载
*
* @param $fullFileName
* @param $expires | 过期时效
* @return mixed
* @throws \Exception
*/
public function getUrl($fullFileName, $expires)
{
$expires = $expires ? $expires : $this->expires;
$signUrl = $this->ossClient->signUrl($this->bucket, $fullFileName, $expires);
return $signUrl;
}
/**
* 替换url域名
*
* @param $url
* @return mixed
*/
public function replaceUrl($url)
{
return str_replace($this->aliHost, $this->myHost, $url);
}
}3. 華為OBS 實作
<?php
namespace App\Service\OSS;
use Obs\ObsClient;
class HuaweiOBS implements IOSS
{
private $endPoint;
private $key;
private $secret;
private $bucket;
private $obsClient;
private $expires = 3 * 24 * 3600;
private $hwHost = '';
private $myHost = '';
public function __construct()
{
$this->endPoint = env("OSS_HW_ENDPOINT");
$this->key = env("OSS_HW_KEY");
$this->secret = env("OSS_HW_SECRET");
$this->bucket = env("OSS_HW_BUCKET");
try {
$this->obsClient = new ObsClient(['key' => $this->key, 'secret' => $this->secret, 'endpoint' => $this->endPoint]);
} catch (\Exception $e) {
}
}
/**
* 上传
*
* @param $fullFileName
* @param $filePath
* @return mixed
*/
public function publicUpload($fullFileName, $filePath)
{
$res = $this->obsClient->putObject([
'Bucket' => $this->bucket,
'Key' => $fullFileName,
'SourceFile' => $filePath
]);
return $res;
}
/**
* url验签、下载
*
* @param $fullFileName
* @param $expires | 过期时效
* @return mixed
* @throws \Exception
*/
public function getUrl($fullFileName, $expires)
{
$expires = $expires ? $expires : $this->expires;
// 生成下载对象的带授权信息的URL
$res = $this->obsClient->createSignedUrl([
'Method' => 'GET',
'Bucket' => $this->bucket,
'Key' => $fullFileName,
'Expires' => $expires
]);
return $res['SignedUrl'];
}
/**
* 替换url域名
*
* @param $url
* @return mixed
*/
public function replaceUrl($url)
{
return str_replace($this->hwHost, $this->myHost, $url);
}
}Demo: 業務邏輯OSS 類別
<?php
namespace App\Service;
class UploadFile
{
/**
* 文件上传 带签名访问
*
* @param $files
* @param string $prefix
* @return array
* @throws \Exception
*/
public static function upload($files, $prefix = '')
{
if (empty($files)) {
return ['ok' => false, 'message' => '请上传文件！'];
}
if (is_array($files)) {
$pics = [];
foreach ($files as $key => $file) {
if ($file->isValid()) {
$name = $file->getClientOriginalName();
$fullName = OSS::getFullFileName($name, $prefix);
$ret = OSS::publicUpload($fullName, $file, $prefix);
if ($ret) {
$url = OSS::getUrl($fullName);
$url = OSS::replaceUrl($url);
$pics[] = ['name' => $name, 'url' => $url, 'file_name' => $fullName];
}
} else {
return ['ok' => false, 'message' => '无效文件！'];
}
}
if (count($pics) > 0) {
return ['ok' => true, 'data' => $pics];
}
} else {
$name = $files->getClientOriginalName();
$fullName = OSS::getFullFileName($name, $prefix);
$ret = OSS::publicUpload($fullName, $files, $prefix);
if ($ret) {
$url = OSS::getUrl($fullName);
$url = OSS::replaceUrl($url);
return ['ok' => true, 'data' => ['name' => $name, 'url' => $url, 'file_name' => $fullName]];
} else {
return ['ok' => false, 'message' => '无效文件！'];
}
}
}
}<?php
namespace App\Service;
use App\Service\OSS\AliOSS;
use App\Service\OSS\HuaweiOBS;
use Exception;
class OSS
{
const DEFAULT_DRIVER = 'HW_OBS';
const OSS_PREFIX = 'oss/';
public $OSSService;
/**
* 初始化 service
*/
public function __construct()
{
if (env('OSS_DRIVER') === self::DEFAULT_DRIVER) {
$this->OSSService = new HuaweiOBS();
} else {
$this->OSSService = new AliOSS();
}
}
public static function getInstance()
{
return new self();
}
/**
* 使用外网上传文件
*
* @param $fullName
* @param $filePath
* @param $prefix
* @return mixed
* @throws Exception
*/
public static function publicUpload($fullName, $filePath, $prefix)
{
return self::getInstance()->OSSService->publicUpload($fullName, $filePath);
}
/**
* 获取oss图片url
*
* @param $fullName
* @param $expires | 过期时效
* @return string
* @throws Exception
*/
public static function getUrl($fullName, $expires = '')
{
return self::getInstance()->OSSService->getUrl($fullName, $expires);
}
/**
* 替换url域名
*
* @param $url
* @return mixed
*/
public static function replaceUrl($url)
{
return self::getInstance()->OSSService->replaceUrl($url);
}
/**
* 获取完整的文件名含路径
*
* @param $fileName
* @param $prefix
* @return string
*/
public static function getFullFileName($fileName, $prefix)
{
return self::OSS_PREFIX . $prefix . self::setFileName($fileName);
}
/**
* 设置新的文件名(重命名规则)
*
* @param $fileName
* @return string
*/
public static function setFileName($fileName)
{
$nameArray = explode('.', $fileName);
$extension = $nameArray[count($nameArray) - 1];
$newName = date('Ymd') . '/' . date('YmdHis') . rand(10000, 99999) . '.' . $extension;
return $newName;
}
}有時間可以對其進行功能介面補充，豐富更多雲接口能力。
附：
composer 套件：https://packagist.org/packages/league/flysystem
composer require league/flysystem
Spring mvn 套件：https:/ /spring-file-storage.xuyanwu.cn/#/ | https://spring-file-storage.xuyanwu.cn/#/
推薦學習：《laravel影片教學》
以上是分享OSS雲環境文件上傳與簽名的重點代碼的詳細內容。更多資訊請關注PHP中文網其他相關文章！
