YiiFramework.ru

YiiTalk, эпизод 4

sam@rmcreative.ru (Alexander Makarov) — Tue, 21 Feb 2012 17:12:28 +0000

Эпизоды подкаста про Yii — YiiTalk выходят как горячие пирожки. Участвуют Юрий Беляков и Максим Фуртуна, известный сообществу как Ekstazi.

YiiTalk, эпизод 3

sam@rmcreative.ru (Alexander Makarov) — Fri, 17 Feb 2012 20:20:13 +0000

И ещё один выпуск подкаста про Yii — YiiTalk. Участвуют Юрий Беляков и Константин Перминов.

Yii переехал на GitHub

sam@rmcreative.ru (Alexander Makarov) — Wed, 15 Feb 2012 20:35:56 +0000

Yii официально целиком и полностью переехал на GitHub. Перенесён весь код с полной историей, а также трекер со всеми тикетами.

Очень многие об этом просили и команда Yii думает, что это верный ход, который позволит сообществу в полной мере участвовать в разработке фреймворка и ускорить темпы его развития.

Все кто использует SVN могут не волноваться. Ничего не отвалится. Код будет синхронизоваться с SVN каждые сутки.

p.s. если что-то прошло не совсем гладко и вы это заметили, не стесняйтесь, пишите.

Yii 1.1.10

sam@rmcreative.ru (Alexander Makarov) — Mon, 13 Feb 2012 09:11:22 +0000

Вышел релиз 1.1.10. В данной версии, в основном, исправлены ошибки в CActiveForm, CJuiDatePicker и невозможность запуска с yiilite.php.

YiiTalk, эпизод 2

sam@rmcreative.ru (Alexander Makarov) — Tue, 24 Jan 2012 19:44:24 +0000

Вышел первый полноценный эпизод YiiTalk, русскоязычного подкаста про Yii.

В гостях разработчик ядра Yii Александр Макаров, известный также под ником SamDark. Говорим об Александре, Yii и программировании в целом.

Слушаем на podfm или на rpod

Yii 1.1.9

sam@rmcreative.ru (Alexander Makarov) — Sun, 01 Jan 2012 05:08:37 +0000

Вышла стабильная версия Yii 1.1.9. В данном релизе около 60 улучшений и исправленных ошибок.

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

Русскоязычная документация, как обычно, находится в полностью актуальном состоянии. Кроме того, поправлены все найденные на момент релиза опечатки. Спасибо всем, кто использует Orphus на yiiframework.ru.

Рассмотрим наиболее интересные изменения.

Более удобный способ определения `through` в отношениях ActiveRecord

Опция though была добавлена в версии 1.1.7, но синтаксис был не слишком удобен, так что было решено сделать его более явным. В текущей версии используется следующий синтаксис:

'comments'=>array(self::HAS_MANY,'Comment',array('key1'=>'key2'),'through'=>'posts'),

В приведённом выше array('key1'=>'key2'):

key1 является ключом, определённым в отношении, котрое указано в through (в нашем случае это posts).
key2 является ключом, определённым в модели, на которую указывает отношение (в нашем случае это Comment).

through можно использовать как для HAS_ONE, так и для HAS_MANY.

Подробнее данная возможность описана в разделе Реляционная Active Record полного руководства.

Поддержка групп условий в Model::relations()

Теперь можно использовать группы условий при определении отношений модели:

'recentApprovedComments'=>array(self::BELONGS_TO, 'Post', 'post_id', 
    'scopes' => array('approved', 'recent')),

При использовании лишь одной группы условий её можно указать как строку.

Возможность сделать JOIN между моделями по заданным ключам

В данной версии стало возможым создание отношений по заданной паре PK->FK не опираясь на схему данных. Это означает, что можно, например, задать следующее отношение для модели Day:

'jobs'=>array(self::HAS_MANY, 'Job', array('date' => 'target_date')),

В данном случае Day может содержать несколько Jobов. При этом они не связаны привычным образом. Мы задали ключ в виде array('fk'=>'pk'), то есть на выходе мы получим SQL вроде

