2015年5月 – 端くれプログラマの備忘録

[CakePHP] CakeEmailの使い方

2015年5月31日2015年8月17日 @84kure

CakePHPにはメール送信のためのコアライブラリが用意されている。以下、管理者へ簡単な通知メールを送信する前提での基本的な使い方覚え書き。

設定 app/Config/email.php

class EmailConfig {
    public $notify = array(
        'transport' => 'Mail',
        'from' => 'foo@example.com',
        'to' => 'recipient@example.com',
        'sendAs' => 'text', //メール形式はテキスト
        'log' => true,      //念のためログを記録 (app/tmpに生成される)
    );
}

class EmailConfig {

public $notify = array(

'transport' => 'Mail',

'from' => 'foo@example.com',

'to' => 'recipient@example.com',

'sendAs' => 'text', //メール形式はテキスト

'log' => true, //念のためログを記録 (app/tmpに生成される)

);

}

メールレイアウト app/View/Layout/Emails/text/notify.ctp

<?php echo $this->fetch('content'); ?>

1	<?php echo $this->fetch('content'); ?>

メールビュー app/View/Emails/text/notify.ctp

Notification:　<?php echo $body; ?>

1	Notification:　<?php echo $body; ?>

送信処理 (コントローラ)

$vars = array('body' => 'Hello, world'); //メール本文

App::uses('CakeEmail', 'Network/Email');
$email = new CakeEmail();
$email->config('contact');
if (!$email
    ->replyTo('webmaster@example.com')
    ->subject('Notification')
    ->viewVars($vars)              //テンプレートに値をセット
    ->template('notify', 'notify') //引数はビュー,レイアウト
    ->send()) {
    //送信失敗
}

$vars = array('body' => 'Hello, world'); //メール本文

App::uses('CakeEmail', 'Network/Email');

$email = new CakeEmail();

$email->config('contact');

if (!$email

->replyTo('webmaster@example.com')

->subject('Notification')

->viewVars($vars) //テンプレートに値をセット

->template('notify', 'notify') //引数はビュー,レイアウト

->send()) {

//送信失敗

}

参考サイト

CakeEmail — CakePHP Cookbook 2.x documentation
http://book.cakephp.org/2.0/en/core-utility-libraries/email.html

[CakePHP] Timeヘルパーの使い方

2015年5月30日2015年8月21日 @84kure

複数のタイムゾーンにユーザが分散している会員サイトの場合、ログインしているユーザのタイムゾーンに合わせて時刻表示を補正する必要がある。CakePHPでは、そのためにTimeヘルパーが用意されている。以下ざっくり覚え書き。

ユーザのタイムゾーンに合わせて日時を補正するには

基本的なストーリは以下のとおり。

アプリのタイムゾーンをUTCにする
(app/Config/core.php の date_default_timezone_set(‘UTC’)を有効にする)
データベースに保存する時刻はUTCで統一する
ユーザのタイムゾーンをデータベースに保存する
(ログインしているユーザのタイムゾーンをわかるようにする)
Timeヘルパーを使って時刻を補正して表示する
(Timeヘルパーのメソッドの多くにタイムゾーンが指定できる)

Timeヘルパーの使い方

ビュー内ではTimeHelperクラス経由でメソッドを呼び出す。

$this->Time->メソッド名(引数);

1	$this->Time->メソッド名(引数);

バージョン2.1からはCakeTimeクラスのグローバルメソッドに含まれるようになったので、任意の場所から呼び出すことが可能。

CakeTime::メソッド名(引数);

1	CakeTime::メソッド名(引数);

サンプル

以下Cookbookから。

echo $this->Time->format(
    'F jS, Y h:i A',
    $post['Post']['created'],
    null,
    $user['User']['time_zone']
);
// Will display August 22nd, 2011 11:53 PM for a user in GMT+0
// August 22nd, 2011 03:53 PM for a user in GMT-8
// and August 23rd, 2011 09:53 AM GMT+10

echo $this->Time->format(

'F jS, Y h:i A',

$post['Post']['created'],

null,

$user['User']['time_zone']

);

