documentation/manual/ru/module_specs/Zend_Controller-Migration.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- Reviewed: no -->
   3 <sect1 id="zend.controller.migration">
   4     <title>Переход с предыдущих версий</title>
   5
   6     <para>
   7         API компонент системы MVC претерпевал изменения со временем. Если вы
   8         начали использование Zend Framework с его ранних версий, то следуйте
   9         приведенным ниже рекомендациям по переносу вашего кода на новую
  10         архитектуру.
  11     </para>
  12
  13     <sect2 id="zend.controller.migration.fromoneseventooneeight">
  14         <title>Переход с 1.7.x на 1.8.0 и более поздние версии</title>
  15
  16         <sect3 id="zend.controller.migration.fromoneseventooneeight.router">
  17             <title>Изменения в стандартном маршруте</title>
  18
  19             <para>
  20                 Поскольку в новый стандартный маршрут были добавлены
  21                 переводимые сегменты, символ <code>@</code> стал
  22                 специальным символом в начале сегмента маршрута.
  23                 Для того, чтобы можно было использовать его в статических
  24                 сегментах, вы должны экранировать его путем добавления второго
  25                 символа <code>@</code>. То же самое правило теперь применяется
  26                 и к символу <code>:</code>.
  27             </para>
  28         </sect3>
  29     </sect2>
  30
  31     <sect2 id="zend.controller.migration.fromonesixtooneseven">
  32         <title>Переход с 1.6.x на 1.7.0 и более поздние версии</title>
  33
  34         <sect3 id="zend.controller.migration.fromonesixtooneseven.dispatcher">
  35             <title>Изменения в интерфейсе диспетчера</title>
  36
  37             <para>
  38                 Пользователи обратили наше внимание на тот факт, что
  39                 <classname>Zend_Controller_Action_Helper_ViewRenderer</classname>
  40                 использует не присутствующий в интерфейсе метод из
  41                 абстрактного класса диспетчера. Мы добавили
  42                 этот метод в интерфейс диспетчера для того,
  43                 чтобы гарантировать работу созданного вами диспетчера с
  44                 классами, входящими в поставку Zend Framework:
  45             </para>
  46
  47             <itemizedlist>
  48                 <listitem><para>
  49                     <code>formatModuleName()</code>: должен принимать
  50                     необработанное имя контроллера (в том виде, в котором оно
  51                     хранится в объекте запроса) и преобразовывать его в имя
  52                     класса контроллера, наследующего от
  53                     <classname>Zend_Controller_Action</classname>.
  54                 </para></listitem>
  55             </itemizedlist>
  56         </sect3>
  57     </sect2>
  58
  59     <sect2 id="zend.controller.migration.fromoneohtoonesix">
  60         <title>Переход с 1.5.x на 1.6.0 и более поздние версии</title>
  61
  62         <sect3 id="zend.controller.migration.fromoneohtoonesix.dispatcher">
  63             <title>Изменения в интерфейсе диспетчера</title>
  64
  65             <para>
  66                 Пользователи обратили наше внимание на тот факт, что
  67                 <classname>Zend_Controller_Front</classname> и
  68                 <classname>Zend_Controller_Router_Route_Module</classname> используют
  69                 методы диспетчера, которые не определены в его интерфейсе.
  70                 Мы добавили следующие три метода в его интерфейс для того,
  71                 чтобы гарантировать работу созданного вами диспетчера с
  72                 классами, входящими в поставку Zend Framework:
  73             </para>
  74
  75             <itemizedlist>
  76                 <listitem><para>
  77                     <code>getDefaultModule()</code>: должен возвращать имя
  78                     используемого по умолчанию модуля.
  79                 </para></listitem>
  80
  81                 <listitem><para>
  82                     <code>getDefaultControllerName()</code>: должен возвращать
  83                     имя используемого по умолчанию контроллера.
  84                 </para></listitem>
  85
  86                 <listitem><para>
  87                     <code>getDefaultAction()</code>: должен возвращать имя
  88                     используемого по умолчанию действия.
  89                 </para></listitem>
  90             </itemizedlist>
  91         </sect3>
  92     </sect2>
  93
  94     <sect2 id="zend.controller.migration.fromoneohtoonefive">
  95         <title>Переход с 1.0.x на 1.5.0 и более поздние версии</title>
  96
  97         <para>
  98             Хотя основной набор функциональных возможностей остался тем же, и
  99             все документированные возможности не претерпели изменений, есть одна
 100             <emphasis>недокументированная</emphasis> "возможность", которая была
 101             изменена.
 102         </para>
 103
 104         <para>
 105             При написании URL-ов, документированным способом написания имен
 106             действий в формате camelCase является использование разделителей
 107             слов. По умолчанию это '.' или '-', но они могут быть заменены на
 108             другие символы путем настройки диспетчера. Диспетчер внутри себя
 109             приводит имена действий к нижнему регистру и использует эти
 110             разделители слов для "пересборки" имен действий с использованием
 111             формата camelCase. Но из-за того, что функции PHP не чувствительны к
 112             регистру, вы <emphasis>могли</emphasis> по-прежнему писать URL-ы в
 113             формате camelCasе, и результатом был запуск тех же методов
 114             действий. Например, 'camel-cased' должен был преобразовываться
 115             диспетчером в 'camelCasedAction', а 'camelCased' - в
 116             'camelcasedAction', но из-за нечувствительности PHP к регистру имен
 117             функций в обоих случаях будет произведен вызов одного и того же
 118             метода.
 119         </para>
 120
 121         <para>
 122             Это вызывало проблемы с ViewRenderer при определении имени скрипта
 123             вида. Документированный способ состоит в том, что все разделители
 124             слов преобразуются в тире, и слова приводятся к нижнему регистру.
 125             Это создает семантическую связь между действиями и скриптами видов,
 126             а нормализация гарантирует, что скрипты могут быть найдены. Тем не
 127             менее, если вызывается действие с именем 'camelCased' и благополучно
 128             обработано, то разделитель слов более не присутствует в имени, и
 129             ViewRenderer пытается вызвать другой скрипт вида -
 130             'camelcased.phtml' вместо 'camel-cased.phtml'.
 131         </para>
 132
 133         <para>
 134             Некоторые разработчики полагались на эту незапланированную
 135             "возможность". Тем не менее, некоторые изменения в дереве 1.5.0,
 136             привели к тому, что ViewRenderer более не ищет такие пути;
 137             семантическая связь теперь усилена. Главное, диспетчер
 138             теперь чувствителен к регистру в именах действий. Это значит, что
 139             ссылка на действие через URL с использованием формата camelCase
 140             не будет приводить к вызову того же метода, что и с использованием
 141             разделителей слов (т.е. 'camel-casing').
 142         </para>
 143
 144         <para>
 145             Если получилось, что вы используете эту "возможность", то в имеете
 146             несколько вариантов решения:
 147         </para>
 148
 149         <itemizedlist>
 150             <listitem><para>
 151                     Наилучший вариант: переименуйте ваши скрипты вида. Плюсы:
 152                     будущая совместимость. Минусы: если вы имеете много скриптов
 153                     вида, которые полагаются на старое, незапланированное
 154                     поведение, то вам придется сделать много переименований.
 155             </para></listitem>
 156
 157             <listitem>
 158                 <para>
 159                     Второй лучший вариант: ViewRenderer теперь делегирует
 160                     определение скриптов вида инфлектору
 161                     <classname>Zend_Filter_Inflector</classname>; вы можете изменить
 162                     правила инфлектора так, чтобы он более не разделял слова в
 163                     имени действия знаком тире:
 164                 </para>
 165
 166                 <programlisting language="php"><![CDATA[
 167 $viewRenderer =
 168     Zend_Controller_Action_HelperBroker::getStaticHelper('viewRenderer');
 169 $inflector = $viewRenderer->getInflector();
 170 $inflector->setFilterRule(':action', array(
 171     new Zend_Filter_PregReplace(
 172         '#[^a-z0-9' . preg_quote(DIRECTORY_SEPARATOR, '#') . ']+#i',
 173         ''
 174     ),
 175     'StringToLower'
 176 ));
 177 ]]></programlisting>
 178
 179                 <para>
 180                     Приведенный выше код изменит инфлектор таким образом, чтобы
 181                     он более не разделял слова в имени действия знаком тире; вы
 182                     можете также убрать фильтр 'StringToLower', если хотите,
 183                     чтобы реальные имена скриптов вида тоже были в формате
 184                     camelCase.
 185                 </para>
 186
 187                 <para>
 188                     Если переименование скриптов вида слишком утомительно или
 189                     требует много времени, то этот вариант будет наилучшим
 190                     решением на тот период, пока вы не найдете время на
 191                     переименование.
 192                 </para>
 193             </listitem>
 194
 195             <listitem>
 196                 <para>
 197                     Менее желательное решение: Вы можете заставить диспетчер
 198                     принимать имена действий в формате camelCase, установив
 199                     новый флаг фронт-контроллера 'useCaseSensitiveActions':
 200                 </para>
 201
 202                 <programlisting language="php"><![CDATA[
 203 $front->setParam('useCaseSensitiveActions', true);
 204 ]]></programlisting>
 205
 206                 <para>
 207                     Это позволит вам использовать camelCase в URL-ах и они будут
 208                     приводить к запуску тех действий, что и при использовании
 209                     разделителей слов. Тем не менее, это будет означать, что
 210                     исходная проблема может повлечь за собой другие; возможно,
 211                     вам потребуется также использовать описанный выше второй
 212                     вариант, чтобы все работало наверняка.
 213                 </para>
 214
 215                 <para>
 216                     Также заметьте, что использование этого флага приведет к
 217                     появлению предупреждения (notice) о том, что его
 218                     использование не рекомендуется.
 219                 </para>
 220             </listitem>
 221         </itemizedlist>
 222     </sect2>
 223
 224     <sect2 id="zend.controller.migration.fromzeroninethree">
 225         <title>Переход с 0.9.3 на 1.0.0RC1 и более поздние версии</title>
 226
 227         <para>
 228             Основные изменения, появившиеся в 1.0.0RC1 - это добавление
 229             включенного по умолчанию плагина
 230             <link linkend="zend.controller.plugins.standard.errorhandler">ErrorHandler</link>
 231             и помощника действий <link linkend="zend.controller.actionhelpers.viewrenderer">ViewRenderer</link>.
 232             Пожалуйста, прочитайте внимательно документацию к ним, чтобы понять,
 233             как они работают, и как они могут повлиять на работу ваших
 234             приложений.
 235         </para>
 236
 237         <para>
 238             Плагин <code>ErrorHandler</code> производит в методе
 239             <code>postDispatch()</code> проверку на предмет исключений и
 240             переход (forwarding) к определенному контроллеру-обработчику
 241             исключений. Вы можете отключить его путем установки параметра
 242             <code>noErrorHandler</code> во фронт-контроллере:
 243         </para>
 244
 245         <programlisting language="php"><![CDATA[
 246 $front->setParam('noErrorHandler', true);
 247 ]]></programlisting>
 248
 249         <para>
 250             Помощник действий <code>ViewRenderer</code> автоматизирует
 251             добавление вида в контроллеры действий и производит авторендеринг
 252             скрипта вида, выбранного по текущему действию. Первая проблема, с
 253             которой вы можете встретиться - у вас есть действия,
 254             которые не производят рендеринг скриптов вида и не производят
 255             переход или перенаправление, поскольку <code>ViewRenderer</code>
 256             будет пытаться запустить скрипт вида, выбранного по имени действия.
 257         </para>
 258
 259         <para>
 260             Есть несколько стратегий, используя которые, вы можете обновить свой
 261             код. В краткострочной перспективе решением может быть глобальное
 262             отключение <code>ViewRenderer</code> во фронт-контроллере до
 263             начала процесса диспетчеризации:
 264         </para>
 265
 266         <programlisting language="php"><![CDATA[
 267 // $front является экземпляром Zend_Controller_Front
 268 $front->setParam('noViewRenderer', true);
 269 ]]></programlisting>
 270
 271         <para>
 272             Но в долгосрочной перспективе это не лучшее решение, поскольку
 273             оно означает, что вам в будущем придется писать больше кода.
 274         </para>
 275
 276         <para>
 277             Когда вы будете готовы начать использование функционала
 278             <code>ViewRenderer</code>, то необходимо проверить некоторые места в
 279             коде контроллеров. Первое, просмотрите методы действий (методы,
 280             заканчивающиеся на 'Action') и определите, что делает каждый метод.
 281             Если не происходит ничего из следующего, то нужно произвести
 282             изменения:
 283         </para>
 284
 285         <itemizedlist>
 286             <listitem><para>
 287                 Вызов <varname>$this-&gt;render()</varname>
 288             </para></listitem>
 289             <listitem><para>
 290                 Вызов <varname>$this-&gt;_forward()</varname>
 291             </para></listitem>
 292             <listitem><para>
 293                 Вызов <varname>$this-&gt;_redirect()</varname>
 294             </para></listitem>
 295             <listitem><para>
 296                 Вызов помощника действий <code>Redirector</code>
 297             </para></listitem>
 298         </itemizedlist>
 299
 300         <para>
 301             Наиболее легким способом будет отключение авторендеринга в данном
 302             методе:
 303         </para>
 304
 305         <programlisting language="php"><![CDATA[
 306 $this->_helper->viewRenderer->setNoRender();
 307 ]]></programlisting>
 308
 309         <para>
 310             Если вы обнаружили, что ни один из методов действий не производит
 311             рендеринг, переход или перенаправление, то, скорее всего, нужно
 312             поместить эту строку в методы
 313             <code>preDispatch()</code> или <code>init()</code>:
 314         </para>
 315
 316         <programlisting language="php"><![CDATA[
 317 public function preDispatch()
 318 {
 319     // отключение авторендеринга скриптов вида
 320     $this->_helper->viewRenderer->setNoRender()
 321     // ... еще код ..
 322 }
 323 ]]></programlisting>
 324
 325         <para>
 326             Если вы вызываете <code>render()</code> и используете
 327             <link linkend="zend.controller.modular">определенную соглашением
 328             модульную структуру директорий</link>, то нужно
 329             изменить свой код так, чтобы использовался авторендеринг:
 330         </para>
 331
 332         <itemizedlist>
 333             <listitem>
 334                 <para>
 335                     Если производится рендеринг нескольких скриптов вида в
 336                     одном действии, то не нужно ничего изменять.
 337                 </para>
 338             </listitem>
 339             <listitem>
 340                 <para>
 341                     Если производится простой вызов метода
 342                     <code>render()</code> без аргументов, то можете удалить
 343                     соответствующие строки.
 344                 </para>
 345             </listitem>
 346             <listitem>
 347                 <para>
 348                     Если вызывается <code>render()</code> с аргументами и не
 349                     производится впоследствии каких-либо действий или рендеринга
 350                     нескольких скриптов вида, то можно заменить эти вызовы на
 351                     чтение <varname>$this-&gt;_helper-&gt;viewRenderer()</varname>.
 352                 </para>
 353             </listitem>
 354         </itemizedlist>
 355
 356         <para>
 357             На тот случай, если вы не используете определенную соглашением
 358             модульную структуру директорий, есть набор методов для
 359             установки базового пути к видам и спецификаций пути ко скрипту,
 360             поэтому вы сможете и в этом случае использовать
 361             <code>ViewRenderer</code>. Информацию об этих методах вы найдете в
 362             <link linkend="zend.controller.actionhelpers.viewrenderer">документации
 363             по ViewRenderer</link>
 364         </para>
 365
 366         <para>
 367             Если вы используете объект вида из реестра, создали свой объект
 368             вида, либо используете другие реализации встроенного, то может
 369             потребоваться добавить этот объект в <code>ViewRenderer</code>. Это
 370             легко можно сделать в любой момент времени.
 371         </para>
 372
 373         <itemizedlist>
 374             <listitem>
 375                 <para>
 376                     До начала диспетчеризации экземпляра фронт-контроллера:
 377                 </para>
 378
 379                 <programlisting language="php"><![CDATA[
 380 // Предполагается, что $view уже определен
 381 $viewRenderer = new Zend_Controller_Action_Helper_ViewRenderer($view);
 382 Zend_Controller_Action_HelperBroker::addHelper($viewRenderer);
 383 ]]></programlisting>
 384             </listitem>
 385
 386             <listitem>
 387                 <para>
 388                     В любой точке процесса загрузки (bootstrap process):
 389                 </para>
 390
 391                 <programlisting language="php"><![CDATA[
 392 $viewRenderer =
 393     Zend_Controller_Action_HelperBroker::getStaticHelper('viewRenderer');
 394 $viewRenderer->setView($view);
 395 ]]></programlisting>
 396             </listitem>
 397         </itemizedlist>
 398
 399         <para>
 400             Есть много способов модификации <code>ViewRenderer</code>, включая
 401             установку других скриптов вида для рендеринга, определение замещений
 402             для всех замещаемых элементов пути ко скрипту вида (включая
 403             суффикс), выбор именованного сегмента ответа в качестве
 404             используемого и др. Если вы не используете определенную соглашением
 405             модульную структуру директорий, то можете ассоциировать с
 406             <code>ViewRenderer</code> другие спецификации путей.
 407         </para>
 408
 409         <para>
 410             Рекомендуется адаптировать свой код для использования
 411             <code>ErrorHandler</code> и <code>ViewRenderer</code>, так как
 412             сейчас это лежащий в основе фреймворка функционал.
 413         </para>
 414     </sect2>
 415
 416     <sect2 id="zend.controller.migration.fromzeroninetwo">
 417         <title>Переход с 0.9.2 на 0.9.3 и более поздние версии</title>
 418
 419         <para>
 420             В версии 0.9.3 были добавлены <link
 421             linkend="zend.controller.actionhelpers">помощники действий</link>
 422             (action helpers).
 423             Это изменение включает в себя удаление перечисленных ниже методов
 424             из-за того, что сейчас они инкапсулированы в
 425             <link linkend="zend.controller.actionhelpers.redirector">помощнике
 426             перенаправлений</link> (redirector action helper):
 427         </para>
 428
 429         <itemizedlist>
 430             <listitem>
 431                 <para>
 432                     <code>setRedirectCode()</code>; используйте
 433                     <code>Zend_Controller_Action_Helper_Redirector::setCode()</code>.
 434                 </para>
 435             </listitem>
 436             <listitem>
 437                 <para>
 438                     <code>setRedirectPrependBase()</code>; используйте
 439                     <code>Zend_Controller_Action_Helper_Redirector::setPrependBase()</code>.
 440                 </para>
 441             </listitem>
 442             <listitem>
 443                 <para>
 444                     <code>setRedirectExit()</code>; используйте
 445                     <code>Zend_Controller_Action_Helper_Redirector::setExit()</code>.
 446                 </para>
 447             </listitem>
 448         </itemizedlist>
 449
 450         <para>
 451             Более подробную информацию о том, как извлекать и работать с
 452             объектами действий, читайте в <link
 453             linkend="zend.controller.actionhelpers">документации по помощникам
 454             действий</link>. Об установке опций перенаправления и альтернативных
 455             методах перенаправления читайте в <link
 456             linkend="zend.controller.actionhelpers.redirector">документации по
 457             помощнику перенаправлений</link>.
 458         </para>
 459     </sect2>
 460
 461     <sect2 id="zend.controller.migration.fromzerosix">
 462         <title>Переход с 0.6.0 на 0.8.0 и более поздние версии</title>
 463
 464         <para>
 465             Базовое использование компонент MVC не изменилось:
 466         </para>
 467
 468         <programlisting language="php"><![CDATA[
 469 Zend_Controller_Front::run('/path/to/controllers');
 470 ]]></programlisting>
 471
 472         <para>
 473             Тем не менее, структура директорий была подвергнута пересмотру,
 474             некоторые компоненты были удалены, другие добавлены или
 475             переименованы. Изменения включают в себя следующее:
 476         </para>
 477
 478         <itemizedlist>
 479             <listitem>
 480                 <para>
 481                     <classname>Zend_Controller_Router</classname> удален в пользу
 482                     использования Rewrite Router.
 483                 </para>
 484             </listitem>
 485
 486             <listitem>
 487                 <para>
 488                     <classname>Zend_Controller_RewriteRouter</classname> переименован в
 489                     <classname>Zend_Controller_Router_Rewrite</classname>, теперь это
 490                     стандартный маршрутизатор, поставляемый с фреймворком.
 491                     <classname>Zend_Controller_Front</classname> будет использовать его по
 492                     умолчанию, если не был установлен другой маршрутизатор.
 493                 </para>
 494             </listitem>
 495
 496             <listitem>
 497                 <para>
 498                     Добавлен новый класс маршрута для использования с Rewrite
 499                     Router - <classname>Zend_Controller_Router_Route_Module</classname>.
 500                     Он включает в себя маршрут по умолчанию, используемый
 501                     MVC, и поддерживает <link
 502                         linkend="zend.controller.modular">модули
 503                         контроллеров</link>.
 504                 </para>
 505             </listitem>
 506
 507             <listitem>
 508                 <para>
 509                     <classname>Zend_Controller_Router_StaticRoute</classname> переименован
 510                     в <classname>Zend_Controller_Router_Route_Static</classname>.
 511                 </para>
 512             </listitem>
 513
 514             <listitem>
 515                 <para>
 516                     <classname>Zend_Controller_Dispatcher</classname> переименован в
 517                     <classname>Zend_Controller_Dispatcher_Standard</classname>.
 518                 </para>
 519             </listitem>
 520
 521             <listitem>
 522                 <para>
 523                     Аргументы метода
 524                     <code>Zend_Controller_Action::_forward()</code> изменились.
 525                     Его сигнатура теперь:
 526                 </para>
 527
 528                 <programlisting language="php"><![CDATA[
 529 final protected function _forward($action,
 530                                   $controller = null,
 531                                   $module = null,
 532                                   array $params = null);
 533 ]]></programlisting>
 534
 535                 <para>
 536                     <varname>$action</varname> - обязательный аргумент. Если не был
 537                     определен контроллер, то предполагается, что вызывается
 538                     действие в текущем контроллере. <varname>$module</varname> всегда
 539                     игнорируется, если не определен контроллер. Все переданные в
 540                     аргументе <varname>$params</varname> параметры будут добавлены в
 541                     объект запроса. Если вы не запрашиваете контроллер или
 542                     модуль, но нужно передать параметры, то просто укажите null
 543                     на месте соответствующих аргументов.
 544                 </para>
 545             </listitem>
 546         </itemizedlist>
 547     </sect2>
 548
 549     <sect2 id="zend.controller.migration.fromzerotwo">
 550         <title>Переход с 0.2.0 и более ранних версий на 0.6.0</title>
 551
 552         <para>
 553             Базовое использование компонент системы MVC не изменилось,
 554             следующий код будет корректно выполняться и в версии 0.6.0:
 555         </para>
 556
 557         <programlisting language="php"><![CDATA[
 558 Zend_Controller_Front::run('/path/to/controllers');
 559 ]]></programlisting>
 560
 561         <programlisting language="php"><![CDATA[
 562 /* -- создание маршрутизатора -- */
 563 $router = new Zend_Controller_RewriteRouter();
 564 $router->addRoute('user',
 565                   'user/:username',
 566                   array('controller' => 'user', 'action' => 'info')
 567 );
 568
 569 /* -- установка его во фронт-контроллере -- */
 570 $ctrl = Zend_Controller_Front::getInstance();
 571 $ctrl->setRouter($router);
 572
 573 /* -- установка директории контроллеров и запуск диспетчеризации -- */
 574 $ctrl->setControllerDirectory('/path/to/controllers');
 575 $ctrl->dispatch();
 576 ]]></programlisting>
 577
 578         <para>
 579             Рекомендуется использовать объект ответа для сбора содержимого и
 580             заголовков. Это дает большую гибкость при переключении
 581             между разными форматами вывода (например, JSON или XML вместо XHTML)
 582             в приложениях. По умолчанию <code>dispatch()</code> будет возвращать
 583             ответ, отправляя заголовки и выводя весь контент. Можно также
 584             сделать так, чтобы фронт-контроллер возвращал ответ, используя метод
 585             <code>returnResponse()</code>, и затем выводить ответ так, как нужно
 586             вам. Будущая версия фронт-контроллер может принуждать к
 587             использованию объекта ответа посредством буферизации вывода.
 588         </para>
 589
 590         <para>
 591             Также добавлено много новых функциональных возможностей,
 592             расширяющих существующий API, они описаны в документации.
 593         </para>
 594
 595         <para>
 596             Основные изменения, о которых следует знать, касаются расширения
 597             существующих компонент. Наиболее важные из них следующие:
 598         </para>
 599
 600         <itemizedlist>
 601             <listitem>
 602                 <para>
 603                     <code>Zend_Controller_Front::dispatch()</code> по умолчанию
 604                     отлавливает все исключения в объекте ответа и не отображает
 605                     их для предотвращения раскрытия данных о системе. Вы
 606                     можете переопределить это поведение несколькими способами:
 607                 </para>
 608
 609                 <itemizedlist>
 610                     <listitem>
 611                         <para>
 612                             Установка <code>throwExceptions()</code> во
 613                             фронт-контроллере:
 614                         </para>
 615                         <programlisting language="php"><![CDATA[
 616 $front->throwExceptions(true);
 617 ]]></programlisting>
 618                     </listitem>
 619
 620                     <listitem>
 621                         <para>
 622                             Установка <code>renderExceptions()</code> в объекте
 623                             ответа:
 624                         </para>
 625                         <programlisting language="php"><![CDATA[
 626 $response->renderExceptions(true);
 627 $front->setResponse($response);
 628 $front->dispatch();
 629
 630 // или:
 631 $front->returnResponse(true);
 632 $response = $front->dispatch();
 633 $response->renderExceptions(true);
 634 echo $response;
 635 ]]></programlisting>
 636                     </listitem>
 637                 </itemizedlist>
 638             </listitem>
 639
 640             <listitem><para>
 641                 <code>Zend_Controller_Dispatcher_Interface::dispatch()</code>
 642                 теперь принимает и возвращает объект запроса
 643                 <xref linkend="zend.controller.request" />
 644                 вместо метки <classname>Zend_Controller_Dispatcher_Token</classname>.
 645             </para></listitem>
 646
 647             <listitem><para>
 648                 <code>Zend_Controller_Router_Interface::route()</code>
 649                 теперь принимает и возвращает объект ответа
 650                 <xref linkend="zend.controller.request" />
 651                 вместо метки <classname>Zend_Controller_Dispatcher_Token</classname>
 652             </para></listitem>
 653
 654             <listitem>
 655                 <para>
 656                     Изменения <classname>Zend_Controller_Action</classname> включают в
 657                     себя следующее:
 658                 </para>
 659
 660                 <itemizedlist>
 661                     <listitem><para>
 662                         Его конструктор теперь включает в себя три аргумента:
 663                         <code>Zend_Controller_Request_Abstract $request</code>,
 664                         <code>Zend_Controller_Response_Abstract $response</code>
 665                         и <code>array $params</code> (необязательный).
 666                         <code>Zend_Controller_Action::__construct()</code>
 667                         использует их для установки запроса, ответа и свойств
 668                         объекта (аргументов вызова); переопределяя конструктор,
 669                         вам следует реализовать те же операции.
 670                         Но лучше использовать метод <code>init()</code> для
 671                         выполнения любого конфигурирования экземпляра класса,
 672                         так как этот метод вызывается в конце конструктора.
 673                     </para></listitem>
 674
 675                     <listitem><para>
 676                         Метод <code>run()</code> теперь не определен с ключевым
 677                         словом <code>final</code>, но он также и не используется
 678                         во фронт-контроллере; единственным его назначением
 679                         является использование класса как контроллера страниц.
 680                         Теперь он принимает два необязательных аргумента –
 681                         <code>Zend_Controller_Request_Abstract $request</code>
 682                         и <code>Zend_Controller_Response_Abstract $response</code>.
 683                     </para></listitem>
 684
 685                     <listitem><para>
 686                         <code>indexAction()</code> уже не обязателен для
 687                         определения, но все же рекомендуется определять его в
 688                         качестве действия по умолчанию. Это позволяет
 689                         использовать RewriteRouter и контроллеры действий для
 690                         указания других используемых по умолчанию методов
 691                         действий.
 692                     </para></listitem>
 693
 694                     <listitem><para>
 695                         <code>__call()</code> должен переопределяться для
 696                         автоматической обработки вызовов действий, не
 697                         определенных в классе контроллера.
 698                     </para></listitem>
 699
 700                     <listitem><para>
 701                         Метод <code>_redirect()</code> теперь принимает второй
 702                         необязательный аргумент, HTTP-код, который должен
 703                         возвращаться при перенаправлении, и третий
 704                         необязательный аргумент, <varname>$prependBase</varname>,
 705                         который указывает, что базовый URL, зарегистрированный в
 706                         объекте запроса, должен предшествовать URL, переданному
 707                         в первом аргументе.
 708                     </para></listitem>
 709
 710                     <listitem>
 711                         <para>
 712                             Свойство <code>_action</code> больще не
 713                             устанавливается. Это свойство было объектом класса
 714                             <classname>Zend_Controller_Dispatcher_Token</classname>,
 715                             которй больше не существует в текущем воплощении.
 716                             Единственным назначением метки (token) было
 717                             предоставление информации о запрошенных контроллере,
 718                             действии и параметрах URL. Эта информация теперь
 719                             доступна в объекте запроса, и доступ к ней можно
 720                             получить следующим образом:
 721                         </para>
 722
 723                         <programlisting language="php"><![CDATA[
 724 // Извлечение имени запрошенного контроллера
 725 // Ранее доступ был через $this->_action->getControllerName().
 726 // Пример ниже использует getRequest(), хотя вы можете обращаться напрямую
 727 // ко свойству $_request; рекомендуется использовать getRequest(), поскольку
 728 // родительский класс может переопределить доступ к объекту запроса.
 729 $controller = $this->getRequest()->getControllerName();
 730
 731 // Извлечение имени запрошенного действия
 732 // Ранее доступ был через $this->_action->getActionName().
 733 $action = $this->getRequest()->getActionName();
 734
 735 // Извлечение параметров запроса
 736 // Оно не изменилось; _getParams() и _getParam() просто вызывают аналогичные
 737 // методы объекта запроса
 738 $params = $this->_getParams();
 739
 740 // запрашивается параметр 'foo', если параметр не найден,
 741 // то используется значение по умолчанию 'default'
 742 $foo = $this->_getParam('foo', 'default');
 743 ]]></programlisting>
 744                     </listitem>
 745
 746                     <listitem>
 747                         <para>
 748                             Удален метод <code>noRouteAction()</code>.
 749                             Подходящим способом обработки несуществующих методов
 750                             действий будет перенаправление к действию по
 751                             умолчанию через <code>__call()</code>:
 752                         </para>
 753
 754                         <programlisting language="php"><![CDATA[
 755 public function __call($method, $args)
 756 {
 757     // Если запрошен несуществующий метод действия, то вызывается метод
 758     // действия по умолчанию:
 759     if ('Action' == substr($method, -6)) {
 760         return $this->defaultAction();
 761     }
 762
 763     throw new Zend_Controller_Exception('Invalid method called');
 764 }
 765 ]]></programlisting>
 766                     </listitem>
 767                 </itemizedlist>
 768             </listitem>
 769
 770             <listitem><para>
 771                 Удален метод
 772                 <code>Zend_Controller_RewriteRouter::setRewriteBase()</code>.
 773                 Вместо него используйте
 774                 <code>Zend_Controller_Front::setBaseUrl()</code> (или
 775                 <code>Zend_Controller_Request_Http::setBaseUrl()</code>,
 776                 если используется класс запроса).
 777             </para></listitem>
 778
 779             <listitem><para>
 780                 <classname>Zend_Controller_Plugin_Interface</classname> был заменен на
 781                 <classname>Zend_Controller_Plugin_Abstract</classname>. Все методы теперь
 782                 принимают и возвращают объект ответа
 783                 <xref linkend="zend.controller.request" /> вместо метки
 784                 диспетчеризации.
 785             </para></listitem>
 786         </itemizedlist>
 787     </sect2>
 788 </sect1>
 789 <!--
 790 vim:se ts=4 sw=4 et:
 791 -->