安裝 - LimeSurvey CE

注意：這些安裝說明適用於目前的 LimeSurvey 版本。1.92 的舊安裝說明可在此處找到，更新說明可在此處找到。如果您偏好從命令列安裝 LimeSurvey，請參閱使用命令列介面 (CLI) 安裝。

確認 LimeSurvey 能夠在您的伺服器上執行

請確認您的伺服器符合以下需求。

安裝過程中也將檢查最低需求！

LimeSurvey 的最低需求：

• 至少 500 MB 磁碟空間（僅解壓縮後的 LimeSurvey 7.x 套件就約佔 380 MB），另需為您上傳的檔案和問卷資料預留空間。
• MariaDB 10.3.38 或更高版本 或 MySQL 8 或更高版本 或 Microsoft SQL Server 2019 或更高版本 或 Postgres 14 或更高版本。
• PHP 版本需求：
  • LS 7.x 需 PHP 8.1.29 及以上（已測試至 PHP 8.5.x）
  • LS 6.x 需 PHP 8.1.x 至 8.3.x
  • LS 5.x 需 PHP 7.2.5 至 8.0.x
  • LS 3.x 需 PHP 5.5.9 至 7.4.x
• PHP memory_limit 至少為 128 MB。
• 以下 PHP 模組/程式庫必須啟用：
  • mbstring (Multibyte String Functions) 擴充程式庫。
  • MySQL/MariaDB (pdo_mysql) 或 Postgres (pdo_pgsql) 或 MSSQL 的 PDO 資料庫驅動程式（Windows 使用 pdo_sqlsrv，Linux 使用 pdo_dblib）。
  • GD - 請參閱 PHP GD-Library 擴充功能文件
  • Zip - 請參閱 PHP Zip 擴充功能文件
  • Zlib - 請參閱 PHP Zlib 擴充功能文件
  • Curl 程式庫
  • fileinfo
  • JSON
  • 此外，我們一般假設所有 PHP 預設程式庫皆已啟用，例如：
    • ctype
    • filter
    • hash
    • openssl
    • session
    • SimpleXML
    • 等等…
• 對於 LimeSurvey 7.x：URL 格式必須設定為 path（例如 index.php/admin 形式的網址）。不再支援舊的 get URL 格式（例如 index.php?r=admin 形式的網址）。安裝工具會自動設定 path 格式，因此只有在您重複使用含有 'urlFormat' => 'get' 的舊版 config.php 檔案時，才需要檢查此項。

注意：如果您使用 dblib PDO 驅動程式從 Linux 連接到 Windows 伺服器上的 MSSQL 資料庫，則需要正確設定底層的 FreeTDS。請查看Troubleshooting頁面以獲取更多資訊。

選用的 PHP 擴充功能：

• 使用驗證碼、統計中的精美圖表，或透過 HTML 編輯器上傳圖片時，需要 GD-Library 並支援 FreeType 和 JPEG - 請參閱 PHP GD-Library 擴充功能文件
• 使用電子郵件退信追蹤系統時需要 IMAP - 請參閱 PHP IMAP 擴充功能文件。自 PHP 8.4 起，IMAP 擴充功能不再隨 PHP 一併提供，必須從 PECL 另行安裝。
• 使用 LDAP 匯入問卷參與者時需要 LDAP - 請參閱 PHP LDAP 文件
• Intl 用於依各語言的規則正確排序文字 - 請參閱 PHP Intl 文件
• 建議使用 Sodium 進行資料加密 - 請參閱 PHP Sodium 文件。如果未安裝，LimeSurvey 會改用速度慢得多的 PHP 實作。

建議的 PHP 設定（如果您的數值較低，安裝工具會顯示警告）：

• max_input_vars：5000 或以上
• post_max_size：32M 或以上
• upload_max_filesize：32M 或以上

在大多數情況下，您的網頁伺服器供應商或系統管理員能夠協助您解決這些選用元件的問題。