// Will display August 22nd, 2011 11:53 PM for a user in GMT+0

// August 22nd, 2011 03:53 PM for a user in GMT-8

// and August 23rd, 2011 09:53 AM GMT+10

Timeヘルパーには役立ちそうなメソッドがいろいろ用意されている。

参考サイト

TimeHelper — CakePHP Cookbook 2.x documentation
http://book.cakephp.org/2.0/en/core-libraries/helpers/time.html

[CakePHP] Formヘルパーを使って日時を入力する

2015年5月29日2015年8月17日 @84kure

Formヘルパーはオプションが多いので、良く使いそうな形式のサンプルを記しておく。

デフォルト

echo $this->Form->input('created');

1	echo $this->Form->input('created');

日本式 (12時間表記)

echo $this->Form->input('created', array(
    'type' => 'datetime',       //タイプは日時
    'label' => 'Creation Date', //ラベルの指定
    'dateFormat' => 'YMD',      //日付を"年月日"形式にする
    'monthNames' => false,      //月は数字表記 (trueだと英語表記)
    'minYear' => date('Y')-1,   //年の選択肢の最小値を昨年に
    'maxYear' => date('Y')+1,   //年の選択肢の最大値を来年に
));

echo $this->Form->input('created', array(

'type' => 'datetime', //タイプは日時

'label' => 'Creation Date', //ラベルの指定

'dateFormat' => 'YMD', //日付を"年月日"形式にする

'monthNames' => false, //月は数字表記 (trueだと英語表記)

'minYear' => date('Y')-1, //年の選択肢の最小値を昨年に

'maxYear' => date('Y')+1, //年の選択肢の最大値を来年に

));

日本式 (24時間表記)

echo $this->Form->input('tested', array(
    'type' => 'datetime',
    'label' => 'Testing Date',
    'dateFormat' => 'YMD',
    'monthNames' => false,
    'minYear' => date('Y')-1,
    'maxYear' => date('Y')+1,
    'timeFormat' => '24',       //時刻を24時間表記
    'empty' => true,            //空選択可能
    'default' => date('Y-m-d H:i', strtotime("2014-01-01 12:33")),  //初期値指定
));

echo $this->Form->input('tested', array(

'type' => 'datetime',

'label' => 'Testing Date',

'dateFormat' => 'YMD',

'monthNames' => false,

'minYear' => date('Y')-1,

'maxYear' => date('Y')+1,

'timeFormat' => '24', //時刻を24時間表記

'empty' => true, //空選択可能

'default' => date('Y-m-d H:i', strtotime("2014-01-01 12:33")), //初期値指定

));

[PHP] DateTimeクラスの使い方

2015年5月28日2015年8月17日 @84kure

以下のページがとっても良くまとまっていたのでリンク。

PHP – DateTime クラスのまとめメモ – Qiita
http://qiita.com/re-24/items/c3ed814f2e1ee0f8e811

[CakePHP] WordPressを共存させる

2015年5月27日2015年8月17日 @84kure

例えば、以下の構成の会社サイトをCakePHPベースで構築するとする。

/ ホーム
/products 製品紹介
/support サポート
/about 会社紹介
/contact お問い合わせ

そこへ社長が「会社サイト内に社長ブログを設置したい」と言い出したとする。

/blog 社長のブログ

カスタムでブログCMSを作る予算は無いので、じゃあWordPressを使いましょうという話になったとする。で、CakePHPにどうやってWordPressを入れ込むか、という話になる。

WordPressを配置するディレクトリ

事前準備として、まずはWordPressを配置するディレクトリを決める。CakePHPのルールではapp/webrootがホームなので、そこにWordPressを配置するのが定石かもしれない。

だけど、そうするとWordPressがCakePHPに依存しすぎる感じがする。もし将来CakePHP以外のフレームワークを使ってサイトを作り直すことがあると、WordPressを移動させる必要が出てきてしまう。CakePHPとWordPressの２つのCMSの依存関係は出来る限り低くしておきたいので、CakePHPの内部にWordPressを配置することは得策ではないように思う。

