PHPackages                             quansitech/qscmf-formitem-aliyun-oss - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Admin Panels](/categories/admin)
4. /
5. quansitech/qscmf-formitem-aliyun-oss

ActiveLibrary[Admin Panels](/categories/admin)

quansitech/qscmf-formitem-aliyun-oss
====================================

qscmf formbuilder item

v1.15.0(11mo ago)22.1k↓100%61MITJavaScriptPHP &gt;=7.2.0

Since Mar 7Pushed 11mo ago1 watchersCompare

[ Source](https://github.com/quansitech/qscmf-formitem-aliyun-oss)[ Packagist](https://packagist.org/packages/quansitech/qscmf-formitem-aliyun-oss)[ RSS](/packages/quansitech-qscmf-formitem-aliyun-oss/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (2)Versions (47)Used By (1)

qscmf-formitem-aliyun-oss
=========================

[](#qscmf-formitem-aliyun-oss)

上传文件至阿里云OSS组件

#### 安装

[](#安装)

```
composer require quansitech/qscmf-formitem-aliyun-oss
```

#### 如何使用

[](#如何使用)

- 修改.env，设置相关配置

    ```
    ALIOSS_ACCESS_KEY_ID=**********
    ALIOSS_ACCESS_KEY_SECRET=**********
    ALIOSS_HOST=**********
    ```
- 修改/app/Common/Conf/config.php，配置对应上传类型，如：

    ```
    //UPLOAD_TYPE_*** 其中***为对应的type
    ```

```
'UPLOAD_TYPE_FILE' => array(
 'mimes' => '', //允许上传的文件MiMe类型
 'maxSize' => 500*1024*1024, //上传的文件大小限制 (0-不做限制)
 'exts' => 'doc,docx,xls,xlsx,pdf,ppt,txt,rar,pptx,rtf,zip,7z,jpg,png', //允许上传的文件后缀
 'autoSub' => true, //自动子目录保存文件
 'subName' => array('date','Ymd'), //子目录创建方式，[0]-函数名，[1]-参数，多个参数使用数组
 'rootPath' => './Uploads/', //保存根路径
 'savePath' => 'file/', //保存路径
 'saveName' => array('uniqid', ''), //上传文件命名规则，[0]-函数名，[1]-参数，多个参数使用数组
 'saveExt' => '', //文件保存后缀，空则使用原后缀
 'replace' => false, //存在同名是否覆盖
 'hash' => true, //是否生成hash编码
 'callback' => false, //检测文件是否存在回调函数，如果存在返回文件信息数组
 'oss_host' => env('ALIOSS_HOST'), // oss地址，如果不指定upload_oss_host，该地址会作为上传地址和资源访问地址
 'upload_oss_host' => env("UPLOAD_ALIOSS_HOST"), // 指定上传的oss地址,不指定的话会使用oss_host作为上传地址
 'oss_meta' => array('Cache-Control' => 'max-age=2592000', 'Content-Disposition' => 'attachment'),
),
```

Ps. 其中oss\_meta支持设置变量替换，如：希望下载oss文件时，可以使用原来的文件名称进行下载（上传到oss后真实文件名会变成随机码）, 在filename=后面加上"\_\_title\_\_"，程序会自动替换成真实的文件名, 代码如下

```
'oss_meta' => array('Cache-Control' => 'max-age=2592000', 'Content-Disposition' => 'attachment; filename=__title__''),
```

```
+ 使用
  + 上传音频：audio_oss/audios_oss

  ```php
  // audio_oss为上传单个音频，audios_oss为上传多个音频

  $extra_attr = 'data-url='.U('/extends/AliyunOss/policyGet', array('type' => 'audio')); // 默认值
  // 如没有特别需求，$extra_attr可不传
  addFormItem('audio_id', 'audio_oss', '单个音频', '', '', '', $extra_attr)
  addFormItem('audios_id', 'audios_oss', '多个音频')

```

- 上传文件：file\_oss/files\_oss

    ```
    // file_oss为上传单个文件，files_oss为上传多个文件

    $extra_attr = 'data-url='.U('/extends/AliyunOss/policyGet', array('type' => 'file')); // 默认值
    // 如没有特别需求，$extra_attr可不传
    addFormItem('file_id', 'file_oss', '单个文件', '', '', '', $extra_attr)
    addFormItem('files_id', 'files_oss', '多个文件')
    ```
- 上传图片：picture\_oss/pictures\_oss

    ```
    // picture_oss为上传单张图片，pictures_oss为上传多张图片

    $extra_attr = 'data-url='.U('/extends/AliyunOss/policyGet', array('type' => 'image')); // 默认值
    // 如没有特别需求，$extra_attr可不传
    addFormItem('picture_id', 'picture_oss', '单张图片', '', '', '', $extra_attr)
    addFormItem('pictures_id', 'pictures_oss', '多张图片')

    $options = ['process'=>'?x-oss-process=image/resize,m_fill,w_300,h_200'] //其中w_300,h_200为参数宽300高200，请根据实际需求填写
    // 如表单没有显示缩略图需求，$options可以不传，$options为空时显示原图
    addFormItem('picture_id', 'picture_oss', '单张图片', '',$options , '', '')
    ```
- 上传裁剪后的图片：picture\_oss\_intercept/pictures\_oss\_intercept

    ```
    // picture_oss_intercept为上传单张裁剪后的图片，pictures_oss_intercept为上传多张裁剪后的图片

    $option = [
      'type' => 'image', // 默认值
      'width' => 1, // 裁剪框宽高比例，此为宽度，默认为1
      'height' => 1 // 裁剪框宽高比例，此为高度，默认1
    ];

    // 如没有特别需求，$option可不传
    addFormItem('cover', 'picture_oss_intercept', '单张裁剪后的图片', '', $option)
    addFormItem('covers', 'pictures_oss_intercept', '多张裁剪后的图片')
    ```

oss\_uploader oss上传图片
-------------------------------------------------------------

[](#oss_uploader-oss上传图片)

### 介绍

[](#介绍)

图片裁剪上传功能,内置cropper.js,可配置是否裁剪,可配置oss。

### 功能：

[](#功能)

- 可配置使用oss
- 可配置是否裁剪
- 可以定义裁剪尺寸,裁剪比例
- 可以定义限制文件后缀、大小以及是否允许选取重复文件
- 限制上传张数
- 可自定义提示函数
- 裁剪上传图会默认转成jpg;png透明背景默认转成白色

    ### 初始化调用

    [](#初始化调用)

    ```
    $(selector).ossuploader(option); //selector 为隐藏域

    option: {
      url:                //string require  上传图片的地址
      multi_selection:    //boolean optional 是否多选
      oss:                //boolean optional 是否启用oss
      canvasOption:{       //object optional 配置getCroppedCanvas
          //修改裁剪后图片的背景色 为黑色
          fillColor: '#333',
      }
      //get more information: https://github.com/fengyuanchen/cropperjs

      crop:{              //object optional cropper配置,若存在此项，则裁剪图片,更多配置请参考cropper.js官网
          aspectRatio: 120/120,
          viewMode: 1,
          ready: function () {
              croppable = true;
          }
      },
      //由于plup_upload内置的filter,出错时会触发Error回调
      //导致上一个上传任务的失败,自定义了 check_image,limit_file_size,用于前端验证文件后缀格式与文件大小
      filters: {                // object optional
           check_image:         // Boolean 是否检查图片类型(若为true: 对于裁剪上传,允许无后缀文件;多选上传,不允许无后缀文件)
           limit_file_size:     // Number 限制文件大小，参考格式：5 * 1024 * 1024
           prevent_duplicates:  // Boolean 是否允许选取重复文件，false：是，true 否，默认为false
      },
      show_msg:           //function optional 展示提示消息的函数,默认为window.alert
      limit:              //number   optional 上传图片张数的限制,默认值32
      tpye:               //string   optional 上传类型 file | image 默认值 image
      beforeUpload:       //function optional 回调 参考回调说明
      filePerUploaded:    //function optional 回调 参考回调说明
      uploadCompleted:    //function optional 回调 参考回调说明
      uploadError:        //function optional 回调 参考回调说明
      deleteFile:         //function optional 回调 参考回调说明
    }
    ```

    备注:

1. cropper：

    - [官网demo](https://fengyuanchen.github.io/cropper/)
    - [github](https://github.com/fengyuanchen/cropper/blob/master/README.md)
2. 回调说明:

    - beforeUpload : 当选中文件时的回调。若返回false,则不添加选中的文件
    - filePerUploaded : 每个文件上传完成，都会触发此回调
    - uploadCompleted : 若多选上传选中3个图，则3个图完成上传才触发此回调
    - uploadError : 上传出错
    - deleteFile : 删除图片

    oss\_upload\_extend oss上传扩展
    ----------------------------------------------------------------------

    [](#oss_upload_extend-oss上传扩展)

    ### 介绍

    [](#介绍-1)

    基于oss上传插件，对上传插件的回调进行扩展，增强oss插件上传功能

    ### 功能：

    [](#功能-1)

- 可以组合添加拓展
- 可以对扩展进行排序
- [内置preventUpload扩展](#preventUpload)
- 根据oss\_upload的回调,添加各自的回调

### 初始化调用

[](#初始化调用-1)

```
$(selector).ossuploaderWrapper(option[, extend]); //selector 为隐藏域
option: object require 原oss上传插件的option
extend: string_array optional 扩展名
```

链接：

- [oss\_uploader](#oss_uploader)
- 扩展名: [扩展介绍](#extend_desc)

扩展说明
----

[](#扩展说明)

### 执行逻辑

[](#执行逻辑)

- 根据传入的extend进行排序
- 把extend遍历,从conf中取出要扩展的配置
- 把配置中的回调放到相应的队列中
- 当触发相应的回调,则执行相应队列中的函数
- 若队列中有函数返回false,则队列后面的函数都不执行

    ### 内置扩展介绍

    [](#内置扩展介绍)

    #### preventUpload(默认扩展)

    [](#preventupload默认扩展)

    上传图片的过程中,隐藏域所在的form
- 会禁止submit事件(submit事件禁止且提示图片上传中)
- type为submit 的按钮会显示为上传中，当上传完成会恢复原来的描述

    ```
    $(selector).ossuploaderWrapper(option, ['preventUpload']); //selector 为隐藏域
    ```

    ### 添加自定义扩展

    [](#添加自定义扩展)

    conf 对象内置了preventUpload扩展

    往conf对象加属性对象，实现扩展的功能

    ```
    var conf = {
      myExtend: {
          invoke: function(){
                  return {};
              } || {} //require
          order: number, // >=2,optional
      }
    };
    ```
- invoke 属性必须为`返回对象的函数`或`纯对象`
    `返回对象`或`纯对象`属性包含回调,如 beforeUpload,uploadCompleted 等 扩展的回调队列中，任意一个函数返回false,都会停止执行后续回调
- order属性为插件的调用排序,值越小调用顺序越早;
    由于preventUpload扩展(内置扩展)的order为 1,
    其他默认内置扩展大于1， 非默认内置扩展大于100。

###  Health Score

41

—

FairBetter than 89% of packages

Maintenance50

Moderate activity, may be stable

Popularity22

Limited adoption so far

Community20

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~41 days

Recently: every ~147 days

Total

46

Last Release

357d ago

PHP version history (2 changes)v1.0.0PHP &gt;=7.2.0

v1.11.0PHP &gt;=8.0.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/15a0610fee78753bdad92fd45c3506455c0fd45ae51924797b1841d260495a3f?d=identicon)[tiderjian](/maintainers/tiderjian)

![](https://www.gravatar.com/avatar/6c2b4bb10b346cb957c091d3273e3332276b5d09a29e255d387184f5dd4b5976?d=identicon)[xhiny](/maintainers/xhiny)

---

Top Contributors

[![Xhiny](https://avatars.githubusercontent.com/u/35066497?v=4)](https://github.com/Xhiny "Xhiny (38 commits)")[![viki719632](https://avatars.githubusercontent.com/u/20202439?v=4)](https://github.com/viki719632 "viki719632 (36 commits)")[![tiderjian](https://avatars.githubusercontent.com/u/1665649?v=4)](https://github.com/tiderjian "tiderjian (24 commits)")[![qq958691165](https://avatars.githubusercontent.com/u/13673962?v=4)](https://github.com/qq958691165 "qq958691165 (11 commits)")[![ericlwd](https://avatars.githubusercontent.com/u/49860861?v=4)](https://github.com/ericlwd "ericlwd (3 commits)")[![1041729157](https://avatars.githubusercontent.com/u/35829078?v=4)](https://github.com/1041729157 "1041729157 (2 commits)")

---

Tags

aliyuncomponentadminossthinkphpformbuilderqscmf

### Embed Badge

![Health badge](/badges/quansitech-qscmf-formitem-aliyun-oss/health.svg)

```
[![Health](https://phpackages.com/badges/quansitech-qscmf-formitem-aliyun-oss/health.svg)](https://phpackages.com/packages/quansitech-qscmf-formitem-aliyun-oss)
```

###  Alternatives

[zhongshaofa/easyadmin

基于ThinkPHP6.0和layui的快速开发的后台管理系统。

6589.3k](/packages/zhongshaofa-easyadmin)[rockys/ex-admin-thinkphp

Ex-admin-thinkphp 是一个基于Ant Design of Vue + Thinkphp 开发而成后台系统构建工具，无需关注页面模板JavaScript，只用php代码即可快速构建出一个功能完善的后台系统。

173.0k](/packages/rockys-ex-admin-thinkphp)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
