Монтаж - LimeSurvey CE

Забележка: Тези инструкции за инсталиране са за текущата версия на LimeSurvey. По-стари инструкции за 1.92 можете да намерите тук, а инструкции за актуализиране можете да намерите тук. Ако предпочитате да инсталирате LimeSurvey от командния ред, вижте Инсталиране чрез интерфейс на командния ред (CLI).

Уверете се, че можете да използвате LimeSurvey на вашия уебсайт

Уверете се, че вашият сървър отговаря на следните изисквания.

Минималният набор от изисквания за LimeSurvey:

• Минимум 500 MB дисково пространство (само разархивираният пакет на LimeSurvey 7.x заема около 380 MB), плюс място за качените от вас файлове и данните от проучванията.
• MariaDB 10.3.38 или по-нова версия ИЛИ MySQL 8 или по-нова версия ИЛИ Microsoft SQL Server 2019 или по-нова версия ИЛИ Postgres 14 или по-нова версия.
• Изисквания за версията на PHP:
  • LS 7.x от PHP 8.1.29 и по-нова (тествано до PHP 8.5.x)
  • LS 6.x от PHP 8.1.x до 8.3.x
  • LS 5.x от PHP 7.2.5 до 8.0.x
  • LS 3.x от PHP 5.5.9 до 7.4.x
• PHP memory_limit от поне 128 MB.
• Следните PHP модули/библиотеки трябва да бъдат активирани:
  • mbstring (Multibyte String Functions) разширение библиотека.
  • PDO драйвер за база данни за MySQL/MariaDB (pdo_mysql) или Postgres (pdo_pgsql) или MSSQL (pdo_sqlsrv за Windows и pdo_dblib за Linux).
  • GD - вижте документацията на PHP GD-Library Extension
  • Zip - вижте документацията на PHP Zip Extension
  • Zlib - вижте документацията на PHP Zlib Extension
  • Curl библиотека
  • fileinfo
  • JSON
  • Освен това приемаме като цяло, че всички PHP библиотеки по подразбиране са активирани, например:
    • ctype
    • filter
    • hash
    • openssl
    • session
    • SimpleXML
    • и т.н. …
• За LimeSurvey 7.x: Форматът на URL адресите трябва да е зададен на path (URL адреси като index.php/admin). Старият формат get (URL адреси като index.php?r=admin) вече не се поддържа. Инсталаторът автоматично задава формата path, така че трябва да проверите това само ако използвате повторно по-стар файл config.php с 'urlFormat' => 'get'.

Забележка: Ако се свързвате от Linux към MSSQL база данни на Windows сървър, като използвате драйвера dblib PDO, тогава основният FreeTDS трябва да бъде настроен правилно. Вижте страницата Отстраняване на проблеми за повече информация.

Допълнителни PHP разширения:

• GD-Library с поддръжка на FreeType и JPEG е необходима за captcha, хубави диаграми в статистиката или за качване на изображения чрез HTML редактора - вижте документацията на PHP GD-Library Extension
• IMAP е необходим за системата за проследяване на отхвърлени имейли - вижте документацията на PHP IMAP Extension. От PHP 8.4 разширението IMAP вече не е включено в PHP и трябва да се инсталира отделно от PECL.
• LDAP е необходим за импортиране на респонденти чрез LDAP - вижте документацията на PHP LDAP
• Intl се използва за правилно сортиране на текстове според правилата на съответния език - вижте документацията на PHP Intl
• Sodium се препоръчва за криптиране на данни - вижте документацията на PHP Sodium. Ако липсва, LimeSurvey използва много по-бавна PHP реализация.

Препоръчителни PHP настройки (инсталаторът показва предупреждение, ако вашите стойности са по-ниски):

• max_input_vars: 5000 или повече
• post_max_size: 32M или повече
• upload_max_filesize: 32M или повече

В повечето случаи вашият доставчик на уеб сървър или системен администратор ще могат да ви помогнат с тези незадължителни компоненти.

Съвместимост с браузър

За анкетата, в момента поддържаме IE11 (интранет режимът е изключен) и всички по-нови сравними браузъри като Edge, FF, Chrome, Opera и т.н. с активиран JavaScript.

