Meelky Blog

Під час створення одного з проектів, в мене виникла ідея створення декількох поведінок для того, щоб зробити своє життя легшим. Але як завжди, після того як я пройшовся по пекарні виявилось що добрі дядьки вже це зробили.
Далі я розповім вам про те, як використовувати поведінку для автоматичного завантаження файлів на сервер, і запису шляху до завантаженого файлу в таблицю.

Як завжди, все дуже просто. Використовуємо MeioUpload Behavior написаний Vinicius Brandao Mendes.

Поведінка дозволяє завантажити будь-який файл. Після того, як файл буде завантажено, його ім?я буде записано в поле таблиці. Окрім того, він підтримує валідацію типів файлів (включаючи MIME тип), розмірів, тощо.

Використання:

1. Завантажуємо meio_upload.php і кидаємо в app/models/behaviors
2. Якщо маєте бажання використовувати зменьшенні копії, то встановить ще компонент phpThumb
3. Додайте до таблиці поле типу varchar. Наприклад:
^?View Code SQL

CREATE TABLE `products` ( `id` int(8) unsigned NOT NULL auto_increment, `name` varchar(255) default NULL, `description` text default NULL, `price` double default NULL, `picture` varchar(255) default NULL, `dir` varchar(255) default NULL, `mimetype` varchar(255) NULL, `filesize` int(11) unsigned default NULL, `created` datetime default NULL, `modified` datetime default NULL, PRIMARY KEY (`id`) ) ENGINE=MyISAM DEFAULT CHARSET=utf8;

4. Додайте поведінку до моделі
^?View Code PHP

var $actsAs = array( 'MeioUpload' => array( 'picture' => array( 'dir' => 'img{DS}{model}{DS}{field}', 'create_directory' => true, 'allowed_mime' => array('image/jpeg', 'image/pjpeg', 'image/png'), 'allowed_ext' => array('.jpg', '.jpeg', '.png'), 'default' => 'default.jpg', ) ) );

5. Використовуєм хелпер form і додаємо в вид поле picture:
^?View Code PHP

echo $form->input('picture', array('type' => 'file'));

6. Обов?язково використовуйте форму типу multipart/form-data, наприклад так:
^?View Code PHP

echo $form->create('Product',array('type' => 'file'));

7. Це все, зображення завантаженно. Не забудьте перевірити права доступу до директорії, а також максимально дозволений розмір файлу для завантаження в php.ini

Опції

Як відомо під час ініціалізацї поведінки можна задавати додаткові опції.

1. dir – тут можна вказати шлях для завантаження файлів. Він буде знаходитись всередині /app/webroot. Наприклад, якщо ви вказали шлях “imgs”, то він буде знаходитись в /app/webroot/imgs/
2. allowed_mime – дозволяє вибрати які типи MIME можна буде завантажити. Наприклад таке:
^?View Code PHP

var $actsAs = array( 'picture' => array( 'allowed_mime' => array('image/jpeg', 'image/pjpeg', 'image/png') ) );

3. allowed_ext - теж саме, тільки перевіряється розширення
^?View Code PHP

var $actsAs = array( 'picture' => array( 'allowed_ext' => array('.jpg', '.jpeg', '.png') ) );

4. create_directory - чи треба створювати діректорію, якщо вона не існує. Дефолтне значення – True
5. default - файл, що встановлюється, якщо нічого не було завантаженно
6. fields - встановлює відповідність полів таблиці з інормацією про файл. Можна зберегти ім?я файла, розмір і шлях.
^?View Code PHP

var $actsAs = array( 'picture' => array( 'fields' => array( 'filesize' => 'picture_filesize', 'mimetype' => '{field}_mimetype', 'dir' => 'pictures_folder' ) ) );

Ви можете помітити, що {field} буде замінено на ім?я файла.

Валідація

1. FieldName - перевіряє чи поле в таблиці вже підготовлено
2. Dir - перевіряє чи існує шлях. Залежить від опції create_directory
3. Empty - перевіряє чи поле пусте
4. UploadError - перевіряє чи була помилка під час завантаження
5. MaxSize - перевіряє чи файл меньший за максимальний розмір
6. InvalidMime -перевіряє чи файл має вірний тип MIME
7. InvalidExt - перевіряє чи файл має вірне розширення

Ось приклади. Перевірка на вірне розширення, а також валідатор Empty віключено (check=>false)

var $validate = array(
	'picture' => array(
		'Empty' => array(
			'check' => false
		),
		'InvalidExt => array(
			'message' => 'Файл такого типу не дозволено завантажувати'
		)
	)
);

Як видалити файл?

Якщо переслати в формі не пусте поле data[Model][field][remove], поведінка автоматично видалить файл. Наприклад можна використовувати чекбокс:

echo $form->input('Product.picture.remove', array('type' => 'checkbox'));

UPD: Зменшені копії

Окрім основної функціональності, поведінка за допомогою компонента phpThumb дозволяє створювати зменшені копії зображення. Наприклад в такий спосіб:

    var $actsAs = array(
	'MeioUpload' => array(
                                { ... }
				'thumbsizes' => array(
					'smalled' => array('width'=>50, 'height'=>50),
					'original' => array('width'=>100, 'height'=>100),
				),
			)
		)
	);

Зверніть увагу на массив thumbsizes. Він вказує на розміри зображень яки будуть завантажені. Елемент під назвою “original” вказує на розмір, до якого буде зменшено оригінальне зображення, а усі інші створять копії. В цьому прикладі копія матиме назву thumb.smalled.{ІМ?Я_ФАЙЛУ}.