LimeSurvey Manual - User contributions [en]

LimeSurvey PRO vs LimeSurvey CE/zh-hant

2025-02-25T10:01:02Z

Rickylu: Created page with "''LimeSurvey GmbH'' 是指圍繞LimeSurvey 軟體建立的公司，以便更好地協調其開發並提供各種 LimeSurvey 付費服務（例如託管、個人化模板、附加套件、技術支援等等）。"

<languages />

__TOC__

<span id="Introduction"></span>
=簡介=

'''注意：LimeSurvey PRO 現在更名為 LimeSurvey Cloud。'''

在開始討論'''LimeSurvey Cloud'''和'''LimeSurvey CE''' （LimeSurvey 社群版）之前，了解''LimeSurvey''和''LimeSurvey GmbH''之間的差異非常重要。

<div class="mw-translate-fuzzy">
''LimeSurvey'' 以及之後的版本是根據 [https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html GNU 通用公共授權 v2]（GPL v2) 免費發布的一種架設於伺服器上的軟體。
</div>

''LimeSurvey GmbH'' 是指圍繞LimeSurvey 軟體建立的公司，以便更好地協調其開發並提供各種 LimeSurvey 付費服務（例如託管、個人化模板、附加套件、技術支援等等）。

<div class="simplebox">[[File:help.png]] 要了解有關 LimeSurvey 許可證的更多信息，請訪問 https://community.limesurvey.org/licence-trademark/。</div>

