バージョン6から7へのアップグレード

LimeSurvey 7 メジャーバージョン

このページでは、LimeSurvey 7 で導入された主な変更点の概要と、関連するドキュメントページへのリンクを紹介します。

  この情報は主に LimeSurvey Community Edition (CE) に当てはまります。

LimeSurvey 7 の主な変更点

回答テーブルとフィールド名の構造の変更

LimeSurvey 7 では、回答テーブルとフィールド名の生成方法が構造的に整理されました。この変更により一貫性が向上し、プラットフォームの保守や拡張が容易になります。

詳細はこちらをご覧ください: フィールド名と回答テーブルのリファクタリング - LimeSurvey 7

新しい質問エディタ

LimeSurvey 7 では、新しい質問エディタも導入されました。ユーザーインターフェースが刷新され、質問の作成や管理のワークフローが改善されています。

詳細はこちらをご覧ください: LimeSurvey 7 の新しい質問エディタ

RemoteControl APIの変更

RemoteControl 2 APIのレスポンスが改善され、エラーテキストに加えてエラーコードも返されるようになりました。これらの変更については、RemoteControl 2 APIのドキュメントをご確認ください。戻り値の処理方法によっては後方互換性がありますが、お使いの実装では正しく処理されない可能性があります。

詳細はこちらをご覧ください: RemoteControl 2 API

タイムゾーンの変更

バージョン6以前では、記録されるタイムスタンプにタイムゾーンの情報がなく、サーバーの日時に依存していました。バージョン7への移行時に、従来の「時差」設定は可能な場合に移行され、以降のすべてのタイムスタンプはUTCで記録されます。過去のタイムスタンプは移行されません。 全体設定でデフォルトのタイムゾーンを設定できるほか、ユーザーごとに個別のタイムゾーンを設定することもできます。これらはデータの表示にのみ適用されます。エクスポートとRemoteControl APIでは、生のタイムスタンプのみを受け付け、または返します。

カスタムアンケートテーマ

LS6と互換性のあるアンケートテーマはすべて、アップグレード後も稼働したままになります。LS6と互換性のないアンケートテーマはアンインストールされ、全体設定、グループ設定、アンケート設定のテーマ設定は新しいデフォルト値にリセットされます。

アップグレードの手順:

1. 旧アプリケーションからアンケートテーマをエクスポートします
2. 新しいアプリケーションにインポートする前に、互換性タグが正しく設定されていることを確認します: https://manual.limesurvey.org/Extension_compatibility#Survey_themes
3. 新しいアプリケーションにインポートします
4. アンケートテーマ用にカスタマイズしたコードを確認し、使用する新バージョンのアプリケーションに合わせて更新します。
5. 更新したカスタムアンケートテーマを新しいアプリケーションからエクスポートします
6. アップグレード後、LS6と互換性のあるアンケートテーマは稼働したままになり、それより古いテーマはアンインストールされます。
7. アンケートテーマを更新する場合は、インポートできます。正しく更新されたことを確認したら、古いテーマを削除してもかまいません。

カスタム管理画面テーマ

デフォルトの管理画面テーマがデフォルトで有効になります。 カスタムテーマはそのまま残りますが、更新しない限り再び有効にすることはできません。

セルフホスト環境の場合:

1. 管理画面テーマを新しいアプリケーションにコピーする前に、互換性タグが正しく設定されていることを確認します: https://manual.limesurvey.org/Extension_compatibility#Admin_themes
2. 既存の管理画面テーマを旧アプリケーションから新しいアプリケーションにコピーします https://manual.limesurvey.org/Custom_Admin_Themes
3. 管理画面テーマ用にカスタマイズしたコードを確認し、使用する新バージョンのアプリケーションに合わせて更新します。
4. 旧アプリケーションのアップグレード後は、新しい管理画面テーマがデフォルトで表示されます。以前インストールした管理画面テーマを更新するには、次のいずれかを行います:
   • 非互換とマークされている管理画面テーマのコードを手動で更新する
   • 古い管理画面テーマを削除し、テスト環境で事前に更新しておいた新しいテーマをインストールする

Cloudをご利用の場合:
サポートまでお問い合わせください。

カスタム質問テーマ

現在のバージョンと一致しないカスタム質問テーマはインストールできませんが、アップグレード後も稼働したままになります。 質問テーマの詳細については、こちらをご覧ください: 質問テーマ。アンケートテーマやアンケート内の質問に挿入したカスタムJavaScriptも、動作しなくなる可能性が高くなります。

カスタマイズした質問テーマのアップグレード:

1. Webサイトから質問テーマをダウンロードするか、現在の質問テーマをエクスポートします
2. アップロードする前に、カスタム質問テーマの互換性が正しく設定されていることを確認します
3. 質問テーマを新しいアプリケーションにアップロードしてみます。
4. 自作の質問テーマの場合は、必要な調整を行います
5. アップロードが成功したら、質問テーマが表示され、期待どおりに動作しているか確認してください。

自分で作成していないテーマのアップグレード:
提供元のWebサイトや開発者から更新版が公開されていないか確認してください。

カスタムプラグイン

現在のバージョンと一致しないカスタムプラグインは、アップグレード処理中に無効化されます。

