README

渲染 BlueImp jQuery File Upload 插件。该插件集成了多文件选择、拖拽支持、进度条、验证和图片预览功能。

安装

安装此扩展的首选方式是通过 composer。

运行以下命令之一

$ composer require 2amigos/yii2-file-upload-widget:~1.0

或者

"2amigos/yii2-file-upload-widget": "~1.0"

将以下内容添加到您的 composer.json 文件的 require 部分。

用法

此小部件提供了两种风味

• FileUpload: 基本 和 基本+
• FileUploadUI: 基本+ UI

<?php
use dosamigos\fileupload\FileUpload;

// without UI
?>

<?= FileUpload::widget([
	'model' => $model,
	'attribute' => 'image',
	'url' => ['media/upload', 'id' => $model->id], // your url, this is just for demo purposes,
	'options' => ['accept' => 'image/*'],
	'clientOptions' => [
		'maxFileSize' => 2000000
	],
	// Also, you can specify jQuery-File-Upload events
	// see: https://github.com/blueimp/jQuery-File-Upload/wiki/Options#processing-callback-options
	'clientEvents' => [
	    'fileuploaddone' => 'function(e, data) {
	                            console.log(e);
	                            console.log(data);
	                        }',
        'fileuploadfail' => 'function(e, data) {
	                            console.log(e);
	                            console.log(data);
                            }',
	],
]);?>

<?php

// with UI

use dosamigos\fileupload\FileUploadUI;
?>
<?= FileUploadUI::widget([
	'model' => $model,
	'attribute' => 'image',
	'url' => ['media/upload', 'id' => $tour_id],
	'gallery' => false,
	'fieldOptions' => [
    		'accept' => 'image/*'
	],
	'clientOptions' => [
    		'maxFileSize' => 2000000
	],
	// ...
	'clientEvents' => [
    	    'fileuploaddone' => 'function(e, data) {
    	                            console.log(e);
    	                            console.log(data);
    	                        }',
            'fileuploadfail' => 'function(e, data) {
    	                            console.log(e);
    	                            console.log(data);
                                }',
    ],
]);
?>

<?php

// action examples

public function actionImageUpload()
{
	$imageFile = UploadedFile::getInstanceByName('Transport[name]');
	$directory = \Yii::getAlias('@frontend/web/img/temp') . DIRECTORY_SEPARATOR . Yii::$app->session->id . DIRECTORY_SEPARATOR;
	if (!is_dir($directory)) {
		mkdir($directory);
	}
	if ($imageFile) {
		$uid = uniqid(time(), true);
		$fileName = $uid . '.' . $imageFile->extension;
		$filePath = $directory . $fileName;
		if ($imageFile->saveAs($filePath)) {
			$path = '/img/temp/' . Yii::$app->session->id . DIRECTORY_SEPARATOR . $fileName;
			return Json::encode([
				'files' => [[
					'name' => $fileName,
					'size' => $imageFile->size,
					"url" => $path,
					"thumbnailUrl" => $path,
					"deleteUrl" => 'image-delete?name=' . $fileName,
					"deleteType" => "POST"
				]]
			]);
		}
	}
	return '';
}

public function actionImageDelete($name)
{
	$directory = \Yii::getAlias('@frontend/web/img/temp') . DIRECTORY_SEPARATOR . Yii::$app->session->id;
	if (is_file($directory . DIRECTORY_SEPARATOR . $name)) {
		unlink($directory . DIRECTORY_SEPARATOR . $name);
	}
	$files = FileHelper::findFiles($directory);
	$output = [];
	foreach ($files as $file){
		$path = '/img/temp/' . Yii::$app->session->id . DIRECTORY_SEPARATOR . basename($file);
		$output['files'][] = [
			'name' => basename($file),
			'size' => filesize($file),
			"url" => $path,
			"thumbnailUrl" => $path,
			"deleteUrl" => 'image-delete?name=' . basename($file),
			"deleteType" => "POST"
		];
	}
	return Json::encode($output);
}

请查阅 jQuery File Upload 文档 了解更多配置选项。

测试

$ ./vendor/bin/phpunit

贡献

请参阅 CONTRIBUTING 了解详细信息。

鸣谢

• Antonio Ramirez
• Alexander Kochetov
• 所有贡献者

许可

BSD 许可证 (BSD)。有关更多信息，请参阅 许可文件。

网络开发从未如此有趣
www.2amigos.us