За административната част в момента поддържаме Edge и всички по-нови сравними браузъри като FF, Chrome, Opera и др. с активиран JavaScript.

Размери на екрана

Ние поддържаме всеки разумен размер на екрана за провеждане на проучване (360px x 640px и повече). Минималната поддържана разделителна способност на екрана за страницата за администриране на LimeSurvey е 1280px x 1024px.

Хостинг за LimeSurvey

LimeSurvey трябва да работи с повечето хостинг компании, които предоставят PHP и MySQL/MariaDB. Ако искате готова инсталирана версия на LimeSurvey, която ние поддържаме за вас, опитайте LimeSurvey Cloud. Вижте LimeSurvey Cloud срещу LimeSurvey CE за разликите.

Изтеглете пакета LimeSurvey

Изтеглете най-новия стабилен zip пакет на LimeSurvey (има също налични пакети gzip, bz2 и 7zip за ваше удобство) и го запазете на вашия локален диск.

Разопаковайте пакета LimeSurvey

Разкомпресирайте zip файла в специална директория/папка, като използвате предпочитания от вас софтуер за компресиране. Когато декомпресирате файла, уверете се, че декомпресирате структурата на директорията с файловете (това е поведението по подразбиране за повечето програми за компресиране). Името на пътя за инсталационната директория не трябва да включва специални знаци '(' или ')', но може да включва символа интервал.

Събирайте информация за вашия сървър

За да инсталирате LimeSurvey правилно на вашия уеб сървър, ще трябва да знаете следните неща:

