cakephp2のupgrade shellを実行するとファイルが消える

Question

cake1.3のシステムをcake2.9.3にバージョンアップするため、upgrade shellでソースコードをcake2用に変換しました。

変換後のファイルを確認したところ、モデルの中で削除されてしまったファイルがありました。
試してみた限りでは、以下のように、クラス名の最後が「Case」で終わっているファイルが削除されるような気がしています。

class HogeCase extends AppModel {

}

クラス名を変更してupgrade shellを実行し、その後でクラス名を戻すことで変換はできたのですが、なぜファイルが削除されてしまったのかが気になります。

理由をご存知の方がいらっしゃいましたらご教授ください。

Answer 1

おそらく、locations サブコマンドが原因です。
https://api.cakephp.org/2.9/class-UpgradeShell.html#_locations

Move files and folders to their new homes

---

UpgradeShell.php のソースコードを読むと、locations() メソッドが _movePhpFiles() というメソッドを実行しています。
https://github.com/cakephp/cakephp/blob/2.x/lib/Cake/Console/Command/UpgradeShell.php#L204

_movePhpFiles()メソッドの中では、クラス名の末尾が$this->_mapという配列のキーに一致するファイルを、
そのキーが指す値のパスに移動、もしくはgit mv -fしています。
https://github.com/cakephp/cakephp/blob/2.x/lib/Cake/Console/Command/UpgradeShell.php#L726
https://github.com/cakephp/cakephp/blob/2.x/lib/Cake/Console/Command/UpgradeShell.php#L744

で、$this->_mapプロパティを見ると、

クラス名の最後が「Case」で終わっているファイル

は'Test/Case'というパス（正確には [mywebsite]/app/Test/Case）に移動するよう、定義されています。
https://github.com/cakephp/cakephp/blob/2.x/lib/Cake/Console/Command/UpgradeShell.php#L60

削除されてしまったファイル

が該当ディレクトリに移動されていないか、確認してみてください。

Comments

[sleepsheep]

教えていただいた "app/Test/Case"フォルダを確認したところ、該当するファイルがありました。
削除ではなくて移動されていたのですね。UpgradeShell.phpの中まで探れていませんでした。
他にも消えたファイルが無いか気になっていたのですが、$_mapの定義を見て再度確認したいと思います。
ありがとうございました。

[KiyoshiMotoki]

レスありがとうございます。

> 他にも消えたファイルが無いか気になっていたのですが

もし、ソースコードを Git で管理しているのでしたら、Upgradeシェルの実行時に '--git' オプションを追加してやると良いと思います。

　# ./Console/cake upgrade locations --help

　Welcome to CakePHP v2.3.8 Console
　（中略）
　Options:
　（中略）
　--git, -g Use git command for moving files around.
　--dry-run, -d Dry run the update, no files will actually be modified.

そうすれば、ファイル移動に git mv コマンドを使用するようになるため、
シェルの実行後に git status を見れば、どのファイルがどこに移動したか、簡単に確認できるはずです。

[sleepsheep]

ご提案ありがとうございます。
残念ながらいまだにsvnを使ってるので...。

[KiyoshiMotoki]

orz

Answer 2

回答というよりコメントに近いですが...

ざっとUpgradeShell.phpを見てみましたがそういった処理はなさそうでした。
CaseというワードとしてはTestCaseで一部使われている程度です。削除するような処理でもなさそうでした。

気になるようであれば、アップグレード工程はそれぞれ個別に実行できますので、１つずつ実行してどの処理で削除されたのか確認すると原因が特定できるかもしれません。
参考：Upgrade シェル

なお、自分も2年前ぐらいに1系から2系にアップグレードしましたが、いくつかうまくいかない処理があってUpgradeShell.phpを修正したり、変換後にコードを直して対応した部分は結構あったと記憶しています。

参考になれば幸いです...

Comments

[sleepsheep]

いつも回答いただきありがとうございます。
おっしゃる通り、upgrade shellでうまく変換されずに個別に修正したり、動作確認しながらエラーを取ったり、アップグレードの作業量は思ったより大きいですね。
対応するのに時間はかかっていますが、何とかアップグレードして動作するようになってきました。
もう少し頑張りたいとおもいます。