<?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 => 'pt_BR',
  ),
  'this' => 
  array (
    0 => 'class.yaf-controller-abstract.php',
    1 => 'Yaf_Controller_Abstract',
    2 => 'A classe 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' => 'pt_BR',
    '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">A classe 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">Introdução</h2>
   <p class="para">
    <span class="classname"><strong class="classname">Yaf_Controller_Abstract</strong></span> é o coração do sustema do
    Yaf. MVC é o acrônimo para (Modelo-Visualizador-Controlador) e é um padrão de projeto
    cujo objetivo é separar a lógica da aplicação da lógica da exibição.
   </p>
   <p class="para">
    Todo controlador customizado deve herdar
    <span class="classname"><strong class="classname">Yaf_Controller_Abstract</strong></span>.
   </p>
   <p class="para">
    A função __construct não pode ser definida no controlador
    customizado. Por isso, <span class="classname"><strong class="classname">Yaf_Controller_Abstract</strong></span> fornece
    um método mágico: <span class="methodname"><a href="yaf-controller-abstract.init.php" class="methodname">Yaf_Controller_Abstract::init()</a></span>.
   </p>
   <p class="para">
    Se um método init() for definido no controlador customizado, ele será
    chamado assim que o controlador for instanciado.
   </p>
   <p class="para">
    A ação pode ter argumentos, quando uma solicitação chega, se houver a variável
    de mesmo nome nos parâmetros da solicitação (veja
    <span class="methodname"><a href="yaf-request-abstract.getparam.php" class="methodname">Yaf_Request_Abstract::getParam()</a></span>). Depois de roteada,
    Yaf irá passá-los para o método de ação
    (veja <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">Nota</strong>: 
     <p class="para">
      Esses argumentos são obtidos diretamente sem filtragem, devem ser cuidadosamente
      processados ​​​​antes de serem usados.
     </p>
    </p></blockquote>
   </p>
  </div>


  <div class="section" id="yaf-controller-abstract.synopsis">
   <h2 class="title">Resumo da classe</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">/* Propriedades */</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">/* Métodos */</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">Propriedades</h2>
   <dl>
    
     <dt id="yaf-controller-abstract.props.actions"><var class="varname">actions</var></dt>
     <dd>
      <p class="para">
       Um método de ação também pode ser definido em um script PHP separado usando
       esta propriedade e <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>Exemplo #1 Definindo ação em um arquivo separado</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">/** agora dummyAction está definida em um arquivo separado */<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">/* o método de ação pode ter argumentos */<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 e $id são dados brutos inseguros */<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>Exemplo #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">/* uma classe de ação deve definir este método como o ponto de entrada */<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">
       Nome do módulo.
      </p>
     </dd>
    
    
     <dt id="yaf-controller-abstract.props.name"><var class="varname">_name</var></dt>
     <dd>
      <p class="para">
       Nome do controlador.
      </p>
     </dd>
    
    
     <dt id="yaf-controller-abstract.props.request"><var class="varname">_request</var></dt>
     <dd>
      <p class="para">
       Objeto da requisição atual.
      </p>
     </dd>
    
    
     <dt id="yaf-controller-abstract.props.response"><var class="varname">_response</var></dt>
     <dd>
      <p class="para">
       Objeto da resposta atual.
      </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">
       Objeto do mecanismo de visualização.
      </p>
     </dd>
    
   </dl>
  </div>



 </div>

 
















































































































<h2>Índice</h2><ul class="chunklist chunklist_reference"><li><a href="yaf-controller-abstract.construct.php">Yaf_Controller_Abstract::__construct</a> — Construtor de 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> — Encaminha para outra a&ccedil;&atilde;o</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> — Obt&eacute;m o nome do m&oacute;dulo</li><li><a href="yaf-controller-abstract.getname.php">Yaf_Controller_Abstract::getName</a> — Obt&eacute;m o pr&oacute;prio nome</li><li><a href="yaf-controller-abstract.getrequest.php">Yaf_Controller_Abstract::getRequest</a> — Obt&eacute;m o objeto da requisi&ccedil;&atilde;o atual</li><li><a href="yaf-controller-abstract.getresponse.php">Yaf_Controller_Abstract::getResponse</a> — Obt&eacute;m o objeto da resposta atual</li><li><a href="yaf-controller-abstract.getview.php">Yaf_Controller_Abstract::getView</a> — Obt&eacute;m o mecanismo de visualiza&ccedil;&atilde;o</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> — Inicializador do controlador</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> — Redireciona para um URL</li><li><a href="yaf-controller-abstract.render.php">Yaf_Controller_Abstract::render</a> — Renderiza o modelo de visualiza&ccedil;&atilde;o</li><li><a href="yaf-controller-abstract.setviewpath.php">Yaf_Controller_Abstract::setViewpath</a> — setViewpath</li></ul>
</div>
<?php manual_footer($setup); ?>