というわけで、WordPressは公開ディレクトリのホーム直下に配置することにする。こうしておけば、もしCakePHP関係のファイルを全て削除したとしても、WordPressは生き残る。

/www
- /app
- /blog ← ここにWordPressを配置
- /lib
- /plugin
- /vendors

.htaccessの設定

あとは、ブログへのアクセスが正しくWordPressに流れるように.htaccessを設定してやればよい。

ホームディレクトリの.htaccessを見ると、全てのトラフィックはapp/webroot以下に転送されるようになっているので、blogへのトラフィックだけはblogディレクトリ以下に転送されるように、以下のように設定を追記する。

<IfModule mod_rewrite.c>
    RewriteEngine on
    RewriteRule ^blog$ blog/      ←　追記
    RewriteRule ^blog/(.*)$ - [L] ←　追記
    RewriteRule ^$ app/webroot/ [L]
    RewriteRule (.*) app/webroot/$1 [L]
</IfModule>

RewriteEngine on

RewriteRule ^blog$ blog/ ←　追記

RewriteRule ^blog/(.*)$ - [L] ←　追記

RewriteRule ^$ app/webroot/ [L]

RewriteRule (.*) app/webroot/$1 [L]

</IfModule>

これで事前準備は完了。あとは通常通りWordPressの初期設定をすればよい。

[CakePHP] デフォルトの名前でないビューを指定する

2015年5月26日2015年8月16日 @84kure

CakePHPは「設定よりも規約(convention over configuration)」の考え方に従っているけど、時には規約から外れた実装のほうが効率が良い場合もある。実際にそういうケースがあったので覚え書き。

想定

ブログのようなウェブアプリ。

ビジターには記事(Post)の一覧(index)と詳細(view)を表示する。

PostsController

index
view($post_id)

管理者(admin)には管理者向けの記事一覧(admin_index)とCRUDの基本機能を用意する。

PostsController

admin_index
admin_add
admin_view($post_id)
admin_edit($post_id)
admin_delete($post_id)

さらに管理者には、ビジターに見える体裁での記事のプレビュー表示をしたい。

PostsController

admin_preview($post_id)

「ビジターに見える体裁」なので、独自にビューを定義せずにPosts/view.ctpを流用したい。そうしておけば、将来ビューの体裁が変わったときに編集しなければいけないビューはPost/view.ctpの１つで済む。

実装

デフォルトの名前でないビューを指定するにはどうするか、調べてみると簡単だった。コントローラのメソッドから復帰する前にrenderメソッドで任意のビューを指定できる。

class PostsController extends AppController {
    ....
    public function admin_preview($post_id) {
        ....
        $this->render('view');
    }
}

class PostsController extends AppController {

....

public function admin_preview($post_id) {

....

$this->render('view');

}

参考サイト

コントローラ — CakePHP Cookbook 2.x ドキュメント
http://book.cakephp.org/2.0/ja/controllers.html
Controller::render(string $view, string $layout)の説明を参照。

[CakePHP] 環境に応じてデータベースの設定を変える

2015年5月25日2015年8月16日 @84kure

ローカル、ステージング、本番など複数の環境があって、それぞれデータベースが異なる想定。環境に応じてデータベースの設定を変える方法を考える。

方法1: 設定ファイルを差し替える

環境ごとに設定ファイルを作っておいて、動作環境に応じて差し替える。例えば以下のファイルを作っておいて、ディプロイするときに動作環境に応じたファイルをDatabase.phpにリネームするわけだ。

Config/Database.local.php – ローカル用
Config/Database.staging.php – ステージング用
Config/Database.production.php – 本番用

この方法はわかりやすいが、ディプロイ作業が僅かに煩雑になる。例えば、リモートリポジトリにコードがまとめられている場合、単純にクローンするだけでは足りず、手動でDatabase.phpを仕度する必要がある。ディプロイ手順を工夫すれば済む話だけど。

方法2: プログラムで環境を判別して設定を動的に変える

現在の動作環境をプログラムで判別できるならば、データベース設定を動的に切り替える仕組みをDatabase.phpに組み込んでやればいい。例えば環境ごとにドメインが異なるなら以下のようにできる。

class DATABASE_CONFIG {

