В данной статье мы установим Yii 2.0, настроим локальную среду для разработки и создадим первое простое приложение из встроенного шаблона basic.

Релиз Yii 2.0, новой версии замечательного фреймворка, состоялся 12 октября 2014 года.

Установка Yii 2.0

Подробную информацию по установке фреймворка можно найти в соответствующем разделе Документации по Yii 2.0.  Там же можно найти и описание классов и расширений. Русская документация по Yii 2.0 пока еще не готова на 100%, но перевод ведется активными темпами и текущую версию доков можно оценить здесь.

Установка Composer’а

Yii2 поддерживает Composer, популярный менеджер зависимостей для php. Установим Composer:

curl -s http://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer

Устанавливаем Yii2

Используем свеженький Composer для установки фреймворка, новый проект назовем yii2-demo:

cd ~/Sites
composer global require "fxp/composer-asset-plugin:1.0.0-beta2"
composer create-project --prefer-dist yiisoft/yii2-app-basic hello

В Yii 2.0 включены два шаблона приложений: basic и advanced. На этот раз рассмотрим первый шаблон. Шаблон advanced содержит back-end и frond-end.

Теперь откроем адрес http://yii2.demo любым современным браузером и увидим, что наше приложение уже работает! Встроенные шаблоны basic и advanced используют Bootstrap 3.x по-умолчанию.

Структура приложения Yii

Одно из главных достоинств фреймворка — MVC (шаблон проектирования Модель-Вид-Контроллер).  MVC — не только позволяет писать более простой и поддерживаемый код, но и уменьшить общий его объем за счет простоты повторного использования, а так же упрощает автоматизацию генерации и тестирования кода.

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

// comment out the following two lines when deployed to production
defined('YII_DEBUG') or define('YII_DEBUG', true);
defined('YII_ENV') or define('YII_ENV', 'dev');

require(__DIR__ . '/../vendor/autoload.php');
require(__DIR__ . '/../vendor/yiisoft/yii2/Yii.php');

$config = require(__DIR__ . '/../config/web.php');

(new yii\web\Application($config))->run();

По-умолчанию, приложение передает управление методу Index в /controllers/SiteController.php:

public function actionIndex()
    {
        return $this->render('index');
    }

В общем, контроллеры — это обычные методы php, которые являются (чаще всего и идеологически) прослойкой между данными (Модель) и пользовательским интерфейсом (Вид). То есть контроллер управляет доступом и передает нужные данные Модели в нужный Вид. Основные манипуляции с данными должны осуществляться в Модели, а Виды должны отображать данные используя шаблоны.

Изначально Yii отображает шаблон /views/layouts/main.php через /views/site/index.php. Шаблон main.php содержит основную структуру и разметку страницы html и css. Внутри него можно увидеть код, выводящий динамическое содержимое:

<div class="container">
<?= Breadcrumbs::widget([
'links' => isset($this->params['breadcrumbs']) ? $this->params['breadcrumbs'] : [],
]) ?>
<?= $content ?>
</div>

Переменная $content будет замещена кодом, сгенерированным /views/site/index.php, который просто выдает статичный код, приветствующий нас.

Классика жанра: Hello World! на Yii 2.0

Включаем красивые URL

Для начала включим в нашем новом приложении Yii2 человеко-понятные УРЛ (ЧПУ) с использованием mod_rewrite. Если сейчас щелкнуть по ссылке About на главной странице, мы увидим, что ссылка имеет  вид вроде http://yii2.demo/index.php?r=site%2Fabout. Предлагаю сделать его более читаемым: http://yii2.demo/site/about.

Директория config содержит конфигурацию всего приложения в целом, а так же его веб и консольной частей. Займемся /config/web.php. Добавим компонент urlManagement к текущему приложению:

'components' => [
        'urlManager' => [
            'showScriptName' => false,
            'enablePrettyUrl' => true,
        ],
        'request' => [
//...

Теперь создадим файл .htaccess в каталоге /web, где расположен главный файл index.php:

[perl]RewriteEngine on

# Если файл или директория существуют, использовать их
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
# В ином случае — переадресовать на  index.php
RewriteRule . index.php[/perl]

Теперь, если на вашем веб-сервере включен mod_rewrite, при открытии в браузере страницы http://yii2.demo/site/about, Вы можете увидеть страницу About нашего Yii2 приложения. Другие пункты меню, так же отзываются приятными для нас ссылками с красивыми URL.

Создаем «вежливый» экшн

Теперь добавим приложению экшн, который будет здороваться с каждым, кто к нему обратится. Назовем его Privet и разместим в контроллере Site. Приступим, файл /controllers/SiteController.php:

public function actionPrivet($name = 'Друг')
{
    return $this->render('privet', ['name' => $name]);
}

Новый экшн будет искать параметр URL запроса name для использования его в приветствии, а если не найдет, использует «Друг». В Yii экшены описываются как методы с префиксом «action» и последующим за ним именем с большой буквы. Yii использует префикс action для различия обычных методов и экшенов. В нашем случае, мы создали метод public function acrtionPrivet для класса SiteController.

По-умолчанию файл для рендера ищется по следующему пути: views/ControllerID/ViewName.php. Так что создадим файл /views/site/privet.php:

<?php
use yii\helpers\Html;
?>
<h1>Привет <?= Html::encode($name) ?>!</h1>
<p>Добро пожаловать в твое первое приложение Yii2.</p>

Этот шаблон просто выводит статичный html код, вставляя в него значение переменной $name, которую передал контроллер. Обязательно используем Html::encode() для отображения данных, полученных из запросов GET или POST, что бы исключить некоторые виды атак злоумышленников на наше приложение или его пользователей!

Откроем ссылку http://yii2.demo/site/privet?name=Начинающий%20осваивать%20Yii2. Что мы видим:

Это очень простой пример использования MVC в Yii2 приложении, здесь мы опустили первую часть — Модель.