SELECT * FROM day t
JOIN job ON t.date = job.target_date

Возможность перекрыть классы ядра при помощи Yii::$classMap

Начиная с 1.1.5 в Yii была возможность заранее импортировать классы и использовать их без явного импорта или include. Теперь используя тот же самый подход можно перекрыть классы ядра.

Обновлены архивы расширений yiiext

sam@rmcreative.ru (Alexander Makarov) — Sat, 23 Jul 2011 12:48:14 +0000

Обновлены следующие расширения:

activeFormValidation 0.4
blueprint 0.2
ensureNull 1.0.1
fileUpload 0.3
form 0.5
imperaviRedactor 0.3
smarty 0.9.9
taggable 1.5
trees 1.4
twig 0.9.4
zendAutoloader 1.1.1

Обновляемся

CHM-версии документации для 1.1.8

sam@rmcreative.ru (Alexander Makarov) — Sun, 26 Jun 2011 21:08:52 +0000

Оформление документа и ошибки можно обсудить на форуме.

Yii 1.1.8

sam@rmcreative.ru (Alexander Makarov) — Sun, 26 Jun 2011 20:08:38 +0000

Вышел релиз Yii 1.1.8, включающий более 80 багфиксов, новых возможностей и улучшений. Огромное спасибо тем, кто репортил баги, предлагал новые фичи и использовал по назначению Orphus на yiiframework.ru.

Забрать свежий дистрибутив можно с официального сайта.

Инструкции по обновлению можно почитать в UPGRADE.

Полный список изменений, как обычно, можно прочитать в CHANGELOG, мы же бегло рассмотрим самое интересное.

Свои классы для правил URL

Для сложной работы с URL, с которой не может справится стандартный класс CUrlRule (например, когда часть URL зависит от значений в базе данных), можно написать свои классы для обработки URL и использовать их в конфигурации CUrlManager:

array(
    // стандартное правило '/login' → 'site/login' и т.д.
    '<action:(login|logout|about)>' => 'site/<action>',
 
    // нестандартное правило для '/Производитель/Модель'
    array(
        'class' => 'application.components.CarUrlRule',
        'connectionID' => 'db',
    ),
 
    // стандартное правило для 'post/update'
    '<controller:\w+>/<action:\w+>' => '<controller>/<action>',
),

Сам класс при этом наследуется от CBaseUrlRule и выглядит примерно так:

class CarUrlRule extends CBaseUrlRule
{
    public $connectionID = 'db';
 
    public function createUrl($manager,$route,$params,$ampersand)
    {
        if ($route==='car/index')
        {
            if (isset($params['manufacturer'], $params['model']))
                return $params['manufacturer'] . '/' . $params['model'];
            else if (isset($params['manufacturer']))
                return $params['manufacturer'];
        }
        return false;  // не применяем правило
    }
 
    public function parseUrl($manager,$request,$pathInfo,$rawPathInfo)
    {
        if (preg_match('%^(\w+)(/(\w+))?$%', $pathInfo, $matches))
        {
            // совпадают ли $matches[1] и $matches[3] с
            // производителем и моделью в базе?
            // если да, выставляем $_GET['manufacturer'] и/или $_GET['model']
            // и возвращаем 'car/index'
        }
        return false;  // не применяем правило
    }
}

Улучшенный автозагрузчик классов

В Yii уже есть загрузчик классов, подключающий их как только они потребуются. Теперь он не конфликтует со сторонними загрузчиками и может выполняться как до них, так и после. В предыдущих версиях он всегда выполнялся после сторонних автозагрузчиков, что приводило к лишним вызовам при использовании классов Yii:

// По умолчанию сторонний загрузчик регистрируется до загрузчика Yii
Yii::registerAutoloader($autoloader);

Теперь можно делать так:

// При передаче true вторым параметром сторонний автозагрузчик добавляется после загрузчика Yii
Yii::registerAutoloader($autoloader, true);

По умолчанию автозагрузчик Yii использует PHP include path. Для некоторых хостингов это является проблемой, решить которую можно немного поправив index.php:

