Обзор дополнения CFile

Мы постоянно совершенствуем свои приложения позволяя пользователям загружать свои документы, аватарки и др. Хочешь упростить все эти функции? Читай обзор нового Yii дополнения!

Вчера пользователь idle опубликовал расширения для упрощения работы с файлами. Теперь вы можете легко изменять права на файл (chmod), проверять его существование, копировать и многое другое!

Доступные свойства:

1. exists
2. readable (доступно с версии 0.2)
3. writeable  (доступно с версии 0.2)
4. realpath
5. basename
6. filename
7. dirname
8. extension
9. mimeType
10. timeModified
11. size
12. owner (может быть установлено)
13. group (может быть установлено)
14. permissions (может быть установлено)

Доступные методы:

1. Copy
2. Create (доступно с версии 0.2)
3. Contents (чтение & запись, доступно с версии 0.2)
4. Rename/Move
5. Delete

Установка

Подключение дополнения CFile ничем не отличается от подключения остальных.

1. Первым делом заходим на страницу http://www.yiiframework.com/extension/cfile/ (во вкладку Download) и загружаем последнюю версию
2. Распакуйте архив в папку protected/extensions/file вашего Yii приложения
3. Откройте конфигурационный файл (по умолчанию config/main.php) и добавляем туда:
   

    'components'=>array(
       ...
       'file'=>array(
           'class'=>'application.extensions.file.CFile',
       ),
       ...
   ), 

Теперь Вы можете получить доступ к методам CFile следующим образом:

 $myfile = Yii::app()->file->set('files/test.txt', true);
/* 
  Мы используем метод set() для связки объекта CFile с файлом.
  Первый парраметр в set() - 'files/test.txt' - это путь к фалу (мы используем относительный путь, который автоматически преобразуется в реальный /var/www/htdocs/files/test.txt).
  Второй параметр в set() - значение true - требует получить все свойства файла в самом начале (вы можете не использовать этот параметр если вам не нужны все свойства)
  $myfile содержит объект CFile, давайте посмотрим что у нас там:
*/
var_dump($myfile); // дамп обьекта со всеми свойствами

echo $myfile->size; // можем получить свойство

$myfile->permissions=755; // или установить его

$mynewfile = $myfile->copy('files/test2.txt'); // или проводить манипуляции с файлом (к примеру, копировать его). теперь $mynewfile содержит новый обьект CFile

/* Вы можете использовать такой подход тоже */
if (Yii::app()->file->set('files/test3.txt')->exists)
echo 'Все окей!';
else
echo 'Ошибка(('; 

Более детальное описание всех методов и свойств автор рекомендует посмотреть в исходном коде самого класса.

Примеры использования кода были взяты из официальной документации дополнения.