<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/book.yaf.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ru',
  ),
  'this' => 
  array (
    0 => 'class.yaf-controller-abstract.php',
    1 => 'Yaf_Controller_Abstract',
    2 => 'Класс Yaf_Controller_Abstract',
  ),
  'up' => 
  array (
    0 => 'book.yaf.php',
    1 => 'Yaf',
  ),
  'prev' => 
  array (
    0 => 'yaf-config-simple.valid.php',
    1 => 'Yaf_Config_Simple::valid',
  ),
  'next' => 
  array (
    0 => 'yaf-controller-abstract.construct.php',
    1 => 'Yaf_Controller_Abstract::__construct',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ru',
    'path' => 'reference/yaf/yaf-controller-abstract.xml',
  ),
  'history' => 
  array (
  ),
  'extra_header_links' => 
  array (
    'rel' => 'alternate',
    'href' => '/manual/en/feeds/class.yaf-controller-abstract.atom',
    'type' => 'application/atom+xml',
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="class.yaf-controller-abstract" class="reference">

 <h1 class="title">Класс Yaf_Controller_Abstract</h1>
 

 <div class="partintro"><p class="verinfo">(Yaf &gt;=1.0.0)</p>

  
  <div class="section" id="yaf-controller-abstract.intro">
   <h2 class="title">Введение</h2>
   <p class="para">
    <span class="classname"><strong class="classname">Yaf_Controller_Abstract</strong></span> это сердце системы Yaf.
    MVC расшифровывается как Model-View-Controller и представляет собой шаблон проектирования,
    предназначенный для отделения логики приложения от логики отображения
   </p>
   <p class="para">
    Каждый пользовательский контроллер должен наследовать
    <span class="classname"><strong class="classname">Yaf_Controller_Abstract</strong></span>.
   </p>
   <p class="para">
    Вы обнаружите, что не можете определить функцию __construct для своего пользовательского
    контроллера, поэтому <span class="classname"><strong class="classname">Yaf_Controller_Abstract</strong></span> предоставляет
   </p>
   <p class="para">
    Если вы определили метод init() в своём пользовательском контроллере, он будет
    вызываться до тех пор, пока будет создан экземпляр контроллера.
   </p>
   <p class="para">
    У действия при поступлении запроса могут быть аргументы. Если в параметрах запроса есть
    одна и та же переменная имени
    (<span class="methodname"><a href="yaf-request-abstract.getparam.php" class="methodname">Yaf_Request_Abstract::getParam()</a></span>) после перенаправления,
    Yaf передаст их методу действия (<span class="methodname"><a href="yaf-action-abstract.execute.php" class="methodname">Yaf_Action_Abstract::execute()</a></span>).
    <blockquote class="note"><p><strong class="note">Замечание</strong>: 
     <p class="para">
      Аргументы извлекаются напрямую без фильтрации, перед использованием
      их следует тщательно обработать.
     </p>
    </p></blockquote>
   </p>
  </div>
  

  <div class="section" id="yaf-controller-abstract.synopsis">
   <h2 class="title">Обзор класса</h2>

   
   <div class="classsynopsis">
    <span class="ooclass"><strong class="classname"></strong></span>

    
    <div class="classsynopsisinfo">
     <span class="ooclass">
      <span class="modifier">abstract</span>
      <span class="modifier">class</span> <strong class="classname">Yaf_Controller_Abstract</strong>
     </span>
     {</div>
    
    <div class="classsynopsisinfo classsynopsisinfo_comment">/* Свойства */</div>
    <div class="fieldsynopsis">
     <span class="modifier">public</span>
      <var class="varname"><a href="class.yaf-controller-abstract.php#yaf-controller-abstract.props.actions">$<var class="varname">actions</var></a></var>;</div>

    <div class="fieldsynopsis"><span class="modifier">protected</span>
      <var class="varname"><a href="class.yaf-controller-abstract.php#yaf-controller-abstract.props.module">$<var class="varname">_module</var></a></var>;</div>

    <div class="fieldsynopsis"><span class="modifier">protected</span>
      <var class="varname"><a href="class.yaf-controller-abstract.php#yaf-controller-abstract.props.name">$<var class="varname">_name</var></a></var>;</div>

    <div class="fieldsynopsis"><span class="modifier">protected</span>
      <var class="varname"><a href="class.yaf-controller-abstract.php#yaf-controller-abstract.props.request">$<var class="varname">_request</var></a></var>;</div>

    <div class="fieldsynopsis"><span class="modifier">protected</span>
      <var class="varname"><a href="class.yaf-controller-abstract.php#yaf-controller-abstract.props.response">$<var class="varname">_response</var></a></var>;</div>

    <div class="fieldsynopsis"><span class="modifier">protected</span>
      <var class="varname"><a href="class.yaf-controller-abstract.php#yaf-controller-abstract.props.invoke-args">$<var class="varname">_invoke_args</var></a></var>;</div>

    <div class="fieldsynopsis"><span class="modifier">protected</span>
      <var class="varname"><a href="class.yaf-controller-abstract.php#yaf-controller-abstract.props.view">$<var class="varname">_view</var></a></var>;</div>



    <div class="classsynopsisinfo classsynopsisinfo_comment">/* Методы */</div>
    <div class="constructorsynopsis dc-description">
   <span class="modifier">final</span> <span class="modifier">private</span> <span class="methodname"><a href="yaf-controller-abstract.construct.php" class="methodname">__construct</a></span>()</div>

    <div class="methodsynopsis dc-description"><span class="modifier">protected</span> <span class="methodname"><a href="yaf-controller-abstract.display.php" class="methodname">display</a></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$tpl</code></span>, <span class="methodparam"><span class="type"><a href="language.types.array.php" class="type array">array</a></span> <code class="parameter">$parameters</code><span class="initializer"> = ?</span></span>): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-controller-abstract.forward.php" class="methodname">forward</a></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$action</code></span>, <span class="methodparam"><span class="type"><a href="language.types.array.php" class="type array">array</a></span> <code class="parameter">$paramters</code><span class="initializer"> = ?</span></span>): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-controller-abstract.getinvokearg.php" class="methodname">getInvokeArg</a></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$name</code></span>): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-controller-abstract.getinvokeargs.php" class="methodname">getInvokeArgs</a></span>(): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-controller-abstract.getmodulename.php" class="methodname">getModuleName</a></span>(): <span class="type"><a href="language.types.string.php" class="type string">string</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-controller-abstract.getname.php" class="methodname">getName</a></span>(): <span class="type"><a href="language.types.string.php" class="type string">string</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-controller-abstract.getrequest.php" class="methodname">getRequest</a></span>(): <span class="type"><a href="class.yaf-request-abstract.php" class="type Yaf_Request_Abstract">Yaf_Request_Abstract</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-controller-abstract.getresponse.php" class="methodname">getResponse</a></span>(): <span class="type"><a href="class.yaf-response-abstract.php" class="type Yaf_Response_Abstract">Yaf_Response_Abstract</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-controller-abstract.getview.php" class="methodname">getView</a></span>(): <span class="type"><a href="class.yaf-view-interface.php" class="type Yaf_View_Interface">Yaf_View_Interface</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-controller-abstract.getviewpath.php" class="methodname">getViewpath</a></span>(): <span class="type"><a href="language.types.string.php" class="type string">string</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-controller-abstract.init.php" class="methodname">init</a></span>(): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-controller-abstract.initview.php" class="methodname">initView</a></span>(<span class="methodparam"><span class="type"><a href="language.types.array.php" class="type array">array</a></span> <code class="parameter">$options</code><span class="initializer"> = ?</span></span>): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-controller-abstract.redirect.php" class="methodname">redirect</a></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$url</code></span>): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">protected</span> <span class="methodname"><a href="yaf-controller-abstract.render.php" class="methodname">render</a></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$tpl</code></span>, <span class="methodparam"><span class="type"><a href="language.types.array.php" class="type array">array</a></span> <code class="parameter">$parameters</code><span class="initializer"> = ?</span></span>): <span class="type"><a href="language.types.string.php" class="type string">string</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-controller-abstract.setviewpath.php" class="methodname">setViewpath</a></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$view_directory</code></span>): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>

   }</div>
   

  </div>


  
  <div class="section" id="yaf-controller-abstract.props">
   <h2 class="title">Свойства</h2>
   <dl>
    
     <dt id="yaf-controller-abstract.props.actions"><var class="varname">actions</var></dt>
     <dd>
      <p class="para">
       Вы также можете определить метод действия в отдельном скрипте PHP, используя
       это свойство и <span class="classname"><a href="class.yaf-action-abstract.php" class="classname">Yaf_Action_Abstract</a></span>.
       <div class="example" id="example-1">
        <p><strong>Пример #1 Определение действия в отдельном файле</strong></p>
        <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">class </span><span style="color: #0000BB">IndexController </span><span style="color: #007700">extends </span><span style="color: #0000BB">Yaf_Controller_Abstract </span><span style="color: #007700">{<br />    protected </span><span style="color: #0000BB">$actions </span><span style="color: #007700">= array(<br />        </span><span style="color: #FF8000">/** теперь dummyAction определяется в отдельном файле */<br />        </span><span style="color: #DD0000">"dummy" </span><span style="color: #007700">=&gt; </span><span style="color: #DD0000">"actions/Dummy_action.php"</span><span style="color: #007700">,<br />    );<br /><br />    </span><span style="color: #FF8000">/* у метода действия могут быть аргументы */<br />    </span><span style="color: #007700">public function </span><span style="color: #0000BB">indexAction</span><span style="color: #007700">(</span><span style="color: #0000BB">$name</span><span style="color: #007700">, </span><span style="color: #0000BB">$id</span><span style="color: #007700">) {<br />       </span><span style="color: #FF8000">/* $name и $id небезопасные необработанные данные */<br />       </span><span style="color: #0000BB">assert</span><span style="color: #007700">(</span><span style="color: #0000BB">$name </span><span style="color: #007700">== </span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">getRequest</span><span style="color: #007700">()-&gt;</span><span style="color: #0000BB">getParam</span><span style="color: #007700">(</span><span style="color: #DD0000">"name"</span><span style="color: #007700">));<br />       </span><span style="color: #0000BB">assert</span><span style="color: #007700">(</span><span style="color: #0000BB">$id   </span><span style="color: #007700">== </span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">_request</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">getParam</span><span style="color: #007700">(</span><span style="color: #DD0000">"id"</span><span style="color: #007700">));<br />    }<br />}<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
       </div>

       </div>
       <div class="example" id="example-2">
        <p><strong>Пример #2 Dummy_action.php</strong></p>
        <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">class </span><span style="color: #0000BB">DummyAction </span><span style="color: #007700">extends </span><span style="color: #0000BB">Yaf_Action_Abstract </span><span style="color: #007700">{<br />    </span><span style="color: #FF8000">/* класс действия должен определить этот метод как точку входа */<br />    </span><span style="color: #007700">public function </span><span style="color: #0000BB">execute</span><span style="color: #007700">() {<br />    }<br />}<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
       </div>

       </div>
      </p>
     </dd>
    
    
     <dt id="yaf-controller-abstract.props.module"><var class="varname">_module</var></dt>
     <dd>
      <p class="para">
       имя модуля
      </p>
     </dd>
    
    
     <dt id="yaf-controller-abstract.props.name"><var class="varname">_name</var></dt>
     <dd>
      <p class="para">
       имя контроллера
      </p>
     </dd>
    
    
     <dt id="yaf-controller-abstract.props.request"><var class="varname">_request</var></dt>
     <dd>
      <p class="para">
       текущий объект запроса
      </p>
     </dd>
    
    
     <dt id="yaf-controller-abstract.props.response"><var class="varname">_response</var></dt>
     <dd>
      <p class="para">
       текущий объект ответа
      </p>
     </dd>
    
    
     <dt id="yaf-controller-abstract.props.invoke-args"><var class="varname">_invoke_args</var></dt>
     <dd>
      <p class="para"/>
     </dd>
    
    
     <dt id="yaf-controller-abstract.props.view"><var class="varname">_view</var></dt>
     <dd>
      <p class="para">
       объект движка отображения
      </p>
     </dd>
    
   </dl>
  </div>
  


 </div>

 














































































































