ヘルパー¶

ヘルパーを使用する¶

コントローラに指定することで CakePHP でヘルパーを使用します。各コントローラは $helpers プロパティをもち、ビューで利用可能なヘルパーをリストします。ビューでヘルパーを有効にするには、コントローラの $helpers 配列にヘルパー名を追加します。

<?php
class BakeriesController extends AppController {
    var $helpers = array('Form', 'Html', 'Javascript', 'Time');
}
?>

アクション内からヘルパーを追加できます。そのアクションでのみ有効で、コントローラ内の他のアクションでは無効になります。これはコントローラをよりよい状態にするためにヘルパーを使用しない他のアクションに処理能力を保持します。

<?php
class BakeriesController extends AppController {
    function bake {
        $this->helpers[] = 'Time';
    }
    function mix {
        // Time ヘルパーはここではロードされず、無効です。
    }
}
?>

ヘルパーを作成する¶

コアヘルパー（または Cakeforge や Bakery にあるもの）が機能要求を満たさない場合、簡単にヘルパーを作成することできます。

では、ヘルパーを作成して、特別に作成された CSS 形式のリンクを出力してみましょう。そのリンクはアプリケーション内でさまざまなところで必要とされます。既存の CakePHP のヘルパー構造にロジックを合わせるために、/app/views/helpers 内に新しいクラスを作成する必要があります。ここでは LinkHelper というヘルパーにします。実際の PHP のクラスファイルは次のようになります:

<?php
/* /app/views/helpers/link.php */

class LinkHelper extends AppHelper {
    function makeEdit($title, $url) {
        // 特別な形式のリンクを作成するロジックをここに記述する
    }
}

?>

CakePHP のヘルパークラスには、便利ないくつかのメソッドがあります:

output(string $string)

この関数を使用してビューにデータを返します。

<?php
function makeEdit($title, $url) {
    // ヘルパーの出力関数を使用して、ビューに返す
    // 整形されたデータを処理します:
    return $this->output(
        "<div class=\"editOuter\">
         <a href=\"$url\" class=\"edit\">$title</a>
         </div>"
    );
}
?>

<?php
/* /app/views/helpers/link.php (using other helpers) */
class LinkHelper extends AppHelper {
    var $helpers = array('Html');

    function makeEdit($title, $url) {
        // HTML ヘルパーを使用して整形されたデータを出力する
        // データのフォーマット:

        $link = $this->Html->link($title, $url, array('class' => 'edit'));

        return $this->output("<div class=\"editOuter\">$link</div>");
    }
}
?>

<!-- 新しいヘルパーを使用してリンクを作成する -->
<?php echo $link->makeEdit('Change this Recipe', '/recipes/edit/5') ?>

すべてのヘルパーで使用する機能を作成する¶

すべてのヘルパーは特別クラス AppHelper（モデルが AppModel を継承し、コントローラが AppController を継承しているのと同様に）を継承しています。すべてのヘルパーで利用可能な機能を作成するには、/app/app_helper.php を作成します。

<?php
class AppHelper extends Helper {
    function customMethod () {
    }
}
?>

コアヘルパー¶

CakePHP はビュー作成を目的とするヘルパーがあります。well-formed なマークアップ（フォームを含みます）を作成を補助し、テキスト・時間・数値の整形する目的があります。Ajax 機能をスピードアップさえもします。ここでは組み込みヘルパーの概要を記述します。詳細は 組み込みのヘルパー をみてください。