コード¶

最初のセットアップ¶

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

• Git

• PHP 8.1 以上

• PHPUnit 5.7.0 以上

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

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 を定義すれば、 すべてのテストを実行する ことができるでしょう。

修正に取りかかる¶

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

ブランチは 修正/改善対象のバージョンをベースにして作成してください。たとえば、 3.x のバグを修正するなら、ブランチのベースとして master ブランチを使うことになります。 もし、 2.x 系のバグ修正なら、 2.x ブランチを使用してください。これで、GitHub は、 あなたに対象のブランチを編集させないので、後で変更をマージする際にとても簡単になります。

# 3.x のバグを修正
git fetch upstream
git checkout -b ticket-1234 upstream/master

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

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

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

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

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

Pull Request を送信する¶

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

# master のトップに修正をリベース
git checkout master
git fetch upstream
git merge upstream/master
git checkout <branch_name>
git rebase master

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

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

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

git push origin <branch-name>

ブランチを push した後 rebase した場合、force push を使用する必要があります。

git push --force origin <branch-name>

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