PHPackages                             jormin/qiniu - 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. [File & Storage](/categories/file-storage)
4. /
5. jormin/qiniu

ActiveLibrary[File & Storage](/categories/file-storage)

jormin/qiniu
============

七牛

v1.0.2(7y ago)01391MITPHPPHP ^5.6 || ^7.0

Since Jul 4Pushed 7y ago1 watchersCompare

[ Source](https://github.com/jormin/qiniu)[ Packagist](https://packagist.org/packages/jormin/qiniu)[ Docs](https://github.com/jormin/qiniu)[ RSS](/packages/jormin-qiniu/feed)WikiDiscussions master Synced today

READMEChangelog (2)Dependencies (1)Versions (3)Used By (1)

基于七牛官方SDK的扩展包

安装
--

[](#安装)

```
$ composer require jormin/qiniu -vvv
```

通用响应
----

[](#通用响应)

参数类型是否必须描述successbool是false：操作失败 true:操作成功messagestring是结果说明dataarray否返回数据使用
--

[](#使用)

### 生成七牛对象

[](#生成七牛对象)

```
$accessKey = 'your access key';
$secretKey = 'your secret key';
$qiniu = new \Jormin\Qiniu\Qiniu($accessKey, $secretKey);
```

### 空间域名相关功能

[](#空间域名相关功能)

```
// 获取空间列表
$qiniu->buckets();

// 获取指定空间的域名
$qiniu->domains($bucket);

// 创建空间 $region:区域，默认滑动  z0 华东 z1 华北   z2 华南   na0 北美  as0 东南亚
$qiniu->createBucket($bucket, [$region='z0']);

// 删除空间
$qiniu->dropBucket($bucket);

// 设置空间访问权限 $private:权限 0 公开 1 私有
$qiniu->setBucketAuth($bucket, $private);
```

### 文件操作相关功能

[](#文件操作相关功能)

> 统计指定空间的文件总数功能慎用！！！！！官方并未提供获取总数的方法，该方法原理是分批次读取空间文件列表，直到没有剩余文件，由于读取列表接口限制单次最大数量为1000，所以空间文件数量巨大的情况下该方法效率很差！

```
// 统计指定空间的文件总数
$qiniu->count($bucket);

// 读取指定空间的文件列表
$qiniu->listFiles($bucket, [$limit=1000, $prefix='', $marker='', $delimiter='']);

// 读取文件信息
$qiniu->stat($bucket, $key);

// 批量读取文件信息 $keys:数组
$qiniu->batchStat($bucket, $keys);

// 获取上传文件Token
$qiniu->uploadToken($bucket, [$key = null, $expires = 3600, $policy = null, $strictPolicy = true]);

// 上传文件（默认方法）
$qiniu->upload($bucket, $filePath, [$key = null]);

// 带Token上传文件
$qiniu->uploadWithToken($uploadToken, $filePath, [$key = null]);

// 移动文件
$qiniu->move($srcBucket, $srcKey, $destBucket, $destKey, [$force=true]);

// 批量移动文件 $keys:数组 $prefix:目标文件名前缀 $suffix:目标文件名后缀
$qiniu->batchMove($srcBucket, $keys, $destBucket, [$prefix='', $suffix='', $force=true]);

// 复制文件
$qiniu->copy($srcBucket, $srcKey, $destBucket, $destKey, [$force=true]);

// 批量复制文件 $keys:数组 $prefix:目标文件名前缀 $suffix:目标文件名后缀
$qiniu->batchCopy($srcBucket, $keys, $destBucket, [$prefix='', $suffix='', $force=true]);

// 修改文件存储类型 $type 0:标准存储；1:低频存储
$qiniu->changeType($bucket, $key, $type);

// 批量修改文件存储类型 $type 0:标准存储；1:低频存储 $keys:数组
$qiniu->batchChangeType($bucket, $keys, $type);

// 修改文件状态 $status 0:启用；1:禁用
$qiniu->changeStatus($bucket, $key, $status);

// 修改文件MIME
$qiniu->changeMime($bucket, $key, $mime);

// 批量修改文件MIME
$qiniu->batchChangeMime($bucket, $keys, $mime);

// 删除文件
$qiniu->delete($bucket, $key);

// 批量删除文件 $keys:数组
$qiniu->batchDelete($bucket, $keys);

// 指定天数后删除文件 $days:天数，0表示永久保存
$qiniu->deleteAfterDays($bucket, $key, $days);

// 指定天数后批量删除文件 $keys:数组 $days:天数，0表示永久保存
$qiniu->batchDeleteAfterDays($bucket, $keys, $days);

// 从指定Url抓取资源
$qiniu->fetch($bucket, $url, [$key = null]);
```

### CDN相关功能

[](#cdn相关功能)

```
// 镜像资源更新
$qiniu->prefetch($bucket, $key);

// 刷新文件或目录 $urls:数组 $dirs:数组
$qiniu->refresh($urls, $dirs);

// 文件预取 $urls:数组
$qiniu->prefetchUrls($urls);
```

参考项目
----

[](#参考项目)

1. [qiniu/php-sdk](https://github.com/qiniu/php-sdk)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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 ~18 days

Total

2

Last Release

2849d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/d6ee6d33268c4673c2c01a955a3194083ed174f719ea76bbc259f16dd8615115?d=identicon)[jormin](/maintainers/jormin)

---

Top Contributors

[![jormin](https://avatars.githubusercontent.com/u/5519318?v=4)](https://github.com/jormin "jormin (8 commits)")

---

Tags

Jormin

### Embed Badge

![Health badge](/badges/jormin-qiniu/health.svg)

```
[![Health](https://phpackages.com/badges/jormin-qiniu/health.svg)](https://phpackages.com/packages/jormin-qiniu)
```

###  Alternatives

[zgldh/qiniu-laravel-storage

Qiniu Resource (Cloud) Storage SDK for Laravel 5/6/7/8/9

530394.0k14](/packages/zgldh-qiniu-laravel-storage)[overtrue/flysystem-qiniu

Flysystem adapter for the Qiniu storage.

231891.2k58](/packages/overtrue-flysystem-qiniu)[yangyifan/upload

上传 SDK for Laravel

12422.6k3](/packages/yangyifan-upload)[itbdw/laravel-storage-qiniu

A storage library for laravel5 and qiniu sdk

7015.2k](/packages/itbdw-laravel-storage-qiniu)[catlane/chunk-file-upload

文件上传小扩展，可支持大文件分块分片上传到七牛云or本地，优化您上传大文件的苦恼

284.9k](/packages/catlane-chunk-file-upload)

PHPackages © 2026

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