PHP on the Cake !

全文検索

2009-01-06T15:29:00.003+09:00

Sphinx Behavior - he Bakery, Everything CakePHP
オープンソースのテキスト検索エンジンSphinxを使うビヘイビア。
Sphinxについて
PHP でカスタム検索エンジンを作成する - IBM's resource for developers and IT professionals in Japan

cakePHP キーワード検索 - 空間情報科学研究室卒研wiki

WHERE条件文の書き方

2009-01-05T18:19:00.003+09:00

1.2RCのLIKE,BETWEEN,INの書き方まとめ - CakePHP Users in Japan

CakePHPで検索機能 - WEBで地域活性化

CakePHPで検索機能の実装を少し楽する - toyosystem

存在しないコントローラ・アクション・ビューへのアクセス

2009-01-05T15:48:00.001+09:00

CakePHPでデバッグを有効にしていると、存在しないURLにアクセスした場合にエラーメッセージが表示される。
公開時にはデバッグを無効にする。

/* app/config/core.php /*
  define('DEBUG', 2);  // 変更前
  define('DEBUG', 0);  // 変更後

また、このエラーページは「cake/libs/view/errors/error404.ctp」に存在するのでカスタマイズする場合は「app/views/errors/error404.ctp」を作成して行う。

参考

CakePHP 公開する時はデバッグ情報を出さない - Shin x blog
PageControllerへのルーティング回避。

404エラーページをカスタマイズする方法 - CakePHPクッキング

CakePHP1.2のエラーページは仕様が変わってる - blog.katsuma.tv
その他のエラーページカスタマイズ。

DBの切り替え - database.php

2008-12-30T17:14:00.003+09:00

複数DBの使い分け・切り替え - CakePHP Users in Japan

テスト用・公開用などでDBの切り替えしたり、複数のDBを使い分ける場合。
「app/config/database.php」に好きなだけ定義。

/* database.php */
<?php
class DATABASE_CONFIG
{
    var $default = array
    (
        'driver' => 'mysql'
        , 'persistent' => false
        , 'host' => 'localhost'
        , 'login' => 'db_user'
        , 'password' => 'db_pass'
        , 'database' => 'db_name'
        , 'prefix' => ''
    );
    var $test = array
    (
        'driver' => 'sqlite'
        , 'persistent' => false
        , 'host' => ''
        , 'login' => ''
        , 'password' => ''
        , 'database' => 'test.db'
        , 'prefix' => ''
    );
}

もちろん「database」だけ別とかも大丈夫。
モデルの頭に記述。

/* モデル */
class Test extends AppModel
{
   $useDbConfig = "default";
   // 又は
   $useDbConfig = "test";

CakePHPは複数プロジェクトや巨大なアプリケーションには向かないだろうが、試用などには必要だろう。

CakePHPをベースにしたフォトブログ - CheeseCake

2008-12-29T13:17:00.008+09:00

CakePHP製のPhotoblogシステム：CheeseCakeをXREAサーバにインストールしてみた。

CheeseCake

概要
CheeseCake Photoblog - MOONGIFT

プロジェクトページ
Cheesecake Photoblog - CakeForge

公式サイト
Cheesecake Photoblog Software

デモ
Demo

ダウンロード

cheesecake + cakephp - 2.0 Beta 1(更新:2008-07-29 07:34)
ページ下のほう。

今回はCheesecake + CakePHPまとめてインストール。CheesecakeのみのファイルはCakePHPの「app/」ディレクトリが入ってる。2つの構成は違うように思う。

インストール

解凍したファイルをアップロード。
(ディレクトリ名を「cheesecake2」から「cheesecake」に変更)
「http://www.example.com/cheesecake/admin/install/」にアクセスしてインストール＆セットアップ。
XREAだとエラーが出るので、PHPをCGIモードにする「.htaccess」をWebルートに配置。
```
.htaccess
AddHandler application/x-httpd-phpcgi .php
```


データベースの設定をする。(今回はMySQL)



ユーザの設定をする。ログインのIDとパス、「Name」はサイト名。


インストール完了。各自サーバ環境を確認してディレクトリ等の権限をセーフティーに。
下に表示されてるのはCakePHPによるDebug。



サイト。




CakePHPのデバッグでクエリ結果が表示されてるので「app/config/core.php」のデバッグ設定を変更する。
app/config/core.php
Configure::write('debug', 0);
>ログイン画面。



日本語には対応してない様子。



ページャー/ページ送り - PEAR::Pager,Pagination,(1.2)Paginator
2008-12-13T14:25:00.006+09:00

大量のデータを扱うサイトの場合、ページャーの実装は必要であり、それは実に面倒なことだ。

普通のPHPサイトではPEAR::Pagerが有名でよく使われるところだろう。

PEAR::Pager
マニュアル

Pager - PEAR
使い方・サンプル

ページング(PEAR::Pager) - PHPBook

PEAR::Pager で Digg っぽいページャを作る - cl.pocari.org

PEAR::Pager ページ番号を PATH_INFO で渡す - Sun Limited Mt.

CakePHPでの扱いは以下。

ページネーション - CakePHP Users in Japan

Pagerの実装 - Wheel Of Fortune

-コンポーネント。ファイル一覧をデータとして扱う

PEARが使えない環境の場合、CakePHPのPaginationコンポーネントを使う。1.1系。

Pagination
セットアップ
bakeryの以下リンクからコンポーネント、ヘルパー、エレメントをコピーして各ディレクトリに作成。
Pagination Component→「/app/controllers/components/pagination.php」
Pagination Helper→「/app/views/helpers/pagination.php」
Pagination Element→「/app/views/elements/pagination.thtm」

使い方

CakePHPでPEAR::Pagerを使わずにページング - Do you CakePHP はてな

CakePHP::Pagenation(ページャ、ページング処理) - toyosystem

CakePHP Pagination まとめ - Sun Limited Mt.



データベース等設定が必要。

1.2系ではページャーが用意してある。これは更に容易に機能を提供してくれる。
Paginate(1.2系)
使い方
コントローラでfind()関数の代わりにpaginate()関数を使う。
/* コントローラ */

function index() {
  $this->paginate['limit'] = 5;
  $this->set('items', $this->paginate());
}

ページ送りレイアウト「elements/paginator.ctp」を作成。
/* 「elements/paginator.ctp」 */