瀏覽器相容性

對於問卷填寫方, 我們目前支援 Edge 和其他較新的瀏覽器如 FF, Chrome, Opera 等等，並需啟用JavaScript。

對於問卷管理方,我們目前支援 Edge 和所有較新的瀏覽器，如 FF、Chrome、Opera 等等，並需啟用 JavaScript。

螢幕解析度

對於問卷填寫方我們支援任何螢幕解析度(360px x 640px 還有以上)。 對於問卷管理方最小支援螢幕解析度是1280px x 1024px。

LimeSurvey 託管

LimeSurvey 應能在大多數提供 PHP 和 MySQL/MariaDB 的主機供應商上執行。如果您想要由我們為您維護、已安裝好的 LimeSurvey 版本，請試試 LimeSurvey Cloud。差異請參閱LimeSurvey Cloud 與 LimeSurvey CE 的比較。

下載 LimeSurvey 套件

下載最新穩定的 LimeSurvey zip 安裝套件（您也可以選用 gzip、bz2 和 7zip 套件）並將其儲存到本機磁碟中。

解壓縮 LimeSurvey 套件

使用您喜歡的壓縮軟體將 zip 檔案解壓縮到選定的目錄/資料夾中。解壓縮檔案時，請確保檔案的目錄結構（這是大多數解壓縮程式的預設行為）。安裝目錄的路徑名不應包含'('或')'特殊字符，但可以包含空格字符。

收集您伺服器的資訊

若要在您的網頁伺服器上正確安裝 LimeSurvey，您需要知道以下資訊：

• 您預計存放指令碼的網站 URL（例如 https://my.domain.com/limesurvey）。
• 您使用的是哪一種網頁伺服器軟體？
  • Apache：LimeSurvey Apache 範例設定
  • nginx：請參閱我們的 LimeSurvey nginx 範例設定（已過時，不支援編輯器）
• 您的指令碼在伺服器上存放的實體磁碟位置（例如 /home/usr/htdocs/limesurvey）。
• 您資料庫伺服器的 IP/網路位置（例如 localhost）。
• 如果您的資料庫伺服器使用非標準連接埠，請找出其連接埠號碼。
• 您資料庫伺服器的使用者名稱及密碼。
• 大部分供應商不允許由指令碼建立資料庫，而需要您自行建立。如果您使用的是這類供應商，請自行建立一個資料庫（例如 limesurvey）。對於 MySQL/MariaDB，請使用字元集 utf8mb4 及定序 utf8mb4_unicode_ci。

將檔案上傳到您的網頁伺服器

使用 FTP/SFTP 程式（例如 FileZilla）連接到您的網頁伺服器並建立一個目錄來存放指令碼，然後依原有的目錄結構上傳檔案。請務必以二進位模式上傳檔案（請檢查 FTP 程式的設定）。請注意，使用 ASCII 模式上傳可能會導致罕見的錯誤（例如安裝過程中出現「找不到類別」錯誤），而且圖片也可能無法正確上傳。此外，請確認隱藏的 .htaccess 檔案也一併上傳 - 它們用於保護部分目錄，並在 Apache 上啟用不含 index.php 的網址。

設定目錄權限

