XOOPSCubeLegacy/HowToUpgrade/FromX2JP

XOOPSCubeLegacy/HowToUpgrade

XOOPS 2.0.x JPからのアップグレードの方法 †

Try it first at home!（まずは自宅で試そう） つまり、あなたのXOOPSサイトのコピーをPCの中でローカルにアップグレードしてみてから、実際にサーバー上でアップグレードしましょう、ということです。

STEP 1 準備 †

1. サーバーのPHPのバージョンを調べましょう。 (PHP >= 4.3.11)
2. まず、お使いのXOOPS 2.0.x JPを最新版(XOOPS 2.0.16a JP)にアップデートしてください。
3. お使いのモジュールがXOOPS Cube Legacyと互換かどうかをこちらで調べ、モジュールの最新版もしくはパッチをダウンロードします。
4. お使いのモジュールが互換性のためのシステムモジュールを必要とするかを調べます。もし必要なときはこちらから最新版をダウンロードしてください。

STEP 2 サイトを閉じる †

1. defaultテーマを選択し、他の選択できるテーマを無効にします。
2. サイトをクローズします。
3. デバッグモードをPHP debug modeに変更します。
4. PHPコンテンツを含むカスタムブロックを停止します。 （プロックがXOOPS2のグローバル変数を使っている場合、XOOPS Cube Legacyでは完全には動作しないかもしれません。）
5. さらに、より安全に作業をすすめるため、全てのブロック、とくにシステムプロックを停止してください。
6. スタートモジュールの設定をリセットします。もしもスタートモジュールに互換性がないと、サイトがこわれてしまうかもしれません。
7. キャッシュの設定をすべて外します。XOOPS Cube LegacyではXOOPS2とは異なったキャッシュ方式を採用しています。

STEP 3 ファイルの置換 †

1. mainfile.phpと下記のディレクトリを除いて、 全てのファイルを消去します。
   • images
   • themes
   • uploads
   • modules
   • XOOPS_TRUST_PATH
2. XOOPS Cube Legacyのパッケージで上書きします。ただし、installフォルダはゼロからインストールするときにしか必要ないので、書き込まないでください。
3. 使用している全てのモジュールを、STEP1で入手しておいた最新版もしくはパッチをあてたバージョンに置き換えてください。
   1. XOOPS_TRUST_PATHのファイルを消去する必要はありません。 D3方式のモジュールを最新版にアップデートしておくだけです。
   2. Legacyモジュールをご自分のモジュールフォルダにコピーするのをお忘れないように！
   3. もしコメント統合とともにd3forumをお使いなら、"html/class/smarty/plugins"フォルダにある3つのPHPファイルを適切な場所にコピーしておいくてださい。

STEP 4 アップグレード †

• mainfile.phpにパッチをあてます。

お使いのmainfile.phpにどうやってパッチをあてるか？実はとても簡単です。適当なテキストエディター、例えばnotepadなどを使って、以下のように修正をしてください。

修正前:

if (!isset($xoopsOption['nocommon']) && XOOPS_ROOT_PATH != '') {
  include XOOPS_ROOT_PATH."/include/common.php";
}

修正後:

if (!defined('_LEGACY_PREVENT_LOAD_CORE_') && XOOPS_ROOT_PATH != '') {
  @include_once XOOPS_ROOT_PATH."/include/cubecore_init.php";
  if (!isset($xoopsOption['nocommon']) && !defined('_LEGACY_PREVENT_EXEC_COMMON_')) {
    include XOOPS_ROOT_PATH."/include/common.php";
  }
}

（邦訳追記）上記の例はコードの命令単位で書かれています。閉じ括弧の数に注意してください。XUGJのフォーラムに以下のような質問と回答が出ていました。

• http://www.xugj.org/modules/QandA/index.php?topic_id=311

もしXOOPS Protectorをお使いの場合、mainfile.phpをもう少し修正する必要があります。こちらの'mainfile.php'についてを参考にしてください。

templates_cとcacheフォルダーの777にchmodします（uploadsはすでに設定済みです）。

ブラウザの再読み込みボタンをクリックします。

• 2番目のインストーラーにある必要なモジュールをインストールします。
• モジュール管理で、すべてのモジュールをアップデートします。
• アーカイブ内の/extras/XUpgradeというディレクトリをまるごとサーバのmodules/下にコピーして、モジュール管理からインストールします。これによって、システムモジュールの一般設定などがレガシーパッケージに引き継がれます。（このモジュールは特殊で、インストールするだけですべての移行処理を片付けます。つまり、インストール後、すぐにアンインストールしてかまいません。）

STEP 5 サイトを開く †

1. 全てのモジュールをアップデートして、正しく動くかをチェックします。
2. もしシステムモジュールが不要ならアンインストールしてください。ディレクトリもサーバーから消去します。
3. カスタムブロック以外のブロックをインストールします。
4. カスタムブロックのインストールには2つのウインドウをあけておきます。一つはホームページを見てカスタムブロックが正しく動作するかチェックするためで、もう一つはコントロールパネルを表示して問題があるカスタムブロックをアンインストールするためです。
5. プリファレンスの設定をもとに戻します。
6. サイトをオープンします。
7. サイトの設定を確認したら、デバックモードをOFFにします。