webman storage

Webman mudah digunakan plugin unggahan multi-file

ciri

Awan	Banyak unggahan file	Upload gambar base64	Unggah file server
? Cloud pribadi	✅	-	✅
? ALIBABA Cloud	✅	✅	✅
? Tencent Cloud	✅	✅	✅
? Qiniu Cloud	✅	✅	✅
? Amazon (S3)	✅	✅	✅

Memasang

composer require tinywan/storage

Penggunaan dasar

 $ res = Tinywan  Storage Storage:: uploadFile ();
var_dump ( json_encode ( $ res ));

Setelah v1.0.0 , metode ini tidak perlu dipanggil setelah inisialisasi TinywanStorageStorage::config() , itu akan diinisialisasi secara otomatis. Konfigurasi default adalah file konfigurasi konfigurasi app.php Konfigurasi default Konfigurasi Adaptor Unggah.

Unggah informasi yang berhasil

[
    {
        "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 "
    }
    ...
]

Gagal, melempar pengecualian StorageAdapterException

Bidang respons yang sukses

Bidang	menggambarkan	Nilai contoh
kunci	Unggah Kunci File	Webman
Origin_name	Nama file asli	Perangkat lunak dan alat pemrograman umum.xlsx
save_name	Simpan Nama File	03414C9BDAF7A38148742C87B96B8167.XLSX
save_path	File Saving Path (relatif)	/var/www/webman-admin/runtime/storage/03414c9bdaf7a38148742c87b96b8167.xlsx
url	Jalur akses URL	/storage/03414c9bdaf7a38148742c87b96b8167.xlsx
unik_id	Uniqid	03414C9BDAF7A38148742C87B96B8167
ukuran	Ukuran file	15050 (byte)
mime_type	Jenis file	Application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
perpanjangan	Ekstensi file	xlsx

Unggah aturan

Secara default, diunggah ke server lokal. File dengan tanggal saat ini sebagai subdirektori dan nama file yang dikodekan oleh SHA1 dari aliran file akan dihasilkan di bawah direktori runtime/storage . Misalnya, nama file yang dihasilkan di atas mungkin:

 runtime/storage/fd2d472da56c71a6da0a5251f5e1b586.png

Jika Anda ingin file yang diunggah dapat diakses secara langsung atau diunduh, Anda dapat menggunakan metode penyimpanan public .

Anda dapat mengonfigurasi direktori root unggah di file konfigurasi config/plugin/tinywan/storage/app.php , misalnya:

 ' local ' => [
    ' adapter ' =>  Tinywan  Storage  Adapter LocalAdapter::class,
    ' root ' => public_path () . ' /storage ' ,
],

Akses browser: http://127.0.0.1:8787/storage/fd2d472da56c71a6da0a5251f5e1b586.png

Unggah verifikasi

Mendukung verifikasi file yang diunggah menggunakan kelas verifikasi, termasuk ukuran file, jenis file dan akhiran

Bidang	menggambarkan	Nilai contoh
single_limit	Batas ukuran untuk satu file, default 200m	1024 * 1024 * 200
TOTAL_LIMIT TOTAL_LIMIT	Semua batas ukuran file, default 200m	1024 * 1024 * 200
nums	Batas Nomor File, Default 10	10
termasuk	Daftar jenis file yang diizinkan	['xlsx', 'pdf']
mengecualikan	Daftar jenis file yang tidak sah	['png', 'jpg']

Dukungan Mengunggah SDK

Penyimpanan Objek ALIBABA Cloud

composer require aliyuncs/oss-sdk-php

Penyimpanan objek cloud tencent

composer require qcloud/cos-sdk-v5

Penyimpanan objek qiniu cloud

composer require qiniu/php-sdk

Penyimpanan Objek Amazon (S3)

composer require league/flysystem-aws-s3-v3

Unggah gambar base64

Gunakan skenario: Tangkapan layar langsung dari front-end (AVA, Canvas, dll.) Gambar aliran data Base64 diunggah langsung ke cloud

Parameter permintaan

{
    "extension" : " png " ,
    "base64" : " data:image/jpeg;base64,/9j/4AAQSkxxxxxxxxxxxxZJRgABvtyQBIr/MPTPTP/2Q== "
}

Kasus Permintaan (Ali Cloud)

 public function upload ( Request $ request )
{
    $ base64 = $ request -> post ( ' base64 ' );
    $ response =  Tinywan  Storage Storage:: disk ( Tinywan  Storage Storage:: MODE_OSS , false )-> uploadBase64 ( $ base64 , ' png ' );
    var_dump ( $ response );
}

Setelah v1.0.0 , metode ini tidak perlu dipanggil setelah inisialisasi TinywanStorageStorage::config() , itu akan diinisialisasi secara otomatis. Konfigurasi default adalah file konfigurasi konfigurasi app.php Konfigurasi default Konfigurasi Adaptor Unggah.

Parameter respons

{
	"save_path" : " storage/20220402213639624851671439e.png " ,
	"url" : " http://webman.oss.tinywan.com/storage/20220402213639624851671439e.png " ,
	"unique_id" : " 20220402213639624851671439e " ,
	"size" : 11802 ,
	"extension" : " png "
}

Unggah file server

Skenario Penggunaan: Server mengekspor file perlu diunggah ke penyimpanan cloud, atau diunduh pada penyimpanan file nol waktu.

Kasus Permintaan (Ali Cloud)

 $ serverFile = runtime_path () . DIRECTORY_SEPARATOR . ' storage/webman.png ' ;
$ res =  Tinywan  Storage Storage:: disk ( Tinywan  Storage Storage:: MODE_OSS , false )-> uploadServerFile ( $ serverFile );

Setelah v1.0.0 , metode ini tidak perlu dipanggil setelah inisialisasi TinywanStorageStorage::config() , itu akan diinisialisasi secara otomatis. Konfigurasi default adalah file konfigurasi konfigurasi app.php Konfigurasi default Konfigurasi Adaptor Unggah.

Parameter respons

{
	"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 "
}

Lainnya

phpstan

 vendor/bin/phpstan analyse src

vendor/bin/php-cs-fixer fix src