• Предвидения URL адрес на уебсайта, където ще се намират вашите скриптове (напр. https://my.domain.com/limesurvey).
• Какъв софтуер за уеб сървър използвате?
  • за Apache: Примерна конфигурация на LimeSurvey за Apache
  • за nginx: моля, вижте нашата примерна конфигурация на LimeSurvey за nginx (остаряла, без поддръжка на редактор)
• Физическото местоположение на диска на вашия сървър, където ще се намират вашите скриптове (напр. /home/usr/htdocs/limesurvey).
• IP/мрежовото местоположение на сървъра на вашата база данни (т.е. localhost).
• Ако сървърът на вашата база данни използва нестандартен порт, разберете кой е той.
• Вашето потребителско име и парола за сървъра на вашата база данни.
• При повечето доставчици не можете да оставите скрипта да създаде базата данни, а трябва да го направите сами. Ако използвате такъв доставчик, моля, създайте сами база данни (например limesurvey). За MySQL/MariaDB използвайте набора от знаци utf8mb4 със сравнение (collation) utf8mb4_unicode_ci.

Качете файловете на вашия уеб сървър

Използвайки вашата FTP/SFTP програма (напр. FileZilla), свържете се с вашия уеб сървър и създайте директория за съхранение на вашите скриптове. След това качете файловете, като използвате структурата на директорията, в която се намират. Уверете се, че качвате файловете в двоичен режим (проверете настройките на вашата FTP програма). Моля, обърнете внимание, че качването в режим ASCII може да доведе до необичайни грешки (напр. грешка „класът не е намерен“ по време на инсталацията), а също така изображенията може да не бъдат качени правилно. Уверете се също, че скритите файлове .htaccess са качени - те защитават някои директории и позволяват URL адреси без index.php в Apache.

Задаване на разрешения за директория

За да работи правилно скриптът, той се нуждае от определен достъп до някои директории - това се отнася особено за Linux/*nix системи.

• Директорията "/limesurvey/tmp" (и всички нейни поддиректории и файлове) се използва за импортиране и качване и трябва да бъде настроена на Четене и запис за вашия уеб сървър.
• Директорията "/limesurvey/upload/" (и всички нейни поддиректории и файлове) също трябва да има Четене и запис за вашия уеб сървър, за да е възможно качването на картинни и медийни файлове.
• Директорията "/limesurvey/application/config/" също се нуждае от разрешения Четене и запис за вашия уеб сървър.
• Другите директории могат да бъдат зададени на Само за четене.

  Ако използвате Linux, настройката на разрешенията зависи от конфигурацията на вашия уеб сървър. Например, ако вашият уеб сървър работи като потребител www-data (Debian/Ubuntu) или apache (RHEL/Rocky Linux/AlmaLinux), въведете chown -R www-data <directory> ; chmod -R 755 <directory> за трите директории, изброени по-горе. Това ще даде на всеки достъп за четене, а вашият уеб сървър ще има разрешение да пише.

Създайте потребител на база данни

LimeSurvey ще създаде база данни и таблиците в нея. За да може да направи това, ще са необходими потребителското име и паролата на потребител на база данни. Обикновено препоръчваме да създадете потребител на база данни със следните разрешения:

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

- PostgreSQL: Най-лесният начин е потребителят на базата данни да бъде собственик на базата данни на LimeSurvey. В противен случай потребителят се нуждае от привилегията CREATE върху схемата плюс SELECT, INSERT, UPDATE, DELETE, TRUNCATE, TRIGGER върху таблиците и USAGE върху последователностите.

- Microsoft SQL Server: Потребителят на базата данни трябва да бъде член на ролята db_owner на базата данни на LimeSurvey. Ако искате инсталаторът да създаде базата данни, потребителят се нуждае и от сървърната роля dbcreator.

Стартирайте инсталационния скрипт

Отворете URL адреса на вашата инсталация на LimeSurvey в браузъра си (напр. https://example.org/limesurvey). Ако сте конфигурирали всичко правилно, LimeSurvey инсталаторът стартира автоматично - просто следвайте инструкциите:

1. Изберете езика на инсталатора и приемете лиценза.
2. Прегледайте Проверка преди инсталацията. Всички задължителни елементи трябва да бъдат отбелязани като OK, преди да можете да продължите.
3. Въведете Конфигурация на базата данни. LimeSurvey ще ви попита дали желаете да създадете базата данни и/или да създадете таблиците в базата данни, и след това ще създаде необходимите таблици.
4. Настройте акаунта на администратора: въведете потребителско име, парола и адрес за е-поща на администратора, както и името на вашия сайт за проучвания и езика по подразбиране.

Свържете се с административния скрипт за първи път

Готови сте, когато инсталацията приключи! Отворете браузъра си и въведете URL адреса на администрацията на LimeSurvey. Ако приемем, че сте използвали „limesurvey“ като име на директория за съхраняване на файловете, това ще бъде нещо като https://www.example.com/limesurvey/admin.

Трябва да получите екран за вход. Влезте с потребителското име и паролата на администратора, които сте въвели по време на инсталацията. Ако не сте ги променили в инсталатора, данните за вход по подразбиране са:

Потребител: admin
Парола: парола

Ако все още използвате паролата по подразбиране, сменете я веднага в настройките на вашия акаунт. Забавлявайте се!

Допълнителна конфигурация

За допълнителни настройки, като конфигурация на имейл (SMTP) или настройки за сигурност, вижте Допълнителни настройки и Глобални настройки.

Кеширане

LimeSurvey използва файловия кеш на Yii по подразбиране, но може да бъде конфигуриран да използва други кеш машини. Възможни други кеш памети са:

• Memcached (CMemCache)
• Redis (CRedisCache)
• APCu (CApcCache)
• База данни (CDbCache)

Моля, вижте Yii документация за пълно описание.

От LimeSurvey 4.0.0 вие също имате възможност да кеширате изчисления в ExpressionScript. Това може да осигури значително ускоряване в зависимост от сложността на изследването. За да активирате emcache, добавете това във вашия файл config.php (масив от компоненти):

'emcache' => масив('клас' => 'CFileCache'),

Както при основния кеш на Yii, могат да се използват други кеш системи.

Ами ако имам проблеми...

Както всички компютърни програми, през повечето време нещата ще работят точно както се казва в инструкциите, но понякога просто не. Има твърде много възможни причини нещата да не вървят по план, за да бъдат описани тук. Ако имате проблеми, първо вижте Често задавани въпроси за инсталиране. Ако не намерите отговор там, моля, публикувайте проблема си и всички съобщения за грешка във форумите на LimeSurvey, отворете билет за поддръжка (само за клиенти, използващи LimeSurvey Cloud), или се присъединете към нашия Discord канал.