require('path/to/yii.php');
// отключаем PHP include path
Yii::$enableIncludePath = false;
Yii::createWebApplication($config)->run();

Логирование в режиме реального времени

Некоторые консольные приложения могут работать очень долго. Для них полезно писать сообщения в лог сразу, а не ждать завершения приложения:

// автоматически передаём каждое сообщение роутеру лога
Yii::getLogger()->autoFlush = 1;
// автоматически пишем сообщения при получении логгером
Yii::getLogger()->autoDump = true;

Работаем со счётчиками в БД через AR

В классе CActiveRecord появился новый метод saveCounters(), похожий на существующий CActiveRecord::updateCounters(). Главное отличие — saveCounters() работает только с текущим объектом в то время как updateCounters() работает со всей таблицей:

$post = Post::model()->findByPk(1);
// наращиваем количество просмотров поста
$post->saveCounters(array('views'=>1));
// то же для прошлый версий
Post::model()->updateCounters(array('views'=>1), 'id=1');

Генерация файлов переводов

При использовании yiic message часто приходилось удалять старый файл и заменять его новым, который генерировался рядом. Теперь можно писать сразу в старый файл, если выставить в конфигурации команды опцию overwrite в true.

Создание URL в консольных приложениях

В веб-приложениях для генерации URL обычно используется CUrlManager, который ранее не был доступен консольным приложениям. Теперь и в веб-приложениях и в консольных можно пользоваться Yii::app()->createUrl(), что очень удобно, например, для построения sitemap, в котором перечисляются URL веб-приложения.

В clips теперь можно использовать параметры

Это полезно в том случае, когда кусок кода в view повторяется много раз, но он недостаточно сложен для выноса его в отдельный файл:

<?php // определяем clip ?>
<?php $this->beginClip('hello')?>
<p>Привет, {username}!</p>
<?php $this->endClip() ?>
 
<?php // используем clip ?>
<?php $this->renderClip('hello',array(
    '{username}'=>'Qiang',
))?>
<?php $this->renderClip('hello',array(
    '{username}'=>'Alex',
))?>
<?php $this->renderClip('hello',array(
    '{username}'=>'Michael',
))?>

Yii 1.1.7

sam@rmcreative.ru (Alexander Makarov) — Tue, 29 Mar 2011 09:42:11 +0000

На днях вышел релиз 1.1.7 PHP-фреймворка Yii, в который было включено более 90 исправленных ошибок, улучшений и новых возможностей.

Полный список изменений доступен на сайте фреймворка, самые вкусные из которых мы рассмотрим ниже.

Поддержка URL в стиле REST

Теперь при использовании CUrlManager можно указать метод (GET, POST, PUT и т.д.) в свойстве verb правила URL. К примеру, приведённые ниже правила GET-запрос на post/123 будет обрабатываться действием post/view, а PUT или POST на post/123 — действием post/update.

return array(
    'components'=>array(
        'urlManager'=>array(
            'urlFormat'=>'path',
            'rules'=>array(
                array('<controller>/view', 'pattern'=>'<controller:\w>/<id:\d+>', 'verb'=>'GET'),                
                array('<controller>/update', 'pattern'=>'<controller:\w>/<id:\d+>', 'verb'=>'PUT, POST'),
            ),
        ),
    ),
);

Получить данные PUT и DELETE можно при помощи методов CHttpRequest::getPut() и CHttpRequest::getDelete().

Кэширование запросов

При кэшировании запроса его результат сохраняется в кэш и, в случае повторного запроса берётся оттуда напрямую.

Кэширование запросов реализовано как для DAO, так и для AR. Несколько примеров:

// кэшируем результат выполнения $sql на 1000 секунд или пока не обновится tbl_post
$sql = 'SELECT * FROM tbl_post LIMIT 20';
$dependency = new CDbCacheDependency('SELECT MAX(update_time) FROM tbl_post');
$rows = Yii::app()->db->cache(1000, $dependency)->createCommand($sql)->queryAll();
 