由於 LimeSurvey 具有通用公共授權並且是一個<u>[https://en.wikipedia.org/wiki/Open_source_software 開源軟體]</u> ，因此任何人都可以出於商業、私人和教育目的使用、修改和分發它， '''名稱和徽標除外，它們已註冊為商標'''。例如，LimeSurvey 可以輕鬆用於建立和分發用於評估大學課程或教授的問卷，也可以將其安裝在私人伺服器上，以便為您的企業進行線上/線下市場研究。

<div class="simplebox">[[File:help.png]] LimeSurvey 是一款開源軟體。該程式的代碼已完全公開。您可以透過 https://github.com/LimeSurvey/LimeSurvey 存取它。</div>

必須滿足最低需求才能在您的電腦（用於開發目的）或伺服器上安裝 LimeSurvey。請閱讀我們的[[Installation_-_LimeSurvey_CE/zh-hant|安裝指南]]，以取得有關如何安裝 LimeSurvey 的詳細指南。

However, for users who may find the installation process too complex and who do not have knowledge of server administration, [https://www.limesurvey.org/ LimeSurvey GmbH] offers [https://www.limesurvey.org/en/pricing Cloud hosting services]. With [https://www.limesurvey.org/en/pricing Cloud hosting services], a LimeSurvey instance is created for you in seconds!

<center>[[File:provsce.png]]</center>

<div class="simplebox">[[File:help.png]] Quite often, you will see words related to ''hosting services'', ''self-hosted software'', and ''personal server'' mentioned within this wiki section. We suggest the [https://www.limesurvey.org/en/blog/20-blog/120-hosting-solutions-two-sides-of-the-same-coin following post from our blog] to better grasp these hosting-related concepts.</div>

=LimeSurvey Cloud vs LimeSurvey CE=

Check out the following table for a brief summary of features of each service for a better understanding of the differences between them:

{| class="wikitable" style="text-align: center; color: black"
|+LimeSurvey Cloud vs LimeSurvey CE
|'''LimeSurvey Cloud'''
|'''LimeSurvey CE'''
|-
|Hosting is provided by LimeSurvey. The installation process should take no longer than 5 minutes.
|Self-hosted.
|-
|You can choose one of the four types of plans: [https://www.limesurvey.org/en/pricing FREE, BASIC, EXPERT and ENTERPRISE].
|You may either use the free version or pick one of the [https://www.limesurvey.org/en/pricing three premium plans]. The premium plans contain the ComfortUpdate feature, access to older versions and a multitude of design templates.
|-
|Always uses the latest stable version of LimeSurvey.
|You get access not only to the latest releases, but also to the older ones. You choose which to use.
|-
|Technical support included for the paid plans.
|Technical ComfortUpdate support included for the premium plans.
|-
|Contains all the features that make LimeSurvey great.
|Contains all the features that make LimeSurvey great.
|-
|LimeSurvey Cloud comes with response and storage usage reminders due to the fact that these are limited on the free plan.
|LimeSurvey CE does not have response and storage usage reminders. Limitations are due to the amount of space allocated from the personal server to the LimeSurvey-related tasks.
|-
|No direct server access. Third-party plugins/extensions can be added to your LimeSurvey instance by us on request.
|If you own your server, you can access your LimeSurvey installation. You can start [[Optional settings|tweaking it]] and make further enhancements by adding additional extensions/add-ons.
|-
|The instance is automatically updated by us for minor versions. You decide on the point in time for major versions.
|The ComfortUpdate tool is used to update the LimeSurvey installation. The update can also be done manually.
|-
| Server and installation configuration is handled by us, saving you valuable time.
|Ideal for hands-on people with technical knowledge. [[LimeSurvey_Manual|The LimeSurvey manual]] Is a great place to start learning.
|-
|Reliable response inflow due to a self-renewing subscription system.
|The only limitation is related to your server and its configuration.
|-
|More flexibility - You have 3 days until the date of renewal to cancel your subscription!
|The software is hosted on your server. There are no links between the activity performed by you with the help of the ''LimeSurvey software'' and ''LimeSurvey GmbH''.
|}

{{Box|Please note that the above table is just a summary of the main features provided by the two versions of LimeSurvey. For an exhaustive description, access the following limesurvey.org links: [https://community.limesurvey.org/comfort-update-extension/ LimeSurvey CE] or [https://https://www.limesurvey.org/pricing LimeSurvey Cloud] to get a complete description of each.}}

==LimeSurvey CE==

Convinced that '''LimeSurvey CE''' is right for you? You can install it on your server now. To download LimeSurvey CE, click the '''Downloads''' tab from the [https://community.limesurvey.org/ LimeSurvey] page.

<center>[[File:LimeSurvey.org - Project - Downloads.png]]</center>

The following page will load:

<center>[[File:Project - Downloads - Display.png]]</center>

*'''LimeSurvey Cloud''': If you click on the '''Sign up for free''' button, you will be first asked to create a [https://www.limesurvey.org/en/pricing LimeSurvey.org] account in order to create and access your online LimeSurvey site. If you wish to use our hosting services, refer to the following quick start guide: [[Quick start guide - LimeSurvey 3.0+|LimeSurvey Cloud Quick Start Guide]].
*''LimeSurvey CE'': This option allows you to download the LimeSurvey software, archived in several formats, including an executable file. Use this option if you would like to install LimeSurvey on your own server or on your own computer for personal testing. It is ideal for hands-on people with technical knowledge. You will see that LimeSurvey CE is divided into stable releases and development releases. For a rock-solid software, go for the stable release. If you want to test new LimeSurvey features and help us improve it, go with the development release.

<div class="simplebox">[[File:help.png]] To get access to the latest software developments, [https://github.com/LimeSurvey/LimeSurvey follow us on GitHub].</div>

*'''Templates:''' You may find example surveys here, label sets, and question templates in various languages. All templates are created by the community. You can also contribute by uploading your work and making it publicly available to others.
*'''Extensions:''' LimeSurvey supports plugins and extensions. By clicking on the "Go to the extensions" link, you get access to a directory that contains all of the LimeSurvey third-party extensions (your own contribution can also be listed there).

{{Alert|Title=Attention|text=Only LimeSurvey CE supports third-party plugins! If you would like to use an extension in LimeSurvey Pro, please write [mailto:support@limesurvey.org Support].}}

==LimeSurvey Cloud==

Refer to the following [[Quick start guide - LimeSurvey 3.0+|step-by-step guide]] to learn how to create a [https://www.limesurvey.org/en/pricing LimeSurvey Cloud] account and launch your first survey.

<div class='simplebox'> [[File:help.png]] You can also view the following [https://www.youtube.com/watch?v=oyoq14XpkwA video tutorial] on how to set up a professional account on LimeSurvey.</div>

=What do I need?=

There is a lot of information to grasp. We are completely aware of this and you might feel a bit overwhelmed.
We suggest you do a '''cost-benefit analysis'''. Some aspects that are worth taking into consideration:
*'''Capital:''' Think of the costs of running a server for example. Even though a lot of low-cost hosting providers can be found online, take into account that you have to take care not only of your LimeSurvey installation, but also of the server configuration. If you want to create more complex surveys and/or install/create additional plugins, employees with knowledge in PHP, HTML, CSS will be needed - which means higher costs for you and your business.
*'''Human resources''': If complex surveys are created, employees with IT-related skills might be needed. That is why it is better (sometimes) to outsource such services. You may use our LimeSurvey Cloud services or the help provided by our official partners.
*'''Time:''' Time is a limited resource. Different time-related constraints (e.g., deadlines, lots of qualitative research requests from your clients, etc.) transform time into an important independent variable that should definitely influence your final decision.

Think of all your possible needs and available resources before choosing between LimeSurvey Cloud and LimeSurvey CE.

Generally, if you want to use LimeSurvey without any download or configuration, you should choose LimeSurvey Cloud. You can test it freely as long as you want and then purchase one of the subscription plans. However, if you have a running server infrastructure and want to integrate LimeSurvey into that, take a look at LimeSurvey CE. We also offer great LimeSurvey CE plans to enhance your installation with one-click updates and more custom themes.

{{Note|Additional help can be found at one of our partners listed here: https://www.limesurvey.com/.}}

=What if I still have questions?=

We have an extremely helpful community. You are more than welcome to post your questions and/or thoughts on our [https://forum.limesurvey.org LimeSurvey forums] or [https://discord.gg/DEjguXn|LimeSurvey Discord channel]:

<div class="simplebox"><center>'''[https://discord.gg/DEjguXn Direct link to the official LimeSurvey Discord group]'''</center></div>

Translations:LimeSurvey PRO vs LimeSurvey CE/7/zh-hant

2025-01-18T09:47:46Z

Rickylu:

必須滿足最低需求才能在您的電腦（用於開發目的）或伺服器上安裝 LimeSurvey。請閱讀我們的[[Installation_-_LimeSurvey_CE/zh-hant|安裝指南]]，以取得有關如何安裝 LimeSurvey 的詳細指南。

Translations:LimeSurvey PRO vs LimeSurvey CE/7/zh-hant

2025-01-18T09:46:52Z

Rickylu:

必須滿足最低需求才能在您的電腦（用於開發目的）或伺服器上安裝 LimeSurvey。請閱讀我們的[[安裝 - LimeSurvey CE|安裝指南]]，以取得有關如何安裝 LimeSurvey 的詳細指南。

Translations:LimeSurvey PRO vs LimeSurvey CE/7/zh-hant

2025-01-18T09:46:06Z

Rickylu: Created page with "必須滿足最低需求才能在您的電腦（用於開發目的）或伺服器上安裝 LimeSurvey。請閱讀我們的安裝指南，以取得有關如何安裝 LimeSurvey 的詳細指南。"

必須滿足最低需求才能在您的電腦（用於開發目的）或伺服器上安裝 LimeSurvey。請閱讀我們的[[安裝 – LimeSurvey CE|安裝指南]]，以取得有關如何安裝 LimeSurvey 的詳細指南。

Translations:LimeSurvey PRO vs LimeSurvey CE/6/zh-hant

2025-01-18T09:44:46Z

Rickylu: Created page with "<div class="simplebox">File:help.png LimeSurvey 是一款開源軟體。該程式的代碼已完全公開。您可以透過 https://github.com/LimeSurvey/LimeSurvey 存取它。</div>"

<div class="simplebox">[[File:help.png]] LimeSurvey 是一款開源軟體。該程式的代碼已完全公開。您可以透過 https://github.com/LimeSurvey/LimeSurvey 存取它。</div>

Translations:LimeSurvey PRO vs LimeSurvey CE/5/zh-hant

2025-01-18T09:43:36Z

Rickylu: Created page with "由於 LimeSurvey 具有通用公共授權並且是一個<u>[https://en.wikipedia.org/wiki/Open_source_software 開源軟體]</u> ，因此任何人都可以出於商業、私人和教育目的使用、修改和分發它， '''名稱和徽標除外，它們已註冊為商標'''。例如，LimeSurvey 可以輕鬆用於建立和分發用於評估大學課程或教授的問卷，也可以將其安裝在私人伺服器上，以便為您的企業進行線上/線下市場研..."

由於 LimeSurvey 具有通用公共授權並且是一個<u>[https://en.wikipedia.org/wiki/Open_source_software 開源軟體]</u> ，因此任何人都可以出於商業、私人和教育目的使用、修改和分發它， '''名稱和徽標除外，它們已註冊為商標'''。例如，LimeSurvey 可以輕鬆用於建立和分發用於評估大學課程或教授的問卷，也可以將其安裝在私人伺服器上，以便為您的企業進行線上/線下市場研究。

Translations:LimeSurvey PRO vs LimeSurvey CE/4/zh-hant

2025-01-18T09:38:39Z

Rickylu: Created page with "<div class="simplebox">File:help.png 要了解有關 LimeSurvey 許可證的更多信息，請訪問 https://community.limesurvey.org/licence-trademark/。</div>"

<div class="simplebox">[[File:help.png]] 要了解有關 LimeSurvey 許可證的更多信息，請訪問 https://community.limesurvey.org/licence-trademark/。</div>

Translations:LimeSurvey PRO vs LimeSurvey CE/37/zh-hant

2025-01-18T09:37:43Z

''LimeSurvey GmbH'' 是指圍繞LimeSurvey 軟體建立的公司，以便更好地協調其開發並提供各種 LimeSurvey 付費服務（例如託管、個人化模板、附加套件、技術支援等等）。

Translations:LimeSurvey PRO vs LimeSurvey CE/36/zh-hant

2025-01-18T09:34:24Z

Rickylu: Created page with "''LimeSurvey'' 以及之後的版本是根據 [https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html GNU 通用公共授權 v2]（GPL v2) 免費發布的一種架設於伺服器上的軟體。"

''LimeSurvey'' 以及之後的版本是根據 [https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html GNU 通用公共授權 v2]（GPL v2) 免費發布的一種架設於伺服器上的軟體。

Translations:LimeSurvey PRO vs LimeSurvey CE/3/zh-hant

2025-01-18T09:26:46Z

Rickylu: Created page with "在開始討論'''LimeSurvey Cloud'''和'''LimeSurvey CE''' （LimeSurvey 社群版）之前，了解''LimeSurvey''和''LimeSurvey GmbH''之間的差異非常重要。"

在開始討論'''LimeSurvey Cloud'''和'''LimeSurvey CE''' （LimeSurvey 社群版）之前，了解''LimeSurvey''和''LimeSurvey GmbH''之間的差異非常重要。

Translations:LimeSurvey PRO vs LimeSurvey CE/35/zh-hant

2025-01-18T09:25:20Z

Rickylu: Created page with "'''注意：LimeSurvey PRO 現在更名為 LimeSurvey Cloud。'''"

'''注意：LimeSurvey PRO 現在更名為 LimeSurvey Cloud。'''

Translations:LimeSurvey PRO vs LimeSurvey CE/2/zh-hant

2025-01-18T09:25:04Z

Rickylu: Created page with "=簡介="

=簡介=

Translations:LimeSurvey PRO vs LimeSurvey CE/1/zh-hant

2025-01-18T09:24:57Z

Rickylu: Created page with "__TOC__"

__TOC__

Translations:LimeSurvey PRO vs LimeSurvey CE/Page display title/zh-hant

2025-01-18T09:24:43Z

Rickylu: Created page with "LimeSurvey PRO 與 LimeSurvey CE 的差異"

LimeSurvey PRO 與 LimeSurvey CE 的差異

Translations:Installation - LimeSurvey CE/53/zh-hant

2025-01-18T09:20:22Z

Rickylu:

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

Translations:Installation - LimeSurvey CE/46/zh-hant

2025-01-18T09:19:20Z

Rickylu:

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

Translations:Installation - LimeSurvey CE/9/zh-hant

2025-01-18T09:18:03Z

Rickylu:

'''LimeSurvey 6.x'''的最低需求:
* 至少 250MB 硬碟空間
* MariaDB 10.3.38 或更高版本 '''或''' MySQL 8 或更高版本 '''或''' Microsoft SQL Server 2008 或更高版本 '''或''' Postgres 12 或更高版本。
* PHP 版本需求:
** LS 6.x 需 PHP 7.4.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.ini 裡 `short_open_tag` 參數設定需設為 `ON`
* 以下的 PHP 模組/擴充功能需啟用:
** [[Installation_FAQ/zh-hant#mbstring_(Multibyte_String_Functions)_library_是甚麼?|mbstring (Multibyte String Functions)]] 擴充功能
** 在Windows環境需要 MySQL 的PDO驅動程式庫 (pdo_mysql 或 pdo_mysqli) 或 Postgres (pdo_pgsql) 或 MSSQL ([https://php.net/manual/en/ref.pdo-sqlsrv.php pdo_sqlsrv] 而 Linux環境需要 [http://www.php.net/manual/en/ref.pdo-dblib.php pdo_dblib] )。
** 還有, 我們建議常用的PHP程式庫都應該啟用
*** hash
*** session
*** openssl or mcrypt
*** fileinfo
*** SimpleXML
*** 等等…

Installation - LimeSurvey CE/zh-hant

2024-07-06T08:19:02Z

Rickylu:

<languages />

__TOC__

<div class="simplebox">注意：這些安裝說明適用於 2.0 或更高版本。 1.92 的舊安裝說明可在 [[Installation Version 1.92 or older|此處]] 找到，從舊版升級為新版的說明可在 [[Upgrading from a previous version/zh-hant|此處]] 找到。</div>

<span id="General"></span>
==概觀==

LimeSurvey 提供了兩種安裝的方法：
*在您的網頁伺服器上：<br />在這種情況下，需從步驟 1 開始按照本頁上的說明進行操作。

*在您的本機 Windows PC 上：<br />如果您想在自己的電腦建立問卷（主要是出於速度、開發或測試原因）並在稍後將其佈署到您的網頁伺服器上，通常只需在本機 PC 上安裝 LimeSurvey。為此，我們準備了一個特殊的 LimeSurvey 安裝包，其中包括網頁伺服器、資料庫、LimeSurvey 應用程式和 [[Installation of the LimeSurvey XAMPP package|如何安裝的說明]]。

<span id="Make_sure_you_can_use_LimeSurvey_on_your_website"></span>
==確認 LimeSurvey 能夠在您的伺服器上執行==

確認伺服器符合以下所有需求:

{{Note|安裝過程中也將檢查最低需求！}}

'''LimeSurvey 6.x'''的最低需求:
* 至少 250MB 硬碟空間
* MariaDB 10.3.38 或更高版本 '''或''' MySQL 8 或更高版本 '''或''' Microsoft SQL Server 2008 或更高版本 '''或''' Postgres 12 或更高版本。
* PHP 版本需求:
** LS 6.x 需 PHP 7.4.x ~ 8.x
** LS 5.x 需 PHP 7.2.5 ~ 8.0.x
** LS 3.x 需 PHP 5.5.9 ~ 7.4.x
* php.ini 裡 `short_open_tag` 參數設定需設為 `ON`
* 以下的 PHP 模組/擴充功能庫需啟用:
** [[Installation_FAQ/zh-hant#mbstring_(Multibyte_String_Functions)_library_是甚麼?|mbstring (Multibyte String Functions)]] 擴充功能庫
** 在Windows環境需要 MySQL 的PDO驅動程式庫 (pdo_mysql 或 pdo_mysqli) 或 Postgres (pdo_pgsql) 或 MSSQL ([https://php.net/manual/en/ref.pdo-sqlsrv.php pdo_sqlsrv] 而 Linux環境需要 [http://www.php.net/manual/en/ref.pdo-dblib.php pdo_dblib] )。
** 還有, 我們建議常用的PHP程式庫都應該啟用
*** hash
*** session
*** openssl or mcrypt
*** fileinfo
*** SimpleXML
*** 等等…

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

選擇性PHP擴充:
* '''GD-Library''' '''with FreeType support''' 需安裝才能使用驗證碼、漂亮的統計圖或透過HTML編輯器上傳圖片 - 請參閱[https://php.net/manual/image.setup.php PHP GD-Library Extension documentation]
* '''IMAP''' (pretty standard) 需安裝才能使用 [[Email bounce tracking system|電子郵件退回追蹤系統]] - 請參閱[https://php.net/manual/imap.setup.php PHP IMAP Extension documentation]
* '''LDAP''' 需安裝才能透過LDAP匯入問卷參與者 - 請參閱[https://php.net/manual/en/book.ldap.php PHP LDAP Documentation]
* '''Zip''' (pretty standard) 需安裝才能使用模板上傳、.zip 資源匯入和 Excel 匯出 - 請參閱[https://php.net/manual/zip.setup.php PHP Zip Extension documentation]
* '''Zlib'''（pretty standard）需安裝才能使用 [[ComfortUpdate]] - 請參閱[https://php.net/manual/zlib.setup.php PHP Zlib Extension documentation]

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

如果您想透過 Microsoft 的 IIS 執行，請查看 [[Installation on XP with IIS]] 可能也會有所幫助。

===瀏覽器相容性===
'''對於問卷填寫方''', 我們目前支援 IE11 (除了相容性模式) 和其他較新的瀏覽器如 Edge, FireFox, Chrome, Opera 等等，並需啟用JavaScript。

'''對於問卷管理方''',我們目前支援 Edge 和所有較新的瀏覽器，如 FireFox、Chrome、Opera 等等，並需啟用 JavaScript。<u>問卷管理者部份我們不再支援任何 Internet Explorer 版本。</u>

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

<span id="Hosting_for_LimeSurvey"></span>
===LimeSurvey 託管===

LimeSurvey 應該能夠執行於大多數提供 PHP 和 MySQL 的伺服器供應商。如果您想要找現成的 LimeSurvey 版本，您可以嘗試 [https://www.limesurvey.org/editions-and-prices/limesurvey-pro/editions-and-prices-professional LimeSurvey Cloud]，或參考我們的[[LimeSurvey-compatible hosting companies|LimeSurvey相容託管供應商清單]]。

<span id="Download_the_LimeSurvey_package"></span>
==下載 LimeSurvey 套件==

[https://community.limesurvey.org/downloads/ 下載]最新穩定的 LimeSurvey zip 安裝套件（您也可以選用 gzip、bz2 和 7zip 套件）並將其儲存到本機磁碟中。

<span id="Unpack_the_LimeSurvey_package"></span>
==解壓縮 LimeSurvey 套件==

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

<span id="Collect_information_about_your_server"></span>
==收集您伺服器的資訊==

您需要取得以下資訊才能在網頁伺服器上正確安裝 LimeSurvey：
*您要建立 limesurvey 的域名來指向它的服務 (例如 ''http://my.domain.com/limesurvey'')。
*limesurvey 在伺服器所在的實質位置(例如 ''/home/usr/htdocs/limesurvey'')。
*您資料庫的 IP/網路位置(例如 ''localhost'')。
*如果您的資料庫使用非標準連接埠，您就要找出埠號。
*您資料庫使用的使用者名稱及密碼。
*大部分資料庫的供應商不會讓應用程式建立資料庫，此時您需要自行建立。如果您是使用這類的供應商，請自行建立一個資料庫(例如 ''limesurvey'')。

<span id="Upload_the_files_to_your_web_server"></span>
==將檔案上傳到您的網頁伺服器==

使用 FTP 程式（例如 FileZilla）連接到您的網頁伺服器並建立一個目錄來儲存程式，然後將解壓縮後的檔案上傳到此目錄。請注意，務必以'''二進位模式上傳檔案'''(請從 FTP 程式的設定裡檢查)。使用 ASCII 模式上傳可能會導致預料之外的錯誤（例如安裝過程中出現「找不到類別」錯誤），而且圖片檔也可能無法正確上傳。

<span id="Set_directory_permissions"></span>
==設定目錄權限==

為了使程式正常工作，它需要某些目錄的訪問權限 - 尤其Linux/*nix 系統更是如此。
* '''"/limesurvey/tmp"''' 目錄(包含所有的子目錄和檔案)用於匯入和上傳，應為您的網頁伺服器開啟''讀和寫''權限。
* '''"/limesurvey/upload/"''' 目錄(包含所有的子目錄和檔案)也必須為您的網頁伺服器開啟''讀和寫''權限，以便啟用圖片和媒體檔案上傳功能。
* '''"/limesurvey/application/config/"''' 目錄也需要讓網頁伺服器有''讀和寫'' 的權限。
*其他目錄可以設定為''唯讀''。您可能會想要在 Linux/Unix 中將 /limesurvey/admin 目錄中的每個檔案權限設定為''唯讀''。

{{Alert|如果您使用的是 Linux，則設定權限取決於您的網頁伺服器配置。例如，如果您在 CentOS 上使用 Apache HTTPD，請鍵入 '''chmod -R 755 <directory> ; chown -R apache <directory>'''。這將賦予所有使用者讀取權限，並且您的網頁伺服器將擁有寫入權限。有關 Linux 權限的更多資訊，請查看 [https://www.linux.com/learn/tutorials/309527-understanding-linux-file-permissions 這個連結]。}}

<span id="Create_a_database_user"></span>
==建立資料庫使用者==

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

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

- PostgreSQL: SELECT, INSERT, UPDATE, DELETE, TRUNCATE, TRIGGER

- Microsoft SQL Server: ''不明 - 如果您知道如何設定，請填寫於此處''.

<span id="Run_the_installation_script"></span>
==執行安裝程式==

'''進入“example.org/limesurvey/admin”'''。如果您正確設定了所有內容，LimeSurvey 安裝程式應該會啟動 - 只需按照說明進行操作即可。系統將詢問您是否希望建立資料庫和/或在資料庫內建立資料表。 LimeSurvey 將在資料庫中建立所需的資料表。

<span id="Connect_to_the_administration_script_for_the_first_time"></span>
==第一次執行管理者設定程式==

安裝程式執行完後您就可以開始使用問卷系統了！開啟瀏覽器，在網址列輸入管理後臺的網址。如果您是使用 'limesurvey' 作為目錄名稱來存放它所有的檔案, 網址大概會是如下形式 "http://www.example.com/limesurvey/admin"

您應該會看到登入畫面。預設登入憑證（如果在安裝過程中未更改）為：

<syntaxhighlight lang='html'>

使用者：admin
密碼：password

</syntaxhighlight>

'''緊記第一次登入後馬上要更改預設的密碼.'''

<span id="Further_configuration"></span>
==進一步的設定==

<span id="Caching"></span>
===快取===

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

* Memcached
* Redis
* WinCache
* XCache

請參閱 [https://www.yiiframework.com/doc/api/1.1/CCache Yii documentation] 以了解完整說明。

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

<syntaxhighlight lang="php">
'emcache' => array('class' => 'CFileCache'),
</syntaxhighlight>

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

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

<span id="What_if_I_have_problems..."></span>
==如果我遇到問題怎麼辦...==

正如所有電腦程式，運作過程難免偶有問題，導致運作失常的原因也很多。如果您操作上有麻煩，請先查看 [[Installation FAQ]] 。如果無法找到解決辦法，請將問題發佈到支援論壇 [https://www.limesurvey.org/forum LimeSurvey forums] ，或開一個 [https://www.limesurvey.org/contact-us 維修單] (僅適用於使用LimeSurvey Cloud的客戶)，或是加入我們的 [https://discord.gg/DEjguXn Discord channel] 。

Translations:Installation - LimeSurvey CE/52/zh-hant

2024-07-06T08:18:14Z

Rickylu:

<div class="simplebox">注意：這些安裝說明適用於 2.0 或更高版本。 1.92 的舊安裝說明可在 [[Installation Version 1.92 or older|此處]] 找到，從舊版升級為新版的說明可在 [[Upgrading from a previous version/zh-hant|此處]] 找到。</div>

Upgrading from a previous version/zh-hant

2024-07-06T08:15:02Z

Rickylu: Created page with "<div class="simplebox">'''升級後的特殊檢查''': *'''從v1.53之前的版本開始'''：從v1.53之前的版本升級到最新版本時，請檢查每個使用者的'''全域使用者權限'''。 v1.53 中引入了新的'''超級管理者'''權限，可以為使用者提供與安裝期間建立的主管理帳戶相同的權限。升級程序無法猜測出應該向哪個使用者授予此權限。出於這個原因，請人工指定。</div>"

<languages /> <div style="float:right;"><div class="simplebox">附加頁：{toc}</div></div> __TOC__

<span id="Before_you_start..."></span>
=開始之前...=

<span style='color:#FF0000'>....閱讀此內容，因為它非常重要：'''務必備份目前的安裝檔案和資料庫！</span>

您可以使用資料庫管理工具例如 [https://www.phpmyadmin.net phpMyAdmin] 和檔案管理器來執行此操作！
如果您不知道怎麼備份，請勿繼續下面的操作並尋找其他人的幫助。

==建議使用 ComfortUpdate==
'''最簡單/安全的升級方法就是使用我們的[[ComfortUpdate]]服務。'''

<span id="Upgrade_instructions_(from_2.x_or_newer_to_any_later_version)"></span>
=升級說明（從2.x或更高版本到任何之後的版本）=

請按照以下說明操作：
*備份您的檔案和資料庫([[Upgrading from a previous version/zh-hant#Before you start...|我們之前有提過嗎?]])。
*刪除所有舊文件/資料夾，除了以下檔案：
**/application/config/security.php - '''很重要!!這是 LimeSurvey（版本 4 及更高版本）中所有加密資料的金鑰'''
**/application/config/config.php;
**/upload 目錄

<div class="simplebox">[[File:help.png]]'''注意：''' 如果 /upload/templates 中有任何自訂模板，請確保「更新」這些模板以應對使用新 LimeSurvey 版本所造成的變化。檢查此類變更的最簡單方法是將舊範本與新版本的預設範本進行檔案比較。如果您發現自訂之外的任何差異，則需要更新。</div>
*將新檔案從新的 LimeSurvey 套件複製到現有位置。
*在瀏覽器開啟管理者介面 (e.g. https://www.example.com/limesurvey/admin) 並檢查是否需要升級資料庫架構。
*完成升級後'''清空您瀏覽器的快取和Cookies'''

<span id="Instructions_for_older_versions"></span>
=更舊版本的說明=

不幸的是，有一些事情需要您再想想，所以請仔細閱讀以下說明。

==Upgrading from version 1.50 or later to any later 2.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the latest version of LimeSurvey
*Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new files of the new version into the same installation directory
** If your previous version is older than 1.90, copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories (write access to '''/tmp''', '''/upload''', and their subdirectories is required) as described in the [[Installation#Set directory permissions|installation wiki]]
** Open http://<yourdomain>/<yourlimesurveydir>/admin in your browser and follow the instructions (You will find the database data in the old config.php). The existing database will be automatically detected and if necessary, upgraded after confirmation.
* Check if any special manual checks apply as listed below
* '''Now, clear your browser cache and cookies''' and you are good to go

{{Alert|title=Attention|text=請注意，範本結構隨著從 2.0x 更新到 2.50 或更高版本而變化。您的舊模板將不再起作用，因為模板系統現在使用響應式模板。}}

<div class="simplebox">'''Special checks after an upgrade''':
*'''from any earlier version to 2.xx''': Proper question codes are mandatory now. After upgrading the installation, check the survey logic of all surveys and correct the codes where necessary
*'''from a version earlier than v1.53''': When upgrading from a version before v1.53 to the latest version, please check the '''global user rights''' of each user. There was a new '''superadmin''' right introduced in v1.53 that can give a user the same privilege as the master administration account created during the installation. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.
*'''from any earlier version to v2.06''': From 2.05 to 2.06, some unused permissions when editing global permissions for 'surveys' were activated. For example, if a user had only the 'create' permission in 2.05, the other permissions located to the right of 'create' would also get activated with the update to 2.06 (View/read, Update, Delete, Import, Export). Please check whether the admin users got any other global permissions besides the 'original' ones after the update. If yes, please edit them accordingly.
</div>

==Upgrading from version 1.50 or later to any later 1.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the desired version of LimeSurvey
* Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new code version into the same installation directory
** Edit or replace the '''config.php''' file:
*** If your previous version was < 1.70: Edit the new '''config.php''' in order to reflect the changes from the backup '''config.php''' file. '''Do not just overwrite the new '''config.php''' with your old one!'''
*** If your previous version was >= 1.70: Simply replace the new '''config.php''' with your backup '''config.php''' file (as the file format has not changed)
** If your previous version was older than 1.90: Copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories of LimeSurvey (write access to '''/tmp''', '''/upload''', and to their subdirectories is required) as described in the [[Installation#Set Directory permissions|installation wiki]]
* Finish the installation/upgrade process
** Once you open the URL to your LimeSurvey administration, the database tables will be updated after confirmation
** Remove or rename the /admin/install directory as/if instructed by the installation script
** Check if any special manual checks apply (as listed below)

<div class="simplebox">'''升級後的特殊檢查''':
*'''從v1.53之前的版本開始'''：從v1.53之前的版本升級到最新版本時，請檢查每個使用者的'''全域使用者權限'''。 v1.53 中引入了新的'''超級管理者'''權限，可以為使用者提供與安裝期間建立的主管理帳戶相同的權限。升級程序無法猜測出應該向哪個使用者授予此權限。出於這個原因，請人工指定。</div>

<span id="Upgrading_from_a_version_earlier_than_v1.50_(v1.0_through_v1.44)"></span>
==從 v1.50 之前的版本升級（v1.0 到 v1.44）==

由於資料結構和許多其他內容發生了變化，'''從其他更早的版本升級到1.50是<u>不可行</u>的'''。如果您留有*.sql 檔案格式的舊版結構文件，將這些文件轉換為新版本的唯一方法是安裝[http://www.limesurvey.org/en/archived-releases/289-limesurvey150zip 版本1.50] ，接著匯入 .sql 文件，然後將該問卷版本升級到最新的 LimeSurvey 版本。檢查[[Transferring an installation|如何轉移安裝]]以了解更多詳細資訊。

<span id="Upgrading_using_CLI"></span>
= 使用 CLI 升級 =

您可以透過 PHP CLI 升級資料庫： <code>php application/commands/console.php updatedb</code>。這允許您透過命令列自動升級系統（例如，在 crontab 中），但不建議這樣做。

= 手動更新資料庫升級失敗/ComfortUpdate=
有時，即使您所做的一切正確，但在資料庫升級過程中總是會發生意外。
可能是因為不同的資料庫版本、意外的資料格式或內容、不尋常的配置或我們的測試中未出現的任何其他內容（是的，我們測試了很多！）

如果您在資料庫更新期間發生錯誤並且您的 LimeSurvey 實例最終處於不可使用的狀態，您希望返回到先前的版本。
這邊預設您仍然擁有資料庫和檔案備份，無論是來自常規備份還是由 Comfortupdate 建立的備份。

請執行以下步驟：

*備份現有的 LimeSurvey 目錄和資料庫（是的，再做一次 - 我們叫它第二個備份）
*從原來的(第一個備份)還原檔案到現存的資料夾(直接覆蓋它們沒關係)
*刪除目前的資料庫然後從(第一個備份)還原資料

就是這樣。一切都應該恢復正常。

'''關於報告此問題的說明：'''

如果您遇到這樣的問題，請務必在我們的錯誤追蹤網站裡回報此問題：https://bugs.limesurvey.org

未回報的錯誤就是不會被修復的錯誤。請不要等別人回報此錯誤。如果您發現該錯誤已被回報，您還可以透過在錯誤追蹤器中將其標記為「是的，此錯誤影響我」來幫助提高錯誤的優先順序。

<span id="FAQ"></span>
=常見問題=

<span id="Can_I_upgrade_even_if_I_have_active_surveys?"></span>
==即使我有進行中的問卷，我也可以升級嗎？==

是的你可以升級。上面的詳細說明中可能會提到例外。我們強烈建議您在升級後測試您的問卷，以確定您設計的模板是否可以正常運作。

<span id="How_to_convert_*.sql/*.csv_survey_structure_files_to_the_latest_LimeSurvey_version?"></span>
==如何將*.sql/*.csv問卷結構檔轉換為最新的LimeSurvey版本？==

安裝版本 1.50，匯入文件，並將調查結構匯出成為較新的 .csv 格式。然後安裝最新版本 2.x 並匯入 .csv 格式並將其匯出為目前的 .lss 格式。

==Survey theme incompatibility==
With certain major version updates any custom survey themes will not be compatible, anymore:

* Update from LimeSurvey 2.6 or lower to LimeSurvey 2.50
* Update from LimeSurvey 5.x or lower to LimeSurvey 6.x

==Error "Multiple primary key defined" when updating MySQL database==
If you encounter this error, please check the setting ''sql_generate_invisible_primary_key'' in your MySQL server variables. This is most likely set to ''ON'', but should be set to ''OFF''. Then restore your database from the backup (as explained above) and try again.

Translations:Upgrading from a previous version/12/zh-hant

2024-07-06T08:14:32Z

<div class="simplebox">'''升級後的特殊檢查''':
*'''從v1.53之前的版本開始'''：從v1.53之前的版本升級到最新版本時，請檢查每個使用者的'''全域使用者權限'''。 v1.53 中引入了新的'''超級管理者'''權限，可以為使用者提供與安裝期間建立的主管理帳戶相同的權限。升級程序無法猜測出應該向哪個使用者授予此權限。出於這個原因，請人工指定。</div>

Upgrading from a previous version/zh-hant

2024-07-06T08:09:02Z

Rickylu: Created page with "= 手動更新資料庫升級失敗/ComfortUpdate= 有時，即使您所做的一切正確，但在資料庫升級過程中總是會發生意外。可能是因為不同的資料庫版本、意外的資料格式或內容、不尋常的配置或我們的測試中未出現的任何其他內容（是的，我們測試了很多！）"

<languages /> <div style="float:right;"><div class="simplebox">附加頁：{toc}</div></div> __TOC__

<span id="Before_you_start..."></span>
=開始之前...=

<span style='color:#FF0000'>....閱讀此內容，因為它非常重要：'''務必備份目前的安裝檔案和資料庫！</span>

您可以使用資料庫管理工具例如 [https://www.phpmyadmin.net phpMyAdmin] 和檔案管理器來執行此操作！
如果您不知道怎麼備份，請勿繼續下面的操作並尋找其他人的幫助。

==建議使用 ComfortUpdate==
'''最簡單/安全的升級方法就是使用我們的[[ComfortUpdate]]服務。'''

<span id="Upgrade_instructions_(from_2.x_or_newer_to_any_later_version)"></span>
=升級說明（從2.x或更高版本到任何之後的版本）=

請按照以下說明操作：
*備份您的檔案和資料庫([[Upgrading from a previous version/zh-hant#Before you start...|我們之前有提過嗎?]])。
*刪除所有舊文件/資料夾，除了以下檔案：
**/application/config/security.php - '''很重要!!這是 LimeSurvey（版本 4 及更高版本）中所有加密資料的金鑰'''
**/application/config/config.php;
**/upload 目錄

<div class="simplebox">[[File:help.png]]'''注意：''' 如果 /upload/templates 中有任何自訂模板，請確保「更新」這些模板以應對使用新 LimeSurvey 版本所造成的變化。檢查此類變更的最簡單方法是將舊範本與新版本的預設範本進行檔案比較。如果您發現自訂之外的任何差異，則需要更新。</div>
*將新檔案從新的 LimeSurvey 套件複製到現有位置。
*在瀏覽器開啟管理者介面 (e.g. https://www.example.com/limesurvey/admin) 並檢查是否需要升級資料庫架構。
*完成升級後'''清空您瀏覽器的快取和Cookies'''

<span id="Instructions_for_older_versions"></span>
=更舊版本的說明=

不幸的是，有一些事情需要您再想想，所以請仔細閱讀以下說明。

==Upgrading from version 1.50 or later to any later 2.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the latest version of LimeSurvey
*Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new files of the new version into the same installation directory
** If your previous version is older than 1.90, copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories (write access to '''/tmp''', '''/upload''', and their subdirectories is required) as described in the [[Installation#Set directory permissions|installation wiki]]
** Open http://<yourdomain>/<yourlimesurveydir>/admin in your browser and follow the instructions (You will find the database data in the old config.php). The existing database will be automatically detected and if necessary, upgraded after confirmation.
* Check if any special manual checks apply as listed below
* '''Now, clear your browser cache and cookies''' and you are good to go

{{Alert|title=Attention|text=請注意，範本結構隨著從 2.0x 更新到 2.50 或更高版本而變化。您的舊模板將不再起作用，因為模板系統現在使用響應式模板。}}

<div class="simplebox">'''Special checks after an upgrade''':
*'''from any earlier version to 2.xx''': Proper question codes are mandatory now. After upgrading the installation, check the survey logic of all surveys and correct the codes where necessary
*'''from a version earlier than v1.53''': When upgrading from a version before v1.53 to the latest version, please check the '''global user rights''' of each user. There was a new '''superadmin''' right introduced in v1.53 that can give a user the same privilege as the master administration account created during the installation. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.
*'''from any earlier version to v2.06''': From 2.05 to 2.06, some unused permissions when editing global permissions for 'surveys' were activated. For example, if a user had only the 'create' permission in 2.05, the other permissions located to the right of 'create' would also get activated with the update to 2.06 (View/read, Update, Delete, Import, Export). Please check whether the admin users got any other global permissions besides the 'original' ones after the update. If yes, please edit them accordingly.
</div>

==Upgrading from version 1.50 or later to any later 1.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the desired version of LimeSurvey
* Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new code version into the same installation directory
** Edit or replace the '''config.php''' file:
*** If your previous version was < 1.70: Edit the new '''config.php''' in order to reflect the changes from the backup '''config.php''' file. '''Do not just overwrite the new '''config.php''' with your old one!'''
*** If your previous version was >= 1.70: Simply replace the new '''config.php''' with your backup '''config.php''' file (as the file format has not changed)
** If your previous version was older than 1.90: Copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories of LimeSurvey (write access to '''/tmp''', '''/upload''', and to their subdirectories is required) as described in the [[Installation#Set Directory permissions|installation wiki]]
* Finish the installation/upgrade process
** Once you open the URL to your LimeSurvey administration, the database tables will be updated after confirmation
** Remove or rename the /admin/install directory as/if instructed by the installation script
** Check if any special manual checks apply (as listed below)

<div class="simplebox">'''Special checks after an upgrade''':
*'''From a version earlier than v1.53''': When upgrading from a version before v1.53 to the latest version, please check the '''global user rights''' of each user. There was a new '''superadmin''' right introduced in v1.53 that can give a user the same privilege as the master administration account created during the install. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.
</div>

<span id="Upgrading_from_a_version_earlier_than_v1.50_(v1.0_through_v1.44)"></span>
==從 v1.50 之前的版本升級（v1.0 到 v1.44）==

由於資料結構和許多其他內容發生了變化，'''從其他更早的版本升級到1.50是<u>不可行</u>的'''。如果您留有*.sql 檔案格式的舊版結構文件，將這些文件轉換為新版本的唯一方法是安裝[http://www.limesurvey.org/en/archived-releases/289-limesurvey150zip 版本1.50] ，接著匯入 .sql 文件，然後將該問卷版本升級到最新的 LimeSurvey 版本。檢查[[Transferring an installation|如何轉移安裝]]以了解更多詳細資訊。

<span id="Upgrading_using_CLI"></span>
= 使用 CLI 升級 =

您可以透過 PHP CLI 升級資料庫： <code>php application/commands/console.php updatedb</code>。這允許您透過命令列自動升級系統（例如，在 crontab 中），但不建議這樣做。

= 手動更新資料庫升級失敗/ComfortUpdate=
有時，即使您所做的一切正確，但在資料庫升級過程中總是會發生意外。
可能是因為不同的資料庫版本、意外的資料格式或內容、不尋常的配置或我們的測試中未出現的任何其他內容（是的，我們測試了很多！）

如果您在資料庫更新期間發生錯誤並且您的 LimeSurvey 實例最終處於不可使用的狀態，您希望返回到先前的版本。
這邊預設您仍然擁有資料庫和檔案備份，無論是來自常規備份還是由 Comfortupdate 建立的備份。

請執行以下步驟：

*備份現有的 LimeSurvey 目錄和資料庫（是的，再做一次 - 我們叫它第二個備份）
*從原來的(第一個備份)還原檔案到現存的資料夾(直接覆蓋它們沒關係)
*刪除目前的資料庫然後從(第一個備份)還原資料

就是這樣。一切都應該恢復正常。

'''關於報告此問題的說明：'''

如果您遇到這樣的問題，請務必在我們的錯誤追蹤網站裡回報此問題：https://bugs.limesurvey.org

未回報的錯誤就是不會被修復的錯誤。請不要等別人回報此錯誤。如果您發現該錯誤已被回報，您還可以透過在錯誤追蹤器中將其標記為「是的，此錯誤影響我」來幫助提高錯誤的優先順序。

<span id="FAQ"></span>
=常見問題=

<span id="Can_I_upgrade_even_if_I_have_active_surveys?"></span>
==即使我有進行中的問卷，我也可以升級嗎？==

是的你可以升級。上面的詳細說明中可能會提到例外。我們強烈建議您在升級後測試您的問卷，以確定您設計的模板是否可以正常運作。

<span id="How_to_convert_*.sql/*.csv_survey_structure_files_to_the_latest_LimeSurvey_version?"></span>
==如何將*.sql/*.csv問卷結構檔轉換為最新的LimeSurvey版本？==

安裝版本 1.50，匯入文件，並將調查結構匯出成為較新的 .csv 格式。然後安裝最新版本 2.x 並匯入 .csv 格式並將其匯出為目前的 .lss 格式。

==Survey theme incompatibility==
With certain major version updates any custom survey themes will not be compatible, anymore:

* Update from LimeSurvey 2.6 or lower to LimeSurvey 2.50
* Update from LimeSurvey 5.x or lower to LimeSurvey 6.x

==Error "Multiple primary key defined" when updating MySQL database==
If you encounter this error, please check the setting ''sql_generate_invisible_primary_key'' in your MySQL server variables. This is most likely set to ''ON'', but should be set to ''OFF''. Then restore your database from the backup (as explained above) and try again.

Translations:Upgrading from a previous version/29/zh-hant

2024-07-06T08:08:50Z

= 手動更新資料庫升級失敗/ComfortUpdate=
有時，即使您所做的一切正確，但在資料庫升級過程中總是會發生意外。
可能是因為不同的資料庫版本、意外的資料格式或內容、不尋常的配置或我們的測試中未出現的任何其他內容（是的，我們測試了很多！）

Upgrading from a previous version/zh-hant

2024-07-06T07:57:01Z

Rickylu: Created page with "由於資料結構和許多其他內容發生了變化，'''從其他更早的版本升級到1.50是<u>不可行</u>的'''。如果您留有*.sql 檔案格式的舊版結構文件，將這些文件轉換為新版本的唯一方法是安裝[http://www.limesurvey.org/en/archived-releases/289-limesurvey150zip 版本1.50] ，接著匯入 .sql 文件，然後將該問卷版本升級到最新的 LimeSurvey 版本。檢查如何轉移安裝以..."

<languages /> <div style="float:right;"><div class="simplebox">附加頁：{toc}</div></div> __TOC__

<span id="Before_you_start..."></span>
=開始之前...=

<span style='color:#FF0000'>....閱讀此內容，因為它非常重要：'''務必備份目前的安裝檔案和資料庫！</span>

您可以使用資料庫管理工具例如 [https://www.phpmyadmin.net phpMyAdmin] 和檔案管理器來執行此操作！
如果您不知道怎麼備份，請勿繼續下面的操作並尋找其他人的幫助。

==建議使用 ComfortUpdate==
'''最簡單/安全的升級方法就是使用我們的[[ComfortUpdate]]服務。'''

<span id="Upgrade_instructions_(from_2.x_or_newer_to_any_later_version)"></span>
=升級說明（從2.x或更高版本到任何之後的版本）=

請按照以下說明操作：
*備份您的檔案和資料庫([[Upgrading from a previous version/zh-hant#Before you start...|我們之前有提過嗎?]])。
*刪除所有舊文件/資料夾，除了以下檔案：
**/application/config/security.php - '''很重要!!這是 LimeSurvey（版本 4 及更高版本）中所有加密資料的金鑰'''
**/application/config/config.php;
**/upload 目錄

<div class="simplebox">[[File:help.png]]'''注意：''' 如果 /upload/templates 中有任何自訂模板，請確保「更新」這些模板以應對使用新 LimeSurvey 版本所造成的變化。檢查此類變更的最簡單方法是將舊範本與新版本的預設範本進行檔案比較。如果您發現自訂之外的任何差異，則需要更新。</div>
*將新檔案從新的 LimeSurvey 套件複製到現有位置。
*在瀏覽器開啟管理者介面 (e.g. https://www.example.com/limesurvey/admin) 並檢查是否需要升級資料庫架構。
*完成升級後'''清空您瀏覽器的快取和Cookies'''

<span id="Instructions_for_older_versions"></span>
=更舊版本的說明=

不幸的是，有一些事情需要您再想想，所以請仔細閱讀以下說明。

==Upgrading from version 1.50 or later to any later 2.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the latest version of LimeSurvey
*Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new files of the new version into the same installation directory
** If your previous version is older than 1.90, copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories (write access to '''/tmp''', '''/upload''', and their subdirectories is required) as described in the [[Installation#Set directory permissions|installation wiki]]
** Open http://<yourdomain>/<yourlimesurveydir>/admin in your browser and follow the instructions (You will find the database data in the old config.php). The existing database will be automatically detected and if necessary, upgraded after confirmation.
* Check if any special manual checks apply as listed below
* '''Now, clear your browser cache and cookies''' and you are good to go

{{Alert|title=Attention|text=請注意，範本結構隨著從 2.0x 更新到 2.50 或更高版本而變化。您的舊模板將不再起作用，因為模板系統現在使用響應式模板。}}

<div class="simplebox">'''Special checks after an upgrade''':
*'''from any earlier version to 2.xx''': Proper question codes are mandatory now. After upgrading the installation, check the survey logic of all surveys and correct the codes where necessary
*'''from a version earlier than v1.53''': When upgrading from a version before v1.53 to the latest version, please check the '''global user rights''' of each user. There was a new '''superadmin''' right introduced in v1.53 that can give a user the same privilege as the master administration account created during the installation. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.
*'''from any earlier version to v2.06''': From 2.05 to 2.06, some unused permissions when editing global permissions for 'surveys' were activated. For example, if a user had only the 'create' permission in 2.05, the other permissions located to the right of 'create' would also get activated with the update to 2.06 (View/read, Update, Delete, Import, Export). Please check whether the admin users got any other global permissions besides the 'original' ones after the update. If yes, please edit them accordingly.
</div>

==Upgrading from version 1.50 or later to any later 1.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the desired version of LimeSurvey
* Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new code version into the same installation directory
** Edit or replace the '''config.php''' file:
*** If your previous version was < 1.70: Edit the new '''config.php''' in order to reflect the changes from the backup '''config.php''' file. '''Do not just overwrite the new '''config.php''' with your old one!'''
*** If your previous version was >= 1.70: Simply replace the new '''config.php''' with your backup '''config.php''' file (as the file format has not changed)
** If your previous version was older than 1.90: Copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories of LimeSurvey (write access to '''/tmp''', '''/upload''', and to their subdirectories is required) as described in the [[Installation#Set Directory permissions|installation wiki]]
* Finish the installation/upgrade process
** Once you open the URL to your LimeSurvey administration, the database tables will be updated after confirmation
** Remove or rename the /admin/install directory as/if instructed by the installation script
** Check if any special manual checks apply (as listed below)

<div class="simplebox">'''Special checks after an upgrade''':
*'''From a version earlier than v1.53''': When upgrading from a version before v1.53 to the latest version, please check the '''global user rights''' of each user. There was a new '''superadmin''' right introduced in v1.53 that can give a user the same privilege as the master administration account created during the install. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.
</div>

<span id="Upgrading_from_a_version_earlier_than_v1.50_(v1.0_through_v1.44)"></span>
==從 v1.50 之前的版本升級（v1.0 到 v1.44）==

由於資料結構和許多其他內容發生了變化，'''從其他更早的版本升級到1.50是<u>不可行</u>的'''。如果您留有*.sql 檔案格式的舊版結構文件，將這些文件轉換為新版本的唯一方法是安裝[http://www.limesurvey.org/en/archived-releases/289-limesurvey150zip 版本1.50] ，接著匯入 .sql 文件，然後將該問卷版本升級到最新的 LimeSurvey 版本。檢查[[Transferring an installation|如何轉移安裝]]以了解更多詳細資訊。

<span id="Upgrading_using_CLI"></span>
= 使用 CLI 升級 =

您可以透過 PHP CLI 升級資料庫： <code>php application/commands/console.php updatedb</code>。這允許您透過命令列自動升級系統（例如，在 crontab 中），但不建議這樣做。

= Failed database upgrade after manual update/ComfortUpdate=
Sometimes, even though you did everything correct, things don't work out they are supposed to during database upgrade.
That may happen because of various reasons: Different database versions, unexpected data formats or contents, unusual configurations or anything else that did not show up in our tests (yes, we test a lot!)

如果您在資料庫更新期間發生錯誤並且您的 LimeSurvey 實例最終處於不可使用的狀態，您希望返回到先前的版本。
這邊預設您仍然擁有資料庫和檔案備份，無論是來自常規備份還是由 Comfortupdate 建立的備份。

請執行以下步驟：

*備份現有的 LimeSurvey 目錄和資料庫（是的，再做一次 - 我們叫它第二個備份）
*從原來的(第一個備份)還原檔案到現存的資料夾(直接覆蓋它們沒關係)
*刪除目前的資料庫然後從(第一個備份)還原資料

就是這樣。一切都應該恢復正常。

'''關於報告此問題的說明：'''

如果您遇到這樣的問題，請務必在我們的錯誤追蹤網站裡回報此問題：https://bugs.limesurvey.org

未回報的錯誤就是不會被修復的錯誤。請不要等別人回報此錯誤。如果您發現該錯誤已被回報，您還可以透過在錯誤追蹤器中將其標記為「是的，此錯誤影響我」來幫助提高錯誤的優先順序。

<span id="FAQ"></span>
=常見問題=

<span id="Can_I_upgrade_even_if_I_have_active_surveys?"></span>
==即使我有進行中的問卷，我也可以升級嗎？==

是的你可以升級。上面的詳細說明中可能會提到例外。我們強烈建議您在升級後測試您的問卷，以確定您設計的模板是否可以正常運作。

<span id="How_to_convert_*.sql/*.csv_survey_structure_files_to_the_latest_LimeSurvey_version?"></span>
==如何將*.sql/*.csv問卷結構檔轉換為最新的LimeSurvey版本？==

安裝版本 1.50，匯入文件，並將調查結構匯出成為較新的 .csv 格式。然後安裝最新版本 2.x 並匯入 .csv 格式並將其匯出為目前的 .lss 格式。

==Survey theme incompatibility==
With certain major version updates any custom survey themes will not be compatible, anymore:

* Update from LimeSurvey 2.6 or lower to LimeSurvey 2.50
* Update from LimeSurvey 5.x or lower to LimeSurvey 6.x

==Error "Multiple primary key defined" when updating MySQL database==
If you encounter this error, please check the setting ''sql_generate_invisible_primary_key'' in your MySQL server variables. This is most likely set to ''ON'', but should be set to ''OFF''. Then restore your database from the backup (as explained above) and try again.

Translations:Upgrading from a previous version/14/zh-hant

2024-07-06T07:56:45Z

由於資料結構和許多其他內容發生了變化，'''從其他更早的版本升級到1.50是<u>不可行</u>的'''。如果您留有*.sql 檔案格式的舊版結構文件，將這些文件轉換為新版本的唯一方法是安裝[http://www.limesurvey.org/en/archived-releases/289-limesurvey150zip 版本1.50] ，接著匯入 .sql 文件，然後將該問卷版本升級到最新的 LimeSurvey 版本。檢查[[Transferring an installation|如何轉移安裝]]以了解更多詳細資訊。

Upgrading from a previous version/zh-hant

2024-07-06T07:52:02Z

Rickylu: Created page with "如果您在資料庫更新期間發生錯誤並且您的 LimeSurvey 實例最終處於不可使用的狀態，您希望返回到先前的版本。這邊預設您仍然擁有資料庫和檔案備份，無論是來自常規備份還是由 Comfortupdate 建立的備份。"

<languages /> <div style="float:right;"><div class="simplebox">附加頁：{toc}</div></div> __TOC__

<span id="Before_you_start..."></span>
=開始之前...=

<span style='color:#FF0000'>....閱讀此內容，因為它非常重要：'''務必備份目前的安裝檔案和資料庫！</span>

您可以使用資料庫管理工具例如 [https://www.phpmyadmin.net phpMyAdmin] 和檔案管理器來執行此操作！
如果您不知道怎麼備份，請勿繼續下面的操作並尋找其他人的幫助。

==建議使用 ComfortUpdate==
'''最簡單/安全的升級方法就是使用我們的[[ComfortUpdate]]服務。'''

<span id="Upgrade_instructions_(from_2.x_or_newer_to_any_later_version)"></span>
=升級說明（從2.x或更高版本到任何之後的版本）=

請按照以下說明操作：
*備份您的檔案和資料庫([[Upgrading from a previous version/zh-hant#Before you start...|我們之前有提過嗎?]])。
*刪除所有舊文件/資料夾，除了以下檔案：
**/application/config/security.php - '''很重要!!這是 LimeSurvey（版本 4 及更高版本）中所有加密資料的金鑰'''
**/application/config/config.php;
**/upload 目錄

<div class="simplebox">[[File:help.png]]'''注意：''' 如果 /upload/templates 中有任何自訂模板，請確保「更新」這些模板以應對使用新 LimeSurvey 版本所造成的變化。檢查此類變更的最簡單方法是將舊範本與新版本的預設範本進行檔案比較。如果您發現自訂之外的任何差異，則需要更新。</div>
*將新檔案從新的 LimeSurvey 套件複製到現有位置。
*在瀏覽器開啟管理者介面 (e.g. https://www.example.com/limesurvey/admin) 並檢查是否需要升級資料庫架構。
*完成升級後'''清空您瀏覽器的快取和Cookies'''

<span id="Instructions_for_older_versions"></span>
=更舊版本的說明=

不幸的是，有一些事情需要您再想想，所以請仔細閱讀以下說明。

==Upgrading from version 1.50 or later to any later 2.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the latest version of LimeSurvey
*Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new files of the new version into the same installation directory
** If your previous version is older than 1.90, copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories (write access to '''/tmp''', '''/upload''', and their subdirectories is required) as described in the [[Installation#Set directory permissions|installation wiki]]
** Open http://<yourdomain>/<yourlimesurveydir>/admin in your browser and follow the instructions (You will find the database data in the old config.php). The existing database will be automatically detected and if necessary, upgraded after confirmation.
* Check if any special manual checks apply as listed below
* '''Now, clear your browser cache and cookies''' and you are good to go

{{Alert|title=Attention|text=請注意，範本結構隨著從 2.0x 更新到 2.50 或更高版本而變化。您的舊模板將不再起作用，因為模板系統現在使用響應式模板。}}

<div class="simplebox">'''Special checks after an upgrade''':
*'''from any earlier version to 2.xx''': Proper question codes are mandatory now. After upgrading the installation, check the survey logic of all surveys and correct the codes where necessary
*'''from a version earlier than v1.53''': When upgrading from a version before v1.53 to the latest version, please check the '''global user rights''' of each user. There was a new '''superadmin''' right introduced in v1.53 that can give a user the same privilege as the master administration account created during the installation. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.
*'''from any earlier version to v2.06''': From 2.05 to 2.06, some unused permissions when editing global permissions for 'surveys' were activated. For example, if a user had only the 'create' permission in 2.05, the other permissions located to the right of 'create' would also get activated with the update to 2.06 (View/read, Update, Delete, Import, Export). Please check whether the admin users got any other global permissions besides the 'original' ones after the update. If yes, please edit them accordingly.
</div>

==Upgrading from version 1.50 or later to any later 1.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the desired version of LimeSurvey
* Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new code version into the same installation directory
** Edit or replace the '''config.php''' file:
*** If your previous version was < 1.70: Edit the new '''config.php''' in order to reflect the changes from the backup '''config.php''' file. '''Do not just overwrite the new '''config.php''' with your old one!'''
*** If your previous version was >= 1.70: Simply replace the new '''config.php''' with your backup '''config.php''' file (as the file format has not changed)
** If your previous version was older than 1.90: Copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories of LimeSurvey (write access to '''/tmp''', '''/upload''', and to their subdirectories is required) as described in the [[Installation#Set Directory permissions|installation wiki]]
* Finish the installation/upgrade process
** Once you open the URL to your LimeSurvey administration, the database tables will be updated after confirmation
** Remove or rename the /admin/install directory as/if instructed by the installation script
** Check if any special manual checks apply (as listed below)

<div class="simplebox">'''Special checks after an upgrade''':
*'''From a version earlier than v1.53''': When upgrading from a version before v1.53 to the latest version, please check the '''global user rights''' of each user. There was a new '''superadmin''' right introduced in v1.53 that can give a user the same privilege as the master administration account created during the install. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.
</div>

<span id="Upgrading_from_a_version_earlier_than_v1.50_(v1.0_through_v1.44)"></span>
==從 v1.50 之前的版本升級（v1.0 到 v1.44）==

Since the data structure and a lot of other things were changed, '''upgrading from any version previous to v1.50 is <u>NOT</u> possible'''. If you have old survey structure files with an *.sql extension, the only way to get these into a newer version is to install [http://www.limesurvey.org/en/archived-releases/289-limesurvey150zip version 1.50], import the .sql file(s) there, then upgrade that version to the most recent LimeSurvey version. Check the page related to [[Transferring an installation|how an installation can be transferred]] for more details.

<span id="Upgrading_using_CLI"></span>
= 使用 CLI 升級 =

您可以透過 PHP CLI 升級資料庫： <code>php application/commands/console.php updatedb</code>。這允許您透過命令列自動升級系統（例如，在 crontab 中），但不建議這樣做。

= Failed database upgrade after manual update/ComfortUpdate=
Sometimes, even though you did everything correct, things don't work out they are supposed to during database upgrade.
That may happen because of various reasons: Different database versions, unexpected data formats or contents, unusual configurations or anything else that did not show up in our tests (yes, we test a lot!)

如果您在資料庫更新期間發生錯誤並且您的 LimeSurvey 實例最終處於不可使用的狀態，您希望返回到先前的版本。
這邊預設您仍然擁有資料庫和檔案備份，無論是來自常規備份還是由 Comfortupdate 建立的備份。

請執行以下步驟：

*備份現有的 LimeSurvey 目錄和資料庫（是的，再做一次 - 我們叫它第二個備份）
*從原來的(第一個備份)還原檔案到現存的資料夾(直接覆蓋它們沒關係)
*刪除目前的資料庫然後從(第一個備份)還原資料

就是這樣。一切都應該恢復正常。

'''關於報告此問題的說明：'''

如果您遇到這樣的問題，請務必在我們的錯誤追蹤網站裡回報此問題：https://bugs.limesurvey.org

未回報的錯誤就是不會被修復的錯誤。請不要等別人回報此錯誤。如果您發現該錯誤已被回報，您還可以透過在錯誤追蹤器中將其標記為「是的，此錯誤影響我」來幫助提高錯誤的優先順序。

<span id="FAQ"></span>
=常見問題=

<span id="Can_I_upgrade_even_if_I_have_active_surveys?"></span>
==即使我有進行中的問卷，我也可以升級嗎？==

是的你可以升級。上面的詳細說明中可能會提到例外。我們強烈建議您在升級後測試您的問卷，以確定您設計的模板是否可以正常運作。

<span id="How_to_convert_*.sql/*.csv_survey_structure_files_to_the_latest_LimeSurvey_version?"></span>
==如何將*.sql/*.csv問卷結構檔轉換為最新的LimeSurvey版本？==

安裝版本 1.50，匯入文件，並將調查結構匯出成為較新的 .csv 格式。然後安裝最新版本 2.x 並匯入 .csv 格式並將其匯出為目前的 .lss 格式。

==Survey theme incompatibility==
With certain major version updates any custom survey themes will not be compatible, anymore:

* Update from LimeSurvey 2.6 or lower to LimeSurvey 2.50
* Update from LimeSurvey 5.x or lower to LimeSurvey 6.x

==Error "Multiple primary key defined" when updating MySQL database==
If you encounter this error, please check the setting ''sql_generate_invisible_primary_key'' in your MySQL server variables. This is most likely set to ''ON'', but should be set to ''OFF''. Then restore your database from the backup (as explained above) and try again.

Translations:Upgrading from a previous version/30/zh-hant

2024-07-06T07:51:46Z

如果您在資料庫更新期間發生錯誤並且您的 LimeSurvey 實例最終處於不可使用的狀態，您希望返回到先前的版本。
這邊預設您仍然擁有資料庫和檔案備份，無論是來自常規備份還是由 Comfortupdate 建立的備份。

Upgrading from a previous version/zh-hant

2024-07-06T07:50:01Z

Rickylu: Created page with "您可以透過 PHP CLI 升級資料庫： <code>php application/commands/console.php updatedb</code>。這允許您透過命令列自動升級系統（例如，在 crontab 中），但不建議這樣做。"

<languages /> <div style="float:right;"><div class="simplebox">附加頁：{toc}</div></div> __TOC__

<span id="Before_you_start..."></span>
=開始之前...=

<span style='color:#FF0000'>....閱讀此內容，因為它非常重要：'''務必備份目前的安裝檔案和資料庫！</span>

您可以使用資料庫管理工具例如 [https://www.phpmyadmin.net phpMyAdmin] 和檔案管理器來執行此操作！
如果您不知道怎麼備份，請勿繼續下面的操作並尋找其他人的幫助。

==建議使用 ComfortUpdate==
'''最簡單/安全的升級方法就是使用我們的[[ComfortUpdate]]服務。'''

<span id="Upgrade_instructions_(from_2.x_or_newer_to_any_later_version)"></span>
=升級說明（從2.x或更高版本到任何之後的版本）=

請按照以下說明操作：
*備份您的檔案和資料庫([[Upgrading from a previous version/zh-hant#Before you start...|我們之前有提過嗎?]])。
*刪除所有舊文件/資料夾，除了以下檔案：
**/application/config/security.php - '''很重要!!這是 LimeSurvey（版本 4 及更高版本）中所有加密資料的金鑰'''
**/application/config/config.php;
**/upload 目錄

<div class="simplebox">[[File:help.png]]'''注意：''' 如果 /upload/templates 中有任何自訂模板，請確保「更新」這些模板以應對使用新 LimeSurvey 版本所造成的變化。檢查此類變更的最簡單方法是將舊範本與新版本的預設範本進行檔案比較。如果您發現自訂之外的任何差異，則需要更新。</div>
*將新檔案從新的 LimeSurvey 套件複製到現有位置。
*在瀏覽器開啟管理者介面 (e.g. https://www.example.com/limesurvey/admin) 並檢查是否需要升級資料庫架構。
*完成升級後'''清空您瀏覽器的快取和Cookies'''

<span id="Instructions_for_older_versions"></span>
=更舊版本的說明=

不幸的是，有一些事情需要您再想想，所以請仔細閱讀以下說明。

==Upgrading from version 1.50 or later to any later 2.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the latest version of LimeSurvey
*Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new files of the new version into the same installation directory
** If your previous version is older than 1.90, copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories (write access to '''/tmp''', '''/upload''', and their subdirectories is required) as described in the [[Installation#Set directory permissions|installation wiki]]
** Open http://<yourdomain>/<yourlimesurveydir>/admin in your browser and follow the instructions (You will find the database data in the old config.php). The existing database will be automatically detected and if necessary, upgraded after confirmation.
* Check if any special manual checks apply as listed below
* '''Now, clear your browser cache and cookies''' and you are good to go

{{Alert|title=Attention|text=請注意，範本結構隨著從 2.0x 更新到 2.50 或更高版本而變化。您的舊模板將不再起作用，因為模板系統現在使用響應式模板。}}

<div class="simplebox">'''Special checks after an upgrade''':
*'''from any earlier version to 2.xx''': Proper question codes are mandatory now. After upgrading the installation, check the survey logic of all surveys and correct the codes where necessary
*'''from a version earlier than v1.53''': When upgrading from a version before v1.53 to the latest version, please check the '''global user rights''' of each user. There was a new '''superadmin''' right introduced in v1.53 that can give a user the same privilege as the master administration account created during the installation. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.
*'''from any earlier version to v2.06''': From 2.05 to 2.06, some unused permissions when editing global permissions for 'surveys' were activated. For example, if a user had only the 'create' permission in 2.05, the other permissions located to the right of 'create' would also get activated with the update to 2.06 (View/read, Update, Delete, Import, Export). Please check whether the admin users got any other global permissions besides the 'original' ones after the update. If yes, please edit them accordingly.
</div>

==Upgrading from version 1.50 or later to any later 1.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the desired version of LimeSurvey
* Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new code version into the same installation directory
** Edit or replace the '''config.php''' file:
*** If your previous version was < 1.70: Edit the new '''config.php''' in order to reflect the changes from the backup '''config.php''' file. '''Do not just overwrite the new '''config.php''' with your old one!'''
*** If your previous version was >= 1.70: Simply replace the new '''config.php''' with your backup '''config.php''' file (as the file format has not changed)
** If your previous version was older than 1.90: Copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories of LimeSurvey (write access to '''/tmp''', '''/upload''', and to their subdirectories is required) as described in the [[Installation#Set Directory permissions|installation wiki]]
* Finish the installation/upgrade process
** Once you open the URL to your LimeSurvey administration, the database tables will be updated after confirmation
** Remove or rename the /admin/install directory as/if instructed by the installation script
** Check if any special manual checks apply (as listed below)

<div class="simplebox">'''Special checks after an upgrade''':
*'''From a version earlier than v1.53''': When upgrading from a version before v1.53 to the latest version, please check the '''global user rights''' of each user. There was a new '''superadmin''' right introduced in v1.53 that can give a user the same privilege as the master administration account created during the install. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.
</div>

<span id="Upgrading_from_a_version_earlier_than_v1.50_(v1.0_through_v1.44)"></span>
==從 v1.50 之前的版本升級（v1.0 到 v1.44）==

Since the data structure and a lot of other things were changed, '''upgrading from any version previous to v1.50 is <u>NOT</u> possible'''. If you have old survey structure files with an *.sql extension, the only way to get these into a newer version is to install [http://www.limesurvey.org/en/archived-releases/289-limesurvey150zip version 1.50], import the .sql file(s) there, then upgrade that version to the most recent LimeSurvey version. Check the page related to [[Transferring an installation|how an installation can be transferred]] for more details.

<span id="Upgrading_using_CLI"></span>
= 使用 CLI 升級 =

您可以透過 PHP CLI 升級資料庫： <code>php application/commands/console.php updatedb</code>。這允許您透過命令列自動升級系統（例如，在 crontab 中），但不建議這樣做。

= Failed database upgrade after manual update/ComfortUpdate=
Sometimes, even though you did everything correct, things don't work out they are supposed to during database upgrade.
That may happen because of various reasons: Different database versions, unexpected data formats or contents, unusual configurations or anything else that did not show up in our tests (yes, we test a lot!)

If you have an error during database update and your LimeSurvey instance ends up in an unusable state, you want to go back to the previous version.
This assumes that you still have the database and file backup, either from your regular backup or the one created by Comfortupdate.

請執行以下步驟：

*備份現有的 LimeSurvey 目錄和資料庫（是的，再做一次 - 我們叫它第二個備份）
*從原來的(第一個備份)還原檔案到現存的資料夾(直接覆蓋它們沒關係)
*刪除目前的資料庫然後從(第一個備份)還原資料

就是這樣。一切都應該恢復正常。

'''關於報告此問題的說明：'''

如果您遇到這樣的問題，請務必在我們的錯誤追蹤網站裡回報此問題：https://bugs.limesurvey.org

未回報的錯誤就是不會被修復的錯誤。請不要等別人回報此錯誤。如果您發現該錯誤已被回報，您還可以透過在錯誤追蹤器中將其標記為「是的，此錯誤影響我」來幫助提高錯誤的優先順序。

<span id="FAQ"></span>
=常見問題=

<span id="Can_I_upgrade_even_if_I_have_active_surveys?"></span>
==即使我有進行中的問卷，我也可以升級嗎？==

是的你可以升級。上面的詳細說明中可能會提到例外。我們強烈建議您在升級後測試您的問卷，以確定您設計的模板是否可以正常運作。

<span id="How_to_convert_*.sql/*.csv_survey_structure_files_to_the_latest_LimeSurvey_version?"></span>
==如何將*.sql/*.csv問卷結構檔轉換為最新的LimeSurvey版本？==

安裝版本 1.50，匯入文件，並將調查結構匯出成為較新的 .csv 格式。然後安裝最新版本 2.x 並匯入 .csv 格式並將其匯出為目前的 .lss 格式。

==Survey theme incompatibility==
With certain major version updates any custom survey themes will not be compatible, anymore:

* Update from LimeSurvey 2.6 or lower to LimeSurvey 2.50
* Update from LimeSurvey 5.x or lower to LimeSurvey 6.x

==Error "Multiple primary key defined" when updating MySQL database==
If you encounter this error, please check the setting ''sql_generate_invisible_primary_key'' in your MySQL server variables. This is most likely set to ''ON'', but should be set to ''OFF''. Then restore your database from the backup (as explained above) and try again.

Translations:Upgrading from a previous version/26/zh-hant

2024-07-06T07:49:38Z

您可以透過 PHP CLI 升級資料庫： <code>php application/commands/console.php updatedb</code>。這允許您透過命令列自動升級系統（例如，在 crontab 中），但不建議這樣做。

Upgrading from a previous version/zh-hant

2024-07-06T07:47:01Z

Rickylu:

<languages /> <div style="float:right;"><div class="simplebox">附加頁：{toc}</div></div> __TOC__

<span id="Before_you_start..."></span>
=開始之前...=

<span style='color:#FF0000'>....閱讀此內容，因為它非常重要：'''務必備份目前的安裝檔案和資料庫！</span>

您可以使用資料庫管理工具例如 [https://www.phpmyadmin.net phpMyAdmin] 和檔案管理器來執行此操作！
如果您不知道怎麼備份，請勿繼續下面的操作並尋找其他人的幫助。

==建議使用 ComfortUpdate==
'''最簡單/安全的升級方法就是使用我們的[[ComfortUpdate]]服務。'''

<span id="Upgrade_instructions_(from_2.x_or_newer_to_any_later_version)"></span>
=升級說明（從2.x或更高版本到任何之後的版本）=

請按照以下說明操作：
*備份您的檔案和資料庫([[Upgrading from a previous version/zh-hant#Before you start...|我們之前有提過嗎?]])。
*刪除所有舊文件/資料夾，除了以下檔案：
**/application/config/security.php - '''很重要!!這是 LimeSurvey（版本 4 及更高版本）中所有加密資料的金鑰'''
**/application/config/config.php;
**/upload 目錄

<div class="simplebox">[[File:help.png]]'''注意：''' 如果 /upload/templates 中有任何自訂模板，請確保「更新」這些模板以應對使用新 LimeSurvey 版本所造成的變化。檢查此類變更的最簡單方法是將舊範本與新版本的預設範本進行檔案比較。如果您發現自訂之外的任何差異，則需要更新。</div>
*將新檔案從新的 LimeSurvey 套件複製到現有位置。
*在瀏覽器開啟管理者介面 (e.g. https://www.example.com/limesurvey/admin) 並檢查是否需要升級資料庫架構。
*完成升級後'''清空您瀏覽器的快取和Cookies'''

<span id="Instructions_for_older_versions"></span>
=更舊版本的說明=

不幸的是，有一些事情需要您再想想，所以請仔細閱讀以下說明。

==Upgrading from version 1.50 or later to any later 2.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the latest version of LimeSurvey
*Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new files of the new version into the same installation directory
** If your previous version is older than 1.90, copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories (write access to '''/tmp''', '''/upload''', and their subdirectories is required) as described in the [[Installation#Set directory permissions|installation wiki]]
** Open http://<yourdomain>/<yourlimesurveydir>/admin in your browser and follow the instructions (You will find the database data in the old config.php). The existing database will be automatically detected and if necessary, upgraded after confirmation.
* Check if any special manual checks apply as listed below
* '''Now, clear your browser cache and cookies''' and you are good to go

{{Alert|title=Attention|text=請注意，範本結構隨著從 2.0x 更新到 2.50 或更高版本而變化。您的舊模板將不再起作用，因為模板系統現在使用響應式模板。}}

<div class="simplebox">'''Special checks after an upgrade''':
*'''from any earlier version to 2.xx''': Proper question codes are mandatory now. After upgrading the installation, check the survey logic of all surveys and correct the codes where necessary
*'''from a version earlier than v1.53''': When upgrading from a version before v1.53 to the latest version, please check the '''global user rights''' of each user. There was a new '''superadmin''' right introduced in v1.53 that can give a user the same privilege as the master administration account created during the installation. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.
*'''from any earlier version to v2.06''': From 2.05 to 2.06, some unused permissions when editing global permissions for 'surveys' were activated. For example, if a user had only the 'create' permission in 2.05, the other permissions located to the right of 'create' would also get activated with the update to 2.06 (View/read, Update, Delete, Import, Export). Please check whether the admin users got any other global permissions besides the 'original' ones after the update. If yes, please edit them accordingly.
</div>

==Upgrading from version 1.50 or later to any later 1.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the desired version of LimeSurvey
* Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new code version into the same installation directory
** Edit or replace the '''config.php''' file:
*** If your previous version was < 1.70: Edit the new '''config.php''' in order to reflect the changes from the backup '''config.php''' file. '''Do not just overwrite the new '''config.php''' with your old one!'''
*** If your previous version was >= 1.70: Simply replace the new '''config.php''' with your backup '''config.php''' file (as the file format has not changed)
** If your previous version was older than 1.90: Copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories of LimeSurvey (write access to '''/tmp''', '''/upload''', and to their subdirectories is required) as described in the [[Installation#Set Directory permissions|installation wiki]]
* Finish the installation/upgrade process
** Once you open the URL to your LimeSurvey administration, the database tables will be updated after confirmation
** Remove or rename the /admin/install directory as/if instructed by the installation script
** Check if any special manual checks apply (as listed below)

<div class="simplebox">'''Special checks after an upgrade''':
*'''From a version earlier than v1.53''': When upgrading from a version before v1.53 to the latest version, please check the '''global user rights''' of each user. There was a new '''superadmin''' right introduced in v1.53 that can give a user the same privilege as the master administration account created during the install. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.
</div>

<span id="Upgrading_from_a_version_earlier_than_v1.50_(v1.0_through_v1.44)"></span>
==從 v1.50 之前的版本升級（v1.0 到 v1.44）==

Since the data structure and a lot of other things were changed, '''upgrading from any version previous to v1.50 is <u>NOT</u> possible'''. If you have old survey structure files with an *.sql extension, the only way to get these into a newer version is to install [http://www.limesurvey.org/en/archived-releases/289-limesurvey150zip version 1.50], import the .sql file(s) there, then upgrade that version to the most recent LimeSurvey version. Check the page related to [[Transferring an installation|how an installation can be transferred]] for more details.

<span id="Upgrading_using_CLI"></span>
= 使用 CLI 升級 =

You can upgrade the database via the PHP CLI: <code>php application/commands/console.php updatedb</code>. This allows you to set up an auto-upgrade system via command line (for example, in a crontab), although it is not recommended.

= Failed database upgrade after manual update/ComfortUpdate=
Sometimes, even though you did everything correct, things don't work out they are supposed to during database upgrade.
That may happen because of various reasons: Different database versions, unexpected data formats or contents, unusual configurations or anything else that did not show up in our tests (yes, we test a lot!)

If you have an error during database update and your LimeSurvey instance ends up in an unusable state, you want to go back to the previous version.
This assumes that you still have the database and file backup, either from your regular backup or the one created by Comfortupdate.

請執行以下步驟：

*備份現有的 LimeSurvey 目錄和資料庫（是的，再做一次 - 我們叫它第二個備份）
*從原來的(第一個備份)還原檔案到現存的資料夾(直接覆蓋它們沒關係)
*刪除目前的資料庫然後從(第一個備份)還原資料

就是這樣。一切都應該恢復正常。

'''關於報告此問題的說明：'''

如果您遇到這樣的問題，請務必在我們的錯誤追蹤網站裡回報此問題：https://bugs.limesurvey.org

未回報的錯誤就是不會被修復的錯誤。請不要等別人回報此錯誤。如果您發現該錯誤已被回報，您還可以透過在錯誤追蹤器中將其標記為「是的，此錯誤影響我」來幫助提高錯誤的優先順序。

<span id="FAQ"></span>
=常見問題=

<span id="Can_I_upgrade_even_if_I_have_active_surveys?"></span>
==即使我有進行中的問卷，我也可以升級嗎？==

是的你可以升級。上面的詳細說明中可能會提到例外。我們強烈建議您在升級後測試您的問卷，以確定您設計的模板是否可以正常運作。

<span id="How_to_convert_*.sql/*.csv_survey_structure_files_to_the_latest_LimeSurvey_version?"></span>
==如何將*.sql/*.csv問卷結構檔轉換為最新的LimeSurvey版本？==

安裝版本 1.50，匯入文件，並將調查結構匯出成為較新的 .csv 格式。然後安裝最新版本 2.x 並匯入 .csv 格式並將其匯出為目前的 .lss 格式。

==Survey theme incompatibility==
With certain major version updates any custom survey themes will not be compatible, anymore:

* Update from LimeSurvey 2.6 or lower to LimeSurvey 2.50
* Update from LimeSurvey 5.x or lower to LimeSurvey 6.x

==Error "Multiple primary key defined" when updating MySQL database==
If you encounter this error, please check the setting ''sql_generate_invisible_primary_key'' in your MySQL server variables. This is most likely set to ''ON'', but should be set to ''OFF''. Then restore your database from the backup (as explained above) and try again.

Translations:Upgrading from a previous version/8/zh-hant

2024-07-06T07:46:16Z

Rickylu:

不幸的是，有一些事情需要您再想想，所以請仔細閱讀以下說明。

Upgrading from a previous version/zh-hant

2024-07-06T07:46:01Z

Rickylu:

<languages /> <div style="float:right;"><div class="simplebox">附加頁：{toc}</div></div> __TOC__

<span id="Before_you_start..."></span>
=開始之前...=

<span style='color:#FF0000'>....閱讀此內容，因為它非常重要：'''務必備份目前的安裝檔案和資料庫！</span>

您可以使用資料庫管理工具例如 [https://www.phpmyadmin.net phpMyAdmin] 和檔案管理器來執行此操作！
如果您不知道怎麼備份，請勿繼續下面的操作並尋找其他人的幫助。

==建議使用 ComfortUpdate==
'''最簡單/安全的升級方法就是使用我們的[[ComfortUpdate]]服務。'''

<span id="Upgrade_instructions_(from_2.x_or_newer_to_any_later_version)"></span>
=升級說明（從2.x或更高版本到任何之後的版本）=

請按照以下說明操作：
*備份您的檔案和資料庫([[Upgrading from a previous version/zh-hant#Before you start...|我們之前有提過嗎?]])。
*刪除所有舊文件/資料夾，除了以下檔案：
**/application/config/security.php - '''很重要!!這是 LimeSurvey（版本 4 及更高版本）中所有加密資料的金鑰'''
**/application/config/config.php;
**/upload 目錄

<div class="simplebox">[[File:help.png]]'''注意：''' 如果 /upload/templates 中有任何自訂模板，請確保「更新」這些模板以應對使用新 LimeSurvey 版本所造成的變化。檢查此類變更的最簡單方法是將舊範本與新版本的預設範本進行檔案比較。如果您發現自訂之外的任何差異，則需要更新。</div>
*將新檔案從新的 LimeSurvey 套件複製到現有位置。
*在瀏覽器開啟管理者介面 (e.g. https://www.example.com/limesurvey/admin) 並檢查是否需要升級資料庫架構。
*完成升級後'''清空您瀏覽器的快取和Cookies'''

<span id="Instructions_for_older_versions"></span>
=更舊版本的說明=

不幸的是，有一些事情需要考慮，所以請仔細閱讀以下說明。

==Upgrading from version 1.50 or later to any later 2.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the latest version of LimeSurvey
*Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new files of the new version into the same installation directory
** If your previous version is older than 1.90, copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories (write access to '''/tmp''', '''/upload''', and their subdirectories is required) as described in the [[Installation#Set directory permissions|installation wiki]]
** Open http://<yourdomain>/<yourlimesurveydir>/admin in your browser and follow the instructions (You will find the database data in the old config.php). The existing database will be automatically detected and if necessary, upgraded after confirmation.
* Check if any special manual checks apply as listed below
* '''Now, clear your browser cache and cookies''' and you are good to go

{{Alert|title=Attention|text=請注意，範本結構隨著從 2.0x 更新到 2.50 或更高版本而變化。您的舊模板將不再起作用，因為模板系統現在使用響應式模板。}}

<div class="simplebox">'''Special checks after an upgrade''':
*'''from any earlier version to 2.xx''': Proper question codes are mandatory now. After upgrading the installation, check the survey logic of all surveys and correct the codes where necessary
*'''from a version earlier than v1.53''': When upgrading from a version before v1.53 to the latest version, please check the '''global user rights''' of each user. There was a new '''superadmin''' right introduced in v1.53 that can give a user the same privilege as the master administration account created during the installation. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.
*'''from any earlier version to v2.06''': From 2.05 to 2.06, some unused permissions when editing global permissions for 'surveys' were activated. For example, if a user had only the 'create' permission in 2.05, the other permissions located to the right of 'create' would also get activated with the update to 2.06 (View/read, Update, Delete, Import, Export). Please check whether the admin users got any other global permissions besides the 'original' ones after the update. If yes, please edit them accordingly.
</div>

==Upgrading from version 1.50 or later to any later 1.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the desired version of LimeSurvey
* Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new code version into the same installation directory
** Edit or replace the '''config.php''' file:
*** If your previous version was < 1.70: Edit the new '''config.php''' in order to reflect the changes from the backup '''config.php''' file. '''Do not just overwrite the new '''config.php''' with your old one!'''
*** If your previous version was >= 1.70: Simply replace the new '''config.php''' with your backup '''config.php''' file (as the file format has not changed)
** If your previous version was older than 1.90: Copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories of LimeSurvey (write access to '''/tmp''', '''/upload''', and to their subdirectories is required) as described in the [[Installation#Set Directory permissions|installation wiki]]
* Finish the installation/upgrade process
** Once you open the URL to your LimeSurvey administration, the database tables will be updated after confirmation
** Remove or rename the /admin/install directory as/if instructed by the installation script
** Check if any special manual checks apply (as listed below)

<div class="simplebox">'''Special checks after an upgrade''':
*'''From a version earlier than v1.53''': When upgrading from a version before v1.53 to the latest version, please check the '''global user rights''' of each user. There was a new '''superadmin''' right introduced in v1.53 that can give a user the same privilege as the master administration account created during the install. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.
</div>

<span id="Upgrading_from_a_version_earlier_than_v1.50_(v1.0_through_v1.44)"></span>
==從 v1.50 之前的版本升級（v1.0 到 v1.44）==

Since the data structure and a lot of other things were changed, '''upgrading from any version previous to v1.50 is <u>NOT</u> possible'''. If you have old survey structure files with an *.sql extension, the only way to get these into a newer version is to install [http://www.limesurvey.org/en/archived-releases/289-limesurvey150zip version 1.50], import the .sql file(s) there, then upgrade that version to the most recent LimeSurvey version. Check the page related to [[Transferring an installation|how an installation can be transferred]] for more details.

<span id="Upgrading_using_CLI"></span>
= 使用 CLI 升級 =

You can upgrade the database via the PHP CLI: <code>php application/commands/console.php updatedb</code>. This allows you to set up an auto-upgrade system via command line (for example, in a crontab), although it is not recommended.

= Failed database upgrade after manual update/ComfortUpdate=
Sometimes, even though you did everything correct, things don't work out they are supposed to during database upgrade.
That may happen because of various reasons: Different database versions, unexpected data formats or contents, unusual configurations or anything else that did not show up in our tests (yes, we test a lot!)

If you have an error during database update and your LimeSurvey instance ends up in an unusable state, you want to go back to the previous version.
This assumes that you still have the database and file backup, either from your regular backup or the one created by Comfortupdate.

請執行以下步驟：

*備份現有的 LimeSurvey 目錄和資料庫（是的，再做一次 - 我們叫它第二個備份）
*從原來的(第一個備份)還原檔案到現存的資料夾(直接覆蓋它們沒關係)
*刪除目前的資料庫然後從(第一個備份)還原資料

就是這樣。一切都應該恢復正常。

'''關於報告此問題的說明：'''

如果您遇到這樣的問題，請務必在我們的錯誤追蹤網站裡回報此問題：https://bugs.limesurvey.org

未回報的錯誤就是不會被修復的錯誤。請不要等別人回報此錯誤。如果您發現該錯誤已被回報，您還可以透過在錯誤追蹤器中將其標記為「是的，此錯誤影響我」來幫助提高錯誤的優先順序。

<span id="FAQ"></span>
=常見問題=

<span id="Can_I_upgrade_even_if_I_have_active_surveys?"></span>
==即使我有進行中的問卷，我也可以升級嗎？==

是的你可以升級。上面的詳細說明中可能會提到例外。我們強烈建議您在升級後測試您的問卷，以確定您設計的模板是否可以正常運作。

<span id="How_to_convert_*.sql/*.csv_survey_structure_files_to_the_latest_LimeSurvey_version?"></span>
==如何將*.sql/*.csv問卷結構檔轉換為最新的LimeSurvey版本？==

安裝版本 1.50，匯入文件，並將調查結構匯出成為較新的 .csv 格式。然後安裝最新版本 2.x 並匯入 .csv 格式並將其匯出為目前的 .lss 格式。

==Survey theme incompatibility==
With certain major version updates any custom survey themes will not be compatible, anymore:

* Update from LimeSurvey 2.6 or lower to LimeSurvey 2.50
* Update from LimeSurvey 5.x or lower to LimeSurvey 6.x

==Error "Multiple primary key defined" when updating MySQL database==
If you encounter this error, please check the setting ''sql_generate_invisible_primary_key'' in your MySQL server variables. This is most likely set to ''ON'', but should be set to ''OFF''. Then restore your database from the backup (as explained above) and try again.

Translations:Upgrading from a previous version/7/zh-hant

2024-07-06T07:45:46Z

Rickylu:

=更舊版本的說明=

Upgrading from a previous version/zh-hant

2024-07-06T07:45:01Z

Rickylu:

<languages /> <div style="float:right;"><div class="simplebox">附加頁：{toc}</div></div> __TOC__

<span id="Before_you_start..."></span>
=開始之前...=

<span style='color:#FF0000'>....閱讀此內容，因為它非常重要：'''務必備份目前的安裝檔案和資料庫！</span>

您可以使用資料庫管理工具例如 [https://www.phpmyadmin.net phpMyAdmin] 和檔案管理器來執行此操作！
如果您不知道怎麼備份，請勿繼續下面的操作並尋找其他人的幫助。

==建議使用 ComfortUpdate==
'''最簡單/安全的升級方法就是使用我們的[[ComfortUpdate]]服務。'''

<span id="Upgrade_instructions_(from_2.x_or_newer_to_any_later_version)"></span>
=升級說明（從2.x或更高版本到任何之後的版本）=

請按照以下說明操作：
*備份您的檔案和資料庫([[Upgrading from a previous version/zh-hant#Before you start...|我們之前有提過嗎?]])。
*刪除所有舊文件/資料夾，除了以下檔案：
**/application/config/security.php - '''很重要!!這是 LimeSurvey（版本 4 及更高版本）中所有加密資料的金鑰'''
**/application/config/config.php;
**/upload 目錄

<div class="simplebox">[[File:help.png]]'''注意：''' 如果 /upload/templates 中有任何自訂模板，請確保「更新」這些模板以應對使用新 LimeSurvey 版本所造成的變化。檢查此類變更的最簡單方法是將舊範本與新版本的預設範本進行檔案比較。如果您發現自訂之外的任何差異，則需要更新。</div>
*將新檔案從新的 LimeSurvey 套件複製到現有位置。
*在瀏覽器開啟管理者介面 (e.g. https://www.example.com/limesurvey/admin) 並檢查是否需要升級資料庫架構。
*完成升級後'''清空您瀏覽器的快取和Cookies'''

<span id="Instructions_for_older_versions"></span>
=舊版說明=

不幸的是，有一些事情需要考慮，所以請仔細閱讀以下說明。

==Upgrading from version 1.50 or later to any later 2.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the latest version of LimeSurvey
*Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new files of the new version into the same installation directory
** If your previous version is older than 1.90, copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories (write access to '''/tmp''', '''/upload''', and their subdirectories is required) as described in the [[Installation#Set directory permissions|installation wiki]]
** Open http://<yourdomain>/<yourlimesurveydir>/admin in your browser and follow the instructions (You will find the database data in the old config.php). The existing database will be automatically detected and if necessary, upgraded after confirmation.
* Check if any special manual checks apply as listed below
* '''Now, clear your browser cache and cookies''' and you are good to go

{{Alert|title=Attention|text=請注意，範本結構隨著從 2.0x 更新到 2.50 或更高版本而變化。您的舊模板將不再起作用，因為模板系統現在使用響應式模板。}}

<div class="simplebox">'''Special checks after an upgrade''':
*'''from any earlier version to 2.xx''': Proper question codes are mandatory now. After upgrading the installation, check the survey logic of all surveys and correct the codes where necessary
*'''from a version earlier than v1.53''': When upgrading from a version before v1.53 to the latest version, please check the '''global user rights''' of each user. There was a new '''superadmin''' right introduced in v1.53 that can give a user the same privilege as the master administration account created during the installation. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.
*'''from any earlier version to v2.06''': From 2.05 to 2.06, some unused permissions when editing global permissions for 'surveys' were activated. For example, if a user had only the 'create' permission in 2.05, the other permissions located to the right of 'create' would also get activated with the update to 2.06 (View/read, Update, Delete, Import, Export). Please check whether the admin users got any other global permissions besides the 'original' ones after the update. If yes, please edit them accordingly.
</div>

==Upgrading from version 1.50 or later to any later 1.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the desired version of LimeSurvey
* Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new code version into the same installation directory
** Edit or replace the '''config.php''' file:
*** If your previous version was < 1.70: Edit the new '''config.php''' in order to reflect the changes from the backup '''config.php''' file. '''Do not just overwrite the new '''config.php''' with your old one!'''
*** If your previous version was >= 1.70: Simply replace the new '''config.php''' with your backup '''config.php''' file (as the file format has not changed)
** If your previous version was older than 1.90: Copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories of LimeSurvey (write access to '''/tmp''', '''/upload''', and to their subdirectories is required) as described in the [[Installation#Set Directory permissions|installation wiki]]
* Finish the installation/upgrade process
** Once you open the URL to your LimeSurvey administration, the database tables will be updated after confirmation
** Remove or rename the /admin/install directory as/if instructed by the installation script
** Check if any special manual checks apply (as listed below)

<div class="simplebox">'''Special checks after an upgrade''':
*'''From a version earlier than v1.53''': When upgrading from a version before v1.53 to the latest version, please check the '''global user rights''' of each user. There was a new '''superadmin''' right introduced in v1.53 that can give a user the same privilege as the master administration account created during the install. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.
</div>

<span id="Upgrading_from_a_version_earlier_than_v1.50_(v1.0_through_v1.44)"></span>
==從 v1.50 之前的版本升級（v1.0 到 v1.44）==

Since the data structure and a lot of other things were changed, '''upgrading from any version previous to v1.50 is <u>NOT</u> possible'''. If you have old survey structure files with an *.sql extension, the only way to get these into a newer version is to install [http://www.limesurvey.org/en/archived-releases/289-limesurvey150zip version 1.50], import the .sql file(s) there, then upgrade that version to the most recent LimeSurvey version. Check the page related to [[Transferring an installation|how an installation can be transferred]] for more details.

<span id="Upgrading_using_CLI"></span>
= 使用 CLI 升級 =

You can upgrade the database via the PHP CLI: <code>php application/commands/console.php updatedb</code>. This allows you to set up an auto-upgrade system via command line (for example, in a crontab), although it is not recommended.

= Failed database upgrade after manual update/ComfortUpdate=
Sometimes, even though you did everything correct, things don't work out they are supposed to during database upgrade.
That may happen because of various reasons: Different database versions, unexpected data formats or contents, unusual configurations or anything else that did not show up in our tests (yes, we test a lot!)

If you have an error during database update and your LimeSurvey instance ends up in an unusable state, you want to go back to the previous version.
This assumes that you still have the database and file backup, either from your regular backup or the one created by Comfortupdate.

請執行以下步驟：

*備份現有的 LimeSurvey 目錄和資料庫（是的，再做一次 - 我們叫它第二個備份）
*從原來的(第一個備份)還原檔案到現存的資料夾(直接覆蓋它們沒關係)
*刪除目前的資料庫然後從(第一個備份)還原資料

就是這樣。一切都應該恢復正常。

'''關於報告此問題的說明：'''

如果您遇到這樣的問題，請務必在我們的錯誤追蹤網站裡回報此問題：https://bugs.limesurvey.org

未回報的錯誤就是不會被修復的錯誤。請不要等別人回報此錯誤。如果您發現該錯誤已被回報，您還可以透過在錯誤追蹤器中將其標記為「是的，此錯誤影響我」來幫助提高錯誤的優先順序。

<span id="FAQ"></span>
=常見問題=

<span id="Can_I_upgrade_even_if_I_have_active_surveys?"></span>
==即使我有進行中的問卷，我也可以升級嗎？==

是的你可以升級。上面的詳細說明中可能會提到例外。我們強烈建議您在升級後測試您的問卷，以確定您設計的模板是否可以正常運作。

<span id="How_to_convert_*.sql/*.csv_survey_structure_files_to_the_latest_LimeSurvey_version?"></span>
==如何將*.sql/*.csv問卷結構檔轉換為最新的LimeSurvey版本？==

安裝版本 1.50，匯入文件，並將調查結構匯出成為較新的 .csv 格式。然後安裝最新版本 2.x 並匯入 .csv 格式並將其匯出為目前的 .lss 格式。

==Survey theme incompatibility==
With certain major version updates any custom survey themes will not be compatible, anymore:

* Update from LimeSurvey 2.6 or lower to LimeSurvey 2.50
* Update from LimeSurvey 5.x or lower to LimeSurvey 6.x

==Error "Multiple primary key defined" when updating MySQL database==
If you encounter this error, please check the setting ''sql_generate_invisible_primary_key'' in your MySQL server variables. This is most likely set to ''ON'', but should be set to ''OFF''. Then restore your database from the backup (as explained above) and try again.

Translations:Upgrading from a previous version/27/zh-hant

2024-07-06T07:44:35Z

Rickylu:

<div class="simplebox">[[File:help.png]]'''注意：''' 如果 /upload/templates 中有任何自訂模板，請確保「更新」這些模板以應對使用新 LimeSurvey 版本所造成的變化。檢查此類變更的最簡單方法是將舊範本與新版本的預設範本進行檔案比較。如果您發現自訂之外的任何差異，則需要更新。</div>
*將新檔案從新的 LimeSurvey 套件複製到現有位置。
*在瀏覽器開啟管理者介面 (e.g. https://www.example.com/limesurvey/admin) 並檢查是否需要升級資料庫架構。
*完成升級後'''清空您瀏覽器的快取和Cookies'''

Upgrading from a previous version/zh-hant

2024-07-06T07:41:01Z

Rickylu: Created page with "<div class="simplebox">File:help.png'''注意：''' 如果 /upload/templates 中有任何自訂模板，請確保「更新」這些模板以應對使用新 LimeSurvey 版本所造成的變化。檢查此類變更的最簡單方法是將舊範本與新版本的預設範本進行檔案比較。如果您發現自訂之外的任何差異，則需要更新。</div> *將新檔案從新的 LimeSurvey 套件複製到現有位置。 *在瀏覽器開啟管理者介面(如:http..."

<languages /> <div style="float:right;"><div class="simplebox">附加頁：{toc}</div></div> __TOC__

<span id="Before_you_start..."></span>
=開始之前...=

<span style='color:#FF0000'>....閱讀此內容，因為它非常重要：'''務必備份目前的安裝檔案和資料庫！</span>

您可以使用資料庫管理工具例如 [https://www.phpmyadmin.net phpMyAdmin] 和檔案管理器來執行此操作！
如果您不知道怎麼備份，請勿繼續下面的操作並尋找其他人的幫助。

==建議使用 ComfortUpdate==
'''最簡單/安全的升級方法就是使用我們的[[ComfortUpdate]]服務。'''

<span id="Upgrade_instructions_(from_2.x_or_newer_to_any_later_version)"></span>
=升級說明（從2.x或更高版本到任何之後的版本）=

請按照以下說明操作：
*備份您的檔案和資料庫([[Upgrading from a previous version/zh-hant#Before you start...|我們之前有提過嗎?]])。
*刪除所有舊文件/資料夾，除了以下檔案：
**/application/config/security.php - '''很重要!!這是 LimeSurvey（版本 4 及更高版本）中所有加密資料的金鑰'''
**/application/config/config.php;
**/upload 目錄

<div class="simplebox">[[File:help.png]]'''注意：''' 如果 /upload/templates 中有任何自訂模板，請確保「更新」這些模板以應對使用新 LimeSurvey 版本所造成的變化。檢查此類變更的最簡單方法是將舊範本與新版本的預設範本進行檔案比較。如果您發現自訂之外的任何差異，則需要更新。</div>
*將新檔案從新的 LimeSurvey 套件複製到現有位置。
*在瀏覽器開啟管理者介面(如:https://www.example.com/limesurvey/admin)並檢查是否需要升級資料庫架構。
*完成升級後'''清空您瀏覽器的快取和Cookies'''

<span id="Instructions_for_older_versions"></span>
=舊版說明=

不幸的是，有一些事情需要考慮，所以請仔細閱讀以下說明。

==Upgrading from version 1.50 or later to any later 2.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the latest version of LimeSurvey
*Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new files of the new version into the same installation directory
** If your previous version is older than 1.90, copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories (write access to '''/tmp''', '''/upload''', and their subdirectories is required) as described in the [[Installation#Set directory permissions|installation wiki]]
** Open http://<yourdomain>/<yourlimesurveydir>/admin in your browser and follow the instructions (You will find the database data in the old config.php). The existing database will be automatically detected and if necessary, upgraded after confirmation.
* Check if any special manual checks apply as listed below
* '''Now, clear your browser cache and cookies''' and you are good to go

{{Alert|title=Attention|text=請注意，範本結構隨著從 2.0x 更新到 2.50 或更高版本而變化。您的舊模板將不再起作用，因為模板系統現在使用響應式模板。}}

<div class="simplebox">'''Special checks after an upgrade''':
*'''from any earlier version to 2.xx''': Proper question codes are mandatory now. After upgrading the installation, check the survey logic of all surveys and correct the codes where necessary
*'''from a version earlier than v1.53''': When upgrading from a version before v1.53 to the latest version, please check the '''global user rights''' of each user. There was a new '''superadmin''' right introduced in v1.53 that can give a user the same privilege as the master administration account created during the installation. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.
*'''from any earlier version to v2.06''': From 2.05 to 2.06, some unused permissions when editing global permissions for 'surveys' were activated. For example, if a user had only the 'create' permission in 2.05, the other permissions located to the right of 'create' would also get activated with the update to 2.06 (View/read, Update, Delete, Import, Export). Please check whether the admin users got any other global permissions besides the 'original' ones after the update. If yes, please edit them accordingly.
</div>

==Upgrading from version 1.50 or later to any later 1.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the desired version of LimeSurvey
* Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new code version into the same installation directory
** Edit or replace the '''config.php''' file:
*** If your previous version was < 1.70: Edit the new '''config.php''' in order to reflect the changes from the backup '''config.php''' file. '''Do not just overwrite the new '''config.php''' with your old one!'''
*** If your previous version was >= 1.70: Simply replace the new '''config.php''' with your backup '''config.php''' file (as the file format has not changed)
** If your previous version was older than 1.90: Copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories of LimeSurvey (write access to '''/tmp''', '''/upload''', and to their subdirectories is required) as described in the [[Installation#Set Directory permissions|installation wiki]]
* Finish the installation/upgrade process
** Once you open the URL to your LimeSurvey administration, the database tables will be updated after confirmation
** Remove or rename the /admin/install directory as/if instructed by the installation script
** Check if any special manual checks apply (as listed below)

<div class="simplebox">'''Special checks after an upgrade''':
*'''From a version earlier than v1.53''': When upgrading from a version before v1.53 to the latest version, please check the '''global user rights''' of each user. There was a new '''superadmin''' right introduced in v1.53 that can give a user the same privilege as the master administration account created during the install. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.
</div>

<span id="Upgrading_from_a_version_earlier_than_v1.50_(v1.0_through_v1.44)"></span>
==從 v1.50 之前的版本升級（v1.0 到 v1.44）==

Since the data structure and a lot of other things were changed, '''upgrading from any version previous to v1.50 is <u>NOT</u> possible'''. If you have old survey structure files with an *.sql extension, the only way to get these into a newer version is to install [http://www.limesurvey.org/en/archived-releases/289-limesurvey150zip version 1.50], import the .sql file(s) there, then upgrade that version to the most recent LimeSurvey version. Check the page related to [[Transferring an installation|how an installation can be transferred]] for more details.

<span id="Upgrading_using_CLI"></span>
= 使用 CLI 升級 =

You can upgrade the database via the PHP CLI: <code>php application/commands/console.php updatedb</code>. This allows you to set up an auto-upgrade system via command line (for example, in a crontab), although it is not recommended.

= Failed database upgrade after manual update/ComfortUpdate=
Sometimes, even though you did everything correct, things don't work out they are supposed to during database upgrade.
That may happen because of various reasons: Different database versions, unexpected data formats or contents, unusual configurations or anything else that did not show up in our tests (yes, we test a lot!)

If you have an error during database update and your LimeSurvey instance ends up in an unusable state, you want to go back to the previous version.
This assumes that you still have the database and file backup, either from your regular backup or the one created by Comfortupdate.

請執行以下步驟：

*備份現有的 LimeSurvey 目錄和資料庫（是的，再做一次 - 我們叫它第二個備份）
*從原來的(第一個備份)還原檔案到現存的資料夾(直接覆蓋它們沒關係)
*刪除目前的資料庫然後從(第一個備份)還原資料

就是這樣。一切都應該恢復正常。

'''關於報告此問題的說明：'''

如果您遇到這樣的問題，請務必在我們的錯誤追蹤網站裡回報此問題：https://bugs.limesurvey.org

未回報的錯誤就是不會被修復的錯誤。請不要等別人回報此錯誤。如果您發現該錯誤已被回報，您還可以透過在錯誤追蹤器中將其標記為「是的，此錯誤影響我」來幫助提高錯誤的優先順序。

<span id="FAQ"></span>
=常見問題=

<span id="Can_I_upgrade_even_if_I_have_active_surveys?"></span>
==即使我有進行中的問卷，我也可以升級嗎？==

是的你可以升級。上面的詳細說明中可能會提到例外。我們強烈建議您在升級後測試您的問卷，以確定您設計的模板是否可以正常運作。

<span id="How_to_convert_*.sql/*.csv_survey_structure_files_to_the_latest_LimeSurvey_version?"></span>
==如何將*.sql/*.csv問卷結構檔轉換為最新的LimeSurvey版本？==

安裝版本 1.50，匯入文件，並將調查結構匯出成為較新的 .csv 格式。然後安裝最新版本 2.x 並匯入 .csv 格式並將其匯出為目前的 .lss 格式。

==Survey theme incompatibility==
With certain major version updates any custom survey themes will not be compatible, anymore:

* Update from LimeSurvey 2.6 or lower to LimeSurvey 2.50
* Update from LimeSurvey 5.x or lower to LimeSurvey 6.x

==Error "Multiple primary key defined" when updating MySQL database==
If you encounter this error, please check the setting ''sql_generate_invisible_primary_key'' in your MySQL server variables. This is most likely set to ''ON'', but should be set to ''OFF''. Then restore your database from the backup (as explained above) and try again.

Translations:Upgrading from a previous version/27/zh-hant

2024-07-06T07:40:14Z

<div class="simplebox">[[File:help.png]]'''注意：''' 如果 /upload/templates 中有任何自訂模板，請確保「更新」這些模板以應對使用新 LimeSurvey 版本所造成的變化。檢查此類變更的最簡單方法是將舊範本與新版本的預設範本進行檔案比較。如果您發現自訂之外的任何差異，則需要更新。</div>
*將新檔案從新的 LimeSurvey 套件複製到現有位置。
*在瀏覽器開啟管理者介面(如:https://www.example.com/limesurvey/admin)並檢查是否需要升級資料庫架構。
*完成升級後'''清空您瀏覽器的快取和Cookies'''

Installation - LimeSurvey CE/zh-hant

2024-07-06T07:28:02Z

Rickylu:

<languages />

__TOC__

<div class="simplebox">注意：這些安裝說明適用於 2.0 或更高版本。 1.92 的舊安裝說明可在 [[Installation Version 1.92 or older|此處]] 找到，從舊版升級為新版的說明可在 [[Upgrading from a previous version|此處]] 找到。</div>

<span id="General"></span>
==概觀==

LimeSurvey 提供了兩種安裝的方法：
*在您的網頁伺服器上：<br />在這種情況下，需從步驟 1 開始按照本頁上的說明進行操作。

*在您的本機 Windows PC 上：<br />如果您想在自己的電腦建立問卷（主要是出於速度、開發或測試原因）並在稍後將其佈署到您的網頁伺服器上，通常只需在本機 PC 上安裝 LimeSurvey。為此，我們準備了一個特殊的 LimeSurvey 安裝包，其中包括網頁伺服器、資料庫、LimeSurvey 應用程式和 [[Installation of the LimeSurvey XAMPP package|如何安裝的說明]]。

<span id="Make_sure_you_can_use_LimeSurvey_on_your_website"></span>
==確認 LimeSurvey 能夠在您的伺服器上執行==

確認伺服器符合以下所有需求:

{{Note|安裝過程中也將檢查最低需求！}}

'''LimeSurvey 6.x'''的最低需求:
* 至少 250MB 硬碟空間
* MariaDB 10.3.38 或更高版本 '''或''' MySQL 8 或更高版本 '''或''' Microsoft SQL Server 2008 或更高版本 '''或''' Postgres 12 或更高版本。
* PHP 版本需求:
** LS 6.x 需 PHP 7.4.x ~ 8.x
** LS 5.x 需 PHP 7.2.5 ~ 8.0.x
** LS 3.x 需 PHP 5.5.9 ~ 7.4.x
* php.ini 裡 `short_open_tag` 參數設定需設為 `ON`
* 以下的 PHP 模組/擴充功能庫需啟用:
** [[Installation_FAQ/zh-hant#mbstring_(Multibyte_String_Functions)_library_是甚麼?|mbstring (Multibyte String Functions)]] 擴充功能庫
** 在Windows環境需要 MySQL 的PDO驅動程式庫 (pdo_mysql 或 pdo_mysqli) 或 Postgres (pdo_pgsql) 或 MSSQL ([https://php.net/manual/en/ref.pdo-sqlsrv.php pdo_sqlsrv] 而 Linux環境需要 [http://www.php.net/manual/en/ref.pdo-dblib.php pdo_dblib] )。
** 還有, 我們建議常用的PHP程式庫都應該啟用
*** hash
*** session
*** openssl or mcrypt
*** fileinfo
*** SimpleXML
*** 等等…

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

選擇性PHP擴充:
* '''GD-Library''' '''with FreeType support''' 需安裝才能使用驗證碼、漂亮的統計圖或透過HTML編輯器上傳圖片 - 請參閱[https://php.net/manual/image.setup.php PHP GD-Library Extension documentation]
* '''IMAP''' (pretty standard) 需安裝才能使用 [[Email bounce tracking system|電子郵件退回追蹤系統]] - 請參閱[https://php.net/manual/imap.setup.php PHP IMAP Extension documentation]
* '''LDAP''' 需安裝才能透過LDAP匯入問卷參與者 - 請參閱[https://php.net/manual/en/book.ldap.php PHP LDAP Documentation]
* '''Zip''' (pretty standard) 需安裝才能使用模板上傳、.zip 資源匯入和 Excel 匯出 - 請參閱[https://php.net/manual/zip.setup.php PHP Zip Extension documentation]
* '''Zlib'''（pretty standard）需安裝才能使用 [[ComfortUpdate]] - 請參閱[https://php.net/manual/zlib.setup.php PHP Zlib Extension documentation]

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

如果您想透過 Microsoft 的 IIS 執行，請查看 [[Installation on XP with IIS]] 可能也會有所幫助。

===瀏覽器相容性===
'''對於問卷填寫方''', 我們目前支援 IE11 (除了相容性模式) 和其他較新的瀏覽器如 Edge, FireFox, Chrome, Opera 等等，並需啟用JavaScript。

'''對於問卷管理方''',我們目前支援 Edge 和所有較新的瀏覽器，如 FireFox、Chrome、Opera 等等，並需啟用 JavaScript。<u>問卷管理者部份我們不再支援任何 Internet Explorer 版本。</u>

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

<span id="Hosting_for_LimeSurvey"></span>
===LimeSurvey 託管===

LimeSurvey 應該能夠執行於大多數提供 PHP 和 MySQL 的伺服器供應商。如果您想要找現成的 LimeSurvey 版本，您可以嘗試 [https://www.limesurvey.org/editions-and-prices/limesurvey-pro/editions-and-prices-professional LimeSurvey Cloud]，或參考我們的[[LimeSurvey-compatible hosting companies|LimeSurvey相容託管供應商清單]]。

<span id="Download_the_LimeSurvey_package"></span>
==下載 LimeSurvey 套件==

[https://community.limesurvey.org/downloads/ 下載]最新穩定的 LimeSurvey zip 安裝套件（您也可以選用 gzip、bz2 和 7zip 套件）並將其儲存到本機磁碟中。

<span id="Unpack_the_LimeSurvey_package"></span>
==解壓縮 LimeSurvey 套件==

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

<span id="Collect_information_about_your_server"></span>
==收集您伺服器的資訊==

您需要取得以下資訊才能在網頁伺服器上正確安裝 LimeSurvey：
*您要建立 limesurvey 的域名來指向它的服務 (例如 ''http://my.domain.com/limesurvey'')。
*limesurvey 在伺服器所在的實質位置(例如 ''/home/usr/htdocs/limesurvey'')。
*您資料庫的 IP/網路位置(例如 ''localhost'')。
*如果您的資料庫使用非標準連接埠，您就要找出埠號。
*您資料庫使用的使用者名稱及密碼。
*大部分資料庫的供應商不會讓應用程式建立資料庫，此時您需要自行建立。如果您是使用這類的供應商，請自行建立一個資料庫(例如 ''limesurvey'')。

<span id="Upload_the_files_to_your_web_server"></span>
==將檔案上傳到您的網頁伺服器==

使用 FTP 程式（例如 FileZilla）連接到您的網頁伺服器並建立一個目錄來儲存程式，然後將解壓縮後的檔案上傳到此目錄。請注意，務必以'''二進位模式上傳檔案'''(請從 FTP 程式的設定裡檢查)。使用 ASCII 模式上傳可能會導致預料之外的錯誤（例如安裝過程中出現「找不到類別」錯誤），而且圖片檔也可能無法正確上傳。

<span id="Set_directory_permissions"></span>
==設定目錄權限==

為了使程式正常工作，它需要某些目錄的訪問權限 - 尤其Linux/*nix 系統更是如此。
* '''"/limesurvey/tmp"''' 目錄(包含所有的子目錄和檔案)用於匯入和上傳，應為您的網頁伺服器開啟''讀和寫''權限。
* '''"/limesurvey/upload/"''' 目錄(包含所有的子目錄和檔案)也必須為您的網頁伺服器開啟''讀和寫''權限，以便啟用圖片和媒體檔案上傳功能。
* '''"/limesurvey/application/config/"''' 目錄也需要讓網頁伺服器有''讀和寫'' 的權限。
*其他目錄可以設定為''唯讀''。您可能會想要在 Linux/Unix 中將 /limesurvey/admin 目錄中的每個檔案權限設定為''唯讀''。

{{Alert|如果您使用的是 Linux，則設定權限取決於您的網頁伺服器配置。例如，如果您在 CentOS 上使用 Apache HTTPD，請鍵入 '''chmod -R 755 <directory> ; chown -R apache <directory>'''。這將賦予所有使用者讀取權限，並且您的網頁伺服器將擁有寫入權限。有關 Linux 權限的更多資訊，請查看 [https://www.linux.com/learn/tutorials/309527-understanding-linux-file-permissions 這個連結]。}}

<span id="Create_a_database_user"></span>
==建立資料庫使用者==

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

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

- PostgreSQL: SELECT, INSERT, UPDATE, DELETE, TRUNCATE, TRIGGER

- Microsoft SQL Server: ''不明 - 如果您知道如何設定，請填寫於此處''.

<span id="Run_the_installation_script"></span>
==執行安裝程式==

'''進入“example.org/limesurvey/admin”'''。如果您正確設定了所有內容，LimeSurvey 安裝程式應該會啟動 - 只需按照說明進行操作即可。系統將詢問您是否希望建立資料庫和/或在資料庫內建立資料表。 LimeSurvey 將在資料庫中建立所需的資料表。

<span id="Connect_to_the_administration_script_for_the_first_time"></span>
==第一次執行管理者設定程式==

安裝程式執行完後您就可以開始使用問卷系統了！開啟瀏覽器，在網址列輸入管理後臺的網址。如果您是使用 'limesurvey' 作為目錄名稱來存放它所有的檔案, 網址大概會是如下形式 "http://www.example.com/limesurvey/admin"

您應該會看到登入畫面。預設登入憑證（如果在安裝過程中未更改）為：

<syntaxhighlight lang='html'>

使用者：admin
密碼：password

</syntaxhighlight>

'''緊記第一次登入後馬上要更改預設的密碼.'''

<span id="Further_configuration"></span>
==進一步的設定==

<span id="Caching"></span>
===快取===

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

* Memcached
* Redis
* WinCache
* XCache

請參閱 [https://www.yiiframework.com/doc/api/1.1/CCache Yii documentation] 以了解完整說明。

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

<syntaxhighlight lang="php">
'emcache' => array('class' => 'CFileCache'),
</syntaxhighlight>

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

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

<span id="What_if_I_have_problems..."></span>
==如果我遇到問題怎麼辦...==

正如所有電腦程式，運作過程難免偶有問題，導致運作失常的原因也很多。如果您操作上有麻煩，請先查看 [[Installation FAQ]] 。如果無法找到解決辦法，請將問題發佈到支援論壇 [https://www.limesurvey.org/forum LimeSurvey forums] ，或開一個 [https://www.limesurvey.org/contact-us 維修單] (僅適用於使用LimeSurvey Cloud的客戶)，或是加入我們的 [https://discord.gg/DEjguXn Discord channel] 。

Translations:Installation - LimeSurvey CE/52/zh-hant

2024-07-06T07:27:17Z

Rickylu:

<div class="simplebox">注意：這些安裝說明適用於 2.0 或更高版本。 1.92 的舊安裝說明可在 [[Installation Version 1.92 or older|此處]] 找到，從舊版升級為新版的說明可在 [[Upgrading from a previous version|此處]] 找到。</div>

Upgrading from a previous version/zh-hant

2024-07-01T16:29:02Z

Rickylu: Created page with "{{Alert|title=Attention|text=請注意，範本結構隨著從 2.0x 更新到 2.50 或更高版本而變化。您的舊模板將不再起作用，因為模板系統現在使用響應式模板。}}"

<languages /> <div style="float:right;"><div class="simplebox">附加頁：{toc}</div></div> __TOC__

<span id="Before_you_start..."></span>
=開始之前...=

<span style='color:#FF0000'>....閱讀此內容，因為它非常重要：'''務必備份目前的安裝檔案和資料庫！</span>

您可以使用資料庫管理工具例如 [https://www.phpmyadmin.net phpMyAdmin] 和檔案管理器來執行此操作！
如果您不知道怎麼備份，請勿繼續下面的操作並尋找其他人的幫助。

==建議使用 ComfortUpdate==
'''最簡單/安全的升級方法就是使用我們的[[ComfortUpdate]]服務。'''

<span id="Upgrade_instructions_(from_2.x_or_newer_to_any_later_version)"></span>
=升級說明（從2.x或更高版本到任何之後的版本）=

請按照以下說明操作：
*備份您的檔案和資料庫([[Upgrading from a previous version/zh-hant#Before you start...|我們之前有提過嗎?]])。
*刪除所有舊文件/資料夾，除了以下檔案：
**/application/config/security.php - '''很重要!!這是 LimeSurvey（版本 4 及更高版本）中所有加密資料的金鑰'''
**/application/config/config.php;
**/upload 目錄

<div class="simplebox">[[File:help.png]]'''Note:''' If you have any customized templates in /upload/templates, make sure you 'refresh' those with any changes that come with the new LimeSurvey version. The easiest way to check for such changes is to file-compare your old template with the new version of the default template. If you see any differences other than your customizations, a refresh is needed.</div>
*Copy the new files from the new LimeSurvey package to the existing location.
*Open the admin page in your browser (e.g. https://www.example.com/limesurvey/admin) and check if a database scheme upgrade is necessary.
*After the upgrade: '''Clear your browser cache and cookies!'''

<span id="Instructions_for_older_versions"></span>
=舊版說明=

不幸的是，有一些事情需要考慮，所以請仔細閱讀以下說明。

==Upgrading from version 1.50 or later to any later 2.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the latest version of LimeSurvey
*Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new files of the new version into the same installation directory
** If your previous version is older than 1.90, copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories (write access to '''/tmp''', '''/upload''', and their subdirectories is required) as described in the [[Installation#Set directory permissions|installation wiki]]
** Open http://<yourdomain>/<yourlimesurveydir>/admin in your browser and follow the instructions (You will find the database data in the old config.php). The existing database will be automatically detected and if necessary, upgraded after confirmation.
* Check if any special manual checks apply as listed below
* '''Now, clear your browser cache and cookies''' and you are good to go

{{Alert|title=Attention|text=請注意，範本結構隨著從 2.0x 更新到 2.50 或更高版本而變化。您的舊模板將不再起作用，因為模板系統現在使用響應式模板。}}

<div class="simplebox">'''Special checks after an upgrade''':
*'''from any earlier version to 2.xx''': Proper question codes are mandatory now. After upgrading the installation, check the survey logic of all surveys and correct the codes where necessary
*'''from a version earlier than v1.53''': When upgrading from a version before v1.53 to the latest version, please check the '''global user rights''' of each user. There was a new '''superadmin''' right introduced in v1.53 that can give a user the same privilege as the master administration account created during the installation. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.
*'''from any earlier version to v2.06''': From 2.05 to 2.06, some unused permissions when editing global permissions for 'surveys' were activated. For example, if a user had only the 'create' permission in 2.05, the other permissions located to the right of 'create' would also get activated with the update to 2.06 (View/read, Update, Delete, Import, Export). Please check whether the admin users got any other global permissions besides the 'original' ones after the update. If yes, please edit them accordingly.
</div>

==Upgrading from version 1.50 or later to any later 1.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the desired version of LimeSurvey
* Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new code version into the same installation directory
** Edit or replace the '''config.php''' file:
*** If your previous version was < 1.70: Edit the new '''config.php''' in order to reflect the changes from the backup '''config.php''' file. '''Do not just overwrite the new '''config.php''' with your old one!'''
*** If your previous version was >= 1.70: Simply replace the new '''config.php''' with your backup '''config.php''' file (as the file format has not changed)
** If your previous version was older than 1.90: Copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories of LimeSurvey (write access to '''/tmp''', '''/upload''', and to their subdirectories is required) as described in the [[Installation#Set Directory permissions|installation wiki]]
* Finish the installation/upgrade process
** Once you open the URL to your LimeSurvey administration, the database tables will be updated after confirmation
** Remove or rename the /admin/install directory as/if instructed by the installation script
** Check if any special manual checks apply (as listed below)

<div class="simplebox">'''Special checks after an upgrade''':
*'''From a version earlier than v1.53''': When upgrading from a version before v1.53 to the latest version, please check the '''global user rights''' of each user. There was a new '''superadmin''' right introduced in v1.53 that can give a user the same privilege as the master administration account created during the install. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.
</div>

<span id="Upgrading_from_a_version_earlier_than_v1.50_(v1.0_through_v1.44)"></span>
==從 v1.50 之前的版本升級（v1.0 到 v1.44）==

Since the data structure and a lot of other things were changed, '''upgrading from any version previous to v1.50 is <u>NOT</u> possible'''. If you have old survey structure files with an *.sql extension, the only way to get these into a newer version is to install [http://www.limesurvey.org/en/archived-releases/289-limesurvey150zip version 1.50], import the .sql file(s) there, then upgrade that version to the most recent LimeSurvey version. Check the page related to [[Transferring an installation|how an installation can be transferred]] for more details.

<span id="Upgrading_using_CLI"></span>
= 使用 CLI 升級 =

You can upgrade the database via the PHP CLI: <code>php application/commands/console.php updatedb</code>. This allows you to set up an auto-upgrade system via command line (for example, in a crontab), although it is not recommended.

= Failed database upgrade after manual update/ComfortUpdate=
Sometimes, even though you did everything correct, things don't work out they are supposed to during database upgrade.
That may happen because of various reasons: Different database versions, unexpected data formats or contents, unusual configurations or anything else that did not show up in our tests (yes, we test a lot!)

If you have an error during database update and your LimeSurvey instance ends up in an unusable state, you want to go back to the previous version.
This assumes that you still have the database and file backup, either from your regular backup or the one created by Comfortupdate.

請執行以下步驟：

*備份現有的 LimeSurvey 目錄和資料庫（是的，再做一次 - 我們叫它第二個備份）
*從原來的(第一個備份)還原檔案到現存的資料夾(直接覆蓋它們沒關係)
*刪除目前的資料庫然後從(第一個備份)還原資料

就是這樣。一切都應該恢復正常。

'''關於報告此問題的說明：'''

如果您遇到這樣的問題，請務必在我們的錯誤追蹤網站裡回報此問題：https://bugs.limesurvey.org

未回報的錯誤就是不會被修復的錯誤。請不要等別人回報此錯誤。如果您發現該錯誤已被回報，您還可以透過在錯誤追蹤器中將其標記為「是的，此錯誤影響我」來幫助提高錯誤的優先順序。

<span id="FAQ"></span>
=常見問題=

<span id="Can_I_upgrade_even_if_I_have_active_surveys?"></span>
==即使我有進行中的問卷，我也可以升級嗎？==

是的你可以升級。上面的詳細說明中可能會提到例外。我們強烈建議您在升級後測試您的問卷，以確定您設計的模板是否可以正常運作。

<span id="How_to_convert_*.sql/*.csv_survey_structure_files_to_the_latest_LimeSurvey_version?"></span>
==如何將*.sql/*.csv問卷結構檔轉換為最新的LimeSurvey版本？==

安裝版本 1.50，匯入文件，並將調查結構匯出成為較新的 .csv 格式。然後安裝最新版本 2.x 並匯入 .csv 格式並將其匯出為目前的 .lss 格式。

==Survey theme incompatibility==
With certain major version updates any custom survey themes will not be compatible, anymore:

* Update from LimeSurvey 2.6 or lower to LimeSurvey 2.50
* Update from LimeSurvey 5.x or lower to LimeSurvey 6.x

==Error "Multiple primary key defined" when updating MySQL database==
If you encounter this error, please check the setting ''sql_generate_invisible_primary_key'' in your MySQL server variables. This is most likely set to ''ON'', but should be set to ''OFF''. Then restore your database from the backup (as explained above) and try again.

Translations:Upgrading from a previous version/24/zh-hant

2024-07-01T16:28:19Z

{{Alert|title=Attention|text=請注意，範本結構隨著從 2.0x 更新到 2.50 或更高版本而變化。您的舊模板將不再起作用，因為模板系統現在使用響應式模板。}}

Upgrading from a previous version/zh-hant

2024-07-01T14:58:02Z

Rickylu:

<languages /> <div style="float:right;"><div class="simplebox">附加頁：{toc}</div></div> __TOC__

<span id="Before_you_start..."></span>
=開始之前...=

<span style='color:#FF0000'>....閱讀此內容，因為它非常重要：'''務必備份目前的安裝檔案和資料庫！</span>

您可以使用資料庫管理工具例如 [https://www.phpmyadmin.net phpMyAdmin] 和檔案管理器來執行此操作！
如果您不知道怎麼備份，請勿繼續下面的操作並尋找其他人的幫助。

==建議使用 ComfortUpdate==
'''最簡單/安全的升級方法就是使用我們的[[ComfortUpdate]]服務。'''

<span id="Upgrade_instructions_(from_2.x_or_newer_to_any_later_version)"></span>
=升級說明（從2.x或更高版本到任何之後的版本）=

請按照以下說明操作：
*備份您的檔案和資料庫([[Upgrading from a previous version/zh-hant#Before you start...|我們之前有提過嗎?]])。
*刪除所有舊文件/資料夾，除了以下檔案：
**/application/config/security.php - '''很重要!!這是 LimeSurvey（版本 4 及更高版本）中所有加密資料的金鑰'''
**/application/config/config.php;
**/upload 目錄

<div class="simplebox">[[File:help.png]]'''Note:''' If you have any customized templates in /upload/templates, make sure you 'refresh' those with any changes that come with the new LimeSurvey version. The easiest way to check for such changes is to file-compare your old template with the new version of the default template. If you see any differences other than your customizations, a refresh is needed.</div>
*Copy the new files from the new LimeSurvey package to the existing location.
*Open the admin page in your browser (e.g. https://www.example.com/limesurvey/admin) and check if a database scheme upgrade is necessary.
*After the upgrade: '''Clear your browser cache and cookies!'''

<span id="Instructions_for_older_versions"></span>
=舊版說明=

不幸的是，有一些事情需要考慮，所以請仔細閱讀以下說明。

==Upgrading from version 1.50 or later to any later 2.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the latest version of LimeSurvey
*Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new files of the new version into the same installation directory
** If your previous version is older than 1.90, copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories (write access to '''/tmp''', '''/upload''', and their subdirectories is required) as described in the [[Installation#Set directory permissions|installation wiki]]
** Open http://<yourdomain>/<yourlimesurveydir>/admin in your browser and follow the instructions (You will find the database data in the old config.php). The existing database will be automatically detected and if necessary, upgraded after confirmation.
* Check if any special manual checks apply as listed below
* '''Now, clear your browser cache and cookies''' and you are good to go

{{Alert|title=Attention|text=Please note that the template structure has changed with the update from 2.0x to 2.50 or later. Your old templates will not be working anymore as the template system is now using responsive templates.}}

<div class="simplebox">'''Special checks after an upgrade''':
*'''from any earlier version to 2.xx''': Proper question codes are mandatory now. After upgrading the installation, check the survey logic of all surveys and correct the codes where necessary
*'''from a version earlier than v1.53''': When upgrading from a version before v1.53 to the latest version, please check the '''global user rights''' of each user. There was a new '''superadmin''' right introduced in v1.53 that can give a user the same privilege as the master administration account created during the installation. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.
*'''from any earlier version to v2.06''': From 2.05 to 2.06, some unused permissions when editing global permissions for 'surveys' were activated. For example, if a user had only the 'create' permission in 2.05, the other permissions located to the right of 'create' would also get activated with the update to 2.06 (View/read, Update, Delete, Import, Export). Please check whether the admin users got any other global permissions besides the 'original' ones after the update. If yes, please edit them accordingly.
</div>

==Upgrading from version 1.50 or later to any later 1.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the desired version of LimeSurvey
* Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new code version into the same installation directory
** Edit or replace the '''config.php''' file:
*** If your previous version was < 1.70: Edit the new '''config.php''' in order to reflect the changes from the backup '''config.php''' file. '''Do not just overwrite the new '''config.php''' with your old one!'''
*** If your previous version was >= 1.70: Simply replace the new '''config.php''' with your backup '''config.php''' file (as the file format has not changed)
** If your previous version was older than 1.90: Copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories of LimeSurvey (write access to '''/tmp''', '''/upload''', and to their subdirectories is required) as described in the [[Installation#Set Directory permissions|installation wiki]]
* Finish the installation/upgrade process
** Once you open the URL to your LimeSurvey administration, the database tables will be updated after confirmation
** Remove or rename the /admin/install directory as/if instructed by the installation script
** Check if any special manual checks apply (as listed below)

<div class="simplebox">'''Special checks after an upgrade''':
*'''From a version earlier than v1.53''': When upgrading from a version before v1.53 to the latest version, please check the '''global user rights''' of each user. There was a new '''superadmin''' right introduced in v1.53 that can give a user the same privilege as the master administration account created during the install. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.
</div>

<span id="Upgrading_from_a_version_earlier_than_v1.50_(v1.0_through_v1.44)"></span>
==從 v1.50 之前的版本升級（v1.0 到 v1.44）==

Since the data structure and a lot of other things were changed, '''upgrading from any version previous to v1.50 is <u>NOT</u> possible'''. If you have old survey structure files with an *.sql extension, the only way to get these into a newer version is to install [http://www.limesurvey.org/en/archived-releases/289-limesurvey150zip version 1.50], import the .sql file(s) there, then upgrade that version to the most recent LimeSurvey version. Check the page related to [[Transferring an installation|how an installation can be transferred]] for more details.

<span id="Upgrading_using_CLI"></span>
= 使用 CLI 升級 =

You can upgrade the database via the PHP CLI: <code>php application/commands/console.php updatedb</code>. This allows you to set up an auto-upgrade system via command line (for example, in a crontab), although it is not recommended.

= Failed database upgrade after manual update/ComfortUpdate=
Sometimes, even though you did everything correct, things don't work out they are supposed to during database upgrade.
That may happen because of various reasons: Different database versions, unexpected data formats or contents, unusual configurations or anything else that did not show up in our tests (yes, we test a lot!)

If you have an error during database update and your LimeSurvey instance ends up in an unusable state, you want to go back to the previous version.
This assumes that you still have the database and file backup, either from your regular backup or the one created by Comfortupdate.

請執行以下步驟：

*備份現有的 LimeSurvey 目錄和資料庫（是的，再做一次 - 我們叫它第二個備份）
*從原來的(第一個備份)還原檔案到現存的資料夾(直接覆蓋它們沒關係)
*刪除目前的資料庫然後從(第一個備份)還原資料

就是這樣。一切都應該恢復正常。

'''關於報告此問題的說明：'''

如果您遇到這樣的問題，請務必在我們的錯誤追蹤網站裡回報此問題：https://bugs.limesurvey.org

未回報的錯誤就是不會被修復的錯誤。請不要等別人回報此錯誤。如果您發現該錯誤已被回報，您還可以透過在錯誤追蹤器中將其標記為「是的，此錯誤影響我」來幫助提高錯誤的優先順序。

<span id="FAQ"></span>
=常見問題=

<span id="Can_I_upgrade_even_if_I_have_active_surveys?"></span>
==即使我有進行中的問卷，我也可以升級嗎？==

是的你可以升級。上面的詳細說明中可能會提到例外。我們強烈建議您在升級後測試您的問卷，以確定您設計的模板是否可以正常運作。

<span id="How_to_convert_*.sql/*.csv_survey_structure_files_to_the_latest_LimeSurvey_version?"></span>
==如何將*.sql/*.csv問卷結構檔轉換為最新的LimeSurvey版本？==

安裝版本 1.50，匯入文件，並將調查結構匯出成為較新的 .csv 格式。然後安裝最新版本 2.x 並匯入 .csv 格式並將其匯出為目前的 .lss 格式。

==Survey theme incompatibility==
With certain major version updates any custom survey themes will not be compatible, anymore:

* Update from LimeSurvey 2.6 or lower to LimeSurvey 2.50
* Update from LimeSurvey 5.x or lower to LimeSurvey 6.x

==Error "Multiple primary key defined" when updating MySQL database==
If you encounter this error, please check the setting ''sql_generate_invisible_primary_key'' in your MySQL server variables. This is most likely set to ''ON'', but should be set to ''OFF''. Then restore your database from the backup (as explained above) and try again.

Translations:Upgrading from a previous version/32/zh-hant

2024-07-01T14:57:46Z

Rickylu:

*備份現有的 LimeSurvey 目錄和資料庫（是的，再做一次 - 我們叫它第二個備份）
*從原來的(第一個備份)還原檔案到現存的資料夾(直接覆蓋它們沒關係)
*刪除目前的資料庫然後從(第一個備份)還原資料

Upgrading from a previous version/zh-hant

2024-07-01T14:57:02Z

Rickylu: Created page with "*備份現有的 LimeSurvey 目錄和資料庫（是的，再做一次 - 我們叫它第二個備份） *從原來的第一個備份還原檔案到現存的資料夾(直接覆蓋它們沒關係) *刪除目前的資料庫然後從第一個備份還原資料"

<languages /> <div style="float:right;"><div class="simplebox">附加頁：{toc}</div></div> __TOC__

<span id="Before_you_start..."></span>
=開始之前...=

<span style='color:#FF0000'>....閱讀此內容，因為它非常重要：'''務必備份目前的安裝檔案和資料庫！</span>

您可以使用資料庫管理工具例如 [https://www.phpmyadmin.net phpMyAdmin] 和檔案管理器來執行此操作！
如果您不知道怎麼備份，請勿繼續下面的操作並尋找其他人的幫助。

==建議使用 ComfortUpdate==
'''最簡單/安全的升級方法就是使用我們的[[ComfortUpdate]]服務。'''

<span id="Upgrade_instructions_(from_2.x_or_newer_to_any_later_version)"></span>
=升級說明（從2.x或更高版本到任何之後的版本）=

請按照以下說明操作：
*備份您的檔案和資料庫([[Upgrading from a previous version/zh-hant#Before you start...|我們之前有提過嗎?]])。
*刪除所有舊文件/資料夾，除了以下檔案：
**/application/config/security.php - '''很重要!!這是 LimeSurvey（版本 4 及更高版本）中所有加密資料的金鑰'''
**/application/config/config.php;
**/upload 目錄

<div class="simplebox">[[File:help.png]]'''Note:''' If you have any customized templates in /upload/templates, make sure you 'refresh' those with any changes that come with the new LimeSurvey version. The easiest way to check for such changes is to file-compare your old template with the new version of the default template. If you see any differences other than your customizations, a refresh is needed.</div>
*Copy the new files from the new LimeSurvey package to the existing location.
*Open the admin page in your browser (e.g. https://www.example.com/limesurvey/admin) and check if a database scheme upgrade is necessary.
*After the upgrade: '''Clear your browser cache and cookies!'''

<span id="Instructions_for_older_versions"></span>
=舊版說明=

不幸的是，有一些事情需要考慮，所以請仔細閱讀以下說明。

==Upgrading from version 1.50 or later to any later 2.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the latest version of LimeSurvey
*Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new files of the new version into the same installation directory
** If your previous version is older than 1.90, copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories (write access to '''/tmp''', '''/upload''', and their subdirectories is required) as described in the [[Installation#Set directory permissions|installation wiki]]
** Open http://<yourdomain>/<yourlimesurveydir>/admin in your browser and follow the instructions (You will find the database data in the old config.php). The existing database will be automatically detected and if necessary, upgraded after confirmation.
* Check if any special manual checks apply as listed below
* '''Now, clear your browser cache and cookies''' and you are good to go

{{Alert|title=Attention|text=Please note that the template structure has changed with the update from 2.0x to 2.50 or later. Your old templates will not be working anymore as the template system is now using responsive templates.}}

<div class="simplebox">'''Special checks after an upgrade''':
*'''from any earlier version to 2.xx''': Proper question codes are mandatory now. After upgrading the installation, check the survey logic of all surveys and correct the codes where necessary
*'''from a version earlier than v1.53''': When upgrading from a version before v1.53 to the latest version, please check the '''global user rights''' of each user. There was a new '''superadmin''' right introduced in v1.53 that can give a user the same privilege as the master administration account created during the installation. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.
*'''from any earlier version to v2.06''': From 2.05 to 2.06, some unused permissions when editing global permissions for 'surveys' were activated. For example, if a user had only the 'create' permission in 2.05, the other permissions located to the right of 'create' would also get activated with the update to 2.06 (View/read, Update, Delete, Import, Export). Please check whether the admin users got any other global permissions besides the 'original' ones after the update. If yes, please edit them accordingly.
</div>

==Upgrading from version 1.50 or later to any later 1.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the desired version of LimeSurvey
* Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new code version into the same installation directory
** Edit or replace the '''config.php''' file:
*** If your previous version was < 1.70: Edit the new '''config.php''' in order to reflect the changes from the backup '''config.php''' file. '''Do not just overwrite the new '''config.php''' with your old one!'''
*** If your previous version was >= 1.70: Simply replace the new '''config.php''' with your backup '''config.php''' file (as the file format has not changed)
** If your previous version was older than 1.90: Copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories of LimeSurvey (write access to '''/tmp''', '''/upload''', and to their subdirectories is required) as described in the [[Installation#Set Directory permissions|installation wiki]]
* Finish the installation/upgrade process
** Once you open the URL to your LimeSurvey administration, the database tables will be updated after confirmation
** Remove or rename the /admin/install directory as/if instructed by the installation script
** Check if any special manual checks apply (as listed below)

<div class="simplebox">'''Special checks after an upgrade''':
*'''From a version earlier than v1.53''': When upgrading from a version before v1.53 to the latest version, please check the '''global user rights''' of each user. There was a new '''superadmin''' right introduced in v1.53 that can give a user the same privilege as the master administration account created during the install. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.
</div>

<span id="Upgrading_from_a_version_earlier_than_v1.50_(v1.0_through_v1.44)"></span>
==從 v1.50 之前的版本升級（v1.0 到 v1.44）==

Since the data structure and a lot of other things were changed, '''upgrading from any version previous to v1.50 is <u>NOT</u> possible'''. If you have old survey structure files with an *.sql extension, the only way to get these into a newer version is to install [http://www.limesurvey.org/en/archived-releases/289-limesurvey150zip version 1.50], import the .sql file(s) there, then upgrade that version to the most recent LimeSurvey version. Check the page related to [[Transferring an installation|how an installation can be transferred]] for more details.

<span id="Upgrading_using_CLI"></span>
= 使用 CLI 升級 =

You can upgrade the database via the PHP CLI: <code>php application/commands/console.php updatedb</code>. This allows you to set up an auto-upgrade system via command line (for example, in a crontab), although it is not recommended.

= Failed database upgrade after manual update/ComfortUpdate=
Sometimes, even though you did everything correct, things don't work out they are supposed to during database upgrade.
That may happen because of various reasons: Different database versions, unexpected data formats or contents, unusual configurations or anything else that did not show up in our tests (yes, we test a lot!)

If you have an error during database update and your LimeSurvey instance ends up in an unusable state, you want to go back to the previous version.
This assumes that you still have the database and file backup, either from your regular backup or the one created by Comfortupdate.

請執行以下步驟：

*備份現有的 LimeSurvey 目錄和資料庫（是的，再做一次 - 我們叫它第二個備份）
*從原來的第一個備份還原檔案到現存的資料夾(直接覆蓋它們沒關係)
*刪除目前的資料庫然後從第一個備份還原資料

就是這樣。一切都應該恢復正常。

'''關於報告此問題的說明：'''

如果您遇到這樣的問題，請務必在我們的錯誤追蹤網站裡回報此問題：https://bugs.limesurvey.org

未回報的錯誤就是不會被修復的錯誤。請不要等別人回報此錯誤。如果您發現該錯誤已被回報，您還可以透過在錯誤追蹤器中將其標記為「是的，此錯誤影響我」來幫助提高錯誤的優先順序。

<span id="FAQ"></span>
=常見問題=

<span id="Can_I_upgrade_even_if_I_have_active_surveys?"></span>
==即使我有進行中的問卷，我也可以升級嗎？==

是的你可以升級。上面的詳細說明中可能會提到例外。我們強烈建議您在升級後測試您的問卷，以確定您設計的模板是否可以正常運作。

<span id="How_to_convert_*.sql/*.csv_survey_structure_files_to_the_latest_LimeSurvey_version?"></span>
==如何將*.sql/*.csv問卷結構檔轉換為最新的LimeSurvey版本？==

安裝版本 1.50，匯入文件，並將調查結構匯出成為較新的 .csv 格式。然後安裝最新版本 2.x 並匯入 .csv 格式並將其匯出為目前的 .lss 格式。

==Survey theme incompatibility==
With certain major version updates any custom survey themes will not be compatible, anymore:

* Update from LimeSurvey 2.6 or lower to LimeSurvey 2.50
* Update from LimeSurvey 5.x or lower to LimeSurvey 6.x

==Error "Multiple primary key defined" when updating MySQL database==
If you encounter this error, please check the setting ''sql_generate_invisible_primary_key'' in your MySQL server variables. This is most likely set to ''ON'', but should be set to ''OFF''. Then restore your database from the backup (as explained above) and try again.

Translations:Upgrading from a previous version/32/zh-hant

2024-07-01T14:56:42Z

*備份現有的 LimeSurvey 目錄和資料庫（是的，再做一次 - 我們叫它第二個備份）
*從原來的第一個備份還原檔案到現存的資料夾(直接覆蓋它們沒關係)
*刪除目前的資料庫然後從第一個備份還原資料

Upgrading from a previous version/zh-hant

2024-07-01T14:52:01Z

Rickylu: Created page with "未回報的錯誤就是不會被修復的錯誤。請不要等別人回報此錯誤。如果您發現該錯誤已被回報，您還可以透過在錯誤追蹤器中將其標記為「是的，此錯誤影響我」來幫助提高錯誤的優先順序。"

<languages /> <div style="float:right;"><div class="simplebox">附加頁：{toc}</div></div> __TOC__

<span id="Before_you_start..."></span>
=開始之前...=

<span style='color:#FF0000'>....閱讀此內容，因為它非常重要：'''務必備份目前的安裝檔案和資料庫！</span>

您可以使用資料庫管理工具例如 [https://www.phpmyadmin.net phpMyAdmin] 和檔案管理器來執行此操作！
如果您不知道怎麼備份，請勿繼續下面的操作並尋找其他人的幫助。

==建議使用 ComfortUpdate==
'''最簡單/安全的升級方法就是使用我們的[[ComfortUpdate]]服務。'''

<span id="Upgrade_instructions_(from_2.x_or_newer_to_any_later_version)"></span>
=升級說明（從2.x或更高版本到任何之後的版本）=

請按照以下說明操作：
*備份您的檔案和資料庫([[Upgrading from a previous version/zh-hant#Before you start...|我們之前有提過嗎?]])。
*刪除所有舊文件/資料夾，除了以下檔案：
**/application/config/security.php - '''很重要!!這是 LimeSurvey（版本 4 及更高版本）中所有加密資料的金鑰'''
**/application/config/config.php;
**/upload 目錄

<div class="simplebox">[[File:help.png]]'''Note:''' If you have any customized templates in /upload/templates, make sure you 'refresh' those with any changes that come with the new LimeSurvey version. The easiest way to check for such changes is to file-compare your old template with the new version of the default template. If you see any differences other than your customizations, a refresh is needed.</div>
*Copy the new files from the new LimeSurvey package to the existing location.
*Open the admin page in your browser (e.g. https://www.example.com/limesurvey/admin) and check if a database scheme upgrade is necessary.
*After the upgrade: '''Clear your browser cache and cookies!'''

<span id="Instructions_for_older_versions"></span>
=舊版說明=

不幸的是，有一些事情需要考慮，所以請仔細閱讀以下說明。

==Upgrading from version 1.50 or later to any later 2.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the latest version of LimeSurvey
*Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new files of the new version into the same installation directory
** If your previous version is older than 1.90, copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories (write access to '''/tmp''', '''/upload''', and their subdirectories is required) as described in the [[Installation#Set directory permissions|installation wiki]]
** Open http://<yourdomain>/<yourlimesurveydir>/admin in your browser and follow the instructions (You will find the database data in the old config.php). The existing database will be automatically detected and if necessary, upgraded after confirmation.
* Check if any special manual checks apply as listed below
* '''Now, clear your browser cache and cookies''' and you are good to go

{{Alert|title=Attention|text=Please note that the template structure has changed with the update from 2.0x to 2.50 or later. Your old templates will not be working anymore as the template system is now using responsive templates.}}

<div class="simplebox">'''Special checks after an upgrade''':
*'''from any earlier version to 2.xx''': Proper question codes are mandatory now. After upgrading the installation, check the survey logic of all surveys and correct the codes where necessary
*'''from a version earlier than v1.53''': When upgrading from a version before v1.53 to the latest version, please check the '''global user rights''' of each user. There was a new '''superadmin''' right introduced in v1.53 that can give a user the same privilege as the master administration account created during the installation. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.
*'''from any earlier version to v2.06''': From 2.05 to 2.06, some unused permissions when editing global permissions for 'surveys' were activated. For example, if a user had only the 'create' permission in 2.05, the other permissions located to the right of 'create' would also get activated with the update to 2.06 (View/read, Update, Delete, Import, Export). Please check whether the admin users got any other global permissions besides the 'original' ones after the update. If yes, please edit them accordingly.
</div>

==Upgrading from version 1.50 or later to any later 1.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the desired version of LimeSurvey
* Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new code version into the same installation directory
** Edit or replace the '''config.php''' file:
*** If your previous version was < 1.70: Edit the new '''config.php''' in order to reflect the changes from the backup '''config.php''' file. '''Do not just overwrite the new '''config.php''' with your old one!'''
*** If your previous version was >= 1.70: Simply replace the new '''config.php''' with your backup '''config.php''' file (as the file format has not changed)
** If your previous version was older than 1.90: Copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories of LimeSurvey (write access to '''/tmp''', '''/upload''', and to their subdirectories is required) as described in the [[Installation#Set Directory permissions|installation wiki]]
* Finish the installation/upgrade process
** Once you open the URL to your LimeSurvey administration, the database tables will be updated after confirmation
** Remove or rename the /admin/install directory as/if instructed by the installation script
** Check if any special manual checks apply (as listed below)

<div class="simplebox">'''Special checks after an upgrade''':
*'''From a version earlier than v1.53''': When upgrading from a version before v1.53 to the latest version, please check the '''global user rights''' of each user. There was a new '''superadmin''' right introduced in v1.53 that can give a user the same privilege as the master administration account created during the install. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.
</div>

<span id="Upgrading_from_a_version_earlier_than_v1.50_(v1.0_through_v1.44)"></span>
==從 v1.50 之前的版本升級（v1.0 到 v1.44）==

Since the data structure and a lot of other things were changed, '''upgrading from any version previous to v1.50 is <u>NOT</u> possible'''. If you have old survey structure files with an *.sql extension, the only way to get these into a newer version is to install [http://www.limesurvey.org/en/archived-releases/289-limesurvey150zip version 1.50], import the .sql file(s) there, then upgrade that version to the most recent LimeSurvey version. Check the page related to [[Transferring an installation|how an installation can be transferred]] for more details.

<span id="Upgrading_using_CLI"></span>
= 使用 CLI 升級 =

You can upgrade the database via the PHP CLI: <code>php application/commands/console.php updatedb</code>. This allows you to set up an auto-upgrade system via command line (for example, in a crontab), although it is not recommended.

= Failed database upgrade after manual update/ComfortUpdate=
Sometimes, even though you did everything correct, things don't work out they are supposed to during database upgrade.
That may happen because of various reasons: Different database versions, unexpected data formats or contents, unusual configurations or anything else that did not show up in our tests (yes, we test a lot!)

If you have an error during database update and your LimeSurvey instance ends up in an unusable state, you want to go back to the previous version.
This assumes that you still have the database and file backup, either from your regular backup or the one created by Comfortupdate.

請執行以下步驟：

*Backup the existing LimeSurvey directory and database (yes, again - we will call this the 2nd backup)
*Restore files to the existing directory (just overwriting them is fine) from the original (1st) backup.
*Delete the old database and restore the database from the original (1st) backup.

就是這樣。一切都應該恢復正常。

'''關於報告此問題的說明：'''

如果您遇到這樣的問題，請務必在我們的錯誤追蹤網站裡回報此問題：https://bugs.limesurvey.org

未回報的錯誤就是不會被修復的錯誤。請不要等別人回報此錯誤。如果您發現該錯誤已被回報，您還可以透過在錯誤追蹤器中將其標記為「是的，此錯誤影響我」來幫助提高錯誤的優先順序。

<span id="FAQ"></span>
=常見問題=

<span id="Can_I_upgrade_even_if_I_have_active_surveys?"></span>
==即使我有進行中的問卷，我也可以升級嗎？==

是的你可以升級。上面的詳細說明中可能會提到例外。我們強烈建議您在升級後測試您的問卷，以確定您設計的模板是否可以正常運作。

<span id="How_to_convert_*.sql/*.csv_survey_structure_files_to_the_latest_LimeSurvey_version?"></span>
==如何將*.sql/*.csv問卷結構檔轉換為最新的LimeSurvey版本？==

安裝版本 1.50，匯入文件，並將調查結構匯出成為較新的 .csv 格式。然後安裝最新版本 2.x 並匯入 .csv 格式並將其匯出為目前的 .lss 格式。

==Survey theme incompatibility==
With certain major version updates any custom survey themes will not be compatible, anymore:

* Update from LimeSurvey 2.6 or lower to LimeSurvey 2.50
* Update from LimeSurvey 5.x or lower to LimeSurvey 6.x

==Error "Multiple primary key defined" when updating MySQL database==
If you encounter this error, please check the setting ''sql_generate_invisible_primary_key'' in your MySQL server variables. This is most likely set to ''ON'', but should be set to ''OFF''. Then restore your database from the backup (as explained above) and try again.

Translations:Upgrading from a previous version/36/zh-hant

2024-07-01T14:51:09Z

未回報的錯誤就是不會被修復的錯誤。請不要等別人回報此錯誤。如果您發現該錯誤已被回報，您還可以透過在錯誤追蹤器中將其標記為「是的，此錯誤影響我」來幫助提高錯誤的優先順序。

Upgrading from a previous version/zh-hant

2024-07-01T14:49:02Z

Rickylu:

<languages /> <div style="float:right;"><div class="simplebox">附加頁：{toc}</div></div> __TOC__

<span id="Before_you_start..."></span>
=開始之前...=

<span style='color:#FF0000'>....閱讀此內容，因為它非常重要：'''務必備份目前的安裝檔案和資料庫！</span>

您可以使用資料庫管理工具例如 [https://www.phpmyadmin.net phpMyAdmin] 和檔案管理器來執行此操作！
如果您不知道怎麼備份，請勿繼續下面的操作並尋找其他人的幫助。

==建議使用 ComfortUpdate==
'''最簡單/安全的升級方法就是使用我們的[[ComfortUpdate]]服務。'''

<span id="Upgrade_instructions_(from_2.x_or_newer_to_any_later_version)"></span>
=升級說明（從2.x或更高版本到任何之後的版本）=

請按照以下說明操作：
*備份您的檔案和資料庫([[Upgrading from a previous version/zh-hant#Before you start...|我們之前有提過嗎?]])。
*刪除所有舊文件/資料夾，除了以下檔案：
**/application/config/security.php - '''很重要!!這是 LimeSurvey（版本 4 及更高版本）中所有加密資料的金鑰'''
**/application/config/config.php;
**/upload 目錄

<div class="simplebox">[[File:help.png]]'''Note:''' If you have any customized templates in /upload/templates, make sure you 'refresh' those with any changes that come with the new LimeSurvey version. The easiest way to check for such changes is to file-compare your old template with the new version of the default template. If you see any differences other than your customizations, a refresh is needed.</div>
*Copy the new files from the new LimeSurvey package to the existing location.
*Open the admin page in your browser (e.g. https://www.example.com/limesurvey/admin) and check if a database scheme upgrade is necessary.
*After the upgrade: '''Clear your browser cache and cookies!'''

<span id="Instructions_for_older_versions"></span>
=舊版說明=

不幸的是，有一些事情需要考慮，所以請仔細閱讀以下說明。

==Upgrading from version 1.50 or later to any later 2.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the latest version of LimeSurvey
*Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new files of the new version into the same installation directory
** If your previous version is older than 1.90, copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories (write access to '''/tmp''', '''/upload''', and their subdirectories is required) as described in the [[Installation#Set directory permissions|installation wiki]]
** Open http://<yourdomain>/<yourlimesurveydir>/admin in your browser and follow the instructions (You will find the database data in the old config.php). The existing database will be automatically detected and if necessary, upgraded after confirmation.
* Check if any special manual checks apply as listed below
* '''Now, clear your browser cache and cookies''' and you are good to go

{{Alert|title=Attention|text=Please note that the template structure has changed with the update from 2.0x to 2.50 or later. Your old templates will not be working anymore as the template system is now using responsive templates.}}

<div class="simplebox">'''Special checks after an upgrade''':
*'''from any earlier version to 2.xx''': Proper question codes are mandatory now. After upgrading the installation, check the survey logic of all surveys and correct the codes where necessary
*'''from a version earlier than v1.53''': When upgrading from a version before v1.53 to the latest version, please check the '''global user rights''' of each user. There was a new '''superadmin''' right introduced in v1.53 that can give a user the same privilege as the master administration account created during the installation. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.
*'''from any earlier version to v2.06''': From 2.05 to 2.06, some unused permissions when editing global permissions for 'surveys' were activated. For example, if a user had only the 'create' permission in 2.05, the other permissions located to the right of 'create' would also get activated with the update to 2.06 (View/read, Update, Delete, Import, Export). Please check whether the admin users got any other global permissions besides the 'original' ones after the update. If yes, please edit them accordingly.
</div>

==Upgrading from version 1.50 or later to any later 1.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the desired version of LimeSurvey
* Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new code version into the same installation directory
** Edit or replace the '''config.php''' file:
*** If your previous version was < 1.70: Edit the new '''config.php''' in order to reflect the changes from the backup '''config.php''' file. '''Do not just overwrite the new '''config.php''' with your old one!'''
*** If your previous version was >= 1.70: Simply replace the new '''config.php''' with your backup '''config.php''' file (as the file format has not changed)
** If your previous version was older than 1.90: Copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories of LimeSurvey (write access to '''/tmp''', '''/upload''', and to their subdirectories is required) as described in the [[Installation#Set Directory permissions|installation wiki]]
* Finish the installation/upgrade process
** Once you open the URL to your LimeSurvey administration, the database tables will be updated after confirmation
** Remove or rename the /admin/install directory as/if instructed by the installation script
** Check if any special manual checks apply (as listed below)

<div class="simplebox">'''Special checks after an upgrade''':
*'''From a version earlier than v1.53''': When upgrading from a version before v1.53 to the latest version, please check the '''global user rights''' of each user. There was a new '''superadmin''' right introduced in v1.53 that can give a user the same privilege as the master administration account created during the install. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.
</div>

<span id="Upgrading_from_a_version_earlier_than_v1.50_(v1.0_through_v1.44)"></span>
==從 v1.50 之前的版本升級（v1.0 到 v1.44）==

Since the data structure and a lot of other things were changed, '''upgrading from any version previous to v1.50 is <u>NOT</u> possible'''. If you have old survey structure files with an *.sql extension, the only way to get these into a newer version is to install [http://www.limesurvey.org/en/archived-releases/289-limesurvey150zip version 1.50], import the .sql file(s) there, then upgrade that version to the most recent LimeSurvey version. Check the page related to [[Transferring an installation|how an installation can be transferred]] for more details.

<span id="Upgrading_using_CLI"></span>
= 使用 CLI 升級 =

You can upgrade the database via the PHP CLI: <code>php application/commands/console.php updatedb</code>. This allows you to set up an auto-upgrade system via command line (for example, in a crontab), although it is not recommended.

= Failed database upgrade after manual update/ComfortUpdate=
Sometimes, even though you did everything correct, things don't work out they are supposed to during database upgrade.
That may happen because of various reasons: Different database versions, unexpected data formats or contents, unusual configurations or anything else that did not show up in our tests (yes, we test a lot!)

If you have an error during database update and your LimeSurvey instance ends up in an unusable state, you want to go back to the previous version.
This assumes that you still have the database and file backup, either from your regular backup or the one created by Comfortupdate.

請執行以下步驟：

*Backup the existing LimeSurvey directory and database (yes, again - we will call this the 2nd backup)
*Restore files to the existing directory (just overwriting them is fine) from the original (1st) backup.
*Delete the old database and restore the database from the original (1st) backup.

就是這樣。一切都應該恢復正常。

'''關於報告此問題的說明：'''

如果您遇到這樣的問題，請務必在我們的錯誤追蹤網站裡回報此問題：https://bugs.limesurvey.org

A bug not reported is a bug not fixed. Please don't just rely on other people reporting it. If you see that the bug is already reported, you can also help to raise the bug priority by marking it as 'Yes, this bug affects me' in the bug tracker.

<span id="FAQ"></span>
=常見問題=

<span id="Can_I_upgrade_even_if_I_have_active_surveys?"></span>
==即使我有進行中的問卷，我也可以升級嗎？==

是的你可以升級。上面的詳細說明中可能會提到例外。我們強烈建議您在升級後測試您的問卷，以確定您設計的模板是否可以正常運作。

<span id="How_to_convert_*.sql/*.csv_survey_structure_files_to_the_latest_LimeSurvey_version?"></span>
==如何將*.sql/*.csv問卷結構檔轉換為最新的LimeSurvey版本？==

安裝版本 1.50，匯入文件，並將調查結構匯出成為較新的 .csv 格式。然後安裝最新版本 2.x 並匯入 .csv 格式並將其匯出為目前的 .lss 格式。

==Survey theme incompatibility==
With certain major version updates any custom survey themes will not be compatible, anymore:

* Update from LimeSurvey 2.6 or lower to LimeSurvey 2.50
* Update from LimeSurvey 5.x or lower to LimeSurvey 6.x

==Error "Multiple primary key defined" when updating MySQL database==
If you encounter this error, please check the setting ''sql_generate_invisible_primary_key'' in your MySQL server variables. This is most likely set to ''ON'', but should be set to ''OFF''. Then restore your database from the backup (as explained above) and try again.

Translations:Upgrading from a previous version/35/zh-hant

2024-07-01T14:48:22Z

Rickylu:

如果您遇到這樣的問題，請務必在我們的錯誤追蹤網站裡回報此問題：https://bugs.limesurvey.org

Upgrading from a previous version/zh-hant

2024-07-01T14:47:01Z

Rickylu: Created page with "安裝版本 1.50，匯入文件，並將調查結構匯出成為較新的 .csv 格式。然後安裝最新版本 2.x 並匯入 .csv 格式並將其匯出為目前的 .lss 格式。"

<languages /> <div style="float:right;"><div class="simplebox">附加頁：{toc}</div></div> __TOC__

<span id="Before_you_start..."></span>
=開始之前...=

<span style='color:#FF0000'>....閱讀此內容，因為它非常重要：'''務必備份目前的安裝檔案和資料庫！</span>

您可以使用資料庫管理工具例如 [https://www.phpmyadmin.net phpMyAdmin] 和檔案管理器來執行此操作！
如果您不知道怎麼備份，請勿繼續下面的操作並尋找其他人的幫助。

==建議使用 ComfortUpdate==
'''最簡單/安全的升級方法就是使用我們的[[ComfortUpdate]]服務。'''

<span id="Upgrade_instructions_(from_2.x_or_newer_to_any_later_version)"></span>
=升級說明（從2.x或更高版本到任何之後的版本）=

請按照以下說明操作：
*備份您的檔案和資料庫([[Upgrading from a previous version/zh-hant#Before you start...|我們之前有提過嗎?]])。
*刪除所有舊文件/資料夾，除了以下檔案：
**/application/config/security.php - '''很重要!!這是 LimeSurvey（版本 4 及更高版本）中所有加密資料的金鑰'''
**/application/config/config.php;
**/upload 目錄

<div class="simplebox">[[File:help.png]]'''Note:''' If you have any customized templates in /upload/templates, make sure you 'refresh' those with any changes that come with the new LimeSurvey version. The easiest way to check for such changes is to file-compare your old template with the new version of the default template. If you see any differences other than your customizations, a refresh is needed.</div>
*Copy the new files from the new LimeSurvey package to the existing location.
*Open the admin page in your browser (e.g. https://www.example.com/limesurvey/admin) and check if a database scheme upgrade is necessary.
*After the upgrade: '''Clear your browser cache and cookies!'''

<span id="Instructions_for_older_versions"></span>
=舊版說明=

不幸的是，有一些事情需要考慮，所以請仔細閱讀以下說明。

==Upgrading from version 1.50 or later to any later 2.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the latest version of LimeSurvey
*Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new files of the new version into the same installation directory
** If your previous version is older than 1.90, copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories (write access to '''/tmp''', '''/upload''', and their subdirectories is required) as described in the [[Installation#Set directory permissions|installation wiki]]
** Open http://<yourdomain>/<yourlimesurveydir>/admin in your browser and follow the instructions (You will find the database data in the old config.php). The existing database will be automatically detected and if necessary, upgraded after confirmation.
* Check if any special manual checks apply as listed below
* '''Now, clear your browser cache and cookies''' and you are good to go

{{Alert|title=Attention|text=Please note that the template structure has changed with the update from 2.0x to 2.50 or later. Your old templates will not be working anymore as the template system is now using responsive templates.}}

<div class="simplebox">'''Special checks after an upgrade''':
*'''from any earlier version to 2.xx''': Proper question codes are mandatory now. After upgrading the installation, check the survey logic of all surveys and correct the codes where necessary
*'''from a version earlier than v1.53''': When upgrading from a version before v1.53 to the latest version, please check the '''global user rights''' of each user. There was a new '''superadmin''' right introduced in v1.53 that can give a user the same privilege as the master administration account created during the installation. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.
*'''from any earlier version to v2.06''': From 2.05 to 2.06, some unused permissions when editing global permissions for 'surveys' were activated. For example, if a user had only the 'create' permission in 2.05, the other permissions located to the right of 'create' would also get activated with the update to 2.06 (View/read, Update, Delete, Import, Export). Please check whether the admin users got any other global permissions besides the 'original' ones after the update. If yes, please edit them accordingly.
</div>

==Upgrading from version 1.50 or later to any later 1.xx version==
*[https://www.limesurvey.org/about-limesurvey/download Download] the desired version of LimeSurvey
* Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
* Replace all the installation directory files
** Delete all old files in the existing installation directory
** Upload and unpack the new code version into the same installation directory
** Edit or replace the '''config.php''' file:
*** If your previous version was < 1.70: Edit the new '''config.php''' in order to reflect the changes from the backup '''config.php''' file. '''Do not just overwrite the new '''config.php''' with your old one!'''
*** If your previous version was >= 1.70: Simply replace the new '''config.php''' with your backup '''config.php''' file (as the file format has not changed)
** If your previous version was older than 1.90: Copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
** Copy your /upload directory back to the old location
** Double-check the '''permissions''' set on the directories of LimeSurvey (write access to '''/tmp''', '''/upload''', and to their subdirectories is required) as described in the [[Installation#Set Directory permissions|installation wiki]]
* Finish the installation/upgrade process
** Once you open the URL to your LimeSurvey administration, the database tables will be updated after confirmation
** Remove or rename the /admin/install directory as/if instructed by the installation script
** Check if any special manual checks apply (as listed below)

<div class="simplebox">'''Special checks after an upgrade''':
*'''From a version earlier than v1.53''': When upgrading from a version before v1.53 to the latest version, please check the '''global user rights''' of each user. There was a new '''superadmin''' right introduced in v1.53 that can give a user the same privilege as the master administration account created during the install. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.
</div>

<span id="Upgrading_from_a_version_earlier_than_v1.50_(v1.0_through_v1.44)"></span>
==從 v1.50 之前的版本升級（v1.0 到 v1.44）==

Since the data structure and a lot of other things were changed, '''upgrading from any version previous to v1.50 is <u>NOT</u> possible'''. If you have old survey structure files with an *.sql extension, the only way to get these into a newer version is to install [http://www.limesurvey.org/en/archived-releases/289-limesurvey150zip version 1.50], import the .sql file(s) there, then upgrade that version to the most recent LimeSurvey version. Check the page related to [[Transferring an installation|how an installation can be transferred]] for more details.

<span id="Upgrading_using_CLI"></span>
= 使用 CLI 升級 =

You can upgrade the database via the PHP CLI: <code>php application/commands/console.php updatedb</code>. This allows you to set up an auto-upgrade system via command line (for example, in a crontab), although it is not recommended.

= Failed database upgrade after manual update/ComfortUpdate=
Sometimes, even though you did everything correct, things don't work out they are supposed to during database upgrade.
That may happen because of various reasons: Different database versions, unexpected data formats or contents, unusual configurations or anything else that did not show up in our tests (yes, we test a lot!)

If you have an error during database update and your LimeSurvey instance ends up in an unusable state, you want to go back to the previous version.
This assumes that you still have the database and file backup, either from your regular backup or the one created by Comfortupdate.

請執行以下步驟：

*Backup the existing LimeSurvey directory and database (yes, again - we will call this the 2nd backup)
*Restore files to the existing directory (just overwriting them is fine) from the original (1st) backup.
*Delete the old database and restore the database from the original (1st) backup.

就是這樣。一切都應該恢復正常。

'''關於報告此問題的說明：'''

如果您遇到這樣的問題，請務必在我們的錯誤追蹤中回報此問題：https://bugs.limesurvey.org

A bug not reported is a bug not fixed. Please don't just rely on other people reporting it. If you see that the bug is already reported, you can also help to raise the bug priority by marking it as 'Yes, this bug affects me' in the bug tracker.

<span id="FAQ"></span>
=常見問題=

<span id="Can_I_upgrade_even_if_I_have_active_surveys?"></span>
==即使我有進行中的問卷，我也可以升級嗎？==

是的你可以升級。上面的詳細說明中可能會提到例外。我們強烈建議您在升級後測試您的問卷，以確定您設計的模板是否可以正常運作。

<span id="How_to_convert_*.sql/*.csv_survey_structure_files_to_the_latest_LimeSurvey_version?"></span>
==如何將*.sql/*.csv問卷結構檔轉換為最新的LimeSurvey版本？==

安裝版本 1.50，匯入文件，並將調查結構匯出成為較新的 .csv 格式。然後安裝最新版本 2.x 並匯入 .csv 格式並將其匯出為目前的 .lss 格式。

==Survey theme incompatibility==
With certain major version updates any custom survey themes will not be compatible, anymore:

* Update from LimeSurvey 2.6 or lower to LimeSurvey 2.50
* Update from LimeSurvey 5.x or lower to LimeSurvey 6.x

==Error "Multiple primary key defined" when updating MySQL database==
If you encounter this error, please check the setting ''sql_generate_invisible_primary_key'' in your MySQL server variables. This is most likely set to ''ON'', but should be set to ''OFF''. Then restore your database from the backup (as explained above) and try again.