Шаг 5 : Контроллер

Давайте сегодня поговорим что же такое “контроллер” и для чего он используется в приложениях на базе MVC

В уроке номер три вы должны были познакомится с кратким описанием что такое контроллер и какие основные функции он выполняет. Для тех кто уже забыл - повторим в более расширенной форме. В Yii фреймворке контроллером считается класс наследуемый от CController или дочернего от него класса.

В этом уроке у нас будет много примеров работы с контроллером, поэтому давайте договоримся что вы не только читаете урок, но и параллельно выполняете его примеры у себя на хостинге (или локалхосте). Самое удобное будет если вы установите yii-blog из официальной документации (http://www.yiiframework.com/doc/blog/ru/start.overview).

Вот как делаю это я:

1. Зайди на страницу “Download” (http://www.yiiframework.com/download/) и выкачай последнюю версию фреймворка
2. Распакуй. Залей к себе на хостинг
3. Войди в папку demo/blog. Скопируй все что там внутри и перемести в корневую папку что бы получилось что папка protected и yii-1.1.2.rN теперь на одном уровне.
4. Открой index.php и измени пути к папке фреймворка и конфиг файла
5. Заходи к себе через www.mysite.ru и проверь работает ли блог

Больше не какой настройкой заниматься не надо, работает и хорошо. Идем дальше.

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

Пример 1

В Yii есть отличный класс CUrlManager который отвечает за обработку url по которому обратились к нашему приложению. Зайдя по ссылке www.mysite.ru/hello/world сразу начнет работу CUrlManager и определит куда дальше передать запрос на обработку.

Правила обработки url задаются в главном конфиг файле приложения (обычно protected/config/main.php) и могут быть дополнены или изменены вами в любой момент. По умолчанию забито самое главное правило вашего приложения:

'<controller:\w+>/<action:\w+>'=>'<controller>/<action>',

<?php
class HelloController extends CController
{
   public function actionWorld()
   {
       echo 'Привет от HelloController->actionWorld()';
   }
}

<?php
class HelloController extends CController
{
   public function actionWorld()
   {
       echo 'Привет от HelloController->actionWorld()';
   }
   public function actionStepan()
   {
       echo 'Привет Степан!';
   }
   public function actionDima()
   {
       echo 'Привет Дима!';
   }
   public function actionIvan()
   {
       echo 'Привет Иван!';
   }
}

Идем дальше...

В каждом приложении существует такое понятие как контроллер “по умолчанию”. Он используется для обработки url когда параметр контроллера опущен совсем. К примеру, при попытке пользователя открыть www.mysite.ru/ какой контроллер будет отвечать за отображение страницы? Правильно, контроллер по умолчанию.

прим. Контроллер по умолчанию задается в файле конфигурации приложения (обычно config/main.php) в виде парраметра defaultController, например: 'defaultController'=>'index'. Если параметр не указан, контроллер по умолчанию - site

Существует еще понятие как экшин “по умолчанию”. Он выполняется в том случае когда не указанно явно к какому экшину идет обращение. К примеру, при попытке открыть www.mysite.ru/hello/ как скрипту узнать к какому экшину контроллера Hello происходит обращение? В этом случае и будет вызван экшин по умолчанию!

прим. Экшин по умолчанию задается прямо в файле контроллера в виде переменной defaultAction, например $defaultAction = ‘test’. Если параметр не указан, экшин по умолчанию - index

Пример 2

Посмотрели вы что я написал и подумали : “Если для каждой страницы создавать свой экшин - тогда как быть с новостями на сайте? Забивать их в ручную и создавать для каждой свой экшин? Бреееддд”. Совершенно верно подумали :) Совсем не обязательно создавать новый экшин для каждой страницы ваших новостей.

Давайте предположим что мы хотим организовать специальные новости для своего сайта. Для начала откроем контроллер с которым мы уже работали (HelloController) и добавим туда новый экшин:

  public function actionNews()
  {
      echo “Вы открыли новость: ” , $_GET['news_name'];
  }

'urlManager'=>array(
   'urlFormat'=>'path',
   'rules'=>array(
       'post/<id:\d+>/<title:.*?>'=>'post/view',
       'posts/<tag:.*?>'=>'post/index',
       '<controller:\w+>/<action:\w+>'=>'<controller>/<action>',
   ),
),

'news/<news_name:.*?>'=>'hello/news

Идем дальше...

Контроллер сам по себе это сердце логики вашего приложения. В нем вы должны выполнять всякие проверки, обращение к данным из модели и тп. Я мог бы растянуть урок рассказами о том как использовать собственные фильтры в контроллерах, как наследовать их и тп - но все это только запудрит вам голову. Если вы действительно поймете для чего нужен контроллер - вы сможете дойти до всяких “фильтров” сами, прочитав маленький мануальчик.

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

Из примера 2 у нас уже есть некий набросок для страницы новостей. У нас работают ссылки www.mysite.ru/news/my_test_news и мы можем перейти к следующему этапу разработки.

Пример 3

Давайте немного модернизируем наши новости. Задание достаточное простое: новости у нас находятся в тестовых файлах, а параметр news_name является этим самым именем файла. Открыв страницу www.mysite.ru/news/numb1 на странице должно выводится содержимое файла numb1.txt соответственно.
Модернизируем немного наш экшин:

   function actionNews()
   {
       if (!empty($_GET['news_name'])) {
           // если значение не пустое...
           // выводим содержимое переданного файла с расширением txt
           echo file_get_contents($_GET['news_name'] . ".txt");
       }
   }

   function actionNews()
   {
       if (!empty($_GET['news_name'])) {
           // если значение не пустое...
           // загоняем в переменную имя файла который надо открыть
           $file_name = $_GET['news_name'] . ".txt";
           if (file_exists($file_name)) {
               // если файл существует
               // выводим на экран его содержимое
               echo file_get_contents($file_name);
           } else {
               // если файл не найден
               echo 'Новость уже удалили :(';
           }
       }
   }

Идем дальше...

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

Для написания следующей части урока мне потребуется немного времени и пока я буду этим занят вы выполните мое маленькое задание. Нет, писать сайты вместо меня и заниматься другой грязной работой не потребуется :)) Я предлагаю вам модернизировать наш “Пример 3” и вместо открытия новостей из файлов - постараться получить данные из БД. Помните, в прошлом уроке мы уже научились получать данные из базы методами find и findAll? Постарайтесь выполнить это самостоятельно для закрепления материала по контроллерам.  

Вот маленькая подсказка от меня:

1. Создаем таблицу в базе данных для наших новостей (через phpmyadmin). Для начала всего три поля: id, url_name,text
2. Создаем файл модели
3. Изменяем наш экшин таким образом что б он брал данные из нашей модели где url_name = news_name
4. Делаем что б если новость найдена - поле text выводилось на экран

От себя

Спасибо что прочитали все это! Желаю вам сил и терпения в изучении Yii Framework.