Skip to content
页面梗概

助力生态可持续发展

赞助 Fresns 发展

成为赞助者

文件 FileHelper

App\Helpers\FileHelper

根据文件类型输出存储配置信息

php
FileHelper::fresnsFileStorageConfigByType($type);
参数名类型是否必传说明
typeNumberYES类型 ID
查看输出示例
json
{
    "service": "", // plugin unikey
    "secretId": "",
    "secretKey": "",
    "bucketName": "",
    "bucketArea": "",
    "bucketDomain": "",
    "antiLinkStatus": "",
    "antiLinkKey": "",
    "antiLinkExpire": "",
    "storageConfigStatus": true, // true 存储已经配置完整
    "antiLinkConfigStatus": false, // false 未开启防盗链
}

获取文件存储路径

php
FileHelper::fresnsFileStoragePath($fileType, $usageType);
参数名类型是否必传说明
fileTypeNumberYES1.图片 / 2.视频 / 3.音频 / 4.文档
usageTypeNumberYES见编号说明

根据文件 ID 或 FID 获取单个信息

php
FileHelper::fresnsFileInfoById($fileIdOrFid);
参数名类型是否必传说明
fileIdOrFidStringYESfiles > id 或者 files > fid

根据文件 ID 或 FID 获取多个信息

php
# 原始信息
FileHelper::fresnsFileInfoListByIds($fileIdsOrFids);

# 判断并处理防盗链配置后信息
FileHelper::fresnsAntiLinkFileInfoListByIds($fileIdsOrFids);
参数名类型是否必传说明
fileIdsOrFidsArrayYESfiles > id 或者 files > fid
查看列表输出示例
json
{
    "images": [
        {
            // 图片信息
        }
    ],
    "videos": [
        {
            // 视频信息
        }
    ],
    "audios": [
        {
            // 音频信息
        }
    ],
    "documents": [
        {
            // 文档信息
        }
    ],
}

根据表字段获取文件信息列表

php
# 原始信息
FileHelper::fresnsFileInfoListByTableColumn($tableName, $tableColumn, $tableId, $tableKey);

# 判断并处理防盗链配置后信息
FileHelper::fresnsAntiLinkFileInfoListByTableColumn($tableName, $tableColumn, $tableId, $tableKey);
参数名类型是否必传说明
tableNameStringYES表名
tableColumnStringYES字段名
tableIdNumberNO主键 ID
tableKeyStringNO主键名
  • tableIdtableKey 二选一传参
查看列表输出示例
json
{
    "images": [
        {
            // 图片信息
        }
    ],
    "videos": [
        {
            // 视频信息
        }
    ],
    "audios": [
        {
            // 音频信息
        }
    ],
    "documents": [
        {
            // 文档信息
        }
    ],
}

根据文件字段输出指定链接

php
FileHelper::fresnsFileUrlByTableColumn($idColumn, $urlColumn, $urlType);
参数名类型是否必传说明
idColumnNumberYESfile_id 字段,比如 users > decorate_file_id
urlColumnStringYESfile_url 字段,比如 users > decorate_file_url
urlTypeStringNOURL 类型,不传则使用默认 imageConfigUrl
urlType
  • imageDefaultUrl
  • imageConfigUrl
  • imageAvatarUrl
  • imageRatioUrl
  • imageSquareUrl
  • imageBigUrl
  • videoCoverUrl
  • videoGifUrl
  • videoUrl
  • audioUrl
  • documentUrl
  • documentPreviewUrl

根据文件 ID 或 FID 获取源文件链接

php
FileHelper::fresnsFileOriginalUrlById($fileIdOrFid);
参数名类型是否必传说明
fileIdOrFidStringYESfiles > id 或者 files > fid
  • 输出结果会判断防盗链配置,如果开启则输出防盗链文件信息。