yii2-extension yii2-storage {🖫 33, ⚐ 15, ★ 0}

snewer/yii2-storage

Monday, July 2, 2018
by Snewer
Repository
1 Watchers
0 Stars
33 Installations

PHP
1 Dependents
0 Suggesters
0 Forks
0 Open issues
15 Versions
43 % Grown

The README.md

Установка

Компонент распространяется как composer пакет и устанавливается командой, _(*1)

php composer.phar require snewer/yii2-storage

или добавлением, _(*2)

"snewer/yii2-storage": "*"

в composer.json файл проекта., _(*3)

Настройка

Задача компонента — предоставление интерфейса для реализации хранилищ и их использование., _(*4)

Компонент имеет только одно свойство buckets, в котором необходимо указать массив конфигураций хранилищ., _(*5)

Важно! Ключами массива являются названия хранилищ, по которым в дальнейшем получается экземпляр хранилища., _(*6)

Пример подключения компонента в проект:, _(*7)

[
    // ...
    'components' => [
        //...
        'storage' => [
            'class' => 'snewer\storage\StorageManager',
            'buckets' => []
        ],
        //...
    ],
    // ...
]

\ Под хранилищем понимается реализация интерфейса абстрактного класса snewer\storage\AbstractBucket позволяющая:, _(*8)

загрузить файл
получить содержимое файла
удалить файл
получить web ссылку на файл

из какой-либо системы (например, файловой) или какого-либо сервиса (например, Amazon AWS)., _(*9)

Таким образом, для реализации хранилища необходимо унаследоваться от абстрактного класса, _(*10)

snewer\storage\AbstractBucket

\ "Из коробки" доступен драйвер для локальной файловой системы, _(*11)

snewer\storage\drivers\FileSystemDriver

который имеет следующие свойства:, _(*12)

Свойство	Тип	Обятательное	Значение по-умолчанию	Описание
basePath	string	Да	Нет	Папка в файловой системе, куда будут загружаться файлы.
baseUrl	string \| array	Нет	Нет	Url до папки загрузок. Можно указать массив из нескольких путей. Тогда для каждого файла будет равномерно и однозачно выбран один из путей. *
depth	int	Нет	3	Количество подпапок, создаваемое в загрузочной директории.

* Браузеры имеют лимит на одновременное подключение к серверу. Для преодоления лимита можно использовать различные домены, указывающие на один и тот же каталог., _(*13)

\ Пример настройки компонента с использованием хранилищ:, _(*14)

[
    // ...
    'components' => [
        //...
        'storage' => [
            'class' => 'snewer\storage\StorageManager',
            'buckets' => [
                'images' => [
                    'class' => 'snewer\storage\drivers\FileSystemDriver',
                    'basePath' => '@frontend/web/uploads/images/',
                    'baseUrl' => '@web/uploads/images/',
                    'depth' => 4
                ],
                'documents' => [
                    'class' => 'snewer\storage\drivers\FileSystemDriver',
                    'basePath' => '@frontend/web/uploads/documents/',
                    'baseUrl' => '@web/uploads/documents/',
                    'depth' => 4
                ],
                // ...
            ]
        ],
        //...
    ],
    // ...
]

Использование

После настройки компонента использовать хранилище можно как через методы компонента, так и обращаясь непосредственно к объекту хранилища., _(*15)

Пример реализации методов загрузки изображения и получения URL ссылки на него в модели изображения вашего проекта app\models\Image:, _(*16)

public static function upload($imageBinary)
{
    $path =  Yii::$app->storage->upload('images', $imageBinary, 'jpg');
    $model = new self;
    $model->path = $path;
    $model->save();
    return $model;
}

Далее, в той же модели, добавим метод получения ссылки на изображение:, _(*17)

public function getUrl()
{
    return Yii::$app->storage->getUrl('images', $this->path);
}

После чего можно загружать изображения следующим образом:, _(*18)

$image = app\models\Image::upload($imageBinary);

и выводить изображение в каком-либо представлении:, _(*19)

<img src="<?= $image->url ?>">

\ Пример реализации тех же методов с использованием объектов хранилищ:, _(*20)

public static function upload($imageBinary)
{
    $path = Yii::$app->storage->images->upload($imageBinary, 'jpg');
    $model = new self;
    $model->path = $path;
    $model->save();
    return $model;
}

public function getUrl()
{
    return Yii::$app->storage->images->getUrl($this->path);
}

\ Стоит заметить, что реализация метода getUrl не зависит от названия хранилища. То есть в рамках одной и той же модели можно организовать сложную логику хранения файлов в различных хранилищах и легким управлением ими., _(*21)

The Versions

02/07 2018

dev-master

9999999-dev

yii2-extension yii2-storage

snewer/yii2-storage

The README.md

Установка

Настройка

Использование

The Versions

dev-master

The Requires

by Kirill Kasyanov

3.0.2

The Requires

by Kirill Kasyanov

3.0.1

The Requires

by Kirill Kasyanov

3.0.0

The Requires

by Kirill Kasyanov

v2.0.1

The Requires

by Kirill Kasyanov

2.0.1

The Requires

by Kirill Kasyanov

v2.0.0

The Requires

by Kirill Kasyanov

2.0.0

The Requires

by Kirill Kasyanov

v1.0.1

The Requires

by Kirill Kasyanov

1.0.1

The Requires

by Kirill Kasyanov

v1.0

The Requires

by Kirill Kasyanov

1.0

The Requires

by Kirill Kasyanov

v0.1.2

The Requires

v0.1.1

The Requires

v0.1

The Requires