// то же, но для AR
$posts = Post::model()->cache(1000, $dependency)->findAll();
// query caching with relational AR
$posts = Post::model()->cache(1000, $dependency)->with('author')->findAll();

Привязка параметров для классов действий

В версии 1.1.4 была добавлена поддержка автоматического наполнения параметров для действий контроллера. В этой версии возможность была расширена на действия, описываемые в классах. Пример:

class UpdateAction extends CAction
{
    public function run($id)
    {
        // $id будет заполняться данными из $_GET['id']
    }
}

Прозрачная валидация на клиенте

CActiveForm — мощный виджет, который значительно облегчает создание формы и её валидацию. Раньше он поддерживал только валидацию на стороне сервера и валидацию через AJAX. В данной версии добавлена валидация силами клиента, которая работает быстрее и не нагружает сервер.

Для реализации валидации на клиенте нет необходимости в дополнительном коде. Валидация работает на основе правил модели точно так же, как и валидация на стороне сервера.

Включить валидацию на клиенте можно выставив CActiveForm::enableClientValidation в true:

<?php $form=$this->beginWidget('CActiveForm', array(
    'enableClientValidation'=>true,
)); ?>
 
    <div class="row">
        <?php echo $form->labelEx($model,'username'); ?>
        <?php echo $form->textField($model,'username'); ?>
        <?php echo $form->error($model,'username'); ?>
    </div>
 
    <div class="row">
        <?php echo $form->labelEx($model,'password'); ?>
        <?php echo $form->passwordField($model,'password'); ?>
        <?php echo $form->error($model,'password'); ?>
    </div>
 
    <div class="row buttons">
        <?php echo CHtml::submitButton('Login'); ?>
    </div>
 
<?php $this->endWidget(); ?>

Передача параметров реляционным именованным группам параметров

Теперь можно передавать параметры реляционным именованным группам параметров. К примеру, если имеется группа rated в модели Post, которая принимает параметром минимальный рейтинг записи, можно использовать это из модели User следующим образом:

$users=User::model()->findAll(array(
    'with'=>array(
        'posts'=>array(
            'scopes'=>array(
                'rated'=>5,
            ),
        ),
    ),
));

Использование 'through' с HAS_MANY и HAS_ONE

В Active Record добавлена поддержка опции through, которая позволяет строить отношения, подобные MANY_MANY, но более гибкие, позволяющие получение и использование данных из средней таблицы-моста.

К примеру, можно получить все комментарии для всех пользователей определённой группы.

Больше информации и примеров можно найти в соответствующем разделе руководства.

Использование транзакций в миграциях

При выполнении миграции бывают ситуации, когда часть миграции не применяется и требуется откатить всё, что успело примениться. Хорошее решение данной проблемы — обернуть всю миграцию в транзакцию. Конечно, можно сделать это и напрямую, но использование новой возможности более удобно.

Вместо реализации CDbMigration::up() и CDbMigration::down(), можно использовать CDbMigration::safeUp() и CDbMigration::safeDown(). После этого код будет обёрнут в транзакцию:

class m101129_185401_create_news_table extends CDbMigration
{
    public function safeUp()
    {
        $this->createTable('tbl_news', array(
            'id' => 'pk',
            'title' => 'string NOT NULL',
            'content' => 'text',
        ));
    }
 
    public function safeDown()
    {
        $this->dropTable('tbl_news');
    }
}

Стоит отметить, что не все СУБД поддерживают транзакции.

Регистрация и использование своих пакетов скриптов

CClientScript теперь позволяет зарегистрировать и использовать свои пакеты скриптов. Ранее данная возможность использовалась исключительно для внутренних целей.

Пакет может содержать CSS, JavaScript, изображения и любые другие файлы, которые необходимо показать пользователям. Пакет может зависеть от других пакетов. То есть при регистрации пакета все пакеты, от которых он зависит, регистрируются автоматически.

Работа с пакетами строится следующим образом: сначала в CClientScript::packages описываются нужные пакеты, а затем они регистрируются при помощи CClientScript::registerPackage().