コンテンツにスキップ

トラブルシューティング

XOOPS 2.5.xからXOOPS 2.7.0へのアップグレード時の最も一般的な問題のクラスはSmarty 4テンプレートの非互換性です。プリフライトチェックをスキップまたは完了しなかった場合、アップグレード後にフロントエンドまたは管理領域でテンプレートエラーが表示されることがあります。

復帰するには:

  1. プリフライトスキャナーを再実行します - /upgrade/preflight.phpで。提供されている自動修復を適用するか、フラグが立てられたテンプレートを手動で修正します。
  2. コンパイル済みテンプレートキャッシュをクリアします。 xoops_data/caches/smarty_compile/からindex.html以外のすべてを削除します。Smarty 3コンパイル済みテンプレートはSmarty 4と互換性がなく、古いファイルは紛らわしいエラーを引き起こす可能性があります。
  3. 一時的に付属のテーマに切り替えます。 管理領域から、xbootstrap5またはdefaultをアクティブなテーマとして選択します。これにより、問題がカスタムテーマに限定されているか、サイト全体かが確認されます。
  4. カスタムテーマとモジュールテンプレートを検証します - 本番トラフィックを戻す前に。{php}ブロック、非推奨修飾子、または非標準区切り文字構文を使用するテンプレートに特に注意を払います。これらは最も一般的なSmarty 4の破損です。

「特別なトピック」のSmarty 4セクションも参照してください。

XOOPSアップグレードは、以前に読み取り専用に設定されたファイルに書き込む必要がある場合があります。その場合、以下のようなメッセージが表示されます:

XOOPSアップグレード書き込み可能エラー

解決策は権限を変更することです。より直接的なアクセスがない場合は、FTPを使用して権限を変更できます。FileZillaを使用した例を以下に示します:

FileZillaの権限変更

アップグレードを起動するために使用するURLにdebugパラメーターを追加することで、ロガーで余分なデバッグ出力を有効にできます:

http://example.com/upgrade/?debug=1