lgp-admin-plus-api/app/Models/FileModel.php

<?php

namespace App\Models;

use App\BaseApp\BaseModel;

/**
 * 文件 / 素材表（nl_file）
 *
 * 原表只是上传流水（user_id + url）。素材库扩了对象键、体积、哈希与引用计数之后，
 * 它同时充当素材主表，type / source 的取值被同步、回收、前端筛选三处共用，
 * 所以固化成常量，免得三边各写一套魔法数字、还各写错一个。
 */
class FileModel extends BaseModel
{
    /*
     * type 取值。0~4 是老表原有语义，5、6 是素材库补的：
     * 图册 PDF、报价 Excel 这类文件原先全落在「其他」里没法筛。
     */
    public const TYPE_IMAGE = 0;
    public const TYPE_VIDEO = 1;
    public const TYPE_AUDIO = 2;
    public const TYPE_EXCEL = 3;
    public const TYPE_ARCHIVE = 4;
    public const TYPE_DOCUMENT = 5;
    public const TYPE_OTHER = 6;

    /** source：经上传接口进来的 */
    public const SOURCE_UPLOAD = 0;
    /** source：从 OSS 反向列举补录的历史文件 */
    public const SOURCE_OSS = 1;

    protected $table = 'file';

    protected $guarded = [];

    /**
     * 数值列显式转型：MySQL 驱动会把 bigint / int 读成字符串，
     * 前端拿 size 做体积换算、拿 ref_count 判断能否回收时会被字符串坑到
     *
     * created_at / updated_at 不在此列：BaseModel 已经用访问器格式化成了日期串，
     * 再加 cast 只会让两套逻辑互相打架
     */
    protected $casts = [
        'user_id' => 'integer',
        'oss_config_id' => 'integer',
        'folder_id' => 'integer',
        'type' => 'integer',
        'size' => 'integer',
        'width' => 'integer',
        'height' => 'integer',
        'ref_count' => 'integer',
        'last_scan_at' => 'integer',
        'source' => 'integer',
    ];

    /**
     * 扩展名归类到 type
     *
     * 从 OSS 反向同步时手上只有对象键，没有上传时的 MIME，只能按扩展名判断
     */
    public static function typeOfExt(string $ext): int
    {
        return match (strtolower(trim($ext, " \t\n\r\0\x0B."))) {
            'jpg', 'jpeg', 'png', 'gif', 'bmp', 'webp', 'svg', 'ico', 'avif', 'heic' => self::TYPE_IMAGE,
            'mp4', 'mov', 'avi', 'mkv', 'flv', 'wmv', 'webm', 'm3u8', 'ts' => self::TYPE_VIDEO,
            'mp3', 'wav', 'aac', 'flac', 'ogg', 'm4a', 'amr' => self::TYPE_AUDIO,
            'xls', 'xlsx', 'csv' => self::TYPE_EXCEL,
            'zip', 'rar', '7z', 'tar', 'gz', 'bz2' => self::TYPE_ARCHIVE,
            'pdf', 'doc', 'docx', 'ppt', 'pptx', 'txt', 'md' => self::TYPE_DOCUMENT,
            default => self::TYPE_OTHER,
        };
    }
}