    public $default = array();

    // 本番用
    public $production = array(
        'datasource' => 'Database/Mysql',
        'persistent' => false,
        'host' => 'mysql.production.host',
        'login' => 'dbuser1',
        'password' => 'dbpass1',
        'database' => 'dbname1',
        'prefix' => '',
        'encoding' => 'utf8',
    );
    
    // ステージング用
    public $staging = array(
        'datasource' => 'Database/Mysql',
        'persistent' => false,
        'host' => 'mysql.staging.host',
        'login' => 'dbuser2',
        'password' => 'dbpass2',
        'database' => 'dbname2',
        'prefix' => '',
        'encoding' => 'utf8',
    );

    // ローカル用
    public $development = array(
        'datasource' => 'Database/Mysql',
        'persistent' => false, 
        'host' => 'localhost',
        'login' => 'dbuser3',
        'password' => 'dbpass3',
        'database' => 'dbname3',
        'prefix' => '',
        'encoding' => 'utf8',
    );
    
    public function __construct() {
        switch (env('HTTP_HOST')) {
            case 'localhost':
                $this->default = $this->development;
                break;
            case 'www.staging.host':
                $this->default = $this->staging;
                break;
            case 'www.production.host':
                $this->default = $this->production;
                break;
        }
    }
}

class DATABASE_CONFIG {

public $default = array();

// 本番用

public $production = array(

'datasource' => 'Database/Mysql',

'persistent' => false,

'host' => 'mysql.production.host',

'login' => 'dbuser1',

'password' => 'dbpass1',

'database' => 'dbname1',

'prefix' => '',

'encoding' => 'utf8',

);

// ステージング用

public $staging = array(

'datasource' => 'Database/Mysql',

'persistent' => false,

'host' => 'mysql.staging.host',

'login' => 'dbuser2',

'password' => 'dbpass2',

'database' => 'dbname2',

'prefix' => '',

'encoding' => 'utf8',

);

// ローカル用

public $development = array(

'datasource' => 'Database/Mysql',

'persistent' => false,

'host' => 'localhost',

'login' => 'dbuser3',

'password' => 'dbpass3',

'database' => 'dbname3',

'prefix' => '',

'encoding' => 'utf8',

);

public function __construct() {

switch (env('HTTP_HOST')) {

case 'localhost':

$this->default = $this->development;

break;

case 'www.staging.host':

$this->default = $this->staging;

break;

case 'www.production.host':

$this->default = $this->production;

break;

}

この方法の利点はディプロイが楽なこと。環境ごとに設定ファイルを用意する必要が無く、単純にディプロイするだけで動く。結果的に手間が減るしミスも減る。欠点らしい欠点はみつからないので、僕的には最近はこの方法を使うことが多い。

[Git] 基本メモ: 共有リポジトリの利用

2015年5月24日2015年8月21日 @84kure

共有リポジトリの作成

$ cd ~
$ mkdir ourweb.git
$ cd ourweb.git
$ git init --bare

$ cd ~

$ mkdir ourweb.git

$ cd ourweb.git

$ git init --bare

–bare リポジトリをベアとして作成する。
ベアリポジトリはワーキングディレクトリを持たない。更新情報だけを持つ。
ノンベアリポジトリはワーキングディレクトリを持つ。

[A] mywebを共有リポジトリへプッシュ

$ cd ~/myweb
$ git status
$ git remote add origin ~/outweb.git //共有リポジトリを追加
$ git config -l　//確認のためにリポジトリの設定値を表示
$ git push origin master //共有リポジトリへプッシュ

$ cd ~/myweb

$ git status

$ git remote add origin ~/outweb.git //共有リポジトリを追加

$ git config -l　//確認のためにリポジトリの設定値を表示

$ git push origin master //共有リポジトリへプッシュ

[B] 共有リポジトリをクローンして変更後にプッシュ

$ cd ~
$ git clone ~/outweb.git myweb2
$ cd myweb2
$ vim index.html //変更
$ git add .
$ git commit -m "modified index.html"
$ git push origin master //共有リポジトリへプッシュ

$ cd ~

$ git clone ~/outweb.git myweb2

$ cd myweb2

$ vim index.html //変更

$ git add .

$ git commit -m "modified index.html"

$ git push origin master //共有リポジトリへプッシュ

[A] 今日リポジトリをマージ

$ cd ~/myweb
$ git log //ローカルリポジトリの内容を確認
$ git pull
$ vim index.html //マージ時にコンフリクトが発生したら編集
$ git add .
$ git commit -m "fixed conflict"
$ git push origin master //共有リポジトリへプッシュ

$ cd ~/myweb

$ git log //ローカルリポジトリの内容を確認

$ git pull

$ vim index.html //マージ時にコンフリクトが発生したら編集

$ git add .

$ git commit -m "fixed conflict"

$ git push origin master //共有リポジトリへプッシュ

参考 push vs fetch+merge

Git – pull は本当に fetch + merge なの？ – Qiita
http://qiita.com/Teloo/items/95a860ae276b49edb040

Git pullを使うべきでない３つの理由 · DQNEO起業日記
http://dqn.sakusakutto.jp/2012/11/git_pull.html

git pullは、fetchしてmergeするのと同じなのか？ | GMOメディアエンジニアブログ
http://tech.gmo-media.jp/post/110492395034/git-pull-and-fetch-merge

[Git] 基本メモ: ブランチ、マージ、タグ、エイリアス

2015年5月23日2015年8月21日 @84kure

ブランチ

$ git branch //ブランチ一覧
$ git branch foo //ブランチ作成
$ git checkout foo //fooブランチへ移動
$ git checkout master //masterブランチへ戻る

$ git branch //ブランチ一覧

$ git branch foo //ブランチ作成

$ git checkout foo //fooブランチへ移動

$ git checkout master //masterブランチへ戻る

ブランチのマージ

$ git merge foo //fooブランチの内容をmasterに反映させる
$ git branch -d foo //ブランチの削除

1 2	$ git merge foo //fooブランチの内容をmasterに反映させる $ git branch -d foo //ブランチの削除

マージの衝突の対処例

$ git checkout -b foo //ブランチを作ってチェックアウト
$ vi index.html //ファイルを変更
$ git add . //ステージングエリアへ追加
$ git commit -m "changed #1" //コミット

$ git checkout -b foo //ブランチを作ってチェックアウト

$ vi index.html //ファイルを変更

$ git add . //ステージングエリアへ追加

$ git commit -m "changed #1" //コミット

$ git checkout master
$ vi index.html //ファイルを変更
$ git add . //ステージングエリアへ追加
$ git commit -m "changed #2" //コミット

$ git checkout master

$ vi index.html //ファイルを変更

$ git add . //ステージングエリアへ追加

$ git commit -m "changed #2" //コミット

$git merge foo //masterへfooをマージ
CONFLICT //衝突メッセージが表示される
$ git status
$ vi index.html //衝突箇所を修正
$ git add .
$ git commit -m "conflict fixed"
$ git log
$ git status

$git merge foo //masterへfooをマージ

CONFLICT //衝突メッセージが表示される

$ git status

$ vi index.html //衝突箇所を修正

$ git add .

$ git commit -m "conflict fixed"

$ git log

$ git status

タグ

コミットのIDの代わりに解りやすい名前を付ける

$ git tag v1.0 //直前のコミットにタグ付け
$ git tag //タグ一覧
$ git show v1.0

$ git tag v1.0 //直前のコミットにタグ付け

$ git tag //タグ一覧

$ git show v1.0

$ git tag v0.9 <コミットのID> //コミットを指定してタグ付け
$ git tag
$ git show v0.9

$ git tag v0.9 <コミットのID> //コミットを指定してタグ付け

$ git tag

$ git show v0.9

$ git tag -d v0.9 //タグの削除

1	$ git tag -d v0.9 //タグの削除

エイリアス

gitのコマンドにエイリアスを付ける

$ git config --global alias.co checkout
$ git config --global alias.st status
$ git config --global alias.br branch
$ git config --global alias.ci commit

$ git config --global alias.co checkout

$ git config --global alias.st status

$ git config --global alias.br branch

$ git config --global alias.ci commit

$ git st //statusのエリアス
$ git config -l //エリアス一覧

1 2	$ git st //statusのエリアス $ git config -l //エリアス一覧

[Git] 基本メモ: 設定、初期操作、ログ表示、状態表示・変更、コミット

2015年5月22日2015年8月21日 @84kure

設定

$ git config --global user.name "Taro Suzuki"
$ git config --global user.email "taro@example.com"
$ git config --global color.ui true //色分け表示
$ git config -l //設定一覧
$ git config --help //コマンドヘルプ

$ git config --global user.name "Taro Suzuki"

$ git config --global user.email "taro@example.com"

$ git config --global color.ui true //色分け表示

$ git config -l //設定一覧

$ git config --help //コマンドヘルプ

ローカルリポジトリの初期操作

$ mkdir myproject
$ cd myproject
$ git init //初期化
$ vi index.html //ファイル作成
$ git add index.html //ファイルをステージングエリアへ追加
$ git commit -m "Initial commit" //リポジトリへ登録

$ mkdir myproject

$ cd myproject

$ git init //初期化

$ vi index.html //ファイル作成

$ git add index.html //ファイルをステージングエリアへ追加

$ git commit -m "Initial commit" //リポジトリへ登録

ログ表示

$ git log
$ git log --oneline
$ git log -p //変更内容を表示
$ git log --stat //どのファイルが何箇所変更されたか表示

$ git log

$ git log --oneline

$ git log -p //変更内容を表示

$ git log --stat //どのファイルが何箇所変更されたか表示

状態表示・変更

$ git status //作業ディレクトリの状態表示
$ git checkout -- index.html //作業ディレクトリの変更の取り消し

1 2	$ git status //作業ディレクトリの状態表示 $ git checkout -- index.html //作業ディレクトリの変更の取り消し

$ git diff //作業ディレクトリの変更を見る
$ git add index.html
$ git diff --cached //ステージングエリアの変更を見る(コミット前)

$ git diff //作業ディレクトリの変更を見る

$ git add index.html

$ git diff --cached //ステージングエリアの変更を見る(コミット前)

$ git add .　//現ディレクトリ下の全ファイルをステージングエリアへ追加
$ git rm index.html //git管理下のファイルの削除
$ git mv index.html index2.html //git管理下のファイルの移動

$ git add .　//現ディレクトリ下の全ファイルをステージングエリアへ追加

$ git rm index.html //git管理下のファイルの削除

$ git mv index.html index2.html //git管理下のファイルの移動

gitに含めないファイルは .gitignore に記述する。

コミット

$ git commit //コミットメッセージを編集するエディタが立ち上がる
$ git commit -m "Add function test" //コミットメッセージを指定

1 2	$ git commit //コミットメッセージを編集するエディタが立ち上がる $ git commit -m "Add function test" //コミットメッセージを指定

直前のコミットの変更

$ vi index.html //ファイルを変更
$ git add .
$ git commit --amend //直前のコミットを変更する

$ vi index.html //ファイルを変更

$ git add .

$ git commit --amend //直前のコミットを変更する

コミット前に変更を取り消す (作業ディレクトリ、ステージングエリア)

$ git reset --hard HEAD //直前のコミットへ戻す
$ git reset --hard HEAD^ //さらに1つ前のコミットへ戻す
$ git reset --hard 325e5d3f193d1←コミットID(7桁以上) //コミットを指定して戻す

$ git reset --hard HEAD //直前のコミットへ戻す

$ git reset --hard HEAD^ //さらに1つ前のコミットへ戻す

$ git reset --hard 325e5d3f193d1←コミットID(7桁以上) //コミットを指定して戻す

取り消しを取り消す (resetを取り消す)

$ git reset --hard ORIG_HEAD //直前の取り消し前に戻す

1	$ git reset --hard ORIG_HEAD //直前の取り消し前に戻す