<?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 => 'ja',
  ),
  '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' => 'ja',
    '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> ではマジックメソッド
    <span class="methodname"><a href="yaf-controller-abstract.init.php" class="methodname">Yaf_Controller_Abstract::init()</a></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">/** now dummyAction is defined in a separate file */<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">/* action method may have arguments */<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 and $id are unsafe raw data */<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">/* an action class shall define this method as the entry point */<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> — The display purpose</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> — The getInvokeArg purpose</li><li><a href="yaf-controller-abstract.getinvokeargs.php">Yaf_Controller_Abstract::getInvokeArgs</a> — The getInvokeArgs purpose</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> — Get self name</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> — The initView purpose</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> — The setViewpath purpose</li></ul>
</div>
<?php manual_footer($setup); ?>