 <div id='pagination'>
 <?php echo $paginator->prev('<< '.__('previous', true), array(),null,array('class'=>'disabled', 'tag' => 'span')); ?>
 | 
<?php echo $paginator->numbers(). ' | '. $paginator->next(__('next', true).' >>', array(), null, array('tag' => 'span', 'class' => 'disabled')); ?> </div>

ビューで任意の位置で呼び出す。
/* ビュー */

<?php echo $this->renderElement('paginator'); ?>


CakePHPのページング処理には1.2からはpaginatorを使え。 - 

Paginatorの使い方。CakePHP1.2

-仕様の詳細とデモ:PaginatorでPaginateしてみた。


Pagenateは本当に便利で楽。ページ送り部分のデザインもエレメントとして分離できるし、使いまわせる。


追記：2008/12/24
getで送信されたパラメータを引き継ぐpaginationのやり方CommentsAdd Star - 

SQLite3を使う - PHP on the Cake !(2008年10月10日)

残念なことにSQLite3を使うための「dbo_source.php」をアップしているとエラーが出てしまう。このファイルが以前のバージョンを基に作られているためだろうか、calculate()関数が見つからないエラーが表示される。

デフォルトの「dbo_source.php」からコピーしてアップした「dbo_source.php」に追記すれば表示することは出来る。不具合は不明。以下のようなソース。

/* 「/cake/cake/libs/model/datasources/dbo_source.php」 */
～略～

function calculate(&$model, $func, $params = array()) {
  $params = (array)$params;
  switch (strtolower($func)) {
    case 'count':  if (!isset($params[0])) {  $params[0] = '*';  }
                        if (!isset($params[1])) {  $params[1] = 'count';  }
                        return 'COUNT(' . $this->name($params[0]) . ') AS ' . $this->name($params[1]);
    case 'max':
    case 'min' :  if (!isset($params[1])) {  $params[1] = $params[0];  }
                      return strtoupper($func) . '(' . $this->name($params[0]) . ') AS ' . $this->name($params[1]); 
                      break;
  }
}

～略～



CakePHPを基にしたCMS
2008-11-25T23:30:00.005+09:00
有名そうなプロジェクトと開発止まってない、情報も見つかったものをピックアップしてまとめ。

インストールしてみんとす。

個人的に拡張性が高すぎる規模大きいCMSには惹かれないので多分やらない。開発側としては楽しいだろうし有意義だろうけど、使う側として何していいか解んなくなっちゃうしね。ただのお試しには特に。
Wildflower
CakePHP製のCMS。
公式サイト

Wildflower
解説
CakePHPを使ってCMS「Wildflower」 - MOONGIFT

デザインされたデフォルトの管理画面、カスタマイズを前提に作られている(解説有り)、CakePHPなので習得が楽。

CakePHP で作成された CMS - Sun Limited Mt.

app 以下にはコントローラもモデルもビューも置いていないこと。CMS で使う MVC は app ディレクトリと同じ階層にある wildflower というディレクトリに app ディレクトリと同じ構成で入っています。これはカスタマイズするときに、app 以下にカスタマイズした MVC を入れて、wildflower の元々のファイルを修正しなくてもいいように出来ているようです。
CheeseCake
CakePHP製のPhotoblogシステム。
概要

CheeseCake Photoblog - MOONGIFT
プロジェクトページ

Cheesecake Photoblog - CakeForge
公式サイト

Cheesecake Photoblog Software
デモ

Demo
Pocky
インストールいらず、ディレクトリ設置だけでCakePHP開発環境。
Pocky: CakePHP on a Stick - CakeForge
解説
CakePHPフレームワーク開発環境を1分以内で作る方法 - CakePHP のおいしい食べ方
Pocky - MOONGIFT
いい物見つけた - Glorious Life

MySQLのインストールも簡単らしい。
まんじゅうCMS
CloverStudioが開発しているCakePHPで作られたCMS。もちろん日本の人。開発も止まってない。

共有とカスタマイズを方針として開発。

現在公開のモジュール・プラグインはブログ、掲示板、フォーム、外部RSS読み込み。
公式サイト

まんじゅうCMS
デモ

デモ・リンク

ブログなどデモ集。

関連
リンク集。リンク切れや情報がないのが多い。

php sweets - CakePHP のおいしい食べ方

CakePHPで作られたショッピングサイト - BakeSale他 - PHP on the Cake!(2008年11月18日記事)



CakePHPで作られたショッピングサイト - BakeSale他
2008-11-18T13:01:00.003+09:00
BakeSale - CakeForge

CakePHPを基にしたショッピングシステム。

ユーザ登録やメール配信、広告管理の機能、会計のシステム、レーティングといった機能はない。


CakePHPを使ったショッピングサイト「BakeSale」 - オープンソースを毎日紹介

CakePHP で作成したショッピングサイト「BakeSale」 - Sun Limited Mt

CakePHP1.2で作られたBakeSaleを使ってみた - WEBで地域活性化

－構築例アリ。

アフィリエイト商品紹介サイトにはちょうど良いかも。楽天やAmazonから本とかインテリア見繕って、アフィリエイト貼って日紹介するサイトなど。

勉強としてソースを見るのも一興かも。
その他にもショッピングシステムなど以下に一覧。
Cakeを使ったCMS土台のまとめ - CakePHP Users in Japan



HTMLヘルパー：image
2008-11-06T00:16:00.009+09:00
<img>タグの書き方と画像のパスはヘルパーを使って以下のように表現できる。

/* View */
  <img src="<?php echo $html->webroot(IMAGES_URL."/logo.png") ?>" alt="ロゴ" />
  // 出力:<img src="/cake/img/logo.png" alt="ロゴ">
  <?php echo $html->image("/logo.png", array("alt"=>"ロゴ")) ?>
 // 出力:<img src="/cake/logo.png" alt="ロゴ">

IMAGE_URLは「cake/config/path.php」に定義。

$html->link()の第5引数にfalseを渡すとエスケープがオフになるので次のようにcode><img>タグを記述できる。
<?php echo $html->link($html->image("logo.png"), '/',null,null,false);?>



フォーム・ヘルパー : error
2008-10-31T17:40:00.002+09:00

error - The Cookbook :: 1.2 Collection :: マニュアル
error(string $fieldName, string $text, array $options)
    バリデーションエラーが起こったイベントで、指定されたフィールドの $text で指定したエラーメッセージを表示
$options = array(
                         'wrap' => true,
                         'class' => 'error-message',
                         'escape' => true
                );


「wrap=> true」であれば指定したエラーメッセージ「$text」は<div>タグで囲まれる。「false」を指定するとタグで囲まれない。<div>以外のタグを指定することも出来る。
「class」は「wrap」のクラス名を指定する。

「escape」はHTMLエスケープ（h($error)）を行う。

/* ヘルパー */
<?php echo $form->error('App.userId', '入力エラーです'); ?>

「cake/cake/libs/view/helpers/form.php:L365～」
/**
 * Returns a formatted error message for given FORM field, NULL if no errors.
 *
 * @param string $field A field name, like "Modelname.fieldname"
 * @param mixed $text  Error message or array of $options
 * @param array $options Rendering options for <div />wrapper tag
 *   'escape'  bool  Whether or not to html escape the contents of the error.
 *   'wrap'  mixed  Whether or not the error message should be wrapped in a div. If a
 *      string, will be used as the HTML tag to use.
 *   'class'  string  The classname for the error message
 * @return string If there are errors this method returns an error message, otherwise null.
 * @access public
 */
  function error($field, $text = null, $options = array()) {
    $this->setEntity($field);
    $options = array_merge(array('wrap' => true, 'class' => 'error-message', 'escape' => true), $options);

    if ($error = $this->tagIsInvalid()) {
      if (is_array($error)) {
        list(,,$field) = explode('.', $field);
        if (isset($error[$field])) {
          $error = $error[$field];
        } else {
          return null;
        }
      }

      if (is_array($text) && is_numeric($error) && $error > 0) {
        $error--;
      }
      if (is_array($text) && isset($text[$error])) {
        $text = $text[$error];
      } elseif (is_array($text)) {
        $options = array_merge($options, $text);
        $text = null;
      }

      if ($text != null) {
        $error = $text;
      } elseif (is_numeric($error)) {
        $error = sprintf(__('Error in field %s', true), Inflector::humanize($this->field()));
      }
      if ($options['escape']) {
        $error = h($error);
        unset($options['escape']);
      }
      if ($options['wrap']) {
        $tag = is_string($options['wrap']) ? $options['wrap'] : 'div';
        unset($options['wrap']);
        return $this->Html->tag($tag, $error, $options);
      } else {
        return $error;
      }
    } else {
      return null;
    }
  }



フォーム・ヘルパー : isFieldError
2008-10-31T17:15:00.001+09:00

isFieldError - The Cookbook :: 1.2 Collection :: マニュアル

個別にバリデーション・エラーを取得する。バリデーションエラーがあれば「true」を返す。それ以外は「false」。
「Modelname.fieldName」の様に指定する。

/* ヘルパー */
<?php if ($form->isFieldError('App.userId')) echo '<div class="error-message">入力エラーです</div>'; ?>

「cake/cake/libs/view/helpers/form.php:L354～」
/**
 * Returns true if there is an error for the given field, otherwise false
 *
 * @param string $field This should be "Modelname.fieldname"
 * @return boolean If there are errors this method returns true, else false.
 * @access public
 */
  function isFieldError($field) {
    $this->setEntity($field);
    return (bool)$this->tagIsInvalid();
  }



エンティティをモデルに作る（データの加工）
2008-10-30T17:10:00.002+09:00
CakePHPのモデルをエンティティとして扱う - Happy Engineer Life
DBから得られる生のデータを加工して、サイトで必要な意味のあるデータにする。モデルはDBとバリデーションだけじゃない。



デバック「debug」のレベル
2008-10-23T01:30:00.001+09:00
CakePHP debug=0とdebug=2ではパフォーマンスがかなり違う - Shin x blog
それぞれの場合の稼動状況を計測。



CakePHPを1.1から1.2へ上げるときの注意点
2008-10-23T01:02:00.003+09:00
CakePHPを1.1から1.2へ上げるときの注意点 - blog.katsuma.tv
1.1系と1.2系との違いと対処。
簡単に以下に紹介。
viewファイルの拡張子を変更
ビューファイルの拡張子が「.thtml」から「.ctp」に変更になった。
対処法
for file in *; do mv -i $file `echo $file | sed 's/.thtml/.ctp/'`; done
このコマンドで一気に変更。
フォームヘルパの変更
フォームヘルパの仕様変更。「$html」から「$form」に変更。
1.1系<?php echo $html->input('Timeline/title', ...); ?>
1.2系<?php echo $form->input('Timeline.title', ...); ?>
app/config/routes.php
「routes.php」はRouteオブジェクトがRouterクラスに変更。

「app/config/routes.php」を次のように変更。
1.1系$Route->connect('/home', array('controller' => 'pages', 'action' => 'home'));
1.2系Router::connect('/home', array('controller' => 'pages', 'action' => 'home'));
app/config/core.php
「define」で定義していたものが「Configure」クラスを利用する。
元の「app/config/core.php」を次のように変更。
1.1系define('debug', 0);
1.2系Configure::write('debug', 0);

Vendor系ライブラリ
「app/vendors」に配置したサードパーティのライブラリを「app/config/bootstrap.php」から呼び出す方法。
1.1系vendor( 'dBug'.DS.'dBug' );
1.2系App::import( 'Vendor', 'dBug', array('file'=>'dBug' . DS . 'dBug.php') );



CakePHPアプリケーションの情報を表示 - CakeInfo
2008-10-23T00:40:00.003+09:00
CakePHP 1.2beta対応－CakeInfo-0.1.2リリース - Shin x blog

CakePHPアプリケーションの内容をphpinfo()風に見せるCakeInfo

ディレクトリ構成だとか外部からアクションとして呼べるメソッドを表示



フレームワーク・ライブラリの比較
2008-10-20T15:51:00.002+09:00
PHP5のフレームワークの選択で悩んでいます。


cakePHP
利点
手軽
ティップス的な情報はWeb上にたくさんある
欠点
まとまったドキュメントが少ない



Synfony (あまり詳しくないので、間違ってたらごめんなさい）
利点
Yahooが採用したこともあり安心？
ドキュメントも充実
欠点
個人的には使い始める際の敷居が高めだった気がする



ZendFramework
利点
Zendが提供しているので安心？
ドキュメントが充実
欠点
他の２つと比べてリリース後時間がないため実績が少ない？




・Zend FrameworkはフレームワークというよりPEARの代わり(Zend_DBはPEAR::DBの代わり、Zend_AuthはPEAR::Authの代わりという感じ)
・Zend_ControllerのRouter（パスを解決する部分）はrails感覚で設定できるのが便利

なぜCakePHPなのか？



$scripts_for_layoutは$html->css(),$javascript->link()でビューからヘッダに追加する変数
2008-10-14T13:34:00.005+09:00
1.2で「default.ctp」に追加された$scripts_for_layoutは、ビューからヘッダ要素を追加したい時に使える。

特定のビューでだけ使うスクリプトとか使いするのに便利。ビューごとにタイトルを変化させるとか、メタ情報も追加できるのでSEO的に大事。

次のように
  <?php echo $html->css('common',NULL,NULL,false); ?>
と書くとヘッダの$scripts_for_layoutが置き換わる。「cake/app/webroot/css」がカレント。(直接<link>とかで記述するなら「/cake/css/」で良い)
  <link rel="stylesheet" type="text/css" href="/css/common.css" />

最後の引数falseが指定されることでヘッダに追加される。trueだったり省略されるとinline、$html->css()が記述された場所に追加される。


  <?php
    $html->css('hoge', null, array(), false);
    $javascript->link('hoge', false);
    $javascript->codeBlock('alert("foo")', array('inline' => false));
  ?>


  <head>
   <link rel="stylesheet" type="text/css" href="/css/hoge.css" />
   <script type="text/javascript" src="/js/hoge.js"></script>
   <script type="text/javascript">
   //<![CDATA[ 
      alert("foo")
   //]]>
   </script>
 </head>

これらはaddScript()を使って実装されている。
CSSを記述するstyle()などもある。
参考
The Cookbook :: 1.2 Collection :: マニュアル

7.4.1 整形済み要素を挿入する
夜の Discovery

CakePHP1.2 で特定のアクションだけ JS/CSS を読み込んで欲しい
CakePHP Users in Japan

scripts_for_layoutとは？
アルファブレンド・プログラミングチップス

scripts_for_layoutとは？



CakePHP1.2での確認画面を挟んだ登録フォーム
2008-10-13T17:40:00.003+09:00

cakephperの日記(cakePHP1.2RC2ベース)

よくある申込み画面の機能を作る
MVCすべてのソースを載せてます。

アクションの遷移は以下の通り。バリデーションは確認画面の一回だけ。
申し込み画面(index)→確認画面（config）→完了画面(complete)



CakePHP1.2でset()したデータをビューで扱うにはtagValue()ではなくvalue()
2008-10-13T15:35:00.006+09:00
ビューにデータを出力する
 // CakePHP1.1
  <?php e(h($html->tagValue('Sample/name'))); ?>
 // CakePHP1.2 RC2 
  <?php e(h($html->value('Sample/name'))); ?>


参考
tagValueからvalueに変更 - CakePHPクッキング



memo
2008-10-11T15:12:00.002+09:00

CakePHP1.2のラジオボタン

CakePHP Model::generateList メソッドの {n}

FormHelperから自動出力されるdiv要素を消す方法。

CakePHP 1.2の便利なValidation

4.1 データのバリデーション(Data Validation)

MultivalidatableBehavior: Using many validation rulesets per model

→ヴァリデーションのルールを使い分けるビヘイヴォア。



フォームのラベル
2008-10-11T09:57:00.002+09:00
CakePHP1.2系のhelperではフォーム要素が<label></label>に囲まれて出力されます。

echo $form->radio('User/radio', array('1'=>'check'));
echo $form->input('Project/name');
このフォーム・ヘルパーは次の様なコードになる。

<div class="input"> <label for="ProjectName">Name</label> <input name="data[Project][name]" type="text" value="" id="ProjectName" /> </div>
<input name="data[User/radio]" id="User/radio"  value="1" type="radio"><label for="User/radio">無</label>

必要ないとき、とくにテキスト・エリア、は「'label' => false」を与える。
echo $form->input('Project/name', array('label' => false));
また、デフォルトではテキスト・エリアの前にname属性が表示されるが、自由に指定できる。
echo $form->input('Project/name', array('label' => '名前'));
参考
cakebaker

How to create an input field without a label



デフォルトのビュー・レイアウトをカスタマイズ
2008-10-11T01:20:00.002+09:00

「cake/cake/libs/view/layouts/default.ctp」を「cake/app/views/layouts/default.ctp」にコピー＆変更。ヘッダとかフッタとかタイトルとかJS・CSSファイルとか。

「flash.ctp」というファイルも同ディレクトリに存在する。

。$this->flashのテンプレートのようなのでカスタマイズやエラーがあったときは同様にコピーして変更・修正。titleタグよりあとにmetaタグでのエンコード指定があると$this->flashが真っ白になったりすることがある。エンコードの順番はXMLでは他の機会にも起きるので注意。
参考
CakePHP1.2をインストールして最初にする作業メモ
CakePHPの$this->flashで画面が真っ白になる問題



ヘッダでインクルードするJSファイルやCSSファイルをアクションごとに変更
2008-10-11T01:10:00.004+09:00
CakePHP1.2 で特定のアクションだけ JS/CSS を読み込んで欲しい

「app/views/layouts/default.ctp」に 「echo $scripts_for_layout;」を追記。

「app/views/users/signup.ctp」のように特別に<head></head>を変更したいビュー内に作成。


※追記：2008/10/14　14.10

PHP on the Cake!:2008年10月14日記事参照
$scripts_for_layoutは$html->css(),$javascript->link()でビューからヘッダに追加する変数



SQLite3を使う(※追記)
2008-10-10T16:44:00.004+09:00
CakePHP1.2をSQLite3で動かしてみた。＆ダウンロード

邪道です。PHP5でしかできないので、せっかくのPHP4,5対応であるCakePHPの長所を消してしまいます。

SQLite3にCakePHPが正式対応しない理由かもね


ダウンロード
ダウンロードLastUpdate:SQLite3_spok1.0.7beta.ZIP(2008/10/10現在)


インストール
解凍して出来た２つのファイルのうち、「dbo_source.php」は「cake/app/models/datasources/」にアップロード
「dbo_sqlite3_spok.php」を「cake/app/models/datasources/」に「dbo/」ディレクトリを作成しアップロード。

SQLite3_spok1.0.7beta.ZIP
∟「dbo_sqlite3_spok.php」→「cake/app/models/datasources/dbo/」
∟「dbo_source.php」→「cake/app/models/datasources/」



※追記：2008/10/28 23:55

このファイルに上書きされる為か、後からDB接続をMySQLにしたらエラーが出た。

「/public_html/cake/cake/libs/model/datasources/dbo/dbo_mysql.php」の「hasResult()」が見つからないとかナントカ。

二つのファイルを削除したら接続できるようになった。


DB接続の設定ファイル
/* config/database.php */

var $default = array(
        'driver' => 'sqlite3_spok',
        'connect' => 'PDO',
        'host' => '',
        'port' => '',
        'login' => '',
        'password' => '',
        'database' => "sqlite:/home/hoge/hogehoge/filename.sqlite3",
        'schema' => '',
        'prefix' => '',
        'encoding' => ''
      );


「'database'」を「sqlite2:」とすると、SQLite2にも接続できる。ファイル名は何でも良く、拡張子も何でも良いし無くても良い。
「cake/app/webroot/」がカレントになる模様。個人的には「cake/app/db/」を作って権限与えて「'database' => "sqlite:../db/data.sqlite3"」。ファイル名はモデル名にした方が管理しやすいかな。


SQLite3はちょっと違うようなので注意。

CakePHPでSQLite3を使う（覚書編）

※追記：2008/10/13　14:40

GUIで管理 SQLite Manager - さぼてん



フォームからの入力
2008-10-10T09:42:00.002+09:00
コントローラでのフォームからのPOSTデータ
  $this->params
  $this->params['data']
  //$this->dataと同一
変数を表示させるにはpr()を使う。コントローラからもビューからも使えてデバックに便利。
  pr($this->params)
  pr($session)
print_r()で出力して<pre></pre>で囲んでいる模様。
pr()をカスタマイズ
pr()は「/cake/basics.php」定義されている。
デバッグ用に次のように使う場合
  pr($var);
  die;
関数にしてしまえば便利。
  function prd($var) {
    pr($var);
    die;
  }
更に次のように変更すればpr()が記述されてる行も表示する。
  <?  function pr($var) {
    if (Configure::read() > 0) {
      $array = debug_backtrace();
      echo($array[0]['file']." (line ".$array[0]['line'].")");
      echo "<pre>";
      print_r($var);
      echo "</pre>";
    }
  }
debug_backtrace()で取得してる模様。

二つあわせて定義。
  <?  function prd($var) {
    if (Configure::read() > 0) {
      $array = debug_backtrace();
      echo($array[0]['file']." (line ".$array[0]['line'].")");
      echo "<pre>";
      print_r($var);
      echo "</pre>";
      die;
    }
  }
参考
pr()関数で行数表示。便利。
CakePHP の開発を簡単にする 5 つの Tips

１５のCakePHP Tips



APIを使う
2008-10-10T00:05:00.002+09:00
CakePHPでGeocoding

yahoo mapsやgoogle mapsで提供されているGeocoding APIを使って、世界の都市名と緯度・経度情報をマッピングした静的なテーブルを作成
Google Geocoder

Google Geocoderを利用するコンポーネント
Adding a Google Map to your App

GoogleMapHelper チュートリアル風。
∟GoogleMAP+cakePHPにチャレンジ

1.2系対応。
Webservice Behavior

Webサービスを利用するビヘイビア。

∟CakePHP 1.2で WebService APIを利用する
CakePHP1.2のBehaviorを使う

3.8 ビヘイビア



アプリ公開時のエラー処理
2008-10-08T18:08:00.003+09:00
運用時にPHPのエラーを確認する方法
システムの公開時にはPHPのエラーが画面に表示されないようにする。
/* app/config/core.php */

 define('DEBUG', 0);

デバッグできるようにログファイルに書き出すようにする。(ログファイルには書き込み権限を与える)
/* app/webroot/index.php */

 require CORE_PATH . 'cake' . DS . 'bootstrap.php'; error_reporting(E_ALL); //追加
 ini_set("display_errors", 0); //追加
 ini_set("log_errors", 1); //追加
 ini_set("error_log", "/path/to/phperror.log"); //追加

自分の環境では以下を参考。
CakePHPの本番稼動のerror_reportingについて
「.htaccess」ファイルにエラー出力の制御を記述。エラーログも書き出す。
/* app/webroot/.htaccess */

  php_flag display_errors off
  php_flag log_errors on
  php_value error_log "./logs/php_error.log"

そして画面にエラーが表示されないようにする。
/* app/config/core.php - 52行目～ */

  define('DEBUG', 0); // 0はプロダクションモード

ところが上手くいかない。原因は以下が利いているから。
/* cake/libs/configure.php -> Configure::write */

  error_reporting(0)

対策その１～CakePHPの設定を変更
上のコードを変更する。
/* cake/libs/configure.php -> Configure::write */

  error_reporting(E_ALL);

欠点:コア部分を変更してしまう
対策その２～プロジェクト内の設定を変更
そのプロジェクトではエラー出力するように追記する。
/* app/webroot/index.php - 78行目～ */

require CORE_PATH . 'cake' . DS . 'bootstrap.php';
error_reporting(E_ALL);

欠点:すべてのエラーがフォローしきれない



フォームのリロードと遷移
2008-04-10T13:00:00.005+09:00

一般的な登録フォームの画面遷移は次の様に考えられる。

入力画面→入力確認画面→完了画面

「完了画面」で登録や送信の処理が実行されるので、この画面で再読み込み(リロード)をされると同じ処理を繰り返すことになる(メールが2通送られたり)。

これを防ぐ手段としてはチケットやトークンというものを発行して、処理が完了したら破棄させて再処理させないようにするのがおそらく一般的(要するに未処理・未送信を表すフラグを使う)。

【PHP TIPS】 58. すごいリロード対策 - ITpro

リンク先では、「確認画面」で乱数のチケットを発行しセッションに保存、「完了画面」で確認することでリロード対策とCSRF(クロスサイトリクエストフォージェリ)対策が同時に出来る。
※CSRF(クロスサイトリクエストフォージェリ)について

開発者のための正しいCSRF対策

クロスサイトリクエストフォージェリ（CSRF）の正しい対策方法 - 高木浩光＠自宅の日記

ただ、ウィンドウを2つ開いて登録処理をするともう一つも処理できなくなるという問題がある。

あまり有り得ないケースな気もするがブログみたいなシステムだと考えられるか。

改良されたソースが以下のリンク先に公開されている。

対策方法は発行したチケットをすべて記憶させる。


すごいリロード対策 - p4lifeのメモ


個人的には以下のサイトの考え方が自然に思える。


ふつうのリロード対策 - to-R

登録フォームの画面遷移ではなく、以下のような実際のプログラム処理の遷移で考える。
入力画面表示処理→入力確認画面表示処理→登録(メール送信)処理→完了画面表示処理

これによって「完了画面」をリロードしても「登録処理」が繰り返されることは無い。


CSRF対策はベストと思われる対策が存在しないので、個人的にはよほどスパムが多い場合か、神経質に処理しないといけない場合でないと実装しないです。(スパム対策の場合は英字フィルタリングなどで対応するのがほとんどですが)


現実的ですが納得しない人もいるでしょう。


間違いやもっと良い方法をご指摘いただければ幸いです。


class OrdersController extends AppController
{
  var $name = 'Orders';
  function index(){
    if (empty($this->data)) {
      $this->index();
    } else {
      // 入力確認
      if (@$_POST['conf']) {
        if (!$this->Order->validates($this->params['data'])) {
          //入力値が不正
          $this->render("index");
        } else {
          //確認画面表示
          $this->render('conf');
        }
      } else if (@$_POST['send']) {
        //メール送信処理
        $this->_mail();
      }
    }
  }
  //送信処理   -外部からアクセスできない _mail() 関数
  function _mail() {

    /*   メールの作成   */

    //メール送信
    if ($mail->send()) {
        //送信完了
        $this->flash('','/orders/send');
     } else {
        //送信失敗
        $this->flash('Error','/orders/index');
     }
  }
  //送信完了
  function send() {
    $this->render('send');
  }
}



モデルの関数
2008-03-31T00:06:00.003+09:00

PHP において、モデル(models)は AppModel クラスを拡張(extend)したクラスです。

AppModel クラスは、「cake/」ディレクトリで定義されています。

自分でカスタマイズするには「app/app_model.php」ファイルを作成して、全モデルで共有するメソッドを定義します。

このクラスは「cake/libs/model/model.php」の中で定義されている、スタンダード Cake ライブラリの一つであるモデル(Model)クラスを拡張したものです。

findAll($conditions, $fields, $order, $limit, $page, $recursive); 
指定されたフィールドから $conditions にマッチするものを $page (デフォルトは１ページ目)ページから $limit レコードまで返します。
$recursive オプションが１より大きい値に設定されている場合、findAll() オペレーションは、 findAll() で見つかった関連モデルに関しても結果を返します。
find($conditions, $conditions, $fields, $order, $recursive);
$conditions にマッチする最初のレコードから、指定されたフィールド(指定がなければ全フィールド)を返します。
$recursive オプションが１から３の間に設定されていると、find() オペレーションは、find() で見つかったモデルに関連しているモデルも返します。

findAllBy[FieldName]($value);
FieldName に指定した特定のフィールドを検索し、$value 値に一致するものを取得します。(例：$this->Post->findByTitle('My First Blog Post')、$this->User->findByName('Author') など）
findNeighbours($conditions, $conditions, $field, $value);
$field と $value で指定したフィールドから $conditions の SQL 条件にマッチするレコードに隣接するデータを返します。
これはモデルのエントリを特定の順番でたどれるように、「前」「次」リンクを準備する時に便利です。この関数は数値または日付のフィールドの場合のみ動きます。
field($name, $conditions, $order);
$conditions の条件にマッチし、$order で指定された順番で当てはまった一つのフィールドの最初の内容を文字列として返します。
findCount($conditions);
条件にマッチするレコード数を返します。
generateList($conditions, $conditions, $order, $limit, $keyPath, $valuePath);
$keyPath と $valuePath で、key value のペアになったリストを取り出せます。
モデルの一覧から select タグを作る時などに便利です。(select タグの value、ラベルをこの関数で取得した value、key に対応させる)
read($fields, $id);
現在読み込んでいるレコード、または $id で指定したレコードから、フィールドと値をと取得します。
query($query);
execute($query);
SQL クエリを渡します。
query() は結果レコードが返される(カスタム SQL クエリ)のに対して、execute() は返り値はない(カスタム SQL のコマンド)という違いがあります。

参考リンク

6.2. モデルの関数 - CakePHP プログラマーズ リファレンスガイド



モデルについて
2008-03-30T17:05:00.003+09:00
MVC パターンの M にあたる部分、モデル（model）の役割は、ドメインロジックを、表示部分から切り離し、アプリケーションのロジックだけを分離することです。

モデルが一般的に示すものはデータベース、さらに具体的には特定のテーブルです。
それぞれのモデルは、モデル名を複数形にした名前のテーブルに対応します。
例えば「User」モデルは「users」 テーブルを使用します。
モデルにはさらに、データバリデーション(データの値の検証)、アソシエーション(テーブル同士の関連：リレーション)情報、テーブル特有のメソッドなどを含めます。
下記は、シンプルな User モデルが Cake の中にあったらどうなるかというサンプルです
User モデルの例:「/app/models/user.php」に保存

//AppModel は、Cake のモデルの機能をすべて提供しています
class User extends AppModel
{
 
    var $name = 'User';
    // これはバリデーションに用いられます
    var $validate = array();

    // アソシエーション（関連）を定義することもできます
    var $hasMany = array('Image' =>
                   array('className' => 'Image')
                   );

    // 独自の関数を含めることもできます：
    function makeInactive($uid)
    {
        //独自のロジック
    }
}


CakePHPを使ったMVC設計のベストプラクティス - Sooey

CakePHP開発メンバーによるMVCデザインの記事の翻訳。

原文：Best Practices in MVC Design with CakePHP -  (php|architect’s C7Y)



モデルは単なるデータ保存場所ではなくて、アプリケーションのドメインエンティティなのだ。

テーブルとのやりとりにモデルの機能はとても重宝するが、モデルをそのためだけに使っているのであれば、あなたは損をしていることになる。

ちゃんとしたMVCではモデルこそが第一級の存在であり、そのように扱われる。

コントローラはデータをモデルから取得してビューへと送り出すだけのシンプルな糊として振るまい、アプリケーション内で最も魅力のない部分となる。


ロジックをどこに配置すべきか決断するときに使える便利な経験則: 

モデルに置けるあらゆるものは、そうすべきである(少なくとも「モデルかコントローラか」といった場合には。やり過ぎてビューロジックをモデルに置いた人を見たこともあるが…)。

アプリケーションの核となるビジネスロジックと連携しないものは(セッション管理、リクエスト・レスポンス処理、セキュリティやアクセス制限に関するもの)、コントローラに置いたままにすべきである。

それ以外のあらゆるものはモデルに放り込め。


参考リンク

6.1. モデルとは - CakePHP プログラマーズ リファレンスガイド


命名規則 - PHP on the Cake ! 
 

アソシエーション - CakePHP で リレーショナル・データベース - PHP on the Cake ! 



Scaffolding の利用
2008-03-27T22:04:00.003+09:00

「Scaffolding」は「足場・処刑台」という意味を持ちます。

CakePHP の Scaffolding の機能はデータベースとモデルを作成するだけで、そこからデータベースのテーブルを分析し、スタンダードな一覧リストと、追加、削除、編集ボタン、編集用のフォーム、データベースの一つのアイテムを表示するためのスタンダードなビューなどを作り出します。

 Scaffolding はかなりの作業を肩代わりしてくれる、WEBアプリケーションの開発初期の時点での優れた方法ですが、簡易的なものなのでロジックやビューをカスタマイズする場合は scaffolding をやめて独自のコードを書くべき時です。

システムの開発では、初期設計からたびたび変更されることがあります。これは設計プロセスの初期の段階として完全に正常なことですが、変更される度にフォーム等を作らなくてはなりません。scaffolding は、開発者のこの負担を減らすために Cake に含まれています。

アプリケーションで scaffolding を利用するには、コントローラの中で $scaffold 変数を宣言するだけです。


class CategoriesController extends AppController
{
    var $scaffold;
}


Scaffold では「～_id」で終わるフィールド名は、別のテーブルの外部キーだと判断します。
例えば「category_id」というフィールドがあった場合、それは「category」というテーブルの外部キーとなります。

そして外部キーが、アソシエーションによって、モデルに適切に関連付けられている場合、外部テーブルの値が、ビューの中にセレクトボックスで自動的に表示されます。
外部テーブルから表示するフィールドは、外部モデルの $displayField 変数で設定します。


class Title extends AppModel
{
    var $name = 'Title';
    var $displayField = 'title';
}


この例では、外部テーブルの「title」フィールドを取得します。


scaffolded のビューを、自分で独自に準備することでカスタマイズできます。
あくまでプロトタイプの作成を繰り返す時、このカスタマイズは非常に便利です。
利用するにはビューファイルを次のように配置してください。

PostsController 用のカスタム  Scaffolding ビューの配置
/app/views/posts/scaffold/index.scaffold.thtml
/app/views/posts/scaffold/show.scaffold.thtml
/app/views/posts/scaffold/edit.scaffold.thtml
/app/views/posts/scaffold/new.scaffold.thtml

すべてのコントローラ用のカスタム scaffolding ビューの配置
/app/views/scaffold/index.scaffold.thtml
/app/views/scaffold/show.scaffold.thtml
/app/views/scaffold/edit.scaffold.thtml
/app/views/scaffold/new.scaffold.thtml



参考リンク

アソシエーション - CakePHP で リレーショナル・データベース - PHP on the Cake！


5.1. Cake の Scaffolding はかなりクール - CakePHP プログラマーズ リファレンスガイド



高度な Routing 設定
2008-03-26T22:52:00.002+09:00
システムの開発とそのユーザにとって分かりやすい URL を作るために役立つ設定を「/app/config/core.php」ですることが出来ます。
admin routing 

コントローラに管理者用の特別なアクションがある場合、特別な URL を準備して権限を持つ人だけがアクセスできるようにできます。
例として、ProductsController と NewsController がある場合、 通常の「/products/add 」や「/news/post 」などというアクション以外に、管理者のみがアクセスできる「/admin/products/add」や「/admin/news/post」というアクションを用意できます。


設定方法は次の通りです。
「/app/config/core.php」ファイルにある「CAKE_ADMIN」を宣言する行のコメントを外します。 「CAKE_ADMIN」のデフォルト値は「admin」になっています。
この場合の管理アクションは「admin_actionName()」という名前(例えば「admin_add()」など)になります。


望ましい URL と CAKE_ADMIN とコントローラアクションの設定の例を幾つか挙げます：
/admin/products/add CAKE_ADMIN = 'admin'
                             ProductsController のアクション名は = 'admin_add()'

/superuser/news/post CAKE_ADMIN = 'superuser'
                             NewsController のアクション名は = 'superuser_post()'

/admin/posts/delete CAKE_ADMIN = 'admin'
                             PostsController のアクション名は = 'admin_delete()'


admin routes を使うと、ロジックをごちゃごちゃにすることなく、 routing を非常に簡単に実現できます。


webservices routing

同様に、コントローラ内に URL によって異なる二つのビューを持つ単一のアクションを作ることで簡略化することができます。


「/app/config/core.php」の「WEBSERVICES」を「'on'」にすることでルート「admin routing」と同様に利用可能になります。
幾つかのセットは既に定義済みです。(rssx、mlrest、soap、xmlrpc)

参考リンク

4.4. 高度な Routing 設定： Admin Routing と Webservices - 



グローバル設定
2008-03-25T23:36:00.006+09:00

CakePHP のグローバル設定は「app/config/core.php」に記述されており、このファイルを編集する
ことで変更できます。

DEBUG : デバッグ情報の出力設定を指定
０(公開モード) : エラー情報を表示しない
ファイルが見つからない時、Cake は“ページが見つかりません”というページを表示
(app/views/errors/error404.thtml)
１以上(デバッグモード) : pr()、debug() 関数の結果を出力。flash メッセージによるページ転送を自動的にストップする
ファイルが見つからない時、"Missing Controller,"（「コントローラが見つからない」） "Missing Action,"（「アクションが見つからない」） といった生成エラーページを表示
※２以上:ページの最後の部分に SQL ステートメントの結果が表示される
CAKE_SESSION_COOKIE : CakePHP プログラムでセッションを使う際のクッキーの名前を指定
CAKE_SECURITY : セッションチェックのレベル。セッションのタイムアウト、新しいセッションIDの生成、古いセッションファイルの削除などを設定
high : １０秒間の無操作でセッションがタイムアウト。セッション id をリクエスト毎に再生成
medium : ２０分間の無操作でセッションがタイムアウト
low : ３０分間の無操作でセッションがタイムアウト
CAKE_SESSION_SAVE : セッションデータの保存方法を指定
cake : セッションデータは、Cake をインストールしたディレクトリ内「tmp」に保存
php : セッションデータは「php.ini」で定義された場所に保存
database : セッションデータは「default」キーで定義されたデータベース接続で保存

参考リンク
4.2. グローバル設定 - CakePHP プログラマーズ リファレンスガイド



データベースの設定
2008-03-25T00:26:00.005+09:00

CakePHP で使用するデータベースの設定は「cake/app/config/database.php」をサーバの環境に合わせて編集して行います。

ファイルが存在しない時は「database.php.default」のコピーを作成し、ファイル名を「database.php」に変更して編集します。

// app/config/database.php

var $default = array('driver' => 'mysql（ドライバ）',
                     // CakePHP でサポートされるドライバ：mysql、postgres、sqlite、pear-ドライバ名(pear-mysql など)、adodb-ドライバ名
                     'connect' => 'mysql_connect（接続方法）',
                     // データベース接続を持続的に扱うかどうか指定
                     'host' => 'localhost（ホスト名）',
                     'login' => 'user（ユーザ名）',
                     'password' => 'password（パスワード）',
                     'database' => 'project_name（プロジェクト名）',
                     'prefix' => '（テーブル接頭辞の指定）');

※「prefix(テーブル接頭辞)」を指定すると CakePHP から作成されるデータベースのテーブル名の全てにつけられます。

使用するデータベースが他のプログラムでも使用されてる場合は管理がし易くなると思います。


CakePHP のデータベーステーブルには以下の規約があります。



  
      Cake で使用するテーブル名は、英語の複数形にしてください。"users"、 "authors" 、 "articles" などです。注意：対応するモデルの名前は単数形になります。
  
  
       テーブルには、'id' という名前の primary key がなければなりません。
  
  
      テーブル同士を関連付けるのであれば、外部キーは、 'article_id' のようにしてください。テーブル名の単数形にアンダースコア（アンダーバー）を付け、最後に 'id' を付けます。
   
   
      テーブルに、'created'（作成） や 'modified'（修正）という列があると、Cake はしかるべき時、フィールドにデータを自動的に書き込みます。
   



データベースその他については以下のエントリのような規則があります。

命名規則


「database.php」ファイルには、$test という接続設定も含まれています。

ここに設定を記入し、任意の接続方法を選択してデータベースを利用できます。

使い方は、アプリケーションの「model」内で


var $useDbConfig = 'test';

のように設定することで、$test 設定によるデータベース接続が出来ます。
参考リンク
4.1.  データベースの設定 - CakePHP プログラマーズ リファレンスガイド



CakePHP のディレクトリ構成を変更する
2008-03-24T15:07:00.002+09:00
システムを公開する場合に、CakePHP のコアライブラリやアプリケーションコード(コントローラ、モデル、ビューなど)は公開しない様にディレクトリの構成を変更します。
CakePHPの初期状態では下記のようなディレクトリ構成になっています。
/cake
    |-app
        |-config
        |-controllers
        |-models
        |-plugins
        |-tmp
        |-vendors
        |-views
        |-webroot(Web公開用ディレクトリ)
        .htaccess
        index.php
    |-cake(CakePHP コアライブラリ)
    |-vendors
    .htaccess
    index.php


共用サーバ用に、新しい「webroot」として「public_html」に変更します。
/cake
    |-app
        |-config
        |-controllers
        |-models
        |-plugins
        |-tmp
        |-vendors
        |-views
        .htaccess
        index.php
    |-cake  (CakePHP コアライブラリ)
    |-vendors
    .htaccess
    index.php
    |-cake
/public_html  (Web公開用ディレクトリ)


「/app/webroot/index.php」を編集して、「webroot」「app」「cake」ディレクトリの設定を変更します。
設定ファイルで編集する箇所は以下の3つの定数です。

ROOT //「app」フォルダを含むディレクトリのパスを設定
APP_DIR //「app」フォルダのパス名を設定
CAKE_CORE_INCLUDE_PATH // コアライブラリ「cake」ディレクトリのパスを設定


 //「app/webroot/index.php」

 if (!defined('ROOT'))
{
define('ROOT', dirname(dirname(dirname(__FILE__))));
}
if (!defined('APP_DIR'))
{
define ('APP_DIR', basename(dirname(dirname(__FILE__))));
}
if (!defined('CAKE_CORE_INCLUDE_PATH'))
{
define('CAKE_CORE_INCLUDE_PATH', ROOT);
}

これを下記のように変更

if (!defined('ROOT')) {
    define('ROOT', DS.'virtual'.DS.'example'.DS.'cake');
    //「/virtual/example/cake」
}

if (!defined('APP_DIR')) {
 //define('APP_DIR', 'DIRECTORY NAME OF APPLICATION';
    define('APP_DIR', 'app');
}

if (!defined('CAKE_CORE_INCLUDE_PATH')) {
    define('CAKE_CORE_INCLUDE_PATH', ROOT);
}


参考リンク

3.4. CakePHP のセットアップ - CakePHP プログラマーズ リファレンスガイド


xreaでCakePHPを使う - massat.jp


CakePHPのディレクトリ構造を変更する - LifeHacks with Aipo



命名規則
2008-03-21T18:15:00.003+09:00
C.2. ファイル名
ファイル名に アンダースコア（アンダーバー）を使用する場合、直後の頭文字は大文字にする。
 「my_nifty_class.php」 というファイル名なら「MyNiftyClass」 というクラス名。
コントローラ
「my_tests_controller.php」というファイル名なら「MyTestsController」 というクラスになる（ファイル名の中に「 _controller」 が入ることに注意。）
モデル
「my_test.php」というファイル名なら「MyTest」というクラス名のモデルになる。
コンポーネント
「my_mail.php」というファイル名なら、「MyMailComponent」 という名前のコンポーネント。（ファイル名に _component は必要ない。）
ヘルパー
「my_helper.php」というファイル名なら、「MyHelper」 という名前のヘルパー。
参考リンク
4.5. (任意） カスタム Inflections 設定 - CakePHP プログラマーズ リファレンスガイド



アソシエーション - CakePHP で リレーショナル・データベース
2008-03-21T17:38:00.005+09:00
6.4. アソシエーション

CakePHP でのテーブル間の繋がりをアソシエーションという。

リレーショナル・データベースを CakePHP のモデルで構築出来る。

※SQLで言えばJOINで２つのテーブルを結合すること

アソシエーションには四種類ある。

      hasOne
      hasMany
      belongsTo
      hasAndBelongsToMany

二つのモデル間で成り立つ関係は
hasOne - belongsTo (ユーザとプロフィールとか)
hasMany - belongsTo(ユーザと日記とか)

プロフィールと日記を結び付けたかったら hasAndBelongsToMany を使う。



ページのキャッシュ設定
2008-03-15T11:53:00.001+09:00
CakePHP のビューをキャッシュする設定方法。

cake1.1.6以下ではエラーになるので、1.1.7以上で行う。

「app/config/core.php」でキャッシュの設定を有効にする。
/app/config/core.php
      //1.1系
      define ('CACHE_CHECK', true);
      //1.2系
      Configure::write('Cache.check', true);

コントローラのヘルパに cacheヘルパを追加。
var $helpers = array('Cache');

コントローラにキャッシュさせるアクションとキャッシュの有効期限を設定。
var $cacheAction = array('index'=>'1 hour');
//もしくは
var $cacheAction = array('index'=>3600);//秒単位で指定


以上の設定で「http://host/controller/index」にアクセスされたときのキャッシュが「app/tmp/cache/views/」 に作成されます。ファイル名は「controller_index.php」。

「http://host/controller/index/mode1」などアクションに引数を渡す場合も、それぞれファイルが作成されます。ファイル名は「controller_index_mode1.php」。



ヘルパーで画像ボタン
2008-03-13T16:03:00.002+09:00

CakePHP のヘルパーで、 image 属性の input タグを出力する方法。


<?php echo $html->input('Form/image',array('type' => 'image', 'src' =< 'img/button_form_send.jpg', 'alt' => '送信')) ?>

//出力

<input type="image" name="data[Form][image]" src="img/button_form_send.jpg" alt="送信" value="" id="image">


CakePHP に関するサイトには皆、$html->input() はテキスト入力の input タグを出力するヘルパーと説明されてる。


<?php echo $html->input('Form/image',array('size' => '10', 'maxlength' => '10')) ?>

//出力

<input type="text" name="data[Form][image]" size="10" maxlength="10" >

実際は、デフォルトが「type="text"」なだけでタグの属性は第二引数の配列で指定が可能。
試してないが、$html->radio()とか使わずに出力できそうだ。面倒だからしないけど。

他にも id と value がデフォルトになっていた。命名規則とか厳しいので固定かと思ってたが属性は自由になりそうだ。


ソースは見てみるものだ。危うく自作するところだった。

$html ヘルパー
 cake/libs/view/helpers/html.php



ラジオボタンのヘルパー(追記:2008/03/17)
2008-03-12T10:18:00.005+09:00

string radio(string $fieldName, arrray $options [,string $inbetween=null [,array $htmlAttributes=array() [,bool $return=false ]]])

$fieldName：
    name属性の値
$option：
    array(’value’=>’表示名’);
    value は value=”value” になり、表示名はラジオボタンの後ろに表示される文字名
$inbetween：
    ラジオボタンの間に表示される文字列
$htmlAttributes：
    html の属性 array(’属性名’=>’値’)で指定する
$return：
    ヘルパーの自動出力


<?php echo $html->radio('Model/field', array('1'=>'option1','2'=>'option2', '3'=>'option3'), ' | ', array('onchange'=>'alert(this.value)', 'class' => 'myradio', 'style' => 'margin:5px;'), false); ?>

option1 | option2 | option3 |
<input type="radio" name="data[Model][field]" id="field_1" onchange="alert(this.value)" value="1"  />option1 |
<input type="radio" name="data[Model][field]" id="field_2" onchange="alert(this.value)" value="2"  />option2 |
<input type="radio" name="data[Model][field]" id="field_3" onchange="alert(this.value)" value="3"  />option3 |

次のようにもかける。

<?php echo $html->radio('Model/field', array('1'=>'option1'), ' | ', array('checked' => 'checked'); ?>
<?php echo $html->radio('Model/field', array('2'=>'option2'), ' | '); ?>


任意のボタンに初期値としてチェックを入れたい場合はこの記法。(※2008/03/17 追記)

前述の様にラジオボタンをまとめて記述した場合に、「'checked' => 'checked'」とすると最後のラジオボタンがチェックされる。

コーディングやデザイン上の都合でも有効。


値に文字列を与えると以下の様になる。

おとなしく数字で対応させて処理しなさいってことで。数字の方が値チェックも楽だし。


<?php echo $html->radio('Model/field', array('ヴァリュ'=>'オプション1'); ?>
<input type="radio" name="data[Model][field]" id="field_ヴァリュ" onchange="alert(this.value)" value="ヴァリュ"  />オプション1


※2008年3月17日追記

以下の様に記述することでヘルパーから任意のラジオボタンに初期値でチェックを入れられるようだ。

<?php echo $html->radio('Model/field', array('1'=>'option1','2'=>'option2', '3'=>'option3'), ' | ', array('value' => '2')); ?>

これで2つ目のラジオボタンに「checked = "check"」
が指定できる。

ソース見てよかった。



CakePHPシステムデザイン（最新規約）
2008-03-07T18:28:00.000+09:00
CakePHPシステムデザイン（最新規約）
命名規則やファイル構成(ヘッダ、フッタの設定)など。



view 内のforeach、if の記述
2008-03-05T10:40:00.004+09:00

CakePHP のヴューファイルでのforeach 文、if 文の記述例。

 
           :

  <table>
     <?php foreach ($array as $data): ?>
       <tr>
        <?php foreach ($data as $key=>$val): ?>
         <?php if ( !empty($val)): ?>
         <td><? echo $key,$val; ?></td>
         <? endif; ?>
        <?php endforeach; ?>
      </tr>
      <?php endforeach; ?>
   </table>
           :

括弧を使わない形式が何故良いのか具体的には理由が分からなかったが、Wordpress も if～endif で記述されている様なので国際化とか見易さの問題だろうか。

他言語との共通だし。



フォームの入力チェック
2008-03-03T14:43:00.002+09:00

フォームからの入力が正しいか調べるには、以下のように $validate という変数にフォームの入力欄の name とその値の定義をかく。

//モデル - sample.php

class Sample extends AppModel {
   var $name = 'Sample';
:
    var $validate = array(
        'name'  => VALID_NOT_EMPTY,
        'email' => VALID_EMAIL,
        'age' => VALID_NUMBER,
        'year' =>VALID_YEAR
    );
:
}

定義されてる変数の型は4つで以下のように正規表現によるチェック。
cake/cake/libs/validators.php に定義

VALID_NOT_EMPTY:入力の有無(必須項目のチェックとかに)
define('VALID_NOT_EMPTY', '/.+/');
VALID_NUMBER:数字のチェック(符号付)
define('VALID_NUMBER', '/^[-+]?\\b[0-9]*\\.?[0-9]+\\b$/');
VALID_EMAIL:メールアドレスのチェック
define('VALID_EMAIL', 
'/\\A(?:^([a-z0-9][a-z0-9_\\-\\.\\+]*)@([a-z0-9][a-z0-9\\.\\-]{0,63}\\.(com|org|net|biz|info|name|net|pro|aero|coop|museum|[a-z]{2,4}))$)\\z/i');

VALID_YEAR:年のチェック(1000～2999)
define('VALID_YEAR', '/^[12][0-9]{3}$/');



VALID_NOT_EMPTY 以外も未入力はエラーになる。

VALID_NUMBER はマイナスも含まれるので、年齢チェックなどに使う場合は注意が必要。

$validate に VALID_XXX の代わりに直接正規表現を指定しても良さそうだ。

関連
MJ::Blog - http://www.majima.net/

CakePHP 登録フォームの実装 其の三

独自の「入力エラーメッセージ表示」ヘルパーを作成。



CakePHPのscaffoldを日本語化
2008-03-03T10:50:00.003+09:00
頭ん中 - http://www.msng.info/
CakePHPのscaffoldを日本語化してみたComments
自己責任。

CakePHP の scaffold は
簡易管理画面として使うのに便利なのだが、
当然ながら英語で表示されるので

～略～

日本語で表示されるようにしてみた。

ビューを簡単に書き換えただけなので
まだ英語で残っている部分もあるけど、
ないよりはマシかなと思うので置いておきます。

scaffolds.zip

これをダウンロードして解凍して

app/views/scaffolds

の中に

edit.ctp, index.ctp, view.ctp を置くだけ。




公開する
2008-02-26T18:24:00.001+09:00
CakePHP 公開する時はデバッグ情報を出さない
CakePHPのディレクトリ構造を変更する


データベース
2008-02-26T18:23:00.000+09:00
CakePHP で複数のデータベースを使用する
CakePHP 環境によってデータベースを切り替える
CakePHP データベースを使わないアプリケーション


コンポーネント
2008-02-26T18:20:00.003+09:00
9. コンポーネント
Cake PHP コンポーネントでモデルを使用する方法
CakePHPでアプリケーションの設定をデータベースに保存する
CakePHP controller共通のモデル、コンポーネント、ヘルパーを設定する
CakePHP 管理者サイトでBasic認証を簡単に行うコンポーネント
CakePHPの日本語高機能メールコンポーネント
CakePHPで自動ログインコンポーネント


メールアドレスが正しいか正規表現でチェック
2008-02-25T15:59:00.004+09:00

CakePHP のデータ入力チェックは以下の正規表現で行われているようだ。


define('VALID_EMAIL', '/¥¥A(?:^([a-z0-9][a-z0-9_¥¥-¥¥.¥¥+]*)@([a-z0-9][a-z0-9¥¥.¥¥-]{0,63}¥¥.(com|org|net|biz|info|name|net|pro|aero|coop|museum|[a-z]{2,4}))$)¥¥z/i');

参考

ハズレ日記 - http://catbot.net/blog/

re: PHPでメールアドレスかどうか調べる方法

関連
PHP on the Cake ! - 2008年3月3日

フォームの入力チェック



CakePHPとAPI
2008-02-19T15:29:00.001+09:00
神童
cakephpでwebサービスapiを活用したサンプルサイトを作ってみる3



参考サイト
2008-02-19T15:17:00.002+09:00
Sun Limited Mt.

CakePHP Ajax のフォームを作成する

CakePHP 管理画面を作成する方法
CakePHP 携帯でセションを有効にする
CakePHP ファイルアップロードするコンポーネント
CakePHP jQuery を使用した Ajax ファイルアップロード
CakePHP JQuery ヘルパー
CakePHP Security コンポーネントのまとめ



静的なページの作り方
2008-02-19T15:07:00.002+09:00

CakePHP フレームワークには M(モデル)V(ヴュー)C(コントローラ)の仕組みがある。

次の様なページが作れる。

Kemworld::Diary
cakephpで普通のページを作る。

「V（ビュー）だけ使う」→静的なページ（いわゆる普通のページ）。
「V（ビュー）とC（コントローラ）だけ使う」→DBは使わないけどビジネスロジックはあるページ。
「M（モデル）V（ビュー）C（コントローラ）全部使う」→ビジネスロジックがあってDBにデータを保存したり内容を表示したりするページ。



プラグインの作成
2008-02-19T14:57:00.002+09:00
TOYOSYSTEM
CakePHP::メール送信プラグインを書いた



インストールについて
2008-02-04T01:21:00.002+09:00
動作環境
CakePHP を動作させるために必要なサーバのセットアップ条件は下記の通りです。

HTTP サーバ(Apacheなど)
    sessions、 mod_rewrite(必須ではないがある方が良い)
PHP 4.3.2 以降(PHP 4 、PHP 5 どちらでも可)
データベース(MySQL、PostgreSQL、ADODBをサポート)

ダウンロード
以下のサイトから CakePHP パッケージをダウンロードします。(ここではZIPファイルをダウンロードしました)

CakeForge: CakePHP: Project Info
「Latest File Releases」->「Pacake」->「Beta」または「Stable」から(2008/03/23 現在は「1.2.0.6311-beta」と 「1.1.19.6305」)
CakePHP: the rapid development php framework. Downloads
「Downloads」->「Name」->「1.1.x.x」または「1.2.x.x」のリンクから

nightly は最新リリースのベータ版のようです。CakeForge から安定版をダウンロードするのが無難でしょう。

セットアップ
ダウンロードしたCakePHPパッケージのセットアップする方法を説明します。ここではzipファイルを使います。
ダウンロードしたzipファイルを解凍して、サーバの任意のディレクトリに設置します。ここではドキュメントルートディレクトリに設置しました。
/public_html
    /cake
        /app
        /cake
        /vendors
        .htaccess
        index.php

この場合、以下の様なURLでアクセス出来ます。
http://www.example.com/cake/コントローラ名/アクション名/パラメータ1/パラメータ2

構成の詳細は次のようになります。
/public_html
    /cake
        /app
            /config
            /controllers
            /models
            /plugins
            /tmp
            /vendors
            /views
            /webroot
            .htaccess
            index.php
        /cake
        /vendors
        .htaccess
        index.php

「http://www.example.com/cake/」でアクセスされるのは「…/cake/app/webroot/index.php」になります。
「http://www.example.com/cake/コントローラ/」でアクセスされるコントローラファイルは「…/cake/app/controllers/」に置かれます。

「http://www.example.com/cake/index.php」にアクセスしてCakePHPのページが表示されたら準備は完了です。
システムを公開する場合は、自宅サーバなどルート権限を持っているならサーバのDocumentRootを変更して CakePHP を設置したディレクトリを隠します。
// httpd.conf 
DocumentRoot /public_html/cake/app/webroot

これで「http://www.example.com/」のアクセスが「…/cake/app/webroot/index.php」になります。
サーバに応じて更にディレクトリ構成を変更したい場合には以下のエントリのようにします。
CakePHP のディレクトリ構成を変更する
参考リンク

3.4. CakePHP のセットアップ - CakePHP プログラマーズ リファレンスガイド



MVCモデルについて
2008-02-04T00:46:00.001+09:00

MVC は Web アプリケーションをモデル、ビュー、コントローラという三つの部分に分割する手法です。

入力(コントローラ) -> 処理(モデル) -> 出力(ビュー)

例を挙げると
フォーム入力 -> データ処理 -> 結果表示

と言った感じになるかと思います。
このモデルのデータ処理でデータベースを扱う印象が強い為、「CakePHP は DB を使ったシステムだけ」と感じてしまいますがデータベースを使わない PHPシステムを作ることも可能です。

その場合は 「コントローラ -> ビュー」といった仕組みになります。

また静的ページを扱うこともできます。
個人的には、「処理(コントローラ) -> データ型(モデル) -> 出力(ビュー)」という感じがします。

コントローラはプログラムのメイン処理で、モデルではプログラムで扱うデータの型をモデル化、処理結果をビューのテンプレートで結果を表示するといった印象。



Cake PHP について
2008-02-03T23:44:00.001+09:00
CakePHP は、プログラマが Web アプリケーションを作成するためのオープンソース・フレームワークです。

日本語リファレンスが充実しており習得が簡単です。またプログラムが表示するエラーメッセージも詳しく丁寧・親切な為、習得の助けになるでしょう。


CakePHP の利点として、PHP 4・5どちらでも動作するということがあげられます。

CakePHP パッケージのみの使用で、他のライブラリを必要とせず、更には PEAR や Smarty とも併用可能となっています。>

CakePHP の目的は、デザインとシステムの分離にあります。>

CakePHP で構築されるシステムは、MVC(モデル - ビュー - コントローラ)モデルと呼ばれる3つからなります。>

DB などの記述も簡単で、SQL文を意識せずデータを扱えます。>

CakePHP は「Ruby on Rails」フレームワークから触発されて作られました。

参考リンク
PHPフレームワークの比較
PHPベンチマーク: Zend Framework vs Symfony vs CakePHP vs CodeIgniter vs PHP on TRAX - 徒然なるままにBlog

PHP on the Cake !

全文検索

WHERE条件文の書き方

存在しないコントローラ・アクション・ビューへのアクセス

参考

DBの切り替え - database.php

関連

CakePHPをベースにしたフォトブログ - CheeseCake

CheeseCake

ページャー/ページ送り - PEAR::Pager,Pagination,(1.2)Paginator

PEAR::Pager

Pagination

Paginate(1.2系)

CakePHPを基にしたCMS

Wildflower

CheeseCake

Pocky

まんじゅうCMS

関連

CakePHPで作られたショッピングサイト - BakeSale他

HTMLヘルパー：image

フォーム・ヘルパー : error

フォーム・ヘルパー : isFieldError

エンティティをモデルに作る（データの加工）

デバック「debug」のレベル

CakePHPを1.1から1.2へ上げるときの注意点

CakePHPアプリケーションの情報を表示 - CakeInfo

フレームワーク・ライブラリの比較

$scripts_for_layoutは$html->css(),$javascript->link()でビューからヘッダに追加する変数

参考

CakePHP1.2での確認画面を挟んだ登録フォーム

CakePHP1.2でset()したデータをビューで扱うにはtagValue()ではなくvalue()

参考

memo

フォームのラベル

参考

デフォルトのビュー・レイアウトをカスタマイズ

参考

ヘッダでインクルードするJSファイルやCSSファイルをアクションごとに変更

SQLite3を使う(※追記)

ダウンロード

インストール

DB接続の設定ファイル

フォームからの入力

pr()をカスタマイズ

参考

APIを使う

アプリ公開時のエラー処理

フォームのリロードと遷移

モデルの関数

参考リンク

モデルについて

参考リンク

Scaffolding の利用

参考リンク

高度な Routing 設定

admin routing

webservices routing

参考リンク

グローバル設定

参考リンク

データベースの設定

参考リンク

CakePHP のディレクトリ構成を変更する

参考リンク

命名規則

参考リンク

アソシエーション - CakePHP で リレーショナル・データベース

ページのキャッシュ設定

ヘルパーで画像ボタン

ラジオボタンのヘルパー(追記:2008/03/17)

CakePHPシステムデザイン（最新規約）

view 内のforeach、if の記述

フォームの入力チェック

関連

CakePHPのscaffoldを日本語化

公開する

データベース

コンポーネント

メールアドレスが正しいか正規表現でチェック

`pr()`をカスタマイズ

アソシエーション - CakePHP でリレーショナル・データベース