Laravel 阿里云OSS图片上传
OSS对象存储 ( Object Storage Service, 简称 OSS ) ， 它是阿里云对外提供的海量、安全和高可靠的云存储服务。大家可以把自己网站的资源存上面加快自己网站速度。
本文使用johnlui/aliyun-oss这个组件，用法简单易懂，但是还是有部分地方需要注意。
安装
composer require "johnlui/aliyun-oss"
配置
组件下载完成之后, 在 app/config 下面新建一个 oss.php 文件然后在添加配置:
return [
/**
* 经典网络 or VPC
*/
'networkType' => env('OSS_NET_WORK_TYPE','经典网络'),
/**
* 城市名称：
* 经典网络下可选：杭州、上海、青岛、北京、张家口、深圳、香港、硅谷、弗吉尼亚、新加坡、悉尼、日本、法兰克福、迪拜
* VPC 网络下可选：杭州、上海、青岛、北京、张家口、深圳、硅谷、弗吉尼亚、新加坡、悉尼、日本、法兰克福、迪拜
*/
'city' => env('OSS_CITY','深圳'),
'AccessKeyId' => env('OSS_ACCESS_KEY_ID',''),
'AccessKeySecret' => env('OSS_ACCESS_KEY_SECRET',''),
'bucketName' => env('OSS_BUCKET_NAME'),
'ossDomain' => env('OSS_DOMAIN'),//OSS绑定域名
];
然后在 .env 文件里面把配置信息都填上。
构建 Service 文件
<?php
namespace App\Library\Oss;
use JohnLui\AliyunOSS;
use Exception;
use DateTime;
class OSS
{
private $ossClient;
/**
* 私有初始化 API，非 API，不用关注
* @param boolean 是否使用内网
*/
public function __construct($isInternal = false)
{
if (config('oss.networkType') == 'VPC' && !$isInternal) {
throw new Exception("VPC 网络下不提供外网上传、下载等功能");
}
$this->ossClient = AliyunOSS::boot(
config('oss.city'),
config('oss.networkType'),
$isInternal,
config('oss.AccessKeyId'),
config('oss.AccessKeySecret')
);
}
/**
* 使用外网上传文件
* @param string bucket名称
* @param string 上传之后的 OSS object 名称
* @param string 上传文件路径
* @return boolean 上传是否成功
*/
public static function publicUpload($bucketName, $ossKey, $filePath, $options = [])
{
$oss = new OSS();
$oss->ossClient->setBucket($bucketName);
return $oss->ossClient->uploadFile($ossKey, $filePath, $options);
}
/**
* 使用阿里云内网上传文件
* @param string bucket名称
* @param string 上传之后的 OSS object 名称
* @param string 上传文件路径
* @return boolean 上传是否成功
*/
public static function privateUpload($bucketName, $ossKey, $filePath, $options = [])
{
$oss = new OSS(true);
$oss->ossClient->setBucket($bucketName);
return $oss->ossClient->uploadFile($ossKey, $filePath, $options);
}
/**
* 使用外网直接上传变量内容
* @param string bucket名称
* @param string 上传之后的 OSS object 名称
* @param string 上传的变量
* @return boolean 上传是否成功
*/
public static function publicUploadContent($bucketName, $ossKey, $content, $options = [])
{
$oss = new OSS();
$oss->ossClient->setBucket($bucketName);
return $oss->ossClient->uploadContent($ossKey, $content, $options);
}
/**
* 使用阿里云内网直接上传变量内容
* @param string bucket名称
* @param string 上传之后的 OSS object 名称
* @param string 上传的变量
* @return boolean 上传是否成功
*/
public static function privateUploadContent($bucketName, $ossKey, $content, $options = [])
{
$oss = new OSS(true);
$oss->ossClient->setBucket($bucketName);
return $oss->ossClient->uploadContent($ossKey, $content, $options);
}
/**
* 使用外网删除文件
* @param string bucket名称
* @param string 目标 OSS object 名称
* @return boolean 删除是否成功
*/
public static function publicDeleteObject($bucketName, $ossKey)
{
$oss = new OSS();
$oss->ossClient->setBucket($bucketName);
return $oss->ossClient->deleteObject($bucketName, $ossKey);
}
/**
* 使用阿里云内网删除文件
* @param string bucket名称
* @param string 目标 OSS object 名称
* @return boolean 删除是否成功
*/
public static function privateDeleteObject($bucketName, $ossKey)
{
$oss = new OSS(true);
$oss->ossClient->setBucket($bucketName);
return $oss->ossClient->deleteObject($bucketName, $ossKey);
}
/**
* -------------------------------------------------
*
*
* 下面不再分公网内网出 API，也不注释了，大家自行体会吧。。。
*
*
* -------------------------------------------------
*/
public function copyObject($sourceBuckt, $sourceKey, $destBucket, $destKey)
{
$oss = new OSS();
return $oss->ossClient->copyObject($sourceBuckt, $sourceKey, $destBucket, $destKey);
}
public function moveObject($sourceBuckt, $sourceKey, $destBucket, $destKey)
{
$oss = new OSS();
return $oss->ossClient->moveObject($sourceBuckt, $sourceKey, $destBucket, $destKey);
}
// 获取公开文件的 URL
public static function getPublicObjectURL($bucketName, $ossKey)
{
if(config('oss.ossDomain')){
return config('oss.ossDomain').'/'.$ossKey;
}
$oss = new OSS();
$oss->ossClient->setBucket($bucketName);
return $oss->ossClient->getPublicUrl($ossKey);
}
// 获取私有文件的URL，并设定过期时间，如 \DateTime('+1 day')
public static function getPrivateObjectURLWithExpireTime($bucketName, $ossKey, DateTime $expire_time)
{
$oss = new OSS();
$oss->ossClient->setBucket($bucketName);
return $oss->ossClient->getUrl($ossKey, $expire_time);
}
public static function createBucket($bucketName)
{
$oss = new OSS();
return $oss->ossClient->createBucket($bucketName);
}
public static function getAllObjectKey($bucketName)
{
$oss = new OSS();
return $oss->ossClient->getAllObjectKey($bucketName);
}
public static function getObjectMeta($bucketName, $ossKey)
{
$oss = new OSS();
return $oss->ossClient->getObjectMeta($bucketName, $ossKey);
}
}
使用
/**
* 文件上传
* @param $file
* @param string $action
* @return array
*/
public function upload($file, $action = 'avatar')
{
if ($file->isValid()) {
$content_type = mime_content_type($file->getRealPath());
$file_name = $action . '/' . time() . rand(10, 99) . '.' . $file->extension();
//头像处理
if ($action == 'avatar') {
$content = Image::make($file)->resize(200, 200)->encode()->encoded;
} else {
$content = file_get_contents($file);
}
$bucket_name = config('oss.bucketName');
OSS::publicUploadContent($bucket_name, $file_name, $content,['ContentType' => $content_type]);//设置HTTP头
//获取公开文件URL
$url = OSS::getPublicObjectURL($bucket_name, $file_name);
//获取私密文件URL
// $expire_time = Carbon::now()->addDay();
// $url = OSS::getPrivateObjectURLWithExpireTime($bucket_name, $file_name,$expire_time);
return compact('url');
} else {
throw new ApiException('文件上传失败', 500);
}
}
以上采用变量内容content上传，也可使用文件路径path进行上传：
$file_path = $file->getRealPath();
Oss::publicUpload($bucket_name, $file_name,$file_path,['ContentType' => $content_type]);
注意
上传的文件若想直接通过URL地址访问，在浏览器预览，需在上传时设置HTTP头：
刚开始我也未修改HTTP头，上传图片后访问链接后，变成图片下载，后来设置HTTP头为：
'Content-Type' => $content_type
试了好久还是不行，后来发现设置如下，就可以了，真是坑啊！！！
'ContentType' => $content_type
其中，文件类型为：
$content_type = mime_content_type($file->getRealPath());
PS
组件github地址：https://github.com/johnlui/AliyunOSS
原作者博客地址：https://lvwenhan.com/laravel/425.html
