Actions

Installation - LimeSurvey CE/zh-hant: Difference between revisions

From LimeSurvey Manual

(Updating to match new version of source page)
(Updating to match new version of source page)
 
(19 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages />
<languages />
__TOC__


<div class="simplebox"> Note: These installation instructions are for version 2.0 or later. Older instructions for 1.92 can be found [[Installation Version 1.92 or older|here]] and update instructions can be found [[Upgrading from a previous version|here]]. </div>
<div class="simplebox"> Note: These installation instructions are for version 2.0 or later. Older instructions for 1.92 can be found [[Installation Version 1.92 or older|here]] and update instructions can be found [[Upgrading from a previous version|here]]. </div>


=General=
==General==


The LimeSurvey project provides two ways to install LimeSurvey:
The LimeSurvey project provides two ways to install LimeSurvey:
*On your webserver:<br />In this case, just follow the instructions on this page starting with step 1.
*On your webserver:<br />In this case, just follow the instructions on this page starting with step 1.


*On your local Windows PC:<br />You usually only want to install LimeSurvey on your local PC if you want to create surveys locally (mainly for speed or development/test reasons) and upload them later to your live LimeSurvey installation on a web server. We have prepared for this a special package for LimeSurvey which includes the web server, the database, and the LimeSurvey application and [[Installation of the LimeSurvey XAMPP package|instructions how to install it]].
*On your local Windows PC:<br />You usually only want to install LimeSurvey on your local PC if you want to create surveys locally (mainly for speed or development/test reasons) and upload them later to your live LimeSurvey installation on a web server. For this purpose, we have prepared a special LimeSurvey package which includes the web server, the database, the LimeSurvey application, and [[Installation of the LimeSurvey XAMPP package|instructions how to install it]].


<div class="mw-translate-fuzzy">
===1. 你確定 LimeSurvey 能夠在你的網站使用===
===1. 你確定 LimeSurvey 能夠在你的網站使用===
</div>


確定伺服器符合以下全部要求:
確定伺服器符合以下全部要求:
Line 16: Line 20:
{{Note|The minimum set of requirements will also be checked during the installation process!}}
{{Note|The minimum set of requirements will also be checked during the installation process!}}


The minimum set of requirements:
<div class="mw-translate-fuzzy">
* Minimum 180 MB disk space.
必須符合:
* MySQL 5.5.3 or later '''OR''' Microsoft SQL Server 2005 or later '''OR''' Postgres 9 or later.
* 約有 9 mb 硬碟容量來存放源程序的檔案
* Minimum PHP 5.3.3 or later, however we recommend PHP 5.5.x or later with the following modules/libraries enabled:
* PHP 4.3.2 或以上版本
** [[Installation FAQ#Requirements page#What is the mbstring (Multibyte String Functions) library|mbstring (Multibyte String Functions)]] extension library.
* MySQL 4.1.0 或以上版本
** PDO database driver for MySQL (pdo_mysql or pdo_mysqli) or Postgres (pdo_pgsql) or MSSQL ([https://php.net/manual/en/ref.pdo-sqlsrv.php pdo_sqlsrv] for Windows and [http://www.php.net/manual/en/ref.pdo-dblib.php pdo_dblib] for Linux).
* PHP 已安裝 mbstring (多位元組字串函數) extension library (用於本土化文件) (見於 [[安裝 FAQ]])
** Also, we assume in general that all PHP default libraries are enabled (like hash, session, etc.).
</div>


<div class="simplebox"> Note: LimeSurvey 2.x uses different database drivers than 1.x. If you get a message ''not No DBO driver was found during the installation'', you will have to contact your web server provider and ask him or her to activate one of the aforementioned database driver libraries. </div>
<div class="simplebox"> Note: If you are connecting from Linux to a MSSQL database on a Windows server using the dblib PDO driver, then the underlying FreeTDS needs to be set up correctly. Check out the [[Troubleshooting]] page for more information.</div>


<div class="simplebox"> Note: If you are connecting from Linux to a MSSQL database on a Windows server using the dblib PDO driver, then the underlying FreeTDS needs to be set up correctly. Check out the [[Troubleshooting]] page for more information.</div>
<div class="mw-translate-fuzzy">
選項:
* 已安裝 GD-Library (for captchas in registration form) 見於 [http://de3.php.net/manual/en/ref.image.php GD-Library PHP 說明文件]
* 已安裝 LDAP-Library installed (採用 LDAP 導入操作代碼) 見於 [http://de.php.net/manual/en/ref.ldap.php PHP LDAP 說明文件]
</div>


Optional PHP Extensions:
大多數情況下網頁伺服器的供應商可以代勞.
* '''GD-Library''' '''with FreeType support''' installed is needed for captchas or nice charts in statistics - see [https://php.net/manual/image.setup.php PHP GD-Library Extension documentation]
* '''IMAP''' (pretty standard) is needed for the [[Email bounce tracking system|email bounce tracking system]] - see [https://php.net/manual/imap.setup.php PHP IMAP Extension documentation]
* '''LDAP''' installed is needed to import tokens using LDAP - see [https://php.net/manual/en/book.ldap.php PHP LDAP Documentation]
* '''Zip''' (pretty standard) is needed for templates upload and for the import of .zip archived resources - see [https://php.net/manual/zip.setup.php PHP Zip Extension documentation]
* '''Zlib''' (pretty standard) is needed for the [[ComfortUpdate]] - see [https://php.net/manual/zlib.setup.php PHP Zlib Extension documentation]


In most cases, your web server provider or system administrator will be able to help you out with these optional components.
If you want to run Microsoft's IIS server, taking a look at [[Installation on XP with IIS]] might also help.


If you want to run Microsoft's IIS server, taking a look at "[[Installation on XP with IIS]] might also help.
<div class="mw-translate-fuzzy">
===瀏覽器相容性===
For the survey taking side we currently support IE9 and all newer comparable browsers like FF, Chrome, Opera, etc.
For the administration part we currently support IE11 and all newer comparable browsers like FF, Chrome, Opera, etc.
We do not support any IE version running in Intranet-mode or Compatibility-mode!
</div>


===Browser compatibility===
'''For the administration part''', we currently support Edge and all newer comparable browsers like FF, Chrome, Opera etc. with activated JavaScript. <u>We do not support any Internet Explorer versions in the administration part anymore.</u>
'''For the survey-taking side''', we currently support IE9 and all newer comparable browsers like FF, Chrome, Opera, etc., with activated JavaScript.
'''For the administration part''', we currently support IE11 and all newer comparable browsers like FF, Chrome, Opera, etc., with activated JavaScript. We do not support any IE version running in Intranet-mode or Compatibility-mode!


==Screen sizes==
====Screen sizes====
We support any reasonable screen size for survey taking (360px x 640px and up).
We support any reasonable screen size for survey taking (360px x 640px and up).
The minimum supported screen resolution for the LimeSurvey administration page is 1280px x 1024px.
The minimum supported screen resolution for the LimeSurvey administration page is 1280px x 1024px.


==Hosting for LimeSurvey==
===Hosting for LimeSurvey===


LimeSurvey should work with most hosting companies that provide PHP and MYSQL. If you want a ready-installed version of LimeSurvey, you could try [https://www.limesurvey.org/editions-and-prices/limesurvey-pro/editions-and-prices-professional LimeSurvey Professional], else check out our [[LimeSurvey-compatible hosting companies|list of LimeSurvey-compatible hosting companies]].
LimeSurvey should work with most hosting companies that provide PHP and MySQL. If you want a ready-installed version of LimeSurvey, you could try [https://www.limesurvey.org/editions-and-prices/limesurvey-pro/editions-and-prices-professional LimeSurvey Cloud], else check out our [[LimeSurvey-compatible hosting companies|list of LimeSurvey-compatible hosting companies]].


<div class="mw-translate-fuzzy">
===2. 下載 LimeSurvey 套件===
===2. 下載 LimeSurvey 套件===
</div>
<div class="mw-translate-fuzzy">
到訪 sourceforge 網站下載最新的 LimeSurvey 套件. http://sourceforge.net/projects/limesurvey/
套件約 2 MB 的檔案大小。 下載 zip 壓縮格式的檔案，並儲存到您的硬碟內。
</div>
<div class="mw-translate-fuzzy">
===3. 解壓縮 LimeSurvey 軟體包===
</div>


[https://www.limesurvey.org/en/downloads/category/25-latest-stable-release Download] the latest stable LimeSurvey zip package (there are also gzip, bz2 and 7zip packages available for your convenience) and save it to your local disk.
<div class="mw-translate-fuzzy">
採用你慣用的壓縮軟體以預設目錄／資料夾的方式解壓縮 zip 格式的軟體包。請一併解壓縮軟體包原來預設的目錄結構及相關檔案).


===3. 解壓 LimeSurvey 軟件包===
<div class="simplebox">


Uncompress the zip file into a dedicated directory/folder using your preferred compression software. When you uncompress the file make sure that you uncompress the directory structure with the files (this is default behavior for most compression programs). The path name for the installation directory should not include '''(''' or ''')''' special characters, but may include the '''space''' character.
'''目錄使用權限'''
*程序 admin 目錄需要有 '寫入' 權限來導入問卷. "/limesurvey/tmp" 目錄用作上傳文件，所以要設定可讀取/可寫入的狀態. 在 linux 或 unix 它應該 chmod 到 775.


===4. 收集網站伺服器信息===
其他目錄可以設定成可讀取狀態或在 linux/unix chmod 755. 你可以把 /limesurvey/admin 目錄內的文件都設定成 755 的使用權限.</div>
</div>


You will need to know the following things to install LimeSurvey on your web server correctly:
<div class="mw-translate-fuzzy">
*Your intended website URL where your scripts will reside (e.g: ''http://my.domain.com/limesurvey'').
===4. 收集網站伺服器訊息===
*The physical disk location on your server where your scripts will reside (e.g.: ''/home/usr/htdocs/limesurvey'').
</div>
*The IP/net location of your database server (i.e.: ''localhost'').
*If your database server uses a non-standard port, find out which port it is.
*Your user name and password for your database server.
*With most providers you can't let the script create the database, but have to do it yourself.  If you are using such a provider, please create a database (for example ''limesurvey'') yourself.


你需要符合以下條件才可以正確安裝 LimeSurvey.
*你要建立 limesurvey 的網址URL來存放它的源程序 (ie: 'http://my.domain.com/limesurvey')
*limesurvey 在伺服器所在的實質位置 (ie: '/home/usr/htdocs/limesurvey')
*你的 MySQL 資料庫的 IP/網路位置 (ie:'localhost')
*如果您的 MySQL 資料庫使用非標準連接埠, 您就要找出埠號.
*你的 MySQL 資料庫使用的使用者名稱及密碼
*如果您的網路伺服器是使用 Windows 作業系統, 請當試找出 mysql bin 檔案的存放位置. (ie: 'c:/mysql/bin')
<div class="mw-translate-fuzzy">
===5. LimeSurvey 的組態設定===
===5. LimeSurvey 的組態設定===
</div>


使用自己的文字編輯器修改 /limesurvey/目錄內的 config.php 文件檔，下列設定要加以調整:
使用自己的文字編輯器修改 /limesurvey/目錄內的 config.php 文件檔，下列設定要加以調整:


=Set directory permissions=
==Set directory permissions==


For the script to work properly it needs certain access to some directories - this applies especially to Linux/*nix systems.
For the script to work properly it needs certain access to some directories - this applies especially to Linux/*nix systems.
Line 83: Line 110:
{{Alert|If you are using Linux, then setting permissions depends on your webserver configuration. For example, if you use Apache HTTPD on CentOS, type '''chmod -R 755 <directory> ; chown -R apache <directory>'''. This will give everyone access to read, and your webserver will have the permission to write. Check the [https://www.linux.com/learn/tutorials/309527-understanding-linux-file-permissions following link] for more information on Linux permissions.}}
{{Alert|If you are using Linux, then setting permissions depends on your webserver configuration. For example, if you use Apache HTTPD on CentOS, type '''chmod -R 755 <directory> ; chown -R apache <directory>'''. This will give everyone access to read, and your webserver will have the permission to write. Check the [https://www.linux.com/learn/tutorials/309527-understanding-linux-file-permissions following link] for more information on Linux permissions.}}


=Create a database user=
==Create a database user==


LimeSurvey will create a database and the tables inside it. To be able to do this, it will need the user name and password of a database user. We generally recommend to create a database user with the following permissions:
LimeSurvey will create a database and the tables inside it. To be able to do this, it will need the user name and password of a database user. We generally recommend creating a database user with the following permissions:


- MySQL: SELECT, CREATE, INSERT, UPDATE, DELETE, ALTER, DROP, INDEX
- MySQL: SELECT, CREATE, INSERT, UPDATE, DELETE, ALTER, DROP, INDEX
Line 91: Line 118:
- PostgreSQL: SELECT, INSERT, UPDATE, DELETE, TRUNCATE, TRIGGER
- PostgreSQL: SELECT, INSERT, UPDATE, DELETE, TRUNCATE, TRIGGER


- Microsoft SQL Server: ''Unknown - if you can find out this information please complete it''.
- Microsoft SQL Server: ''Unknown - if you can find out this information, please complete it''.


<div class="mw-translate-fuzzy">


</div>


'''Go to "http://www.example.com/limesurvey/admin"'''. If you configured everything correctly, the LimeSurvey installer should be starting - just follow the instructions. You will be asked whether you wish to create the database and/or create the tables inside the database. LimeSurvey will then create the needed tables in the database.
<div class="mw-translate-fuzzy">


</div>
<div class="mw-translate-fuzzy">
===8. 首次連結 admin 源程序===
===8. 首次連結 admin 源程序===
</div>


After the installer has finished you are done! Open your browser and enter the URL to the LimeSurvey administration. Assuming you used 'limesurvey' as the directory name to store the files in, this will be something like "http://www.example.com/limesurvey/admin".
上傳檔案後，您可以透過網站瀏覽器建立 LimeSurvey. 打開您的瀏覽器，在網址列鍵入 admin.php 的 url 網址. 如果您是使用limesurvey 作為目錄名稱來存放它的所有檔案, 網址大概的形式如是 "http://your.domain.com/limesurvey/admin/admin.php"


You should get a login screen. The default login credentials (if they have not been changed during the installation) are:
You should get a login screen. The default login credentials (if they have not been changed during the installation) are:


<syntaxhighlight lang='html' enclose="div">
<div class="mw-translate-fuzzy">
第一次使用 LimeSurvey 時, 源程序會連接到你在 config.php 文件設定的數據庫. 如果該數據庫並未建立, LimeSurvey 會向你發出警訊. 至低限度您會進入登入的頁面. 預設核查身份的登入資料是︰
</div>


User: admin
User: admin
Line 112: Line 147:
'''緊記第一次登入後馬上要更改預設的密碼.'''
'''緊記第一次登入後馬上要更改預設的密碼.'''


==Further configuration==
===Caching===
LimeSurvey uses the Yii file cache by default, but it can be configured to use other cache engines. Possible other caches are:
* Memcached
* Redis
* WinCache
* XCache
Please see the [https://www.yiiframework.com/doc/api/1.1/CCache Yii documentation] for full description.
Since LimeSurvey 4.0.0 you also have the possibility to cache calculations in the ExpressionScript. This can provide a significant speed-up depending on survey complexity. To enable the emcache, add this in your config.php file (components array):
<syntaxhighlight lang="php">
'emcache' => array('class' => 'CFileCache'),
</syntaxhighlight>
As with the main Yii cache, other cache systems can be used.
{{Note| The emcache is not compatible with randomized surveys, and will be automatically turned off in such cases.}}
<div class="mw-translate-fuzzy">
===9. 我遇到問題怎麼辦...===
===9. 我遇到問題怎麼辦...===
</div>


Like all computer programs, most of the time things will work just like the instructions say, but sometimes they just won't. There are too many possible reasons for things not going according to plan to describe here. If you have trouble, first check out the [[Installation FAQ]]. If you don't find your answer there, please post your problem and any error messages in the [https://www.limesurvey.org/forum LimeSurvey forums], open a [https://www.limesurvey.org/contact-us support ticket], or join the [irc://irc.freenode.net/limesurvey|LimeSurvey IRC channel]:
<div class="mw-translate-fuzzy">
 
正如所有電腦程式, 運作過程難免偶有問題, 導致運作失常的原因也很多. 如果您操作上有麻煩, 請透過 limesurvey.org 的[http://www.limesurvey.org/component/option,com_fireboard/Itemid,86/lang,en/ LimeSurvey forums] 支援論壇或加入 [irc://irc.freenode.net/limesurvey|LimeSurvey IRC channel]: irc://irc.freenode.net/limesurvey 發表您遇到的技術問題或LimeSurvey 執行後出現的錯誤訊息，一定有人協助您解決困難。
<div class="simplebox"><center>'''[https://www.limesurvey.org/community-services/live-chat Direct link to the official LimeSurvey IRC Channel]'''</center></div>
</div>

Latest revision as of 07:30, 28 May 2021

Other languages:
Note: These installation instructions are for version 2.0 or later. Older instructions for 1.92 can be found here and update instructions can be found here.

General

The LimeSurvey project provides two ways to install LimeSurvey:

  • On your webserver:
    In this case, just follow the instructions on this page starting with step 1.
  • On your local Windows PC:
    You usually only want to install LimeSurvey on your local PC if you want to create surveys locally (mainly for speed or development/test reasons) and upload them later to your live LimeSurvey installation on a web server. For this purpose, we have prepared a special LimeSurvey package which includes the web server, the database, the LimeSurvey application, and instructions how to install it.

1. 你確定 LimeSurvey 能夠在你的網站使用

確定伺服器符合以下全部要求:

The minimum set of requirements will also be checked during the installation process!

必須符合:

  • 約有 9 mb 硬碟容量來存放源程序的檔案
  • PHP 4.3.2 或以上版本
  • MySQL 4.1.0 或以上版本
  • PHP 已安裝 mbstring (多位元組字串函數) extension library (用於本土化文件) (見於 安裝 FAQ)
Note: If you are connecting from Linux to a MSSQL database on a Windows server using the dblib PDO driver, then the underlying FreeTDS needs to be set up correctly. Check out the Troubleshooting page for more information.

選項:

大多數情況下網頁伺服器的供應商可以代勞.

If you want to run Microsoft's IIS server, taking a look at Installation on XP with IIS might also help.

瀏覽器相容性

For the survey taking side we currently support IE9 and all newer comparable browsers like FF, Chrome, Opera, etc. For the administration part we currently support IE11 and all newer comparable browsers like FF, Chrome, Opera, etc. We do not support any IE version running in Intranet-mode or Compatibility-mode!

For the administration part, we currently support Edge and all newer comparable browsers like FF, Chrome, Opera etc. with activated JavaScript. We do not support any Internet Explorer versions in the administration part anymore.

Screen sizes

We support any reasonable screen size for survey taking (360px x 640px and up). The minimum supported screen resolution for the LimeSurvey administration page is 1280px x 1024px.

Hosting for LimeSurvey

LimeSurvey should work with most hosting companies that provide PHP and MySQL. If you want a ready-installed version of LimeSurvey, you could try LimeSurvey Cloud, else check out our list of LimeSurvey-compatible hosting companies.

2. 下載 LimeSurvey 套件

到訪 sourceforge 網站下載最新的 LimeSurvey 套件. http://sourceforge.net/projects/limesurvey/

套件約 2 MB 的檔案大小。 下載 zip 壓縮格式的檔案，並儲存到您的硬碟內。

3. 解壓縮 LimeSurvey 軟體包

採用你慣用的壓縮軟體以預設目錄／資料夾的方式解壓縮 zip 格式的軟體包。請一併解壓縮軟體包原來預設的目錄結構及相關檔案).

目錄使用權限

  • 程序 admin 目錄需要有 '寫入' 權限來導入問卷. "/limesurvey/tmp" 目錄用作上傳文件，所以要設定可讀取/可寫入的狀態. 在 linux 或 unix 它應該 chmod 到 775.
其他目錄可以設定成可讀取狀態或在 linux/unix chmod 755. 你可以把 /limesurvey/admin 目錄內的文件都設定成 755 的使用權限.

4. 收集網站伺服器訊息

你需要符合以下條件才可以正確安裝 LimeSurvey.

  • 你要建立 limesurvey 的網址URL來存放它的源程序 (ie: 'http://my.domain.com/limesurvey')
  • limesurvey 在伺服器所在的實質位置 (ie: '/home/usr/htdocs/limesurvey')
  • 你的 MySQL 資料庫的 IP/網路位置 (ie:'localhost')
  • 如果您的 MySQL 資料庫使用非標準連接埠, 您就要找出埠號.
  • 你的 MySQL 資料庫使用的使用者名稱及密碼
  • 如果您的網路伺服器是使用 Windows 作業系統, 請當試找出 mysql bin 檔案的存放位置. (ie: 'c:/mysql/bin')

5. LimeSurvey 的組態設定

使用自己的文字編輯器修改 /limesurvey/目錄內的 config.php 文件檔，下列設定要加以調整:

Set directory permissions

For the script to work properly it needs certain access to some directories - this applies especially to Linux/*nix systems.

  • The "/limesurvey/tmp" directory (and all its subdirectories and files) are used for imports & uploads and should be set to Read & Write for your webserver.
  • The "/limesurvey/upload/" directory (and all its subdirectories and files) must also have Read & Write for your webserver in order to enable picture and media files upload.
  • The "/limesurvey/application/config/" directory also needs Read & Write permissions for your webserver.
  • The other directories can be set to Read Only. You may wish in Linux/Unix to set the permissions on each file within the /limesurvey/admin directory to Read Only.
  If you are using Linux, then setting permissions depends on your webserver configuration. For example, if you use Apache HTTPD on CentOS, type chmod -R 755 <directory> ; chown -R apache <directory>. This will give everyone access to read, and your webserver will have the permission to write. Check the following link for more information on Linux permissions.


Create a database user

LimeSurvey will create a database and the tables inside it. To be able to do this, it will need the user name and password of a database user. We generally recommend creating a database user with the following permissions:

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

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

- Microsoft SQL Server: Unknown - if you can find out this information, please complete it.

8. 首次連結 admin 源程序

上傳檔案後，您可以透過網站瀏覽器建立 LimeSurvey. 打開您的瀏覽器，在網址列鍵入 admin.php 的 url 網址. 如果您是使用limesurvey 作為目錄名稱來存放它的所有檔案, 網址大概的形式如是 "http://your.domain.com/limesurvey/admin/admin.php"

You should get a login screen. The default login credentials (if they have not been changed during the installation) are:

第一次使用 LimeSurvey 時, 源程序會連接到你在 config.php 文件設定的數據庫. 如果該數據庫並未建立, LimeSurvey 會向你發出警訊. 至低限度您會進入登入的頁面. 預設核查身份的登入資料是︰

User: admin Password: password

</syntaxhighlight>

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

Further configuration

Caching

LimeSurvey uses the Yii file cache by default, but it can be configured to use other cache engines. Possible other caches are:

  • Memcached
  • Redis
  • WinCache
  • XCache

Please see the Yii documentation for full description.

Since LimeSurvey 4.0.0 you also have the possibility to cache calculations in the ExpressionScript. This can provide a significant speed-up depending on survey complexity. To enable the emcache, add this in your config.php file (components array): 

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

As with the main Yii cache, other cache systems can be used.

The emcache is not compatible with randomized surveys, and will be automatically turned off in such cases.

9. 我遇到問題怎麼辦...

正如所有電腦程式, 運作過程難免偶有問題, 導致運作失常的原因也很多. 如果您操作上有麻煩, 請透過 limesurvey.org 的LimeSurvey forums 支援論壇或加入 IRC channel: irc://irc.freenode.net/limesurvey 發表您遇到的技術問題或LimeSurvey 執行後出現的錯誤訊息，一定有人協助您解決困難。

Retrieved from "http://manual.limesurvey.org/index.php?title=Installation_-_LimeSurvey_CE/zh-hant&oldid=163982"