# PHP上传类库

**Repository Path**: MrMarko/upload

## Basic Information

- **Project Name**: PHP上传类库
- **Description**: PHP上传类库
- **Primary Language**: PHP
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 6
- **Forks**: 1
- **Created**: 2020-11-05
- **Last Updated**: 2023-04-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PHP上传类库

#### 介绍
PHP上传类库

#### 安装

```
composer require coldape/upload
```

#### php.ini可能需要修改的值
    1. post_max_size POST传输限制最大值
    2. upload_max_filesize 文件上传限制最大值
    3. disabled_functions 删除mkdir方法 因该方法需要使用
    

#### 使用说明

```
try {
    // 两种方式实例化
    // $upload = new upload('image');
    $upload = new upload($_FILES['image']);

    // 设置存储文件路径
    $upload->setPath(__DIR__ . '/upload');

    // 设置限制文件大小 (支持单位:B,K,M,G)
    $upload->setMaxSize('20G');

    // 设置文件名  [uniqueName方法生成随机文件名]
    $upload->setName($upload->uniqueName());

    // 设置限制扩展名类型 可以为字符串也可为数组
    $upload->setExtensionLimit('jpg');
    // $upload->setExtension(['png', 'jpg']);

    // 设置限制的MIME类型 同上 可为字符串亦可为数组
    $upload->setMimeLimit('image/jpeg');
    // $upload->setMime(['image/png', 'image/jpeg']);

    // 设置外部访问链接 默认域名+文件路径下
    // $upload->setPublicPath('upload');

    // 执行上传操作
    $up = $upload->save();

    $return = [
        '文件名' => $upload->getName(),
        '文件名+后缀' => $upload->getFullName(),
        '文件路径' => $upload->getPath(),
        '文件路径+文件名+后缀' => $upload->getFullPath(),
        '文件扩展名' => $upload->getExtension(),
        '文件MD5值' => $upload->getMd5(),
        '文件MIME' => $upload->getMime(),
        '文件大小' => $upload->getSize(),
        '外部访问链接' => $upload->getPublicPath()
    ];

    ps($return);
} catch (uploadException $e) {
    echo $e->getMessage();
}


// 对文件进一步操作 例如压缩 修改尺寸等
try {
    $extend = new extend($upload->getFullPath());

    // 设置文件后缀
    $extend->setSuffix('_thumb');

    // 设置文件前缀
    $extend->setPrefix('hello_');

    // 设置尺寸
    $extend->setSize(500,400);

    // 修改扩展名 格式转换
    // $extend->setExtension('png');

    // 修改查看图片的web路径
    // $extend->setPublicPath('/askdjksal/sdjsad');

    // 设置其他独立的ffmpeg参数
    // $extend->setOtherCommand([
    //     '-r 30',
    //     '-loop 1'
    // ]);

    // 修改文件路径
    // $extend->setPath(__DIR__.'/upload');

    // 修改文件名
    // $extend->setName('修改文件名');

    // 设置10个线程
    // $extend->setThreads(10);

    // 压缩视频码率 码率越低大小越小 但会越模糊
    // $extend->setVideoBit(1000);

    // 修改视频为H.264格式
    // $extend->setVideoH264();

    // 设置视频的渐入渐出 out渐出 in渐入
    // $extend->setVideoFade('out', 12.5, 0.5);

    // 设置图片为webp格式
    // $extend->setImageWebp()->getCommand();

    // 视频截图
    // $extend->setVideoShot(5, 'png');

    // 独立执行其他命令
    // $extend->setVideoH264()->setName('1');
    // $extend->setVideoH264()->setName('2');

    // 合并两个视频必须先转成同样的码率【这是个坑】可以用上面的命令先转
    // $extend->run('ffmpeg -y -f concat -safe 0 -i video.txt -c:a copy '.__DIR__.'/upload/视频合并.mp4');

    $extend->run();
    
    $return = [
        '文件名' => $extend->getName(),
        '文件名+后缀' => $extend->getFullName(),
        '文件路径' => $extend->getPath(),
        '文件路径+文件名+后缀' => $extend->getFullPath(),
        '文件扩展名' => $extend->getExtension(),
        '文件MD5值' => $extend->getMd5(),
        '文件MIME' => $extend->getMime(),
        '文件大小' => $extend->getSize(),
        '外部访问链接' => $extend->getPublicPath(),
        'FFMPEG执行语句' => $extend->getCommand(),
    ];

    ps($return);
} catch (uploadException $e) {
    echo $e->getMessage();
}
```

### 版本
- 1.4
  1. 新增获取文件宽高和长度
  2. 修改缩略图size与原图一致的问题
  3. 修改上传后tmp路径被删除而导致tmp_path属性错误
- 1.3 
    1. 修改操作方法
    2. 独立ffmpeg操作类出来操作 而不在上传类进行操作
    
- 1.2
    1. 新增视频截图功能
    2. 新增run可以执行其他独立命令 可执行视频合并等其他ffmpeg独立命令
    3. 新增设置文件输出扩展名，可用于转换格式

- 1.1
    1. 新增FFMPEG操作类
    2. 新增图片视频压缩

- 1.0
    1. 新增上传类