neoacevedo/yii2-storage

Gestión de almacenamiento para Yii2.

Installs: 235

Dependents: 0

Suggesters: 0

Type:yii2-extension

18.12.28 2018-12-28 19:59 UTC

README

Latest Stable Version Total Downloads Latest Unstable Version License Monthly Downloads Daily Downloads

Gestión de almacenamiento para Yii2.

Instalación

La forma preferida de instalar esta extensión es a través de composer.

Luego ejecute

php composer.phar require --prefer-dist neoacevedo/yii2-storage

o agregue

"neoacevedo/yii2-storage": "^18.08"

a la sección require de su archivo composer.json.

Uso

Una vez que la extensión está instalada, configure las credenciales para el servicio de almacenamiento en el archivo de configuración de su aplicación Yii :

<?php

'components' => [
	/**
	 * Amazon S3
	 */ 
	'storageAWS' => [
	    'class' => 'neoacevedo\yii2\Storage',
	    'service' => 's3',
	    'config' => [
	        'key' => 'YOUR_IAM_ACCESS_KEY',
	        'secret' => 'YOUR_IAM__SECRET_ACCESS_KEY',
	        'bucket' => 'your-bucket',
	        'region' => 'your-region',
	        'extensions' => 'pdf, jpg, jpeg, gif, png, bmp'
	    ],
	    'prefix' => '', // ruta al directorio de imágenes. Ej: images/ (Opcional)
	]


	/**
	 * Azure Storage Blob
	 */
	'storageAzure' => [
	    'class' => 'neoacevedo\yii2\Storage',
	    'service' => 'azure',
	    'config' => [
	        'accountName' => 'ACCOUNT_NAME',
	        'accountKey' => 'ACCOUNT_KEY',
	        'container' => 'your-container',
	        'extensions' => 'pdf, jpg, jpeg, gif, png, bmp'
	    ],
	    'prefix' => '' // ruta al directorio de imágenes. Ej: images/ (Opcional)
	]

	/**
	 * Google Storage Cloud
	 */
	'storageGoogle' => [
	    'class' => 'neoacevedo\yii2\Storage',
	    'service' => 'gsc',
	    'config' => [
	        'projectId' => 'YOUR_PROJECT_ID',
	        'bucket' => 'your-bucket'
	        'keyFile' => '', // Contenido del archivo JSON generado en la consola de Google
	        'extensions' => 'pdf, jpg, jpeg, gif, png, bmp'
	    ],
	    'prefix' => '', // ruta al directorio de imágenes. Ej: images/ (Opcional)
	]

	/**
	 * Almacenamiento local
	 */ 
	'storageLocal' => [
	    'class' => 'neoacevedo\yii2\Storage',
	    'service' => 'local',
	    'config' => [
	        'baseUrl' => Yii::$app->request->hostInfo, // ej: http://example.com/
	        'directory' => '@webroot/web/uploads/', // reemplace @webroot por @frontend o @backend según sea el caso. La ruta debe terminar con una barra diagonal
	        'extensions' => 'pdf, jpg, jpeg, gif, png, bmp'
	    ],
	    'prefix' => '', // ruta al directorio de imágenes. Ej: images/ (Opcional) (Opcional)
]

Ahora puede llamarlo desde su aplicación :

/**
 * Sube el archivo de imagen.
 * @param yii\web\UploadedFile $imageFile
 * @return boolean
 */
public function upload($imageFile)
{
    if (null !== $imageFile) {
        Yii::$app->storage->uploadedFile = $imageFile;
        return Yii::$app->storage->save();
    } else {
        return false;
    }
}

...
// obtener la URL generada
echo Yii::$app->storage->getUrl(Yii::$app->storage->prefix.$model->image_file); 

O simplemente en su código :

<?php 
use neoacevedo\yii2\Storage;

public function upload()
{
	$storage = new Storage([
		'service' => Storage::AWS_S3,
		'config' => [
			'key' => 'YOUR_IAM_ACCESS_KEY',
			'secret' => 'YOUR_IAM_SECRET_ACCESS_KEY',
			'bucket' => 'your-bucket',
			'region' => 'your-region',
			'extensions' => 'pdf, jpg, jpeg, gif, png, bmp'
		],
		'prefix' => '' // opcional
	]);
	
	$storage->uploadedFile = \yii\web\UploadedFile::getInstanceByName("file");
	return $storage->save();
}

Puede usar el modelo del componente en su formulario de las siguientes maneras en su controlador:

...
// Constructor de clase
	$storage = new Storage([
		'service' => Storage::AWS_S3,
		'config' => [
			'key' => 'YOUR_IAM_ACCESS_KEY',
			'secret' => 'YOUR_IAM_SECRET_ACCESS_KEY',
			'bucket' => 'your-bucket',
			'region' => 'your-region',
			'extensions' => 'pdf, jpg, jpeg, gif, png, bmp'
		],
		'prefix' => '' // opcional
	]);
	return $this->render('create', [
                'model' => $model,
                'fileModel' => $storage->getModel()
    ]);	
...
// Como componente
	return $this->render('create', [
                'model' => $model,
                'fileModel' => Yii::$app->storage->getModel()
    ]);
...
// Usando el modelo de manera directa
	return $this->render('create', [
                'model' => $model,
                'fileModel' => new neoacevedo\yii2\storage\models\FileManager()
    ]);

Dentro de la vista:

<?= $form->field($fileModel, 'uploadedFile')->fileInput() ?>