「アップデートの手順」の説明について

[mitsuharu8]

MODx CMS JAPAN を運営されている皆様、お疲れ様です。

いつも素晴らしいリリースをしていただき、感謝申し上げます。

さて、この日本公式サイトでは以下のページで「アップデートの手順」について説明されているかと思います。
http://modxcms-jp.com/news/158.html

簡易な説明ページ、ということは承知の上で恐縮なのですが、このページで

・サーバ上の /manager/includes/config.inc.php を上書き・削除しないようにする

といった念のための注意書きをするというのは、いかがでしょうか。

と申しますもの、自身が以前にアップデートを行う際、誤ってサーバ上の上記ファイルを空ファイルで上書きしてしまいました。
（新規インストール時にそうしていたので、という理由のうっかりミスです　 ）

その後のインストール画面で「通常アップデート」が選択できなくなって失敗をした、という経験があります（この時は結局
バックアップファイルで復元して事なきを得たのですが）。

もちろん手順そのままに行えば問題ないはずとは思いますが、念のための記述として追加してみてはと思います。

今後ともどうぞよろしくお願いいたします。

[yama]

config.inc.phpはもともと含まれてないので上書きされないはずなんですが・・アップデートしたバージョンなど、詳しい情報を教えていただいてよろしいでしょうか？

[mitsuharu8]

yama様、フォローいただきありがとうございました。時間が空いてしまい申し訳ございません。

yama様のおっしゃる通り、config.inc.php はアップデートファイルには含まれておりません。
ですが、config.inc.php.blank は含まれているかと思います（modx-1.0.4J 等）。

私の誠に勝手な勘違いではあるのですが、アップデートの際に

サーバ/ローカルで上書きファイルの確認
⇒ /maganager/includes/config.inc.php.blank を発見
⇒ そういえばインストール時にはこれを config.inc.php にリネームしてアップロードしたんだったな・・・
⇒ config.inc.php.blank があるということは同じことをして上書きということか・・・← 勝手な勘違い

という流れで config.inc.php も空ファイルで上書きしてしまったのです・・・。

そんな勘違いはレアケースと言われればその通りなのですが 、一方で当該ファイルはインストールオプションを
決定する特に重要なファイルかと思います。他にも何らかのミスで上書き・削除されないように、注意喚起という
意味で一言添えておくのが良いのではないかなあと思った次第です。

議論させていただき、ありがとうございます。

[sama55]

以下の注意喚起は、レアかもしれないけれど同様のミスを犯してしまう人を事前に救えるかもしれないので、一つの貴重な体験談として掲載してみてはいかがでしょう？

・サーバ上の /manager/includes/config.inc.php を上書き・削除しないようにする

-----（以下余談）-----
config.inc.php.blankの存在理由が気になったので調べてみたら、下のようなissueがありました。
http://code.google.com/p/modx-ja/issues/detail?id=232

恐らくこのファイルは、新規インストールにおけるブランクファイル（中身の無いファイル）を作る手間を軽減し、同時に、config.inc.phpというファイルの存在を示唆することを目的に、アップグレード時の上書きリスクを回避するために *.blank というネーミングにしたのだろう、と考えました。インストーラにファイル自体を含めずに、新規インストール時のみプログラム的にファイルを作り出すことも可能ですが、インストール過程ではパーミッションの関係でファイル操作が期待通りに動かないことも多く、また、ファイルの存在そのものがユーザーへのある種のヒントになる効果もあり、これらのことに配慮して現状のような形に落ち着いた、とも考えられます。

更に言うと、MODxには似たようなファイルが他にも幾つかあります。例えば、ルートのht.accessやsample-robots.txtなど。これらのファイルはブランクではありませんが、リリース時に内容が変更されている可能性が否定できません。従って、厳密にアップグレードする場合は、旧バージョンと新バージョンのファイルを比較して、変更されているようなら、既存ファイルにマージする必要があります。
-------------------------

手引書は、最初からすべてを網羅するのは無理があるので、少しづつでも改善してより良い資料に育つことを期待したいです。

[enogu]

本件とは直接関係ないかも知れませんが、Mac経由でファイルを上書きするとconfig.inc.phpが消えるという症状が本家で警告されていましたね。

なんでもフォルダの上書きを指示すると中のファイルの有無までチェックされず、config.inc.phpがなかったことになるとか。私はMacを使わないので試したことがないのですが、たしかZeRoさんが実際にそこで引っかかっていらっしゃったと記憶しています。