コード¶

最初のセットアップ¶

CakePHP の修正に取りかかる前に自分の環境を整えることをお勧めします。 以下のソフトウェアが必要になります。

• Git

• PHP 5.3.0 以上

• ext/mcrypt

• ext/mbstring

• PHPUnit 3.7.0 以上 (3.7.38 推奨)

• MySQL, SQLite, または Postgres

ユーザ情報（自分の名前/ハンドル名とメールアドレス）をセットしてください。

git config --global user.name 'Bob Barker'
git config --global user.email '[email protected]'

CakePHP のソースコードの clone を GitHub から取得してください。

• GitHub アカウントを持っていないなら、作成してください。

• CakePHP リポジトリ の Fork ボタンをクリックして Fork してください。

Fork できたら、Fork したものを自分のローカルマシンへと clone してください。

git clone git@github.com:YOURNAME/cakephp.git

オリジナルの CakePHP リポジトリを remote リポジトリとして追加してください。 これは後で CakePHP リポジトリから変更分を fetch するのに使うことになり、 こうすることで CakePHP を最新の状態にしておくのです。

cd cakephp
git remote add upstream git://github.com/cakephp/cakephp.git

いまや CakePHP はセットアップされましたので データベース接続 で $test を定義すれば、 すべてのテストを実行する ことができるでしょう。

修正に取りかかる¶

バグや新機能、改善に取り組むたびに毎回、 トピック・ブランチを作成してください。

ブランチは 修正/改善対象のバージョンをベースにして作成してください。たとえば、 2.3 のバグを修正するなら、ブランチのベースとして 2.3 ブランチを使うことになります。 もしも変更が現在の安定版リリースのバグ修正なら、 master ブランチを使ってください。 こうすることで、あなたの変更を後でマージする際にとても簡単になります。

# 2.3 のバグを修正
git fetch upstream
git checkout -b ticket-1234 upstream/2.3

上記は upstream (CakePHP) 2.3 ブランチをベースにローカル・ブランチを作成します。 修正に取り組み、必要なだけ commit してください。 ただし、注意点があります:

• コーディング規約 に従ってください。

• バグが修正されたこと、もしくは新機能が機能することが判るテストケースを追加してください。

• 理にかなったコミットを心がけ、コミット文は解りやすく簡潔に書いてください。

Pull Request を送信する¶

変更し終え、 CakePHP へとマージされる準備が整ったら、あなたのブランチを 更新したくなることでしょう。

git checkout 2.3
git fetch upstream
git merge upstream/2.3
git checkout <branch_name>
git rebase 2.3

これは作業開始以降に CakePHP で行われたすべての変更を fetch + merge します。 その後に rebase 、つまり現在のコードの先端にあなたの変更を適用します。 rebase 中、コンフリクトに出会うかもしれません。もし rebase が早期終了したら、 git status で、どのファイルがコンフリクト/マージ失敗したのかを見ることができます。 各コンフリクトを解決させてください。その後、 rebase を continue してください。

git add <filename> # コンフリクトしたファイルごとにこれを行ってください。
git rebase --continue

あなたのテストがすべて通過し続けているか確認してください。 その後、あなたのブランチをあなたの Fork へと push します。

git push origin <branch-name>

あなたのブランチが GitHub に上がったら、GitHub で Pull Request を送ってください。