Yii 2 – Все для веб-программиста

Начало

Вторая версия отличается от первой кардинально. Список в краткой форме:

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

— Базовый CComponent разделили на Object и Component. Первый осуществляет работу геттеров и сеттеров, второй расширяя первый, добавляя события и поведения.

— Видоизменилось подключение событий и поведений. Подписываемся на событие

$post-&gt;on(<span class="hljs-string">'update'</span>, <span class="hljs-function"><span class="hljs-keyword">function</span><span class="hljs-params">($event)</span> </span>{
    <span class="hljs-comment">// send email notification</span>
});

$post->on('update', function($event) {

// send email notification

});

Настраиваем компонент

$component = \Yii::createObject(<span class="hljs-keyword">array</span>(
  <span class="hljs-string">'class'</span> =&gt; <span class="hljs-string">'\app\components\GoogleMap'</span>,
  <span class="hljs-string">'apiKey'</span> =&gt; <span class="hljs-string">'xyz'</span>,
  <span class="hljs-comment">// Добавим событие</span>
  <span class="hljs-string">'on eventName'</span> =&gt; <span class="hljs-keyword">array</span>(<span class="hljs-string">'Event'</span>, <span class="hljs-string">'run'</span>),
  <span class="hljs-comment">// Добавим поведение</span>
  <span class="hljs-string">'as behaviorName'</span> =&gt; <span class="hljs-keyword">array</span>(<span class="hljs-comment">/* Behavior config */</span>),
));

$component = \Yii::createObject(array(

'class' => '\app\components\GoogleMap',

'apiKey' => 'xyz',

// Добавим событие

'on eventName' => array('Event', 'run'),

// Добавим поведение

'as behaviorName' => array(/* Behavior config */),

));

— Добавили новый класс View, теперь у нас настоящий MVC фреймворк. Представление

<span class="hljs-meta">&lt;?php</span>
<span class="hljs-keyword">use</span> <span class="hljs-title">yii</span>\<span class="hljs-title">helpers</span>\<span class="hljs-title">base</span>\<span class="hljs-title">Html</span>;
<span class="hljs-comment">/**
 * Обратите внимание $this в представлении это уже не контроллер.
 * Добраться к контроллеру можно $this-&gt;context
 * <span class="hljs-doctag">@var</span> yii\base\View $this
 */</span>
$this-&gt;title = <span class="hljs-string">'Hello world'</span>;
<span class="hljs-meta">?&gt;</span>
&lt;h1&gt;<span class="hljs-meta">&lt;?php</span> <span class="hljs-keyword">echo</span> Html::encode($this-&gt;title); <span class="hljs-meta">?&gt;</span>&lt;/h1&gt;
&lt;p <span class="hljs-class"><span class="hljs-keyword">class</span>="<span class="hljs-title">lead</span>"&gt;Привет мир!&lt;/<span class="hljs-title">p</span>&gt;
</span>

<?php

use yii\helpers\base\Html;

/**

* Обратите внимание $this в представлении это уже не контроллер.

* Добраться к контроллеру можно $this->context

* @var yii\base\View $this

*/

$this->title = 'Hello world';

?>

<h1><?php echo Html::encode($this->title); ?></h1>

class="lead">Привет мир!</p>

* View можно для каждого контроллера устанавливать, или использовать базовый для приложения.

— render() контроллера больше ничего не выводит. Оно возвращает данные

<span class="hljs-keyword">public</span> <span class="hljs-function"><span class="hljs-keyword">function</span> <span class="hljs-title">actionIndex</span><span class="hljs-params">()</span>
</span>{
	<span class="hljs-keyword">echo</span> $this-&gt;render(<span class="hljs-string">'index'</span>);
}

public function actionIndex()

{

echo $this->render('index');

}

— В контроллере появились два события, на котрые можно подписываться: beforeAction, afterAction

<span class="hljs-keyword">public</span> <span class="hljs-function"><span class="hljs-keyword">function</span> <span class="hljs-title">init</span><span class="hljs-params">()</span>
</span>{
  $this-&gt;on(<span class="hljs-string">'beforeAction'</span>, <span class="hljs-function"><span class="hljs-keyword">function</span><span class="hljs-params">($event)</span> </span>{
    <span class="hljs-comment">// отменяем действие</span>
    $event-&gt;isValid = <span class="hljs-keyword">false</span>;
  });
}

