README

用于文件上传和模型附加的扩展

演示

您可以在 krajee 网站上查看演示

安装

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

运行以下命令之一
```
php composer.phar require mazpaijo/yii2-attachments-aws "~1.0.0"
```
或将以下内容添加到您的 composer.json 文件的 require 部分。
```
"mazpaijo/yii2-attachments-aws": "~1.0.0"
```
将模块添加到 common/config/main.php

应用迁移

'modules' => [
	...
	'attachments-aws' => [
		'class' => mazpaijo\attachmentsAws\Module::className(),
		'tempPath' => '@app/uploads/temp',
		'storePath' => '@app/uploads/store',
		'rules' => [ // Rules according to the FileValidator
		    'maxFiles' => 10, // Allow to upload maximum 3 files, default to 3
			'mimeTypes' => 'image/png', // Only png images
			'maxSize' => 1024 * 1024 // 1 MB
		],
		'tableName' => '{{%attachments-aws}}' // Optional, default to 'attach_file'
	]
	...
]

将附件行为附加到您的模型（请确保您的模型具有 "id" 属性）

	'controllerMap' => [
	...
	'migrate' => [
		'class' => 'yii\console\controllers\MigrateController',
		'migrationNamespaces' => [
			'mazpaijo\attachmentsAws\migrations',
		],
	],
	...
	],

php yii migrate/up

确保您已在模块规则中指定了 maxFiles，并在 AttachmentsInput 中指定了 maxFileCount 到您想要的数字

public function behaviors()
{
	return [
		...
		'fileBehavior' => [
			'class' => \mazpaijo\attachmentsAws\behaviors\FileBehavior::className()
		]
		...
	];
}

确保您已将 'enctype' => 'multipart/form-data' 添加到 ActiveForm 选项中
确保您在模块规则中指定了 maxFiles，并在 AttachmentsInput 中指定了 maxFileCount 到您想要的数字

使用方法

在您的模型的 form.php 中添加文件输入

<?= \mazpaijo\attachmentsAws\components\AttachmentsInput::widget([
	'id' => 'file-input', // Optional
	'model' => $model,
	'options' => [ // Options of the Kartik's FileInput widget
		'multiple' => true, // If you want to allow multiple upload, default to false
	],
	'pluginOptions' => [ // Plugin options of the Kartik's FileInput widget 
		'maxFileCount' => 10 // Client max files
	]
]) ?>

在 view.php 中使用小部件显示模型的全部 attachments-aws

<?= \mazpaijo\attachmentsAws\components\AttachmentsTable::widget(['model' => $model]) ?>

(已弃用) 在提交按钮上添加 onclick 动作，在提交表单之前上传所有文件

<?= Html::submitButton($model->isNewRecord ? 'Create' : 'Update', [
	'class' => $model->isNewRecord ? 'btn btn-success' : 'btn btn-primary',
	'onclick' => "$('#file-input').fileinput('upload');"
]) ?>

您可以通过调用 $model->files 来获取所有附件文件，例如
```
foreach ($model->files as $file) {
    echo $file->path;
}
```

变更日志

2016 年 12 月 7 日 - 迁移命名空间随 Yii 2.0.10 一起发布。版本 1.0.0-beta.3。
2016 年 4 月 19 日 - 重新设计和测试。Ajax 移除。版本 1.0.0-beta.2。
2015 年 8 月 17 日 - 支持表前缀 - 在迁移前可以指定表名
2015 年 7 月 9 日 - 修复自动提交表单
2015 年 6 月 19 日 - 修复仅上传文件而不提交整个表单以及忽略上传错误提交表单的问题
2015 年 5 月 1 日 - 修复连接缓慢或上传时间长时的上传问题。现在提交按钮上的 onclick 事件已弃用
2015 年 4 月 16 日 - 允许用户拥有一个继承自 FileBehavior 的自定义行为类
2015 年 4 月 4 日 - 现在所有临时上传的文件将在每次打开新表单时被删除
2015 年 3 月 16 日 - 修复：生成初始预览时的错误。添加：通过调用 $file->path 来获取附件文件的路径。
2015 年 3 月 5 日 - 修复：最大上传文件数量的限制。
2015 年 3 月 4 日 - 添加最大上传文件数量的限制。
2015 年 3 月 3 日 - 修复文件输入小部件的 id。
2015 年 2 月 13 日 - 添加对文件的限制（请参阅使用方法部分的第一点），现在在表单视图中使用 AttachmentsInput 小部件而不是 FileInput
2015 年 2 月 11 日 - 添加上传但尚未保存的文件的预览和 tableOptions 小部件属性
2015 年 2 月 2 日 - 修复：所有附件文件将与模型一起删除。
2015 年 2 月 1 日 - AJAX 或基本上传。
2015 年 1 月 30 日 - 几个图像和其他文件的预览，修复所需软件包。
2015 年 1 月 29 日 - 第一个版本，具有基本上传和预览功能。

mazpaijo / yii2-attachments-aws

维护者

详细信息

README

演示

安装

使用方法

变更日志