セルフホスト環境の場合:

1. プラグインが新しいバージョンにインストールできるか確認します。
2. プラグインを更新するか、プラグインの作者に更新を依頼します。
3. アプリケーション内のプラグインを新しいファイルで手動で上書きする（設定は保持されます）か、古いバージョンをアンインストールして新しいバージョンを再インストールします。後者の場合、すべての設定を再入力する必要があります。

Cloudをご利用の場合:

1. LimeSAMLは稼働したままになります
2. プラグインが新しいバージョンにインストールできるか確認します。
3. プラグインのコードを更新するか、プラグインの作者に更新を依頼します。
4. インストールのオプション:
   • 古いバージョンをアンインストールして新しいバージョンを再インストールする（すべての設定が失われるため、再設定が必要です）
   • 設定データを失わずにプラグインを更新するよう、サポートに依頼する

要件

	LimeSurvey 6	LimeSurvey 7
PHP	7.4以上	8.1以上（8.3を推奨）
MySQL	8.0以上	8.0以上
MariaDB	10.3.38以上	10.3.38以上
PostgreSQL	12以上	14以上
MSSQL	2016以上	2019以上
URL形式	getまたはpath	path（新しいエディターに必須）

Node.jsやnpmは必要ありません。新しいエディターはLimeSurveyパッケージに含まれており、すぐに使用できます。

作業を始める前に、ファイルとデータベースの完全なバックアップを作成し、まず環境のコピーでアップグレードをテストしてください。アップグレードを実行すると、そのバックアップを復元する以外に元に戻す方法はありません。

メンテナンス時間を計画してください。データベースのアップグレード中、LimeSurveyはサイトを「メンテナンスモード」に切り替えます。回答データが大量にある環境では、完了までに時間がかかる場合があります。

推奨：ComfortUpdateサービスを使用する

アップグレードの最も簡単で安全な方法は、ComfortUpdateサービスを使用することです。 新しいバージョンのダウンロードとインストールが自動的に行われるため、ファイルを手動で置き換える必要はありません。

手動でアップグレードする場合は、代わりに以下の手順に従ってください。

手動でアップグレードする

1. ファイルとデータベースをバックアップし、サイトをメンテナンスモードにします。
2. 以前のインストールから、次のファイルとフォルダを保管しておきます。
   • application/config/config.php
   • application/config/security.php
   • application/config/allowed_hosts.php
   • アップロードしたファイル、ユーザーのテーマ、ユーザーのプラグインが保存されている upload/ フォルダ
   • プラグインを手動でインストールした場合は plugins/ フォルダ
3. LimeSurvey 7のパッケージをダウンロードし、次のいずれかの方法でインストールを更新します。
   1. 先に古いファイルを削除する。 上記のファイルを別の場所に移動し、LimeSurveyディレクトリ内のそれ以外をすべて削除してから、新しいパッケージを展開し、保管しておいたファイルを元に戻します。
   2. または、古いファイルの上に新しいファイルをコピーする。 既存のインストールの上に新しいパッケージを展開して既存のファイルを上書きします。上記のファイルには手を加えないでください。
4. どちらの方法でも、パッケージに含まれる新しい .htaccess を使用してください。6.xのものは新しいエディターでは動作しません。その後、バージョン6のキャッシュデータが残らないよう、tmp/runtime/ を空にします。
5. application/config/config.php でURL形式を path に設定します。
6. Webサーバーが /editor/ フォルダを直接配信し、Authorization ヘッダーをPHPに渡すようになっていることを確認します。詳細: LimeSurvey 7の新しい質問エディター
7. データベース更新を実行します。LimeSurveyが古いデータベースのバージョンを検出し、更新を提案します。確認して、中断せずに完了するまで待ちます。
8. 完了したら、メンテナンスモードをオフにし、以下のチェックリストを順に確認します。

アップグレード後

• 管理画面のフッターに表示されるバージョン番号を確認します。

• 必要なプラグインを1つずつ再度稼働させます。

• アンケートを開き、新しいエディターが読み込まれることを確認します。

• 稼働中の各アンケートで、条件、クォータ、メール、終了URLを含めて、テスト回答を最初から最後まで1件実行します。

トラブルシューティング

URL形式に関する「操作が必要」メッセージが表示される。 URL形式がまだgetのままです。pathに変更し、tmp/runtime/を消去してください。

エディターは読み込まれるが、空のままになる。 AuthorizationヘッダーがPHPに届いていません。

/editor/にLimeSurveyのページまたは「見つかりません」エラーが表示される。 Webサーバーの設定を確認し、/editor/フォルダーがLimeSurveyを経由せずに直接配信されるようにしてください。

「You cannot use this theme with the new question editor」と表示される。 このアンケートでは、fruity_twentythreeをベースにしていないテーマが使用されています。テーマを切り替えるか、クラシックエディターで続行してください。

プラグインを再度稼働させるとエラーが発生する。 そのプラグインはLimeSurvey 7と互換性がありません。プラグインを停止し、開発元に確認してください。

注意事項

主要な変更点は、それぞれ個別のページで説明しています。これにより、ドキュメントの内容が整理され、お使いの環境に関連する情報を見つけやすくなります。