CakePHPのFormヘルパーがいつまでたっても覚えられないので、自分用にコピペ用にメモっていきたいと思います。（今後どんどん追記していこうかと）
使えるな〜と思ったらどうぞ使って下さい。なお、記法はPHP5.4以降のarray短縮構文です。
//フォームの書き出し（なお、デフォルトではmethodはpost）
echo $this->Form->create('User');
//postじゃなくて、methodをgetにしたい時
echo $this->Form->create('User', ['type' => 'get']);
//multipart/form-data(ファイルアップロード用のフォーム作成時に)
echo $this->Form->create('User', ['type' => 'file']);
//action先を任意で設定したい時
echo $this->Form->create('User', ['url' => ['controller' => 'search', 'action' => 'list']);
エラーも、ラベルもテキストフォームも一緒に表示したい時
//labelを変更したい時
echo $this->Form->input('name', ['label' => '名前']);
//フォームパーツを囲うdivタグが不要な時
echo $this->Form->input('name', ['label' => '名前', 'div' => false]);
何年〜何年までと期間指定出来ることと、monthNamesをfalseにすることで、Aprilなどの月表記を数字に出来る。
maxYearとminYearの設定で、何年〜何年までのプルダウンになります。dateの扱いはけっこう便利。
echo $this->Form->input('birthday', [
'dateFormat' => 'YMD',
'monthNames' => false,
'minYear' => date('Y') - 50,
'maxYear' => date('Y') - 13,
'separator' => array(' 年 ', ' 月 ', ' 日 '),
]);
legendのfalseグループ化fieldsetを除去
$options = ['0' => '男性', '1' => '女性'];
$attributes = ['default' => '0','label' => false, 'legend' => false ];
echo $this->Form->radio('gender', $options, $attributes);
チェックボックスが一つか、複数かで書き方は変わります。
//項目が複数
echo $this->Form->input('Model.field',
['type' => 'select',
'multiple' => 'checkbox',
'options' => $options,
'label' => false,
'div' => false,
'id'=> false]);
//〜に同意します などに使えるチェックボックス
echo $this->Form->input('registration', [
'type' => 'checkbox',
'label'=> false,
]);
empty設定で、未選択状態を設定可能。
echo $this->Form->input( 'field', [
'empty' => '-----',
'label' => false,
'type' => 'select',
'options' => ['Cakes','Cookies']
]);
echo $this->Form->end('変更');
ひっさしぶりにしばらく別の仕事でZendFrameworkに関わっていたため、すっかりCakeのViewを忘れてしまいました。
特のFormヘルパーはすぐ忘れておたおたしちゃうんで、すぐコピペして使えるようにメモがてら残しておきたいと思います。
Formヘルパーを使うと余計なdivで囲われたり idが勝手に付与されたりするので、便利といえば便利なんですけど、時に邪魔な時はfalseを設定しましょう。
classを付与したい場合はclassを以下のように設定しますが、複数classを付与したい時はHTML同様、半角スペースを付けてあげれば複数classが設定出来ます。前にclass複数付与するにはこれも配列で渡すのかとおもってつまづいたことがあるので念のため。
echo $this->Form->input( 'field', [
'div' => false,
'label' => 'false',
'class' => 'class1 class2',
]);
↑↑↑↑なぜこの現象が起きるのですか?Why??
↑↑↑↑CakePHP2.x Authコンポーネントの使いかたはこちらが分かりやすいざます。
$this->User->save($this->request->data);
最初何のことやら分からず大混乱しましたが、、、
直前にidにNULL代入して無事新規データとしてInsertが実行されました。
$this->request->data['User']['id'] = NULL; $this->User->save($this->request->data);
なぜだ〜。でもUserモデルにAuth認証してIDを常にSession持っているからそういうもんなのかな〜と思ってみたり。
$return = $this->Model->query($sql);
もちろん、プレースホルダーをつかってSQLインジェクション対策もします。
class Model extends AppModel {
public function getMember($id){
$sql = "SELECT * FROME table WHERE member_id = ?;";
$params = array(
'member_id'=> $id
);
$data = $this->query($sql,$params);
return $data;
}
あとはController内で受け取ります。
//Controller
public function index($id) {
$data = $this->Model->getMember($id);
$this->set('data', $data);
}
。。特にメモるほどでもなかったかも・・
Facebookアカウント以外にもTwitterやGoogle+など多彩なソーシャルアカウントとログイン連携を取るならOpauthがオススメです。日本語情報も多いですしね。
日本語情報がほとんどないため、一部実装に悩んだ部分もありましたが、導入できました！
このプラグインを導入することで、ログイン以外にこれだけのことが実装出来るようになります。WordPressのプラグインみたいですね〜。CakePHPで作った自作CMSにコメントなど色々導入出来たら楽しそうですね！
CakePHP2.2で導入しました。なお、1.3から導入出来るらしいですし、本家サイトの解説もCakePHP1.3系の書き方をしてあります。
プラグインはGitHubで公開されています。プラグインをダウンロードして、Facebookとフォルダ名を付けて、
/app/Plugins/ に設置します。
//app/Config/bootstrap.php
CakePlugin::load('Facebook');
Facebookのアプリケーション登録をしないと、ログインも何も使うことが出来ません。
今回私はローカルのMAMPでやってみましたが、どう考えても存在しないようなドメインの形だと登録出来ないので、それっぽい、存在しそうなドメイン名で登録しました。
さらに、facebookでログインするWEBサイトの登録部分は Facebookでログイン後にリダイレクトされることになるので、ログイン後に表示させたいURLを登録すればよいみたいです。
app/Config/facebook.phpに Facebookのアプリ情報を記載します。appIdとapiKeyの２つはだいたい同じだと思うのですが。
日本だとlocaleはja_JPとなります。
//app/Config/facebook.php
$config = array(
'Facebook' => array(
'appId' => 'YOUR_APP_ID',
'apiKey' => 'YOUR_API_KEY',
'secret' => 'YOUR_SECRET',
'cookie' => true,
'locale' => 'ja_JP',
)
);
ヘルパーの記載はこんな感じ。プラグインのヘルパーなので、このような記載になりますね。
シェアボタンやいいねボタンの設置などに使います
public $helpers = array('Facebook.Facebook');
ログイン認証に関わる部分。Authコンポーネントと連携して、Facebookのアカウントで認証を行います。
CakePHP２系のAuth認証の参考サイトはこちらが分かりやすいです。
予めCakePHPのAuth認証は作っておいて下さい。
（CakePHP 2.x 系で会員認証 / ログイン関係の機能を AuthComponent を使って構築する方法 ウェブル）
今回はそれに少し追記して実装する形になっています。
//usersController.php
//Example AppController setup
public $components = array('Session',
'Auth' => array(
'authenticate' => array(
'Form' => array(
'fields' => array('username' => 'email')
)
),
'authorize' => 'Controller'
),
'Facebook.Connect' => array('model' => 'User')
);
ヘルパーを使うことで、Facebookとの連携が出来るようになります。
<?php $this->Facebook->html(); ?> <head> <title>Facebook Plugin Example</title> </head> <body> <?php echo $content_for_layout ?> <?php $this->Facebook->init(); ?> </body> </html>
基本的なAuthは今回は解説しません。普通のCakeのAuthとFacebook.Connectとを連携させればOKです。
ただFacebookアプリを通して認証するだけならこれだけでOK。
ちゃんとFacebookIDをデータベースに登録してから、FacebookIDの存在の有無をチェックし、FacebookIDがデータベースに存在しなければ新規登録を促せばよいですね。
Facebookそのものにログインしている状態(CakeのAuthの方じゃなくて)であれば、
debug($this->Connect->user());
と、するだけでプラグインの設定が完了していればFacebookに登録済みのユーザー情報を引っ張ることが出来るのです。
//ユーザー登録時にFacebookIDも合わせて登録する
if($this->request->is('post')) {
$this->User->create();
$this->request->data['User']['facebook_id'] = $this->Connect->user('id');
if ($this->User->save($this->request->data)) {
$this->Session->setFlash(__('The user has been saved'));
$this->redirect(array('action' => 'login'));
} else {
$this->Session->setFlash(__('The user could not be saved. Please, try again.'));
}
}
このように登録しておけば、認証時にデータベースにFacebookIDの有無を確認すればよいですね。
最初は難しいと思ったけれど、使い方が分かるととっても簡単でした！
GWなのに、お仕事してますよ ITかあさんです。先日教えてもらった
のに、
っていう便利な機能を教えてもらいました。
例えばブログの記事投稿ってカテゴリーを指定しますね。あのような
っていうお前は一体何個hasManyしているんだ！っていうのが知りたい時に大変便利です。
このような構造で、今回はCategoryモデルにPostCategoryの数を保存する構造にします。
var $belongsTo = array(
"Category" => array(
'className'=>'Category',
"counterCache" => true,//これだけ！
'foreignKey'=>'category_id'
),
);
Category Modelに数値型でフィールドを追加します。
複数系にならず、hasManyのModelの名称（小文字）+_countとなります。
たったこれだけで、ImageCategoryのデータが登録される度に、または削除される度にimage_category_countの数値が増減します。
で、ここまでの情報は出回っているものの、問題は一度に削除したり、一度にたくさん登録するケース。
この場合、DeleteAllなどたくさんの登録や削除が終わった段階で現在何件あるかを問い合わせすることで、カウントの値が変更されます。
一度にたくさん登録した、たくさん削除した場合はそのままでは件数が更新されないためupdateCounterCacheをデータをたくさん登録したり削除した後に実行します。updateCounterCacheをしたタイミングで、その時の件数を数えてくれるイメージでしょうか。
$this->PostCategory->updateCounterCache(array('post_id' => $post['Post']['id'],'category_id' => $category_id));
queryした時も同様で、updateCounterCacheは１件ずつsaveやdeleteで増減した時でないと自動でカウントはしないみたいです。この時もupdateCounterCacheを実行してあげればいいみたいです。
うん、これで今データは何件あるかの管理は相当楽になりますね。
CakePHPに限らず、WEBサイトのプログラムを作っていると、ページネーションは欠かせないですね。
CakePHPのPagenatorにはView側に非常にたくさんのオプションがあるので、まとめてみました。
1.3系でも2系でも基本的な使い方は変わりません。View側がほんの少し違うだけです。
データの取得条件であるconditionsについては適時変更して下さい。
$this->paginate = array(
'conditions'=>array(),
'order' => array('Model.id' => 'desc'),
'limit'=>10,//１ページあたりの表示件数
);
$this->set('datas', $this->paginate('Model'));
ここからが本題。CakePHP Pagenatorのview側のオプションについてです。
なお、CakePHP2系でのサンプルになりますが、それほど違いはありません。
$paginator->next();//1.3 $this->Paginator->next();//2系
基本的な次へ、戻るリンクです。次へリンクのある場合prevクラスが、先にデータがもうない場合はdisabledのクラスが当たります。
echo $this->Paginator->prev('[前へ]', array(), null, array('class' => 'prev disabled'));
echo $this->Paginator->next('[次へ]', array(), null, array('class' => 'next disabled'));
[前へ]｜[次へ]
デフォルトだと、spanタグで囲われていいます。(基本Pagenatorは何でもspanみたいです)
以下のようにすると、spanがpタグに変わります
echo $this->Paginator->prev('[前へ]', array(), null, array('class' => 'prev disabled','tag' => 'p'));
各ページへのリンクタグも囲っているタグはspanなので、tagでspan以外のタグに変更出来ます。
separatorとは区切り文字です。『|』などがいいでしょうし、必要なければ書かなくても問題ないです。
echo $this->Paginator->numbers(array('separator' => '','tag' => 'li'));
現在 何件のデータがあって、何ページで、何件中何件のデータを表示しているか
echo $this->Paginator->counter('{:count}件中{:start}-{:end}件({:pages}ページ中{:page}ページ)
');
もちろん画像も使うことが出来ます。
$this->Paginator->next("
", array("escape" => false , "tag"=>"span"),
"
",//off
array("escape" => false , "tag"=>"span")
);
こんなもんかな？もしあれば今後追加します。
そこそこ反響がありました、
最後にちらっと
と言ってしばらく放置していたら、UploadPackでアップロードしたファイルのフォルダ分散についてやはり質問を頂きましたので解説します。
ただ、やっていることは非常にシンプルで、
ただそれだけなんですよ。
ITかあさんがCakePHPでCMSを開発する際には、もう無くてはならないプラグインになっているUploadPackなんですが、唯一問題なのは
と、いうことなんです。
UploadPackでアップロードしたファイルの保存先はModelに指定しますね。
var $actsAs = array( 'UploadPack.Upload' => array( 'img' => array( 'path' => ':webroot/img/:id/:style.:extension', 'styles' => array( 'big' => '200x200', 'small' => '120x120', 'thumb' => '80x80', ) ) ) );
これ、マスター管理者しかアップロードしないケースならそれほど気にならないですが、ユーザーが自由にどんどんアップロードするプログラムなら、3000回アップロードされたら3000フォルダも作られてしまいます。
長く運用するなら、デフォルトのままではちょっと無理があると思います。1つのディレクトリにたくさんファイルやフォルダがあるのはちょっとした重さの原因になったり、管理上もよろしくないです。
登録したidを指定した桁数までゼロ埋めして、さらに2桁、3桁くらいでフォルダ分散させます。今回は8桁でやってみます。
$cont_id = sprintf("%08d", $id);
$dir1 = substr($cont_id, 0, 2); //0埋めしたIDをスライスして、一定のファイルごとにディレクトリ分散
$dir2 = substr($cont_id, 2, 3); //一応これで、99999999以上は余裕でいけます。
$file = '/home/example.com/public_html/app/webroot/img/banner/'.$dir1.'/'.$dir2.'/'.$cont_id;
フォルダをちゃんと分散させたほうがいいんだな、ということを頭に入れて、CakePHP UploadPackプラグインで実際にファイルをイイ感じに分散したいと思います。
CakePHPのsaveメソッドとは、読んで時のごとく
CakePHPブログチュートリアルだとこんな風になっています。
function add() {
if (!empty($this->data)) {
//saveメソッド。saveしたらリダイレクトをしている
if ($this->Post->save($this->data)) {
$this->flash('Your post has been saved.','/posts');
}
}
}
何となくループ中にこのようにsaveメソッドを実行しただけでは なぜか最後のデータしか登録されず、全ループ分データが登録されません。
foreach($this->data as $data){
$this->Post->save($data);
}
回答としては、これを実行してね！とあります。
$this->Model->create(false);
どうやら、ループ中にsaveを行いたい場合は必ずcreateメソッドを実行してあげる必要があるようです。
// Create: idがセットされていない $this->Recipe->create(); $this->Recipe->save($this->request->data); // Update: idに整数値がセットされている $this->Recipe->id = 2; $this->Recipe->save($this->request->data);
createメソッドについては本家にも説明があります。
そんなわけでこれらを踏まえてループ中に何度もsaveメソッドを実行するとこうなります。
foreach($this->data as $data){
//saveの前にcreateを実行
$this->Post->create(false);
$this->Post->save($data);
}
なぜfalseなのか。それはIDがないよ(新規登録だよ)と、いうことと同じことみたいです。なので、
foreach($this->data as $data){
//idはないよ、新規登録だよ という意味に。
$this->Post->id = false;
$this->Post->save($data);
}
今回の例だと、ループ中にidがセットされていないケースなので、updateの場合はhiddenでidを渡せばOKだよ！
よく覚えておこう。
先日仕事でCakePHPの画像リサイズで、プラグインのUploadPackを使いまして、日本語の詳細な解説が少ないことから自分自身躓いたこと、分かったことをCakePHPの初心者でも分かりやすく解説していきたいと思います。
画像アップロードに関してはほぼ全てのバリデーションが備わっており、ピクセルサイズ指定はもちろん、指定した大きさにリサイズ・複製など画像のリサイズに関してもかゆい所に手が届く仕様になっており、画像のアップロードに関してはUploadPackプラグインに全て任せることが出来るので、ぜひCakePHP初心者にも覚えて頂きたいプラグインとなっております。
CakePHP使うなら、使わないともったいないプラグインの一つです。
CakePHP1.3と、CakePHP2系では利用するバージョンが違うようで、この点は注意しなければならないポイントです。
zipファイルをダウンロードして解凍すると「uploadpack-master」というフォルダが出現しますので、このフォルダ名を「upload_pack」というファイル名に必ずリネームして、「app/plugins」(Cake1.3) 「app/Plugin」(Cake2系)フォルダに設置します。
データベースの設計については特にCakePHPのテーブル設計と何ら変わりませんが、この「UploadPack」を利用して画像を保存したいものは必ずフィールドを用意する必要があります。
数に制限はないので、何個でも設定することも出来ます。
ではUploadPackプラグインを利用する準備に入ります。
この指定はCake2系で行います。「bootstrap.php」の最終行に以下の記述を加えます。
これで設置したプラグインが自働で読み込まれます。
CakePlugin::loadAll();
プラグイン CakePHP Cookbook v2.x documentation
imagesテーブルを使うためのImage Modelを作ります。
Cake2系ではファイル名が「Image.php」となるだけで、記述内容は全く一緒です。
<?php
class Image extends AppModel{
}
?>
まずはimages_controller.phpを以下のように記述しました。
Cake2では「ImagesController.php」というファイル名になるだけです。
一先ずCakePHPブログチュートリアルをほぼそのまま持ってきたような形になっていますが、UploadPackヘルパーの読み込みを忘れずに行ってください。
class ImagesController extends AppController {
var $uses = array('Image');
//ヘルパーの読み込みを忘れずに行う
var $helpers = array('Form','UploadPack.Upload');
function index() {
$this->set('posts', $this->Image->find('all'));
}
function add() {
if (!empty($this->data)) {
if ($this->Image->save($this->data)) {
$this->redirect('/images');
}
}
}
function edit($id = null) {
$this->Image->id = $id;
if (empty($this->data)) {
$this->data = $this->Image->read();
} else {
if ($this->Image->save($this->data['Image'])) {
$this->redirect('/images');
}
}
}
}
先ほど作ったImageControllerに対応するviewファイルを作成します。まずはindex.ctpだけ作って、画像追加用のフォームを含めたctpファイルは後ほど作ることにします。
<h1>UploadPack</h1>
<p>This is UploadPack Test!</p>
<h2><?php echo $this->Html->link("Add New Image", "/add/"); ?></h2>
<table>
<tr>
<th>ID</th><th>TITLE</th><th>IMAGE</th><th>CREATED</th><th>EDIT</th>
</tr>
<?php foreach($images as $image):?><tr>
<td><?php echo $image['Image']['id'];?></td><td><?php echo $image['Image']['title'];?></td><td><?php echo $image['Image']['img_file_name'];?></td><td><?php echo $image['Image']['created'];?></td><td><?php echo $this->Html->link("EDIT", "/edit/".$image['Image']['id']); ?></td></tr>
<?php endforeach;?>
</table>
後で任意で画像保存のディレクトリは変更できるのですが、デフォルトで画像が保存されるディレクトリが決まっています。
webrootにuploadディレクトリを準備し、先ほど作ったModelの「テーブル名」と同じ名称のフォルダを準備して、パーミッションを777にしておきます。
今回だと以下のようになります。
(Modelと同じ名称ではなく、テーブルと同じ名称なので、「images」と複数系のフォルダになるわけですね。)
以上で準備が完了しました。
CakePHP2系と、1.3系と大きく作業内容が変わることはありません。bootstrap.phpにプラグインの読み込み指定がCakePHP2ではある点だけ注意してください。
それでは早速画像のアップロードを実装してきたいと思います。
MysqlやPostgreSQLなんかのデータベースでデータのデフォルト値を設定しているケース、あると思います。
このデフォルト値を設定しているデータ、削除というていで、デフォルト値に戻したい、というのが今回の問題。
これをSQLでやる時は
CakePHPだとして、クエリー投げてもいいんだけどCakePHPチックに出来ないものかな～と考えていたら、出来ましたよ
function default($id = NULL){
$this->Model->id = $id;
$this->data = $this->Model->read();
$this->Model->saveField('your_field_name', DboSource::expression('DEFAULT(your_field_name)'));
}
ただこれ、クエリーで投げちゃったほうがシンプルですね。でも書き方がCakePHPのデータ変更の基本的なやり方とほぼ一緒なので、
何かのデータ変更の時のついでとかにナイス。今後もたまに使います。