從 6 版升級至 7 版
From LimeSurvey Manual
LimeSurvey 7 主要版本
本頁概述 LimeSurvey 7 帶來的主要變更,並提供相關說明文件頁面的連結。
This information mostly applies to the 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 時間戳記記錄。舊的時間戳記不會被遷移。 您可以在全域設定中設定預設的全域時區,也可以為每位使用者individually設定時區。這些設定僅影響資料的顯示。匯出與 RemoteControl API 僅接受/提供原始時間戳記。
自訂問卷佈景主題
所有與 LS6 相容的問卷佈景主題在升級後仍會保持啟用。若問卷佈景主題與 LS6 不相容,則會被解除安裝,且全域設定、群組設定和問卷設定中的佈景主題選項將重設為新的預設值。
升級策略:
- 從舊應用程式匯出問卷佈景主題
- 在將其匯入新應用程式之前,請確認相容性標籤已正確設定:https://manual.limesurvey.org/Extension_compatibility#Survey_themes
- 將其匯入新應用程式
- 檢查您為問卷佈景主題自訂的程式碼,並依照您要使用的新版應用程式進行更新。
- 從新應用程式匯出您已更新的自訂問卷佈景主題
- 升級後,在 LS6 中相容的問卷佈景主題將保持啟用,較舊的佈景主題則會被解除安裝。
- 如果您選擇更新問卷佈景主題,現在即可匯入。在確認其已正確更新後,您可以選擇刪除舊的佈景主題。
自訂管理員佈景主題
預設的管理員佈景主題將預設啟用。 自訂佈景主題將保持原樣,但在更新之前無法重新啟用。
自行代管的應用程式:
- 在將管理員佈景主題複製到新應用程式之前,請確認相容性標籤已正確設定:https://manual.limesurvey.org/Extension_compatibility#Admin_themes
- 將現有的管理員佈景主題從舊應用程式複製到新應用程式 https://manual.limesurvey.org/Custom_Admin_Themes
- 檢查您為管理員佈景主題自訂的程式碼,並依照您要使用的新版應用程式進行更新。
- 升級舊應用程式後,預設會顯示我們新的管理員佈景主題。若要更新您先前安裝的管理員佈景主題,可選擇以下任一方式:
- 手動更新目前標示為不相容的管理員佈景主題的程式碼
- 刪除舊的管理員佈景主題,並安裝您先前在測試環境中更新好的新佈景主題。
Cloud 使用者:
請聯絡我們的支援團隊。
自訂問題佈景主題
與目前版本不符的自訂問題佈景主題無法安裝,但在升級後仍會保持啟用。 有關問題佈景主題的更多資訊,請參閱 問題佈景主題。插入到問卷佈景主題或問卷中任何問題的自訂 JavaScript 也可能無法再正常運作。
升級您的自訂問題佈景主題:
- 從網站下載問題佈景主題,或匯出目前的問題佈景主題
- 在上傳之前,請確認您的自訂問題佈景主題的相容性已正確設定
- 嘗試將您的問題佈景主題上傳到新應用程式。
- 如果是自行建立的問題佈景主題,請進行必要的調整
- 上傳成功後,請檢查該問題佈景主題是否顯示並如預期運作。
升級非您所擁有的佈景主題:
請查看提供該佈景主題的網站或開發者是否有可用的更新
自訂外掛程式
與目前版本不符的自訂外掛程式將在升級過程中被停用。
自行代管的應用程式:
- 檢查該外掛程式是否可安裝於新版本。
- 更新外掛程式,或聯絡外掛程式作者進行更新。
- 在您的應用程式中以新檔案手動覆蓋外掛程式(這會保留設定),或解除安裝舊版本後重新安裝新版本(此情況下需重新輸入所有設定)。
Cloud 使用者:
- LimeSAML 將保持啟用
- 檢查該外掛程式是否可安裝於新版本。
- 更新外掛程式程式碼,或聯絡外掛程式作者進行更新。
- 安裝選項:
- 解除安裝舊版本並重新安裝新版本(所有設定都會遺失,必須重新套用)
- 聯絡支援團隊,在不遺失組態資料的情況下更新外掛程式
系統需求
| 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 服務。它會為您下載並安裝新版本，因此您不必手動替換任何檔案。
如果您偏好手動升級，請改為依照下列步驟進行。
手動升級
- 備份您的檔案與資料庫，並將網站切換為維護模式。
- 保留舊安裝中的下列檔案與資料夾：
application/config/config.phpapplication/config/security.phpapplication/config/allowed_hosts.phpupload/資料夾，其中存放您上傳的檔案、使用者佈景主題與使用者外掛程式plugins/資料夾（若您曾手動將外掛程式安裝於其中）
- 下載 LimeSurvey 7 套件，並使用下列其中一種方法更新安裝：
- 先刪除舊檔案。將上述列出的檔案移到他處，刪除 LimeSurvey 目錄中的其他所有內容，將新套件解壓縮至該目錄，然後把保留的檔案放回原處。
- 或將新檔案複製到舊檔案上。將新套件解壓縮到現有安裝上並覆寫既有檔案，上述列出的檔案則保持不動。
- 無論採用哪種方式，都請使用套件中的新
.htaccess，因為 6.x 的版本無法搭配新編輯器運作。之後請清空tmp/runtime/，以免留下版本 6 的快取資料。 - 在
application/config/config.php中將 URL 格式設定為path。 - 請確認您的網頁伺服器直接提供
/editor/資料夾，並將Authorization標頭傳遞給 PHP。詳細資訊：New Question Editor in LimeSurvey 7 - 執行資料庫升級。LimeSurvey 會偵測到較舊的資料庫版本並提供升級。請確認並讓它完成，不要中斷。
- 完成後，關閉維護模式，並依照下方的檢查清單逐項確認。
升級之後
- 檢查管理頁面頁尾中的版本號碼。
- 逐一重新啟用您需要的外掛程式。
- 開啟一份問卷，並確認新編輯器可以載入。
- 對每份已啟用的問卷執行一次完整的測試作答，涵蓋條件、配額、電子郵件與結尾 URL。
疑難排解
出現有關 URL 格式的「需要採取行動」訊息。URL 格式仍為 get。請將其改為 path，並清除 tmp/runtime/。
編輯器已載入但內容仍為空白。Authorization 標頭未傳遞到 PHP。
/editor/ 顯示 LimeSurvey 頁面或「未發現」錯誤。請檢查您的網頁伺服器設定，並確保 /editor/ 資料夾是被直接提供，而不是透過 LimeSurvey 進行路由。
「您無法在新的問題編輯器中使用此佈景主題」。該問卷使用的佈景主題並非以 fruity_twentythree 為基礎。請切換佈景主題，或繼續使用傳統編輯器。
外掛程式在重新啟用後造成錯誤。該外掛程式與 LimeSurvey 7 不相容。請將其停用，並向其維護者查詢。
備註
每項重大變更都記錄在各自的頁面中。這有助於讓文件保持精簡，並讓您更容易找到與您的設定相關的資訊。