- 新增阿里云OSS SDK核心类库文件 - 新增OSS插件配置文件及钩子监听 - 新增分类图标SVG资源并优化为轻量化格式 - 替换定位接口为天地图逆地理编码接口 - 新增OSS图片缩略处理工具方法
144 行
4.8 KiB
PHP
144 行
4.8 KiB
PHP
<?php
|
||
|
||
namespace app\common\library;
|
||
|
||
use OSS\Core\OssException;
|
||
use OSS\Credentials\StaticCredentialsProvider;
|
||
use OSS\OssClient;
|
||
use think\Log;
|
||
|
||
/**
|
||
* 阿里云OSS存储助手
|
||
*
|
||
* 开关口径:跟随后台「常规管理 → 插件管理 → alioss」的启用状态;
|
||
* - 插件启用且 AccessKey/Bucket/Endpoint/CDN 配置完整 → 走云存储;
|
||
* - 否则一律回落本地存储(public/uploads)。
|
||
*
|
||
* 上传策略(与 alioss 插件「服务器中转」模式一致):
|
||
* 文件先落盘本地,再推送 OSS;推送成功后附件记录 storage=alioss(url 仍存相对路径,
|
||
* 展示时拼插件配置的 CDN 域名),并根据 serverbackup 配置决定是否保留本地备份;
|
||
* 推送失败自动回落本地,不阻断业务。
|
||
*/
|
||
class OssStorage
|
||
{
|
||
/** alioss 插件名 */
|
||
const ADDON_NAME = 'alioss';
|
||
|
||
/** 附件表 storage 字段值(与 alioss 插件口径一致) */
|
||
const STORAGE_NAME = 'alioss';
|
||
|
||
/**
|
||
* 云存储开关是否开启
|
||
* 插件启用(info.ini state=1)且核心配置非空才视为开启
|
||
* @return bool
|
||
*/
|
||
public static function enabled()
|
||
{
|
||
$config = self::config();
|
||
if ($config === null) {
|
||
return false;
|
||
}
|
||
return !empty($config['accessKeyId'])
|
||
&& !empty($config['accessKeySecret'])
|
||
&& !empty($config['bucket'])
|
||
&& !empty($config['endpoint'])
|
||
&& !empty($config['cdnurl'])
|
||
&& $config['bucket'] !== 'yourbucket';
|
||
}
|
||
|
||
/**
|
||
* 读取 alioss 插件配置(插件停用或不存在时返回 null)
|
||
* @return array|null
|
||
*/
|
||
protected static function config()
|
||
{
|
||
if (!function_exists('get_addon_info') || !function_exists('get_addon_config')) {
|
||
return null;
|
||
}
|
||
$info = get_addon_info(self::ADDON_NAME);
|
||
if (!$info || empty($info['state'])) {
|
||
return null;
|
||
}
|
||
$config = get_addon_config(self::ADDON_NAME);
|
||
return $config ?: null;
|
||
}
|
||
|
||
/**
|
||
* 构造 OssClient(签名V4,与 alioss 插件口径一致)
|
||
* @return OssClient
|
||
* @throws OssException
|
||
*/
|
||
protected static function client()
|
||
{
|
||
$config = self::config();
|
||
return new OssClient([
|
||
'accessKeyId' => $config['accessKeyId'],
|
||
'endpoint' => $config['endpoint'],
|
||
'bucket' => $config['bucket'],
|
||
'region' => str_replace('-internal', '', substr(explode('.', $config['endpoint'])[0], 4)),
|
||
'provider' => new StaticCredentialsProvider($config['accessKeyId'], $config['accessKeySecret']),
|
||
'signatureVersion' => OssClient::OSS_SIGNATURE_VERSION_V4,
|
||
]);
|
||
}
|
||
|
||
/**
|
||
* CDN 域名(带协议,末尾无斜杠),形如 https://bucket.oss-cn-xxx.aliyuncs.com
|
||
* @return string
|
||
*/
|
||
public static function cdnUrl()
|
||
{
|
||
$config = self::config();
|
||
return rtrim((string)($config['cdnurl'] ?? ''), '/');
|
||
}
|
||
|
||
/**
|
||
* 将已落盘的本地文件推送到 OSS
|
||
* 对象键 = 去掉首斜杠的相对路径(/uploads/xxx → uploads/xxx),与附件表 url 口径一致
|
||
* @param string $filePath 本地绝对路径
|
||
* @param string $relativeUrl 相对URL(形如 /uploads/20261119/xxx.jpg)
|
||
* @return bool 是否成功(失败写日志并返回 false,由调用方回落本地)
|
||
*/
|
||
public static function push($filePath, $relativeUrl)
|
||
{
|
||
if (!is_file($filePath)) {
|
||
Log::write('[OssStorage] 推送OSS失败:本地文件不存在 path=' . $filePath);
|
||
return false;
|
||
}
|
||
try {
|
||
$config = self::config();
|
||
self::client()->uploadFile($config['bucket'], ltrim($relativeUrl, '/'), $filePath);
|
||
return true;
|
||
} catch (\Exception $e) {
|
||
Log::write('[OssStorage] 推送OSS失败 url=' . $relativeUrl . ' err=' . $e->getMessage());
|
||
return false;
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 是否保留本地备份(对应插件配置「服务器中转模式备份」serverbackup)
|
||
* @return bool
|
||
*/
|
||
public static function keepLocalBackup()
|
||
{
|
||
$config = self::config();
|
||
return !$config || !empty($config['serverbackup']);
|
||
}
|
||
|
||
/**
|
||
* 删除 OSS 端对象(失败仅记日志,不抛异常)
|
||
* @param string $relativeUrl 相对URL(形如 /uploads/20261119/xxx.jpg)
|
||
* @return bool
|
||
*/
|
||
public static function delete($relativeUrl)
|
||
{
|
||
try {
|
||
$config = self::config();
|
||
self::client()->deleteObject($config['bucket'], ltrim($relativeUrl, '/'));
|
||
return true;
|
||
} catch (\Exception $e) {
|
||
Log::write('[OssStorage] 删除OSS对象失败 url=' . $relativeUrl . ' err=' . $e->getMessage());
|
||
return false;
|
||
}
|
||
}
|
||
}
|