文件
fenleixinxi/application/common/library/OssStorage.php
MiAn 133d425ec0 feat: 新增阿里云OSS适配器及分类图标优化
- 新增阿里云OSS SDK核心类库文件
- 新增OSS插件配置文件及钩子监听
- 新增分类图标SVG资源并优化为轻量化格式
- 替换定位接口为天地图逆地理编码接口
- 新增OSS图片缩略处理工具方法
2026-11-20 11:11:03 +08:00

144 行
4.8 KiB
PHP

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

<?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;
}
}
}