<h2>Содержание</h2><ul class="chunklist chunklist_reference"><li><a href="yaf-controller-abstract.construct.php">Yaf_Controller_Abstract::__construct</a> — Конструктор класса Yaf_Controller_Abstract</li><li><a href="yaf-controller-abstract.display.php">Yaf_Controller_Abstract::display</a> — Назначение display</li><li><a href="yaf-controller-abstract.forward.php">Yaf_Controller_Abstract::forward</a> — Переходит к другому действию</li><li><a href="yaf-controller-abstract.getinvokearg.php">Yaf_Controller_Abstract::getInvokeArg</a> — Назначение getInvokeArg</li><li><a href="yaf-controller-abstract.getinvokeargs.php">Yaf_Controller_Abstract::getInvokeArgs</a> — Назначение getInvokeArgs</li><li><a href="yaf-controller-abstract.getmodulename.php">Yaf_Controller_Abstract::getModuleName</a> — Получает имя модуля</li><li><a href="yaf-controller-abstract.getname.php">Yaf_Controller_Abstract::getName</a> — Получает своё имя</li><li><a href="yaf-controller-abstract.getrequest.php">Yaf_Controller_Abstract::getRequest</a> — Получает текущий объект запроса</li><li><a href="yaf-controller-abstract.getresponse.php">Yaf_Controller_Abstract::getResponse</a> — Получает текущий объект ответа</li><li><a href="yaf-controller-abstract.getview.php">Yaf_Controller_Abstract::getView</a> — Получает движок отображения</li><li><a href="yaf-controller-abstract.getviewpath.php">Yaf_Controller_Abstract::getViewpath</a> — Назначение getViewpath</li><li><a href="yaf-controller-abstract.init.php">Yaf_Controller_Abstract::init</a> — Инициализатор контроллера</li><li><a href="yaf-controller-abstract.initview.php">Yaf_Controller_Abstract::initView</a> — Назначение initView</li><li><a href="yaf-controller-abstract.redirect.php">Yaf_Controller_Abstract::redirect</a> — Перенаправляет на URL</li><li><a href="yaf-controller-abstract.render.php">Yaf_Controller_Abstract::render</a> — Отображает шаблон представления</li><li><a href="yaf-controller-abstract.setviewpath.php">Yaf_Controller_Abstract::setViewpath</a> — Назначение setViewpath</li></ul>
</div>
<?php manual_footer($setup); ?>