Форум АНТИЧАТ - Начальный практикум в Yii

Форум АНТИЧАТ (https://forum.antichat.xyz/index.php)

- Авторские статьи (https://forum.antichat.xyz/forumdisplay.php?f=31)

- - Начальный практикум в Yii (https://forum.antichat.xyz/showthread.php?t=129104)

Начальный практикум в Yii

Официальный сайт фреймворка: http://yiiframework.com/
Русскоязычный форум: http://www.yiiframework.com/forum/index.php/board,19.0.html
Версия фреймворка на момент написания статьи: 1.0.6

Автор: Кузьмин Антон (Kuzya)
Сайт: http://kuzya.name

К сожалению редактор форума не позволяет создавать структурированный текст, из-за чего большие части кода порой трудно читаются.
В этом случае рекомендую Вам скачать PDF-вариант статьи: practical_intro_yii.pdf (17 страниц, шрифт Times New Roman, 12pt).

Прикреплённые файлы: design.zip, ready.zip, database.zip

Введение
Здравствуйте. В этой статье мы будем практиковаться в изготовлении простейшего приложения с помощью фреймворка Yii. Нашей целью будет создание
сайта на котором люди могут вести свои блоги и комментировать чужие.
Скажу сразу что я являюсь ярым противником различных классов и хэлперов для работы с HTML. Поэтому, в отличие от демонстрационных приложений
производителей, я не использую классы типа CHtml. Хотя возможно кто-то сочтёт это неправильным. Вообщем, все шаблоны в этой статье содержат
только HTML и альтернативный PHP-синтаксис.
Начните с создания "чистого" хоста для нашего сайта. Я назвал его "yii".В корневой директории создайте папку base. Скопируйте туда содержимое
архива фреймворка (директории framework, requirements и т.д.). После этого, так же в корне, создайте новое приложение с помощью утилиты "yiic"
и её команды webapp ( http://www.yiiframework.com/doc/guide/ru/quickstart.first-app ).

Дизайн
Возьмите архив с дизайном (приложен к статье). В нём есть директории fonts, images и файл style.css. Скопируйте их в корень сайта. Теперь пройдите
в директорию /protected/views/layouts и откройте файл main.php. Здесь содержится глобальный внешний вид для всех без исключения страниц. Сначала
просто скопируйте в этот шаблон HTML-содержимое нашего дизайна ( из архивного index.html ). После этого, при обращении к корню хоста, Вы должны
увидеть совершенно другую картину.

Главная переменная в layout`e это $content. Туда помещается содержимое текущей страницы. Давайте затрём приветствие

Код HTML:

<h2>Здравствуйте уважаемый гость!</h2>

<p>

Почему мы призываем вас завести блог именно у нас?

Блог - это то место, где можно делиться мыслями, публиковать статьи, фотографии, общаться с друзьями или просто рассказывать о своей жизни. Создай 

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

На нашем сайте Вы найдёте новых друзей, сможете бесконечно общаться с ними.

</p>

и за место него вставим отображение этой переменной

PHP код:


		
			
<?=$content?>

У нас в приложении главным контроллером является Site. В нём есть действие indexAction, которое отображает соответствующий шаблон. Откроем его
( /protected/views/site/index.php ) и за место содержимого поместим ранее вырезанную часть layout`a. Обновите страницу. Внешне никаких изменений
произойти недолжно.

Локализация
Локализацией ( http://www.yiiframework.com/doc/guide/ru/topics.i18n ) мы займёмся именно сейчас. Почему, Вы поймёте по ходу чтения этого раздела.
Для начала настроим исходный язык приложения (sourceLanguage) и пользовательский (просто language). Для этого откройте файл конфигураций
/protected/config/main.php и после параметров "basePath" и "name" добавьте соответствующие ячейки:

PHP код:


		
			
'sourceLanguage' => 'en_US',

'language' => 'ru_RU',

Так мы указываем приложению что в качестве исходного языка используется английский, а требуется русский. Обратите внимание на то что если эти
языки будут совпадать то никакой перевод задействован не будет.
Непосредственно преобразование английских фраз в русские мы будем осуществлять с помощью метода t, класса Yii, которому нужно передать категорию
фразы, и саму фразу ( http://www.yiiframework.com/doc/api/YiiBase#t-detail ). Метод покопается в языковых файлах и вернёт текст перевода. Сами
фразы мы будем хранить в виде массива, в php-файлах ( хотя возможны варианты, например хранение фраз в БД). Пройдите в директорию /protected/messages/
и создайте там папку ru_RU. В ней должны находиться файлы категорий с русскоязычными текстами. Мы будем пользоваться всего одной категорией ( естественно
в настоящем приложении их несколько ) - common. Создайте для неё файл common.php со следующим содержимым:

PHP код:


		
			
 return Array(



);

Поместим в него фразы из нашего приветствия с главной страницы. Отдельно фразу "Здравствуйте уважаемый гость!" и текст приветствия.

PHP код:


		
			
<?php

return Array(

"hello_guest" => "Здравствуйте уважаемый гость!",

"welcome" => "Почему мы призываем вас завести блог именно у нас? Блог - это то место, где можно делиться мыслями, публиковать статьи, фотографии,

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

 На нашем сайте Вы найдёте новых друзей, сможете бесконечно общаться с ними. "

);

Теперь снова обратимся к отображению действия indexAction, и фразу приветствия заменим на

PHP код:


		
			
<?=Yii::t("common","hello_guest")?>

а текст приветствия на

PHP код:


		
			
<?=Yii::t("common","welcome")?>

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

.htaccess

Сейчас мы сделаем так чтоб URL у нас были не такие "index.php?r=path/path", а такие - "/path/path". Для этого откройте конфигурационный файл и в
ячейку components добавьте

PHP код:


		
			
'urlManager'=>array(

'urlFormat'=>'path',

),

А в корень сайта положите файл .htaccess с содержимым

Код:

Options +FollowSymLinks

IndexIgnore */*

RewriteEngine on



# if a directory or a file exists, use it directly

RewriteCond %{REQUEST_FILENAME} !-f

RewriteCond %{REQUEST_FILENAME} !-d



# otherwise forward it to index.php

RewriteRule . index.php

Более подробную информацию по изменению URL Вы можете найти здесь - http://www.yiiframework.com/doc/guide/ru/topics.url

База данных
Займёмся базой данных. Её SQL-код лежит в архиве database.zip. Создайте базу yii и выполните этот код в ней. Теперь следует указать фреймворку
с какой базой ему нужно работать и как с ней соединяться. Снова обратимся к файлу /protected/config/main.php и раскомментируем в нём строки

PHP код:


		
			
/*

'db'=>array(

'connectionString'=>'Your DSN',

),

*/

Далее, за место "Your DSN" вставим строку соединения с БД. У меня это "mysql:host=localhost;dbname=yii". Добавим в этот массив ещё несколько строк:

PHP код:


		
			
'class' => 'CDbConnection', // Выбираем класс для работы с БД

'username' => 'root', // Имя пользователя

'password' => '', // Пароль

'charset' => 'utf8' // Кодировка

Измените их значения под свой сервер.

Регистрация
Самое первое что мы должны сделать на нашем сайте - соорудить регистрацию и авторизацию. Для этого мы модифицируем уже существующий у нас контроллер
Site и создадим модель Users. Создание модели лучше всего производить с помощью утилиты yiic. Для этого запустите yiic с параметром shell и указанием
индексного файла нашего приложения. После этого выполните команду "model Users". Создастся модель которую мы используем для работы с соответствующей
таблицей.
Сначала сделаем регистрацию. Объявите для этого метод actionRegister в контроллере Site. Впишем туда отображение формы регистрации. Она будет лежать
в шаблоне /protected/views/site/register.php и иметь следующее содержимое.

Код HTML:

<h2>Регистрация</h2>

<form action="/site/register/" method="POST">

<table width="100%">

<tr>

<td>Имя пользователя</td>

<td><input type="text" name="Users[login]" class="long_field" ></td>

</tr>

<tr>

<td>E-mail</td>

<td><input type="text" name="Users[email]" class="long_field" ></td>

</tr>

<tr>

<td>Пароль</td>

<td><input type="password" name="Users[password]" class="long_field"></td>

</tr>

<tr>

<td colspan="2">

<input type="submit" value="&nbsp;Зарегистрироваться&nbsp;" />

</td>

</tr>

</table>

</form>

Код обработки этого шаблона будет простой.

PHP код:


		
			
$this->render("register");

Теперь пройдите по ссылке http://yii/site/register/. Вы должны увидеть форму регистрации из трёх полей. Как видно из шаблона,
форма отсылает данные методом POST на этот же адрес. То есть при обращении к действию register контроллер должен как-то проверить
- пришла форма, или это простое обращение. Такую проверку мы будем осуществлять проверяя существование массива $_POST['Users']. Если он есть
- нам пришли данные из формы. В случае регистрации мы просто создадим новый объект модели Users, укажем необходимые поля и сохраним изменения.

PHP код:


		
			
$users = new Users;

// Заполняем поля

$users->login    = $_POST['Users']['login'];

$users->password = md5($_POST['Users']['password']);

$users->email    = $_POST['Users']['email'];

// Сохраняем данные

$users->save();

После регистрации пользователю нужно сообщить об успешности этой операции. Мы воспользуемся Flash-сообщениями. Сначала внесём соответствующий
текст в языковой файл, в ячейку "registered"

PHP код:


		
			
"registered"  => "Поздравляем! Вы зарегистрированы!"

А затем объявим его в контроллере, вызывав метод setFlash ( http://www.yiiframework.com/doc/api/CWebUser#setFlash-detail ).

PHP код:


		
			
Yii::app()->user->setFlash("registered",Yii::t("common","registered"));

Здесь мы создали у текущего пользователя сообщение об успешной регистрации с идентификатором "registered". Осталось только шаблон формы изменить
так чтоб она не отображалась если есть Flash-сообщение. В этом нам помогут методы hasFlash и getFlash этого же объекта. Первый определяет есть
ли нужное нам сообщение, а второй это сообщение возвращает.

Код HTML:

<h2>Регистрация</h2>

<?if(Yii::app()->user->hasFlash("registered")):?>

<p>

<?=Yii::app()->user->getFlash("registered")?>

</p>

<?else:?>

<form action="/site/register/" method="POST">

<table width="100%">

<tr>

<td>Имя пользователя</td>

<td><input type="text" name="Users[login]" class="long_field" ></td>

</tr>

<tr>

<td>E-mail</td>

<td><input type="text" name="Users[email]" class="long_field" ></td>

</tr>

<tr>

<td>Пароль</td>

<td><input type="password" name="Users[password]" class="long_field"></td>

</tr>

<tr>

<td>Подтверждение пароля</td>

<td><input type="password" name="Users[password_confirm]" class="long_field"></td>

</tr>

<tr>

<td colspan="2">

<input type="submit" value="&nbsp;&nbsp;Зарегистрироваться&nbsp;&nbsp;" />

</td>

</tr>

</table>

</form>

<?endif;?>

А вот код который должен у нас получится в действии actionRegister.

PHP код:


		
			
if(isset($_POST['Users']))

{

$users = new Users;

// Сохраняем поля

$users->login    = $_POST['Users']['login'];

$users->password = md5($_POST['Users']['password']);

$users->email    = $_POST['Users']['email'];

// Сохраняем данные

$users->save();

// Устанавливаем сообщение

Yii::app()->user->setFlash("registered",Yii::t("common","registered"));

}



$this->render("register");

Следующим шагом мы добавим валидацию ( http://www.yiiframework.com/doc/guide/form.model#declaring-validation-rules ).
Нам нужно проверить отсутсвие логина и указанного почтового адреса в базе. Для этого откроем файл /protected/models/User.php и
посмотрим метод "rules". Там сейчас 3 правила - максимальная длинна логина 30 символов, пароля - 32, email`a - 50. Мы внесём сюда
5 правил - поля почтового адреса и логина не должны быть пустыми, содержимого этих полей в БД быть не должно, почтовый адрес должен
иметь правильный формат.

PHP код:


		
			
return array(

// логин и почта должны быть введены

array('login','required','on'=>'register','message'=>Yii::t('common','login_empty')),

array('email','required','on'=>'register','message'=>Yii::t('common','email_empty')),

// Они должны быть уникальными

array('login','unique','on'=>'register','message'=>Yii::t('common','login_in_base')),

array('email','unique','on'=>'register','message'=>Yii::t('common','email_in_base!')),

// Почтовый адрес должен иметь соответствующий формат

array('email','email','on'=>'register','message'=>Yii::t('common','email_no_right_format'))

);

Внесём в языковой файл соответствующие переводы.

PHP код:


		
			
"login_empty"   => "Поле логина не должно быть пустым",

"email_empty"   => "Поле почтового адреса не должно быть пустым",

"login_in_base" => "Введёный логин присутсвует среди зарегистрированных пользователей",

"email_in_base" => "Введёный e-mail присутсвует среди зарегистрированных пользователей",

"email_no_right_format" => "Вы ввели не правильный email"

Теперь модифицируем контроллер. Во-первых, объявим массив куда будут складываться все ошибки валидации. Назовём его $errors. Во-вторых,
перед сохранением данных мы вызовем метод "validate". И в третьих, мы осуществим обработку метода getErrors, модели, так чтоб в $errors
поместились все имеющиеся ошибки. Затем мы передадим массив с ошибками в обработчик шаблона.

PHP код:


		
			
$errors = Array();

if(isset($_POST['Users']))

{

$users = new Users;

// Сохраняем поля

$users->login    = $_POST['Users']['login'];

$users->password = md5($_POST['Users']['password']);

$users->email    = $_POST['Users']['email'];

// Проверяем данные

$users->validate('register');

// Если ошибки есть

if( $users->hasErrors() )

{

// Помещаем их текст в массив $errors

foreach($users->getErrors() as $field) $errors[] = $field[0];

}

// Если массив ошибок пуст

if(!count($errors)) {

// Сохраняем данные

$users->save();

// Устанавливаем сообщение

Yii::app()->user->setFlash("registered",Yii::t("common","registered"));

// Обновляем страницу

$this->refresh();

// Если ошибки есть то показываем форму регистрации и передаём их в шаблон

}

}

$this->render('register',Array('errors' => $errors));

В шаблон же мы добавим код который высветит все ошибки, если таковые есть. Его следует поместить прямо перед начальным тегом <form>.

Код HTML:

<?if(count($errors)):?>

Ошибки:    <br />

<?foreach($errors as $error):?>

&amp;amp;amp;amp;amp;amp;nbsp;&amp;amp;amp;amp;amp;amp;nbsp;<b><?=$error;?></b><br />

<?endforeach;?>

<?endif;?>

<br />

Теперь, если Вы всё сделали правильно, при отправке пустой формы покажутся соответствующие сообщения.

Авторизация
Для авторизации мы будем использовать метод actionLogin, контроллера Site и шаблон /protected/views/site/login.php, содержимое которого мы поменяем на

Код HTML:

<div id="bodyPanel">

<h2>Войдите</h2>

<form action="/site/login/" method="POST">

<table width="100%">

<tr>

<td width="20%">Имя пользователя</td>

<td><input type="text" name="Users[login]" class="long_field"></td>

</tr>

<tr>

<td width="20%">Пароль</td>

<td><input type="password" name="Users[password]" class="long_field"></td>

</tr>

<tr>

<td colspan="2">

<input type="submit" value="&nbsp;&nbsp;Войти&nbsp;&nbsp;" />

</td>

</tr>

</table>

</form>

</div>

Так же придётся сменить содержимое метода "authenticate" компонента UserIdentity (/protected/components/UserIdentity.php).
Этот метод содержит код благодаря которому пользователи могут входить на сайт. Работает он сейчас с двумя аккаунтами, информация о которых
внесена непосредственно внутрь метода. Заменим его на код который будет брать информацию из базы данных. Сначала объявим два новых свойства:

PHP код:


		
			
private $_id;

private $_name;

Затем поменяем полностью код метода "authenticate":

PHP код:


		
			
// Получаем имя пользователя и пароль

$username =$this->username;

$password = md5($this->password);

// Ищем их в БД

$user = Users::model()->find("login=? AND password=?", Array($username,$password));

// Если пользователь не найден возвращаем false

if($user === null) return false;

// Если найден то заполняем свойства класса

$this->_id = $user->id;

$this->_name = $user->login;

// и возвращаем true

return true;

И опишем ( а точнее перегрузим уже существующие ) два дополнительных общедоступных метода, возвращающих вышеуказанные свойства.

PHP код:


		
			
public function getId()

{

return $this->_id;

}



public function getName()

{

return $this->_name;

}

Вернёмся к контроллеру. Затрите код его метода actionLogin и поместите туда следующее

PHP код:


		
			
if(isset($_POST['Users']))

{

// Авторизируем пользователя

$identity = new UserIdentity($_POST['Users']['login'],$_POST['Users']['password']);

// Если он не авторизирован

if( $identity->authenticate() )

{

// Если всё хорошо то заносим в данные

// пользователя информацию об авторизации

Yii::app()->user->login($identity);

// И перемещаем его на главную страницу

$this->redirect("/");

}

// Если форма не отправлена то просто отображаем её

} else $this->render('login');

Всё, теперь в "Yii::app()->user" ( http://www.yiiframework.com/doc/api/CWebUser ) буде содержаться информация о вошедшем пользователе. А его имя
и номер мы получим с помощью "Yii::app()->user->getName()" и "Yii::app()->user->getId()" соответственно.
Помните надпись "Здравствуйте гость!" на главной? Давайте сделаем так, чтобы она менялась в зависимости от того авторизирован пользователь или нет.
Добавим в языковой файл соответствующую фразу.

PHP код:


		
			
"hello_user"   => "Здравствуйте {login}!",

А индексную страницу изменим вот так.

Код HTML:

<h2>

<?if(Yii::app()->user->isGuest):?>

<?=Yii::t("common","hello_guest")?>

<?else:?>

<?=Yii::t("common","hello_user",Array("{login}" => Yii::app()->user->getName()))?>

<?endif;?>

</h2>

<p>

<?=Yii::t("common","welcome")?>

</p>

Здесь мы проверяем - если пользователь является гостем то выводим сообщения для гостей, а если нет - выводим фразу приветствия, указывая в качестве
параметра "login" (который содержится в фразе) логин пользователя. И немного модифицируем главное меню. Пусть авторизированный пользователь видит
ссылки на главную, на выход и на создание новой записи. Для этого, в layout`e, заменим код

Код HTML:

<ul>

<li><a href="/site/login">Вход</a></li>

<li><a href="/site/register/">Регистрация</a></li>

<li><a href="/">Главная</a></li>

</ul>

на

Код HTML:

<ul>

<?if(Yii::app()->user->isGuest):?>

<li><a href="/site/login/">Вход</a></li>

<li><a href="/site/register/">Регистрация</a></li>

<?else:?>

<li><a href="/site/logout/">Выход</a></li>

<li><a href="/records/create/">Написать</a></li>

<?endif;?>

<li><a href="/">Главная</a></li>

</ul>

Регистрируемся, входим и проверяем как изменяется главная страница.

Записи
Теперь займёмся основной частью нашего сайта - ведением записей. Всю нужную работу будет выполнять контроллер с именем Records. Создайте его с
помощью утилиты yiic командой "crud Records" ( http://www.yiiframework.com/doc/guide/ru/quickstart.first-app и
http://www.yiiframework.com/doc/guide/ru/topics.console ). Не забудьте предварительно создать и соответствующую модель,
иначе контроллер просто не сможет быть создан и в командную строку выплеснется множество ошибок.
Откроем файл /protected/controllers/RecordsController.php и обратим внимание на его методы. Первый из интересующих нас -
"accessRules" (http://www.yiiframework.com/doc/guide/ru/topics.auth#access-control-filter). Здесь содержатся правила доступа
к действиям контроллера. Сразу после создания они следующие:
1. Любым пользователям разрешено просматривать записи в виде списка и по отдельности (методы list и show)
2. Авторизированным пользователям разрешено добавлять записи и изменять их (методы create, update)
3. Администраторам разрешены функции администрирования и удаления (методы admin, delete)
4. Всё остальное всем запрещено
В принципе, нам ничего тут менять не нужно. Только лишь передать права удаления авторизированным пользователям и стереть из
прав действие admin. Его функционал будет заменён, поэтому можете удалить и само действие. Мы сделаем так, чтоб каждый смог
управлять своими записями, в том числе и удалять их.
Действие create. В самом начале происходит проверка наличия отправленных пользователем данных. Если таковые присутствуют то
они вносятся в базу, в ином случае - обрабатывается шаблон "create". Он содержит в себе пару ссылок и вызов шаблона "_form".
Отображению "_form", в свою очередь, передаётся параметр update. Почти такой-же код есть и в шаблоне обновления сообщения. Вообщем,
здесь для двух действий используется одна и та же форма, только передаются ей, при обработке, разные значения параметра "update".
Код кнопок можете спокойно затирать, оставьте лишь вызов формы. А код отображаемого шаблона _form заменим на следующий.

Код HTML:

<?if($update):?>

<h2>Обновление записи</h2>

<?else:?>

<h2>Создание новой записи</h2>

<?endif;?>

<div class="actionBar">

</div>

<?if($update):?>

<form action="/records/update/" method="POST">

<?else:?>

<form action="/records/create/" method="POST">

<?endif;?>

<table width="100%">

<tr>

<td width="20%"><span class="text">Название записи</span></td>

<td>

<input type="text" name="Records[title]" class="long_field" value="<?=$model->title?>"/>

</td>

</tr>

<tr>

<td colspan="2"><span class="text">Текст записи:</span></td>

</tr>

<tr>

<td colspan="2"><textarea name="Records[text]" class="long_textarea" rows="20"><?=$model->text?></textarea></td>

</tr>

<tr>

<td colspan="2">

<input type="submit" name="createRecord" value="Добавить запись">

</td>

</tr>

</table>

</form>

Здесь мы отправляем 2 параметра - название записи и её содержимое. Но в базе есть ещё 3 поля - время публикации, номер автора и
количество просмотров. Добавим их в POST-массив перед помещением данных в модель, и уже всё вместе занесём в БД. Вот код который должен
быть вызван в том случае если массив $_POST["Records"] обнаружен.

PHP код:


		
			
$_POST['Records']['pub_date'] = time();

$_POST['Records']['author_id'] = Yii::app()->user->getId();

$_POST['Records']['views'] = 0;

// Вносим все данные в модель

$model->attributes=$_POST['Records'];

// Сохраняем

if($model->save()) $this->redirect(array('show','id'=>$model->id));

После сохранения пользователь будет перенесён на действие show, контроллера Records, передав в качестве параметра id номер новоиспечённой
записи (ссылка типа /records/show/id/5/).
Метод actionShow. Он отображает запрошенную запись, в зависимости от указанного id. Его код состоит из одной строки. В ней вызывается
соответствующий шаблон, принимая результат работы метода loadRecords. В отображении этот результат обрабатывается, и полученные данные
выводятся пользователю. Всё идеально, но есть небольшая загвоздка. В данных сообщения нет одного - имени автора. Есть только его идентификатор
(поле author_id). Давайте настроим связь между моделями Records и Users так, чтоб при запросе одной или нескольких записей автоматически запрашивались
имена их авторов ( http://www.yiiframework.com/doc/guide/ru/database.arr#declaring-relationship ). Для этого в первой модели найдите метод "relations"
и в возвращаемый им массив внесите ячейку "author", куда будет помещена связь со второй моделью.

PHP код:


		
			
'author' => array(self::BELONGS_TO,'Users','author_id'),

Теперь в каждой записи кроме основных полей будет добавлено поле author, содержащее результат работы запроса "SELECT * FROM users WHERE id=$author_id".
В отображение все эти данные поступят вместе с остальными, так что нам нужно всего лишь напечатать свойство "$model->author->login". Вот полный код
шаблона show.

Код HTML:

<?if($model === null):?>

Запрашиваемой записи не существует.

<?else:?>

<h2><?php echo $model->title; ?>(<?=date("d-m-Y",$model->pub_date)?>/<?=$model->author->login;?>)</h2><br />

<p><?=$model->text;?></p>

<!-- Если текущий пользователь является автором этого сообщения то выводим ссылки "Редактировать" и "Удалить" -->

<?if($model->author_id == Yii::app()->user->getId()):?>

<a href="/records/edit/id/<?=$model->id?>/">Редактировать</a>

&amp;amp;amp;amp;amp;amp;nbsp;|&amp;amp;amp;amp;amp;amp;nbsp;

<a href="/records/delete/id/<?=$model->id?>/">Удалить</a>

<?endif;?>

<?endif;?>

Ничего сверхъестественного. Попробуйте добавить запись и просмотреть её.
Метод actionList - просмотр списка записей. Разберём всё что в нём делается. Сначала создаётся объект класса CDbCriteria
( http://www.yiiframework.com/doc/api/CDbCriteria ). С помощью него, при выборке данных из базы, указывается сколько записей нужно выбрать
( количество указано в константе PAGE_SIZE нашего контроллера ). Затем эти данные извлекаются. Они передаются в отображение и выводятся на экран.
В конце создаётся объект класса CPagination ( http://www.yiiframework.com/doc/api/CPagination ), отвечающий за разбиение материала на страницы.
В самом действии почти ничего не нужно менять. Надо внести лишь 2 небольших изменения. Во-первых, значение константы PAGE_SIZE измените на 3.
Во-вторых изменим код самого контроллера так, чтобы он показывал список не всех сообщений, а того пользователя, чей идентификатор передан в параметре
"user_id" ( ссылка будет выглядеть вот так - http://yii/records/list/user_id/3 ). В самое начало кода добавим обработку поступившего номера пользователя.

PHP код:


		
			
$user_id = (int) $_GET['user_id'];

А сразу после создания объекта класса CDbCriteria заполним его свойство "condition", содержащее условия для выборки.

PHP код:


		
			
$criteria->condition = "author_id={$user_id}";

Обратите внимание вот на что. В начале шаблона ( то есть до обработки полученных данных ) мы должны вывести надпись "Список сообщений пользователя...".
Для того чтоб получить имя автора можно написать в модели соответствующую функцию, вызвать её, передав в качестве исходных данных номер пользователя в
базе, и результат отдать в отображение. А можно взять его сразу из массива сообщений ещё до их обработки. Например, из нулевой записи

PHP код:


		
			
$models[0]->author->login

Возможно первый вариант в чём-то лучше, но мы будем использовать второй - он проще и быстрее.
На очереди шаблон "list". Сотрите из него весь код и внесите туда вот что.

Код HTML:

<h2>Список сообщений пользователя <?=$models[0]->author->login;?></h2><br />

<?php foreach($models as $n=>$model): ?>

<h2><?php echo $model->title; ?>(<?=date("d-m-Y",$model->pub_date)?>)</h2>

<p><a class="text" href="/records/show/id/<?=$model->id;?>"><?=substr($model->text,0,200);?>...</a></p>

<br />

<?endforeach;?>

<!--шаблон страниц-->

<?php $this->widget('CLinkPager',array('pages'=>$pages)); ?>

Здесь мы сначала сообщаем чей список записей в данный момент просматривает пользователь, а затем выводим и сами сообщения, отображая в виде анонса 200
первых символов текста. Можете сейчас пройти по ссылке http://yii/records/list/user_id/5 и Вы увидите блог пользователя Николай.
В правом нижнем углу страницы можно заметить перекорёженое изображение постраничной навигации. Оно выводится виджетом CLinkPager. Здесь мы напоролись
на один из минусов Yii. По каким-то причинам отображений у CLinkPager нет. HTML-код, который Вы видите, находится прямо в PHP-коде виджета. Исправим
это. Откройте файл ClinkPager.php, находящийся в директории /base/framework/web/widgets/pagers/. Нас интересует методы run и createPageButton. Первый
собирает общий html-код и выводит его на экран. Второй - формирует код кнопок. Переделаем код под более-менее стандартный вид. Для этого мы создадим
дерикторию views в папке с виджетом, и поместим туда 2 шаблона. Первый - pageButton.php. Он содержит код одной ссылки на страницу.

Код HTML:

<?if(!$hidden):?>

<?if($selected):?>

<b><?=$label?></b>&amp;amp;amp;amp;amp;amp;nbsp;&amp;amp;amp;amp;amp;amp;nbsp;

<?else:?>

<a class="text" href="/records/list/user_id/<?=(int)$_GET['user_id']?>/page/<?=$page+1?>"><?=$label?></a>&nbsp;&nbsp;

<?endif;?>

<?endif;?>

Второй - pagesLayout, содержащий код отбражения страниц.

Код HTML:

<br />

<br />

<br />

<br />

<center>

<p>

<?foreach($buttons as $button):?>

<?=$button?>

<?endforeach;?>

</p>

</center><br /><br />

Теперь обратимся к методу createPageButton. Вначале, в зависимости от переменных $hidden и $selected формируется класс тега <li>,
затем сам тег собирается и возвращается в виде результата. Заменим всё это одной строкой. Возвратим обработанный шаблон нашей кнопки, куда
передадим все поступившие в функцию данные. В этом нам поможет метод renderPartitional (
http://www.yiiframework.com/doc/api/CController#renderPartial-detail ), класса CController - он не выводит обработанное отображение, а возвращает его.

PHP код:


		
			
return Ccontroller::renderPartial("pageButton",Array('page'=>$page,'label'=>$label,'hidden'=>$hidden, 'selected'=>$selected), true);

В методе run мы просто сотрём весь код начиная с объявления переменной $htmlOptions. За место него вызовем всё тот-же renderPartitional, передав
ему код кнопок.

PHP код:


		
			
echo CController::renderPartial("pagesLayout",Array("buttons"=>$buttons));

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

PHP код:


		
			
"Next &amp;amp;amp;amp;amp;gt;" => "Следующая &amp;amp;amp;amp;amp;gt;",

"&amp;amp;amp;amp;amp;lt; Previous" => "&amp;amp;amp;amp;amp;lt; Предыдущая",

"&amp;amp;amp;amp;amp;lt;&amp;amp;amp;amp;amp;lt; First" => "&amp;amp;amp;amp;amp;lt;&amp;amp;amp;amp;amp;lt; Первая",

"Last &amp;amp;amp;amp;amp;gt;&amp;amp;amp;amp;amp;gt;" => "Последняя &amp;amp;amp;amp;amp;gt;&amp;amp;amp;amp;amp;gt;",

"Go to page:" => "Страницы:",

А в методе run, виджета, в самом начале, изменим категории в вызовах метода t, с "yii" на "common"

PHP код:


		
			
if($this->nextPageLabel===null)

$this->nextPageLabel=Yii::t('common','Next &amp;amp;amp;amp;amp;gt;');

if($this->prevPageLabel===null)

$this->prevPageLabel=Yii::t('common','&amp;amp;amp;amp;amp;lt; Previous');

if($this->firstPageLabel===null)

$this->firstPageLabel=Yii::t('common','&amp;amp;amp;amp;amp;lt;&amp;amp;amp;amp;amp;lt; First');

if($this->lastPageLabel===null)

$this->lastPageLabel=Yii::t('common','Last &amp;amp;amp;amp;amp;gt;&amp;amp;amp;amp;amp;gt;');

if($this->header===null)

$this->header=Yii::t('common','Go to page: ');

Теперь постраничная навигация отображается по-русски.
Изменение записей. Редактирование сообщений осуществляется через метод actionUpdate. Как Вы помните из описания метода actionCreate, он использует
форму "_form". Единственное, что здесь требует редактирования, это шаблон update. Удалите там всё кроме вызова формы.

PHP код:


		
			
<?php echo $this->renderPartial('_form', array('model'=>$model,    'update'=>true,)); ?>

Для того чтобы пользователи не могли редактировать чужие сообщения можно сразу после объявления переменной $model, в методе actionUpdate, вставить
одну строку.

PHP код:


		
			
if($model->author_id != Yii::app()->user->getId()) $this->redirect("/");

Она сверит номер автора сообщения с номером текущего пользователя и в случае их несовпадения завершит работу, перебросив пользователя на главную страницу.
Действие delete. В нём требуется только вставить проверку авторства пользователя и исправить редирект после удаления. Для этого мы в начало метода
внесём следующий код.

PHP код:


		
			
$record=$this->loadRecords();

if($record->author_id != Yii::app()->user->getId()) $this->redirect("/");

А код редиректа заменим на такой.

PHP код:


		
			
$this->redirect(array('list','user_id'=>$record->author_id));

Вот и всё. Можно приступить к следующему этапу.

Комментарии.
На нашем сайте пользователи (как авторизированные так и неизвестные) должны иметь возможность комментировать каждую запись. Для этого мы создадим
контроллер Comments. По аналогии с контролером записей нужно воспользоваться утилитой yiic и командами model и crud.
После создания контроллера откройте его и подредактируйте правила доступа следующим образом. В разрешённые всем действия добавьте create. Действия
update, delete и admin удалите. Представим что всех их будет выполнять либо администратор ресурса, либо владелец блога.
Затем откройте отображение show, контроллера Records. После кода отображения записи поместите код формы, в которую посетитель будет вносить текст
комментария.

Код HTML:

<br />

<br />

<br />

<h3>Оставьте свой отзыв!</h3>

<form action="/comments/create/" method="post">

<input type="hidden" name="Comments[post_id]" value="<?=$model->id?>" />

<table width="100%">

<tr>

<td>Текст комментария:</td>

</tr>

<tr>

<td><textarea name="Comments[text]" class="long_field"></textarea></td>

</tr>

<tr>

<td><input type="submit" value="Сохранить" /></td>

</tr>

</table>

</form>

Далее нужно изменить сам контроллер. А именно - метод actionCreate. Изначально он выполняет сохранение тех данных которые приходят к нему из формы.
Но в форме у нас всего два поля - комментарий и номер записи. А в таблице должны быть заполнены ещё столько же - дата публикации и идентификатор автора.
Поэтому, прямо перед передачей POST-параметров в модель

PHP код:


		
			
$model->attributes = $_POST['Comments'];

мы создадим в POST-массиве две дополнительные ячейки. В одной будет номер автора (или 0 в случае неавторизированного гостя), а во второй - текущее
время в формате UNIX TIMESTAMP.

PHP код:


		
			
$_POST['Comments']['author_id'] = (Yii::app()->user->getId()) ? Yii::app()->user->getId() : 0;

$_POST['Comments']['pub_date']  = time();

Как всегда, изменим и код редиректа. Сейчас он перенаправляет пользователя на метод show, дабы тот увидел то что он опубликовал. Но нам нужно
показать посетителю не именно то что он оставил, а комментируемую запись и все сообщения комментаторов. Для этого мы перебросим его на метод show
контроллера create, поместив в ссылку номер комментируемой записи.

PHP код:


		
			
$this->redirect("/records/show/id/{$model->post_id}");

Следующим шагом нужно организовать отображение всех комментариев которые есть у записи. Сделать это можно двумя путями - в контроллере Records,
в методе actionShow, получить список отзывов о записи (например, описать для этого соответствующую функцию в модели Comments). А можно настроить ещё
одну связь в модели Records с моделью комментариев. Мы пойдём вторым путём и в массив, возвращаемый методом relations поместим вот такую ячейку.

PHP код:


		
			
'comments' => array(self::HAS_MANY,'Comments','post_id')

Так мы укажем приложению что у каждой записи имеется ( возможно ) множество комментариев, которые должны отбираться в модели Comments, по полю
post_id. Все они будут помещаться в итоговую модель, в соответствующую ячейку. Но в самих комментариях нам нужно отображать ещё и имя их автора.
Для этого применим связь которую уже объявляли при работе с записями - свяжем модель комментариев и модель пользователей по полю author_id.

PHP код:


		
			
'author' => array(self::BELONGS_TO,'Users','author_id'),

Осталось лишь отображение. Для этого в шаблон show поместите следующий код, прямо между формой отзыва и текстом записи.

Код HTML:

<br /><br /><br />

<h3>Комментарии:</h3>

<?foreach($model->comments as $comment):?>

<b>

<?if(isset($comment->author->login)):?>

<?=$comment->author->login?>

<?else:?>

Гость

<?endif;?>

(<?=date('d-m-Y',$comment->pub_date)?>)

</b><br />

<?=$comment->text?><br /><br />

<?endforeach;?>

Теперь у наших блогов есть ещё и комментарии.

Кэширование.
Ну и под конец коснёмся темы кэширования. Оно в Yii ( http://www.yiiframework.com/doc/guide/ru/caching.overview ) может быть реализовано с
помощью пяти компонентов - memCache, ACP, XCache, EAcceleratior и CDbCache. Для всех них создан один уникальный класс-оболочка - CCache
( http://www.yiiframework.com/doc/api/CCache#get-detail ). Через него можно работать со всеми пятью компонентами через один и тот же интерфейс.
Мы воспользуемся кэшированием с использованием базы данных ( CDbCache ). Для активизации компонента требуется открыть главный конфигурационный
файл, и в массив ячейки "components", добавить ячейку "cache" со следующим содержимым

PHP код:


		
			
'cache' => Array('class' => 'system.caching.CDbCache'),

Более ничего делать не нужно. Давайте применим кэширование к показу сообщений в блоге. Кэшировать мы будем данные получаемые из БД ( работа с данными

- http://www.yiiframework.com/doc/guide/ru/caching.data ). Задействовать нам нужно всего 3 метода - get, set и delete. Они принадлежат объекту
возвращаемому Yii::app()->cache. В качестве основного параметра им нужно передать специальный идентификатор ( обычное имя под которым кусок информации
будет записан, удалён или получен из кэша ). Из названий этих методов понятно что первый проверяет наличие определённых данных, второй эти данные
устанавливает, а третий - удаляет.
Откроем контроллер ответственный за записи в блогах и обратимся к методу actionShow. В нём мы будем кэшировать данные поступающие из базы. Изменим
код следующим образом. В начале мы получим номер запрашиваемой записи - он находится в параметре id. Далее, мы проверим - если кэш записи уже есть,
то достанем его и передадим в отображение. Если нет - вызовем метод loadRecords, сохраним в кэше его результат и передадим в отображение. Ничего сложного.

PHP код:


		
			
$id = (int) $_GET['id'];



if(Yii::app()->cache->get("show_{$id}") === false)

{

$model = $this->loadRecords();

Yii::app()->cache->set("show_{$id}",$model);

} else

$model = Yii::app()->cache->get("show_{$id}");



$this->render('show',array('model'=>$model));

Но ведь содержимое сообщения может изменяться. При этом старый кэш нужно будет удалять. В таких случаях следует описать вызов метода delete.
У нас они находятся в действиях редактирования и удаления. В "update" мы заменим код

PHP код:


		
			
if($model->save())

$this->redirect(array('show','id'=>$model->id));

на

PHP код:


		
			
if($model->save())

{

Yii::app()->cache->delete("show_{$model->id}");

$this->redirect(array('show','id'=>$model->id));

}

А в "delete", сразу перед редиректом мы вставим следующую строку:

PHP код:


		
			
Yii::app()->cache->delete("show_{$record->id}");

Всё, эта часть закончена.

Теперь рассмотрим работу с фрагментом страницы ( http://www.yiiframework.com/doc/guide/ru/caching.fragment ). Это ещё проще. Здесь задействуются
методы beginCache и endCache класса CController (то есть можно будет к нему обращаться в отображении через $this). Мы должны вызвать их в начале
и в конце того куска страницы который должен быть записан. При обращениях пользователей, если фрагмент уже находится в кэше он будет извлечён и
показан. Если же нет, то он выполнится и запишется.
Этим фрагментом будет код отвечающий за показ комментариев в отображении records/show. В качестве кэш-идентификатора у нас будет фраза
"comments_page_номер_страницы". Прямо перед заголовком "Комментарии" поместите следующий код:

PHP код:


		
			
<?if($this->beginCache("comments_page_{$model->id}")):?>

А после цикла foreach, и трёх переносов строк, вызов окончания кэширования.

PHP код:


		
			
<?$this->endCache("comments_page_{$model->id}");endif;?>

Ну и удаление кэша мы вызовем в контроллере Comments, в действии create, сразу перед редиректом.

PHP код:


		
			
Yii::app()->cache->delete("comments_page_{$_POST['Comments']['post_id']}");

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

Заключение.
На мой взгляд Yii, в отличие от многих других фреймворков, является инструментом с высоким порогом вхождения. Понять его основы, логику, принципы
и зависимости в начале довольно трудно. Так же мне кажется что утверждение разработчиков о том, что Yii можно использовать для любых приложений,
не верно. Всё-таки он больше подходит именно для веб-2.0-приложений ( как его позиционируют например на сайте журнала phpInside ). Если разобраться
то оказывается что по функционалу фреймворк очень хорош, и является одновременно мощным и простым.

Если в процессе чтения статьи у Вас что-то не получилось то Вы можете взять готовый код экспериментального приложения в архиве ready.zip. Удачи
Вам в Ваших проектах!

Кто нибудь осилил ?

Полезная статья о хорошем фреймворке =)
Кстати...к слову о rules() в моделе...
Если требуется проверить длинну и вывести соответствующее сообщение при не выполнении условия, то это делается так:

PHP код:


		
			
<?

class Feedback extends CActiveRecord

{

    public static function model($className=__CLASS__)

    {

        return parent::model($className);

    }



    public function rules()

    {        

        array('name',         'length',       'min'        => 2,          'tooShort'         =>

                Yii::t('common','tooShort_name')),

        array('name',         'length',       'max'        => 50,         'tooLong'           =>

                Yii::t('common','tooLong_name')),

        array('name',         'required',     'message'    =>

                Yii::t('common','empty_name')),

        );

    }



}

...

Спасибо! Буду знать =)