PHPackages tntma/storage - 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. tntma/storage ActiveLibrary[File & Storage](/categories/file-storage) tntma/storage ============= webman storage plugin 2 1.0.0(3y ago)0182MITPHPPHP >=7.2 Since Nov 30Pushed 3y agoCompare [ Source](https://github.com/TNT-ma/webman-storage)[ Packagist](https://packagist.org/packages/tntma/storage)[ RSS](/packages/tntma-storage/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (1)Dependencies (8)Versions (2)Used By (0) webman 简单易用多文件上传插件 ================== [](#webman-简单易用多文件上传插件) [![Latest Stable Version](https://camo.githubusercontent.com/60a3199bd18a590621b11a9821f9a5a0480b547724c5d13a1fc5e38178c8851b/687474703a2f2f706f7365722e707567782e6f72672f74696e7977616e2f73746f726167652f76)](https://packagist.org/packages/tinywan/storage) [![Total Downloads](https://camo.githubusercontent.com/6db8441b5810f5be63f028d70535b1560cda899055f70d50e929623d7f82370f/687474703a2f2f706f7365722e707567782e6f72672f74696e7977616e2f73746f726167652f646f776e6c6f616473)](https://packagist.org/packages/tinywan/storage)[![Daily Downloads](https://camo.githubusercontent.com/3b3d38b072e56ccbfa2d75dfbfd73e63b3ee37ba821aa0add60772a8ece79c45/687474703a2f2f706f7365722e707567782e6f72672f74696e7977616e2f73746f726167652f642f6461696c79)](https://packagist.org/packages/tinywan/storage)[![Latest Unstable Version](https://camo.githubusercontent.com/a4c307f606bf25108fdf657150ef0bbe85ac26e8716baff118cdc1f0ea595b01/687474703a2f2f706f7365722e707567782e6f72672f74696e7977616e2f73746f726167652f762f756e737461626c65)](https://packagist.org/packages/tinywan/storage)[![License](https://camo.githubusercontent.com/94a922447bbfc71bc06db5f49b115345a8df4cf8b78c4ab4f8902f49185f0fc9/687474703a2f2f706f7365722e707567782e6f72672f74696e7977616e2f73746f726167652f6c6963656e7365)](https://packagist.org/packages/tinywan/storage)[![PHP Version Require](https://camo.githubusercontent.com/ebbca74c4261cd8a04bb291366c79ce6afc70a30c71169e8dd8af1a10a784d80/687474703a2f2f706f7365722e707567782e6f72672f74696e7977616e2f73746f726167652f726571756972652f706870)](https://packagist.org/packages/tinywan/storage)![last-commit](https://camo.githubusercontent.com/0b7e033bec1e439af7f3fae0a250119c48561b2616670477989f3f14c2a777d6/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f74696e7977616e2f73746f726167652f6d61696e)![storage tag](https://camo.githubusercontent.com/07d5982c92d55ff8b723fc3489a4c974a430f07cf9ef4748f32ff083fd33d38d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f7461672f74696e7977616e2f73746f726167653f636f6c6f723d666636396234) 特性 -- [](#特性) #### 🍏 本地对象存储 [](#-本地对象存储) - ✅ 本地多文件上传 #### 🍓 阿里云对象存储 [](#-阿里云对象存储) - ✅ 本地多文件上传 - ✅ `Base64`图片文件上传 - ✅ 上传服务端文件 #### 🍋 腾讯云对象存储 [](#-腾讯云对象存储) - ✅ 本地多文件上传 - ✅ `Base64`图片文件上传 - ✅ 上传服务端文件 #### 🍇 七牛云对象存储 [](#-七牛云对象存储) - ✅ 本地多文件上传 - ✅ `Base64`图片文件上传 - ✅ 上传服务端文件 安装 -- [](#安装) ``` composer require tinywan/storage ``` 基本用法 ---- [](#基本用法) ``` Tinywan\Storage\Storage::config(); // 初始化。 默认为本地存储：local，阿里云：oss，腾讯云：cos，七牛：qiniu $res = Tinywan\Storage\Storage::uploadFile(); var_dump(json_encode($res)); ``` ### 上传成功信息 [](#上传成功信息) ``` [ { "key": "webman", "origin_name": "常用编程软件和工具.xlsx", "save_name": "03414c9bdaf7a38148742c87b96b8167.xlsx", "save_path": "runtime/storage/03414c9bdaf7a38148742c87b96b8167.xlsx", "save_path": "/var/www/webman-admin/public/storage/03414c9bdaf7a38148742c87b96b8167.xlsx", "url": "/storage/fd2d472da56c71a6da0a5251f5e1b586.png", "uniqid ": "03414c9bdaf7a38148742c87b96b8167", "size": 15050, "mime_type": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "extension": "xlsx" } ... ] ``` > 失败，抛出`StorageAdapterException`异常 ### 成功响应字段 [](#成功响应字段) 字段描述示例值key上传文件keywebmanorigin\_name原始文件名常用编程软件和工具.xlsxsave\_name保存文件名03414c9bdaf7a38148742c87b96b8167.xlsxsave\_path文件保存路径（相对）/var/www/webman-admin/runtime/storage/03414c9bdaf7a38148742c87b96b8167.xlsxurlurl访问路径/storage/03414c9bdaf7a38148742c87b96b8167.xlsxunique\_iduniqid03414c9bdaf7a38148742c87b96b8167size文件大小15050（字节）mime\_type文件类型application/vnd.openxmlformats-officedocument.spreadsheetml.sheetextension文件扩展名xlsx上传规则 ---- [](#上传规则) 默认情况下是上传到本地服务器，会在`runtime/storage`目录下面生成以当前日期为子目录，以文件流的sha1编码为文件名的文件，例如上面生成的文件名可能是： ``` runtime/storage/fd2d472da56c71a6da0a5251f5e1b586.png ``` 如果你希望上传的文件是可以直接访问或者下载的话，可以使用`public`存储方式。 你可以在`config/plugin/tinywan/storage/pp.php`配置文件中配置上传根目录，例如： ``` 'local' => [ 'adapter' => \Tinywan\Storage\Adapter\LocalAdapter::class, 'root' => public_path() . '/storage', ], ``` > 浏览器访问： 上传验证 ---- [](#上传验证) 支持使用验证类对上传文件的验证，包括文件大小、文件类型和后缀 字段描述示例值single\_limit单个文件的大小限制，默认200M1024 \* 1024 \* 200total\_limit所有文件的大小限制，默认200M1024 \* 1024 \* 200nums文件数量限制，默认1010include被允许的文件类型列表\['xlsx','pdf'\]exclude不被允许的文件类型列表\['png','jpg'\]支持上传SDK ------- [](#支持上传sdk) #### 阿里云对象存储 [](#阿里云对象存储) ``` composer require aliyuncs/oss-sdk-php ``` #### 腾讯云对象存储 [](#腾讯云对象存储) ``` composer require qcloud/cos-sdk-v5 ``` #### 七牛云云对象存储 [](#七牛云云对象存储) ``` composer require qiniu/php-sdk ``` 上传Base64图片 ---------- [](#上传base64图片) > **使用场景：** 前端直接截图（头像、Canvas等）一个Base64数据流的图片直接上传到云端 #### 请求参数 [](#请求参数) ``` { "extension": "png", "base64": "data:image/jpeg;base64,/9j/4AAQSkxxxxxxxxxxxxZJRgABvtyQBIr/MPTPTP/2Q==" } ``` #### 请求案例（阿里云） [](#请求案例阿里云) ``` public function upload(Request $request) { Storage::config(Storage::MODE_OSS, false); // 第一个参数为存储方式。第二个参数为是否本地文件（默认是） $base64 = $request->post('base64'); $r = Storage::uploadBase64($base64,'png'); var_dump($r); } ``` #### 响应参数 [](#响应参数) ``` { "save_path": "storage/20220402213639624851671439e.png", "url": "http://webman.oss.tinywan.com/storage/20220402213639624851671439e.png", "unique_id": "20220402213639624851671439e", "size": 11802, "extension": "png" } ``` 上传服务端文件 ------- [](#上传服务端文件) > **使用场景：** 服务端导出文件需要上传到云端存储，或者零时下载文件存储。 #### 请求案例（阿里云） [](#请求案例阿里云-1) ``` Storage::config(Storage::MODE_OSS,false); $localFile = runtime_path() . DIRECTORY_SEPARATOR . 'storage/webman.png'; $res = Storage::uploadServerFile($localFile); ``` #### 响应参数 [](#响应参数-1) ``` { "origin_name": "/var/www/webman-admin/runtime/storage/webman.png", "save_path": "storage/6edf04d7c26f020cf5e46e6457620220402213414.png", "url": "http://webman.oss.tinywan.com/storage/6ed9ffd54d0df57620220402213414.png", "unique_id": "6edf04d7c26f020cf5e46e6403213414", "size": 3505604, "extension": "png" } ``` Other ----- [](#other) ### phpstan [](#phpstan) ``` vendor/bin/phpstan analyse src vendor/bin/php-cs-fixer fix src ``` ### Health Score 22 — LowBetter than 22% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity10 Limited adoption so far Community9 Small or concentrated contributor base Maturity41 Maturing project, gaining track record Bus Factor1 Top contributor holds 77.6% 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 Unknown Total 1 Last Release 1264d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/f3696f5a24d3824d00c87143d635039bfcd6a40ae92e09c4b4532bdcc6ca8706?d=identicon)[TNTma](/maintainers/TNTma) --- Top Contributors [![Tinywan](https://avatars.githubusercontent.com/u/14959876?v=4)](https://github.com/Tinywan "Tinywan (45 commits)")[![edwinhuish](https://avatars.githubusercontent.com/u/5207925?v=4)](https://github.com/edwinhuish "edwinhuish (10 commits)")[![TNT-ma](https://avatars.githubusercontent.com/u/114092831?v=4)](https://github.com/TNT-ma "TNT-ma (3 commits)") ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/tntma-storage/health.svg) ``` [![Health](https://phpackages.com/badges/tntma-storage/health.svg)](https://phpackages.com/packages/tntma-storage) ``` ### Alternatives [knplabs/gaufrette PHP library that provides a filesystem abstraction layer 2.5k39.8M123](/packages/knplabs-gaufrette)[google/cloud-storage Cloud Storage Client for PHP 34390.8M125](/packages/google-cloud-storage)[illuminate/filesystem The Illuminate Filesystem package. 15261.6M2.6k](/packages/illuminate-filesystem)[superbalist/flysystem-google-storage Flysystem adapter for Google Cloud Storage 26320.6M30](/packages/superbalist-flysystem-google-storage)[creocoder/yii2-flysystem The flysystem extension for the Yii framework 2931.7M62](/packages/creocoder-yii2-flysystem)[flowjs/flow-php-server PHP library for handling chunk uploads. Works with flow.js html5 file uploads. 2451.6M15](/packages/flowjs-flow-php-server) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)