為了使指令碼正常運作，它需要某些目錄的存取權限 - 尤其是 Linux/*nix 系統。

• "/limesurvey/tmp" 目錄（包含所有子目錄和檔案）用於匯入和上傳，應為您的網頁伺服器設定 讀取和寫入 權限。
• "/limesurvey/upload/" 目錄（包含所有子目錄和檔案）也必須為您的網頁伺服器設定 讀取和寫入 權限，以便啟用圖片和媒體檔案上傳。
• "/limesurvey/application/config/" 目錄同樣需要為您的網頁伺服器設定 讀取和寫入 權限。
• 其他目錄可以設定為 唯讀。

  如果您使用的是 Linux，則設定權限取決於您的網頁伺服器設定。例如，如果您的網頁伺服器以使用者 www-data（Debian/Ubuntu）或 apache（RHEL/Rocky Linux/AlmaLinux）身分執行，請針對上述三個目錄輸入 chown -R www-data <directory> ; chmod -R 755 <directory>。這將賦予所有人讀取權限，並且您的網頁伺服器將擁有寫入權限。

建立資料庫使用者

LimeSurvey 將建立一個資料庫及所有需要的資料表。為此，需要一組資料庫的帳號和密碼。我們通常建議建立具有以下權限的帳號：

- MySQL/MariaDB: SELECT, CREATE, INSERT, UPDATE, DELETE, ALTER, DROP, INDEX

- PostgreSQL：最簡單的方式是讓資料庫用戶成為 LimeSurvey 資料庫的擁有者。否則，該使用者需要具備該 schema 的 CREATE 權限，以及資料表的 SELECT、INSERT、UPDATE、DELETE、TRUNCATE、TRIGGER 權限，和序列的 USAGE 權限。

- Microsoft SQL Server：資料庫用戶應為 LimeSurvey 資料庫 db_owner 角色的成員。如果您希望由安裝工具建立資料庫，該使用者還需要 dbcreator 伺服器角色。

執行安裝程式

在瀏覽器中開啟您的 LimeSurvey 安裝網址（例如 https://example.org/limesurvey）。如果您正確設定了所有內容，LimeSurvey 安裝工具會自動啟動 - 只需依照指示操作：

1. 選擇安裝工具的語言並接受授權條款。
2. 查看安裝前檢查。所有必要項目都必須標示為 OK，才能繼續。
3. 輸入您的資料庫設定。LimeSurvey 會詢問您是否要建立資料庫和/或在資料庫內建立資料表，然後建立所需的資料表。
4. 設定管理員帳號：輸入管理員的使用者名稱、密碼和電子郵件地址，以及您的問卷網站名稱和預設網站語言。

第一次執行管理者設定程式

安裝完成後就大功告成了！開啟瀏覽器，輸入 LimeSurvey 管理後台的網址。假設您使用 'limesurvey' 作為存放檔案的目錄名稱，網址大概會是 https://www.example.com/limesurvey/admin 這種形式。

您應該會看到登入畫面。請使用您在安裝過程中輸入的管理員使用者名稱和密碼登入。如果您在安裝工具中未更改，預設的登入憑證為：

使用者：admin
密碼：password

如果您仍在使用預設密碼，請立即在您的帳號設定中更改。祝您使用愉快！

進一步的設定

如需進一步的設定，例如電子郵件 (SMTP) 設定或安全性設定，請參閱選用設定和全域設定。

快取

LimeSurvey 預設使用 Yii 做檔案快取，但可以配置為使用其他快取引擎。可能的其他快取有：

• Memcached (CMemCache)
• Redis (CRedisCache)
• APCu (CApcCache)
• 資料庫 (CDbCache)

請參閱 Yii documentation 以了解完整說明。

從 LimeSurvey 4.0.0 開始，您也可以在 ExpressionScript 中快取運算。根據調查的複雜程度，這可以顯著提高速度。若要啟用 emcache，請將底下的語法新增至您的 config.php 檔案(components array)：

'emcache' => array('class' => 'CFileCache'),

與主要的 Yii 快取一樣，LimeSurvey也可以使用其他快取系統。

emcache 與隨機問卷不相容，在這種情況下將自動關閉。

如果我遇到問題怎麼辦...

如同所有電腦程式，大多數時候一切都會依照說明運作，但有時就是行不通。導致事情未如預期進行的原因太多，無法在此一一說明。如果您遇到困難，請先查看安裝常見問題。如果在那裡找不到答案，請將您的問題和任何錯誤訊息發佈到 LimeSurvey 討論區，開立支援工單（僅適用於使用 LimeSurvey Cloud 的客戶），或加入我們的 Discord 頻道。