public function init()

{

$this->on('beforeAction', function($event) {

// отменяем действие

$event->isValid = false;

});

}

— Убраны фильтры контроллера CFilter, теперь все делается через поведения

<span class="hljs-keyword">public</span> <span class="hljs-function"><span class="hljs-keyword">function</span> <span class="hljs-title">behaviors</span><span class="hljs-params">()</span>
</span>{
  <span class="hljs-keyword">return</span> <span class="hljs-keyword">array</span>(
    <span class="hljs-string">'AccessControl'</span> =&gt; <span class="hljs-keyword">array</span>(
      <span class="hljs-string">'class'</span> =&gt; <span class="hljs-string">'\yii\web\AccessControl'</span>,
      <span class="hljs-string">'rules'</span> =&gt;<span class="hljs-keyword">array</span>(<span class="hljs-comment">/* тут ничего не поменялось */</span>),
    ),
  );
}

public function behaviors()

{

return array(

'AccessControl' => array(

'class' => '\yii\web\AccessControl',

'rules' =>array(/* тут ничего не поменялось */),

);

}

— В контроллере появился отличный помощник — метод populate

<span class="hljs-keyword">public</span> <span class="hljs-function"><span class="hljs-keyword">function</span> <span class="hljs-title">actionLogin</span><span class="hljs-params">()</span>
</span>{
  $model = <span class="hljs-keyword">new</span> LoginForm();
  <span class="hljs-keyword">if</span> ($this-&gt;populate($_POST, $model) &amp;&amp; $model-&gt;login()) {
    Yii::$app-&gt;response-&gt;redirect(<span class="hljs-keyword">array</span>(<span class="hljs-string">'site/index'</span>));
  }

  <span class="hljs-keyword">echo</span> $this-&gt;render(<span class="hljs-string">'login'</span>, <span class="hljs-keyword">array</span>(
    <span class="hljs-string">'model'</span> =&gt; $model,
  ));
}

public function actionLogin()

{

$model = new LoginForm();

if ($this->populate($_POST, $model) && $model->login()) {

Yii::$app->response->redirect(array('site/index'));

}

echo $this->render('login', array(

'model' => $model,

));

}

— Добавлены еще несколько статических классов-хелперов: ArrayHelper, StringHelper, SecurityHelper. Все хелперы теперь можно перекрыть через LSB. Ура, воскликнул я, т.к лично мне не раз нужно было перекрытьHtml.

— Виджет ActiveForm тоже переписан, и скорее всего заменит форм-билдер CForm. Каждое поле формы теперь может быть представлено как объект ActiveField, который создает ActiveForm

$form = $this-&gt;beginWidget(<span class="hljs-string">'yii\widgets\ActiveForm'</span>, <span class="hljs-keyword">array</span>(
  <span class="hljs-string">'options'</span> =&gt; <span class="hljs-keyword">array</span>(<span class="hljs-string">'class'</span> =&gt; <span class="hljs-string">'form-horizontal'</span>)
));

  <span class="hljs-keyword">echo</span> $form-&gt;field($model, <span class="hljs-string">'username'</span>)-&gt;textInput(); 
  <span class="hljs-keyword">echo</span> $form-&gt;field($model, <span class="hljs-string">'password'</span>)-&gt;passwordInput(); 
  <span class="hljs-keyword">echo</span> $form-&gt;field($model, <span class="hljs-string">'rememberMe'</span>)-&gt;checkbox();

  <span class="hljs-keyword">echo</span> Html::tag(<span class="hljs-string">'div'</span>, Html::submitButton(<span class="hljs-string">'Login'</span>, <span class="hljs-keyword">null</span>, <span class="hljs-keyword">null</span>, <span class="hljs-keyword">array</span>(<span class="hljs-string">'class'</span> =&gt; <span class="hljs-string">'btn btn-primary'</span>)), <span class="hljs-keyword">array</span>(
    <span class="hljs-string">'class'</span> =&gt; <span class="hljs-string">'form-actions'</span>
   ));

$this-&gt;endWidget();

$form = $this->beginWidget('yii\widgets\ActiveForm', array(

'options' => array('class' => 'form-horizontal')

));

echo $form->field($model, 'username')->textInput();

echo $form->field($model, 'password')->passwordInput();

echo $form->field($model, 'rememberMe')->checkbox();

echo Html::tag('div', Html::submitButton('Login', null, null, array('class' => 'btn btn-primary')), array(

'class' => 'form-actions'

));

$this->endWidget();

* Внимание: в Html::tag($tag, $content, $options) — изменили порядок параметров!

ActiveRecord

«По большей части, ActiveRecord осталась нетронутой»

— написано в предыдущей статье. Верно подмечено — не трогали.
Просто взяли и написали совсем другой ActiveRecord.

— Забываем про model()

— Убран CDbCriteria. Но не пугайтесь, работа с базой стала от этого легче. Появился ActiveQuery, который представляет себя гибрид CActiveFinder и CDbCriteria.

<span class="hljs-comment">// получаем экземпляр ActiveQuery</span>
$query = Post::find();

<span class="hljs-comment">// все посты</span>
$posts = $query-&gt;all();

<span class="hljs-comment">// ищем все посты с условием</span>
$posts = $query
    -&gt;where(<span class="hljs-keyword">array</span>(<span class="hljs-string">'status'</span> =&gt; Post::DRAFT))
    -&gt;orderBy(<span class="hljs-string">'time'</span>)
    -&gt;all();

<span class="hljs-comment">// ищем один пост </span>
$post = $query
   -&gt;where(<span class="hljs-keyword">array</span>(<span class="hljs-string">'id'</span> =&gt; <span class="hljs-number">10</span>, <span class="hljs-string">'status'</span> =&gt; Post::READ))
   -&gt;one();

<span class="hljs-comment">// или проще, условие where можно передавать прямо в фабричный метод</span>
$post = Post::find(<span class="hljs-keyword">array</span>(<span class="hljs-string">'id'</span> =&gt; <span class="hljs-number">10</span>, <span class="hljs-string">'status'</span> =&gt; Post::READ));

<span class="hljs-comment">// передав в фабричный метод не массив а число эквивалентно поиску по первичному ключу </span>
$post = Post::find(<span class="hljs-number">10</span>)
   -&gt;where(<span class="hljs-keyword">array</span>(<span class="hljs-string">'status'</span> =&gt; Post::READ))
   -&gt;one();

<span class="hljs-comment">// индексируем результат по нужному атрибуту</span>
$posts = $query-&gt;indexBy(<span class="hljs-string">'title'</span>)-&gt;all();

<span class="hljs-comment">// результат в виде массива</span>
$posts = $query-&gt;asArray()-&gt;all();

// получаем экземпляр ActiveQuery

$query = Post::find();

// все посты

$posts = $query->all();

// ищем все посты с условием

$posts = $query

->where(array('status' => Post::DRAFT))

->orderBy('time')

->all();

// ищем один пост

$post = $query

->where(array('id' => 10, 'status' => Post::READ))

->one();

// или проще, условие where можно передавать прямо в фабричный метод

$post = Post::find(array('id' => 10, 'status' => Post::READ));

// передав в фабричный метод не массив а число эквивалентно поиску по первичному ключу

$post = Post::find(10)

->where(array('status' => Post::READ))

->one();

// индексируем результат по нужному атрибуту

$posts = $query->indexBy('title')->all();

// результат в виде массива

$posts = $query->asArray()->all();

— Все общие методы теперь статические: getDb, tableName, find*, saveAll*, primaryKey. Выигрыш очевиден.

— Связи, куда же без них. Теперь связи определяются добавлением геттеров

<span class="hljs-class"><span class="hljs-keyword">class</span> <span class="hljs-title">Post</span> <span class="hljs-keyword">extends</span> <span class="hljs-title">ActiveRecord</span>
</span>{
    <span class="hljs-keyword">public</span> <span class="hljs-function"><span class="hljs-keyword">function</span> <span class="hljs-title">getCreator</span><span class="hljs-params">()</span>
    </span>{
        <span class="hljs-keyword">return</span> $this-&gt;hasOne(<span class="hljs-string">'User'</span>, <span class="hljs-keyword">array</span>(<span class="hljs-string">'id'</span> =&gt; <span class="hljs-string">'user_id'</span>));
    }
    <span class="hljs-keyword">public</span> <span class="hljs-function"><span class="hljs-keyword">function</span> <span class="hljs-title">getComments</span><span class="hljs-params">()</span>
    </span>{
        <span class="hljs-keyword">return</span> $this-&gt;hasMany(<span class="hljs-string">'Comment'</span>, <span class="hljs-keyword">array</span>(<span class="hljs-string">'post_id'</span> =&gt; <span class="hljs-string">'id'</span>));
    }
    <span class="hljs-keyword">public</span> <span class="hljs-function"><span class="hljs-keyword">function</span> <span class="hljs-title">getTrustComments</span><span class="hljs-params">($isTrust = true)</span>
    </span>{
        <span class="hljs-keyword">return</span> $this-&gt;hasMany(<span class="hljs-string">'Comment'</span>, <span class="hljs-keyword">array</span>(<span class="hljs-string">'post_id'</span> =&gt; <span class="hljs-string">'id'</span>))
            -&gt;where(<span class="hljs-string">'status = :status'</span>, <span class="hljs-keyword">array</span>(
                     <span class="hljs-string">':status'</span> =&gt; $isTrust ? <span class="hljs-keyword">self</span>::TRUST : <span class="hljs-keyword">self</span>::UNTRUST,
              ))
            -&gt;orderBy(<span class="hljs-string">'id'</span>);
    }
}

class Post extends ActiveRecord

{

public function getCreator()

{

return $this->hasOne('User', array('id' => 'user_id'));

}

public function getComments()

{

return $this->hasMany('Comment', array('post_id' => 'id'));

}

public function getTrustComments($isTrust = true)

{

->where('status = :status', array(

':status' => $isTrust ? self::TRUST : self::UNTRUST,

))

->orderBy('id');

}

— Для удобства работы со связями добавили link() и unlink(), который автоматически расставят ключи

$post = Post::find(<span class="hljs-number">1</span>);

$comment = <span class="hljs-keyword">new</span> Comment();
$comment-&gt;text = <span class="hljs-string">'Yii Framework is cool!'</span>;
$post-&gt;link(<span class="hljs-string">'comments'</span>, $comment);

$post = Post::find(1);

$comment = new Comment();

$comment->text = 'Yii Framework is cool!';

$post->link('comments', $comment);

— Именованные группы условий есть, но в другом виде. У нас же нет больше CDbCriteria, а значит и массивов условий тоже больше нет. Теперь это методы, причем статические, добавляющие условия в Query

<span class="hljs-class"><span class="hljs-keyword">class</span> <span class="hljs-title">Post</span> <span class="hljs-keyword">extends</span> \<span class="hljs-title">yii</span>\<span class="hljs-title">db</span>\<span class="hljs-title">ActiveRecord</span>
</span>{
    <span class="hljs-comment">/**
     * <span class="hljs-doctag">@param</span> ActiveQuery $query
     */</span>
    <span class="hljs-keyword">public</span> <span class="hljs-keyword">static</span> <span class="hljs-function"><span class="hljs-keyword">function</span> <span class="hljs-title">byCreator</span><span class="hljs-params">($query, $userId)</span>
    </span>{
        $query-&gt;andWhere(<span class="hljs-string">'user_id = :userId'</span>, <span class="hljs-keyword">array</span>(<span class="hljs-string">'userId'</span> =&gt; $userId));
    }
    <span class="hljs-comment">/**
     * <span class="hljs-doctag">@param</span> ActiveQuery $query
     */</span>
    <span class="hljs-keyword">public</span> <span class="hljs-keyword">static</span> <span class="hljs-function"><span class="hljs-keyword">function</span> <span class="hljs-title">removed</span><span class="hljs-params">($query)</span>
    </span>{
        $query-&gt;andWhere(<span class="hljs-string">'removed = 1'</span>);
    }
}

$posts = Post::find()-&gt;removed()-&gt;all();
$myPosts = Post::find()-&gt;byCreator(Yii::$app-&gt;user-&gt;id)-&gt;all();

Если говорить предельно кратко, то в новой версии фреймворка:

class Post extends \yii\db\ActiveRecord

{

/**

* @param ActiveQuery $query

*/

public static function byCreator($query, $userId)

{

$query->andWhere('user_id = :userId', array('userId' => $userId));

}

/**

* @param ActiveQuery $query

*/

public static function removed($query)

{

$query->andWhere('removed = 1');

}

$posts = Post::find()->removed()->all();

$myPosts = Post::find()->byCreator(Yii::$app->user->id)->all();

Если говорить предельно кратко, то в новой версии фреймворка:

Отсутствие обратной совместимости с Yii 1.1;
Пересмотрена архитектура классов, некоторые их реализации;
Отсутствие, как следствие новой архитектуры, некоторых сущностей, например: CDbCriteria, CClientScript, CUserIdentity и другие;
Поддержка шаблонизаторов Smarty и Twig.

Namespace

Отныне и повсеместно Yii 2.0 использует пространства имен, и это не может не радовать, особенно в случаях, когда проект начинает разрастаться.  Префикс «C» перестал использоваться в именах классов. Именование классов соответствует структуре папок фреймворка, например класс <i>yii\web\Request</i> говорит, о том что будет подключен файл <i>web/Request.php</i> в папке фреймворка. Кстати  вложенность в большинстве случаев не больше двух, поэтому объявление класса вряд ли покажется огромным,  более того его даже легко запомнить.

Да, как ты догадался, теперь фреймворк требует PHP 5.3  (или если быть <a href="http://www.slideshare.net/samdark/yiiconf-2012-alexander-makarov-yii2" rel="nofollow">точным</a> PHP 5.3.8+) со многими вытекающими (но приятными) последствиями, например использование анонимных функций.

Отныне и повсеместно Yii 2.0 использует пространства имен, и это не может не радовать, особенно в случаях, когда проект начинает разрастаться. Префикс «C» перестал использоваться в именах классов. Именование классов соответствует структуре папок фреймворка, например класс yii\web\Request говорит, о том что будет подключен файл web/Request.php в папке фреймворка. Кстати вложенность в большинстве случаев не больше двух, поэтому объявление класса вряд ли покажется огромным, более того его даже легко запомнить.

Да, как ты догадался, теперь фреймворк требует PHP 5.3 (или если быть <a href="http://www.slideshare.net/samdark/yiiconf-2012-alexander-makarov-yii2" rel="nofollow">точным</a> PHP 5.3.8+) со многими вытекающими (но приятными) последствиями, например использование анонимных функций.

Псевдонимы путей

Yii 2.0 позволяет использовать псевдонимы как для путей к файлу/директории так и для URL.  Псевдонимы обязаны начинаться с символа @, чтобы его можно было легко отличить от пути к файлу/директории или URL. Например псевдоним @yii ссылается на директорию, где установлен фреймворк Yii. Псевдонимы путей используются во многих местах ядра Yii 2.0, например в <i>FileCache::cachePath</i>.

Также псевдонимы тесно связаны с пространством имен. Рекомендуется определять псевдоним для каждого корня пространства имен. Если ты используешь сторонние библиотеки, как например Zend Framework, то ты должен определить псевдоним @Zend, который будет ссылаться на директорию куда установлен Zend, чтобы автозагрузчик классов Yii смог обработать любой класс оттуда, например:

Yii 2.0 позволяет использовать псевдонимы как для путей к файлу/директории так и для URL. Псевдонимы обязаны начинаться с символа @, чтобы его можно было легко отличить от пути к файлу/директории или URL. Например псевдоним @yii ссылается на директорию, где установлен фреймворк Yii. Псевдонимы путей используются во многих местах ядра Yii 2.0, например в FileCache::cachePath.

Также псевдонимы тесно связаны с пространством имен. Рекомендуется определять псевдоним для каждого корня пространства имен. Если ты используешь сторонние библиотеки, как например Zend Framework, то ты должен определить псевдоним @Zend, который будет ссылаться на директорию куда установлен Zend, чтобы автозагрузчик классов Yii смог обработать любой класс оттуда, например:

\<span class="hljs-tag">Yii</span><span class="hljs-pseudo">::setAlias('</span><span class="hljs-at_rule">@<span class="hljs-keyword">Zend',</span> <span class="hljs-string">'@app/vendors/Zend'</span>)</span>;

1	\<span class="hljs-tag">Yii</span><span class="hljs-pseudo">::setAlias('</span><span class="hljs-at_rule">@<span class="hljs-keyword">Zend',</span> <span class="hljs-string">'@app/vendors/Zend'</span>)</span>;

Кстати упомянутый выше автозагрузчик классов Yii соответвует <a href="https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-0.md" rel="nofollow">PSR-0</a>.

Кстати упомянутый выше автозагрузчик классов Yii соответвует <a href="https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-0.md" rel="nofollow">PSR-0</a>.

Компонент и объект

Класс CComponent, положенный в основу любого компонента в Yii1.x, теперь представлен в виде двух сущностей:

1 2	Класс CComponent, положенный в основу любого компонента в Yii1.x, теперь представлен в виде двух сущностей:

\yii\base\Object – легковесный класс, реализующий определение атрибутов класса через методы получение (set) и установки (get);
\yii\base\Component – является расширением вышеуказанного, который поддерживает дополнительно события (event) и поведения (behavior).

По рекомендации авторов Yii, если проектируемый тобой класс не нуждается в использовании событий и поведений, наследуй его от Object.
Среди прочих изменений можно добавить, что методы<strong> </strong>primaryKey() и tableName() стали статическими методами.

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

Среди прочих изменений можно добавить, что методы primaryKey() и tableName() стали статическими методами.

Консольные приложения

Консольные приложения теперь также как и веб-приложения состоят из контроллеров и по сути оба наследуются от одного базового класса контроллера. Каждый консольный контроллер похож на класс <i>CConsoleCommand</i> из Yii 1.1 и состоит из одного или нескольких действий.

Чтобы выполнить консольную команду используй <i>yiic &lt;route&gt;</i>, где <i>&lt;route&gt;</i> это путь до контроллера (например, sitemap/index). Дополнительные анонимные аргументы передаются в качестве параметров для соответствующего метода контроллера, а именованные аргументы рассматриваются в качестве глобальных параметров, отъявленных в <i>GlobalOptions()</i>.

Yii 2.0 поддерживает автоматическое создание справки из блока комментариев.

Консольные приложения теперь также как и веб-приложения состоят из контроллеров и по сути оба наследуются от одного базового класса контроллера. Каждый консольный контроллер похож на класс CConsoleCommand из Yii 1.1 и состоит из одного или нескольких действий.

Чтобы выполнить консольную команду используй yiic <route>, где <route> это путь до контроллера (например, sitemap/index). Дополнительные анонимные аргументы передаются в качестве параметров для соответствующего метода контроллера, а именованные аргументы рассматриваются в качестве глобальных параметров, отъявленных в GlobalOptions().

Yii 2.0 поддерживает автоматическое создание справки из блока комментариев.

Yii 2.0 активно развивается

Новая версия фреймворка очень заметно развивается, не только в плане исправления ошибок но и документации, достаточно проследить за активностью в течение нескольких дней:

1 2	Новая версия фреймворка очень заметно развивается, не только в плане исправления ошибок но и документации, достаточно проследить за активностью в течение нескольких дней:

3 мая, вышел Public preview Yii 2.0;
6 мая, Yii 2.0 на первом месте в github, по рейтингу и количеству созданных веток в этот день, неделю и месяц. Также в этот день появляется первое расширение nested-set-behavior-2 от creocoder. На Хабрахабр появляется статья “Создание простого CRUD-приложения с помощью Yii2“;
7 мая, обновление гайдов на хитгаб, в том числе Upgrading from Yii 1.1;
8 мая, статья на Хабрахарб

[su_custom_gallery source="media: 209,210,211,212,213,215,216,217,218,219,220,221" link="lightbox" width="130"]

1	[su_custom_gallery source="media: 209,210,211,212,213,215,216,217,218,219,220,221" link="lightbox" width="130"]