Yaf_Route_Rewrite::__construct

Yaf_Route_Rewrite のコンストラクタ

説明

public Yaf_Route_Rewrite::__construct(string $match, array $route, array $verify = ?)

パラメータ

match

リクエストの URI とマッチさせるパターン。 もしマッチしなければ Yaf_Route_Rewritefalse を返します。

:name 形式を使って、マッチしたセグメントに名前を付けることができます。 また、* で残りの URL セグメントにマッチさせられます。

route

リクエスト URI がパターンにマッチしたときに、 Yaf_Route_Rewrite はこれを使ってルーティング先のモジュール、コントローラ、アクションを判断します。

この配列で指定するモジュール、コントローラ、アクションはすべて任意指定で、 値を省略したときにはデフォルト設定を利用します。

verify

戻り値

例1 Yaf_Route_Rewrite の例

<?php
   /**
    * Add a rewrite route to Yaf_Router route stack
    */
    Yaf_Dispatcher::getInstance()->getRouter()->addRoute("name",
        new Yaf_Route_rewrite(
           "/product/:name/:id/*", //match request uri leading "/product"
           array(
               'controller' => "product",  //route to product controller,
           ),
        )
    );
?>

上の例の出力は、 たとえば以下のようになります。

/* http://yourdomain.com/product/foo/22/foo/bar
 * の場合はこのような結果になります
 */
array(
  "controller" => "product",
  "module"     => "index", //(default)
  "action"     => "index", //(default)
)

/**
 * リクエストパラメータは、このようになります
 */
array(
  "name" => "foo",
  "id"   => 22,
  "foo"  => bar
)

例2 Yaf_Route_Rewrite の例

<?php
   /**
    * Add a rewrite route to Yaf_Router route stack by calling addconfig
    */
    $config = array(
        "name" => array(
           "type"  => "rewrite",        //Yaf_Route_Rewrite route
           "match" => "/user-list/:id", //match only /user/list/?/
           "route" => array(
               'controller' => "user",  //route to user controller,
               'action'     => "list",  //route to list action
           ),
        ),
    );
    Yaf_Dispatcher::getInstance()->getRouter()->addConfig(
        new Yaf_Config_Simple($config));
?>

上の例の出力は、 たとえば以下のようになります。

/* http://yourdomain.com/user-list/22
 * の場合はこのような結果になります
 */
array(
  "controller" => "user",
  "action"     => "list",
  "module"     => "index", //(default)
)

/**
 * リクエストパラメータは、このようになります
 */
array(
  "id"   => 22,
)

例3 Yaf_Route_Rewrite (2.3.0 以降) の例

<?php
   /**
    * Add a rewrite route use match result as m/c/a name
    */
    $config = array(
        "name" => array(
           "type"  => "rewrite",        
           "match" => "/user-list/:a/:id", //match only /user-list/*
           "route" => array(
               'controller' => "user",   //route to user controller,
               'action'     => ":a",     //route to :a action
           ),
        ),
    );
    Yaf_Dispatcher::getInstance()->getRouter()->addConfig(
        new Yaf_Config_Simple($config));
?>

上の例の出力は、 たとえば以下のようになります。

/* http://yourdomain.com/user-list/list/22
 * の場合はこのような結果になります
 */
array(
  "controller" => "user",
  "action"     => "list",
  "module"     => "index", //(default)
)

/**
 * リクエストパラメータは、このようになります
 */
array(
  "id"   => 22,
)

参考

  • Yaf_Router::addRoute
  • Yaf_Router::addConfig
  • Yaf_Route_Static
  • Yaf_Route_Supervar
  • Yaf_Route_Simple
  • Yaf_Route_Regex
  • Yaf_Route_Map