Instalacja - LimeSurvey CE
From LimeSurvey Manual
Upewnij się, że możesz używać LimeSurvey na swojej stronie internetowej
Upewnij się, że Twój serwer spełnia następujące wymagania.
Minimalny zestaw wymagań dla LimeSurvey:
- Minimum 500 MB miejsca na dysku (samo rozpakowane archiwum LimeSurvey 7.x zajmuje około 380 MB), plus miejsce na przesyłane pliki i dane ankiet.
- MariaDB 10.3.38 lub nowsza LUB MySQL 8 lub nowszy LUB Microsoft SQL Server 2019 lub nowszy LUB Postgres 14 lub nowszy.
- Wymagania dotyczące wersji PHP:
- LS 7.x: PHP 8.1.29 i nowszy (testowane do PHP 8.5.x)
- LS 6.x: od PHP 8.1.x do 8.3.x
- LS 5.x: od PHP 7.2.5 do 8.0.x
- LS 3.x: od PHP 5.5.9 do 7.4.x
- Wartość
memory_limitw PHP wynosząca co najmniej 128 MB. - Należy włączyć następujące moduły/biblioteki PHP:
- biblioteka rozszerzenia mbstring (Multibyte String Functions).
- Sterownik bazy danych PDO dla MySQL/MariaDB (pdo_mysql) lub Postgres (pdo_pgsql) lub MSSQL (pdo_sqlsrv dla Windows i pdo_dblib dla Linuksa).
- GD - zobacz dokumentację rozszerzenia PHP GD-Library
- Zip - zobacz dokumentację rozszerzenia PHP Zip
- Zlib - zobacz dokumentację rozszerzenia PHP Zlib
- Biblioteka curl
- fileinfo
- JSON
- Zakładamy również, że wszystkie domyślne biblioteki PHP są włączone, na przykład:
- ctype
- filter
- hash
- openssl
- session
- SimpleXML
- itp. …
- Dla LimeSurvey 7.x: format adresów URL musi być ustawiony na path (adresy URL w postaci index.php/admin). Stary format get (adresy URL w postaci index.php?r=admin) nie jest już obsługiwany. Instalator ustawia format path automatycznie, więc musisz to sprawdzić tylko wtedy, gdy używasz starszego pliku config.php z wpisem
'urlFormat' => 'get'.
Opcjonalne rozszerzenia PHP:
- GD-Library z obsługą FreeType i JPEG jest potrzebna do captcha, ładnych wykresów w statystykach oraz do przesyłania obrazów za pomocą edytora HTML - zobacz dokumentację rozszerzenia PHP GD-Library
- IMAP jest potrzebny do systemu śledzenia zwrotów e-maili - zobacz dokumentację rozszerzenia PHP IMAP. Od PHP 8.4 rozszerzenie IMAP nie jest już dołączane do PHP i należy je zainstalować osobno z PECL.
- LDAP jest potrzebny do importowania uczestników badania przy użyciu LDAP - zobacz dokumentację PHP LDAP
- Intl służy do poprawnego sortowania tekstów zgodnie z regułami danego języka - zobacz dokumentację PHP Intl
- Sodium jest zalecane do szyfrowania danych - zobacz dokumentację PHP Sodium. Jeśli go brakuje, LimeSurvey korzysta ze znacznie wolniejszej implementacji w PHP.
Zalecane ustawienia PHP (instalator wyświetla ostrzeżenie, jeśli Twoje wartości są niższe):
max_input_vars: 5000 lub więcejpost_max_size: 32M lub więcejupload_max_filesize: 32M lub więcej
W ogromnej większości przypadków Twój dostawca hostingu jest w stanie zapewnić Ci takie ustawienia.
Kompatybilność z przeglądarkami
'Dla strony biorącej udział w ankiecie, obecnie obsługujemy IE11 (z wyłączeniem trybu intranetu) i wszystkie nowsze, porównywalne przeglądarki, takie jak Edge, FF, Chrome, Opera itp. z aktywowany JavaScript.
W części administracyjnej obecnie obsługujemy Edge i wszystkie nowsze, porównywalne przeglądarki, takie jak FF, Chrome, Opera itp. z włączoną obsługą JavaScript.
Rozmiary ekranu
Obsługujemy dowolny rozsądny rozmiar ekranu do ankiet (360px x 640px i więcej). Minimalna obsługiwana rozdzielczość ekranu dla strony administracyjnej LimeSurvey to 1280px x 1024px.
Hosting dla LimeSurvey
LimeSurvey powinien działać u większości firm hostingowych udostępniających PHP i MySQL/MariaDB. Jeśli chcesz mieć gotową, zainstalowaną wersję LimeSurvey, którą dla Ciebie utrzymujemy, wypróbuj LimeSurvey Cloud. Różnice opisano na stronie LimeSurvey Cloud a LimeSurvey CE.
Pobierz pakiet LimeSurvey
Pobierz najnowszy stabilny pakiet zip LimeSurvey (dla Twojej wygody dostępne są również pakiety gzip, bz2 i 7zip) i zapisz go na dysku lokalnym.
Rozpakuj pakiet LimeSurvey
Rozpakuj uprzednio zapisane archiwum. Upewnij się, że rozpakowane archiwum zachowało oryginalną struktura katalogów i plików (ustawienie domyślne większości archiwizatorów).
Zbierz informacje o swoim serwerze
Aby poprawnie zainstalować LimeSurvey na swoim serwerze WWW, musisz znać następujące informacje:
- Docelowy adres URL witryny, w której będą znajdować się skrypty (np. https://my.domain.com/limesurvey).
- Z jakiego oprogramowania serwera WWW korzystasz?
- dla Apache: Przykładowa konfiguracja LimeSurvey dla Apache
- dla nginx: zapoznaj się z naszą przykładową konfiguracją LimeSurvey dla nginx (nieaktualna, brak obsługi edytora)
- Fizyczna lokalizacja na dysku serwera, w której będą znajdować się skrypty (np. /home/usr/htdocs/limesurvey).
- Adres IP/sieciowy serwera bazy danych (np. localhost).
- Jeśli serwer bazy danych korzysta z niestandardowego portu, dowiedz się, jaki to port.
- Nazwę użytkownika i hasło do serwera bazy danych.
- U większości dostawców nie można pozwolić skryptowi na utworzenie bazy danych – trzeba zrobić to samodzielnie. Jeśli korzystasz z takiego dostawcy, utwórz bazę danych (na przykład limesurvey) samodzielnie. Dla MySQL/MariaDB użyj zestawu znaków utf8mb4 z metodą porównywania utf8mb4_unicode_ci.
Prześlij pliki na swój serwer internetowy
Za pomocą programu FTP/SFTP (np. FileZilla) połącz się z serwerem WWW i utwórz katalog na skrypty. Następnie prześlij pliki, zachowując ich strukturę katalogów. Upewnij się, że pliki są przesyłane w trybie binarnym (sprawdź ustawienia swojego programu FTP). Pamiętaj, że przesyłanie w trybie ASCII może prowadzić do nietypowych błędów (np. błędu „class not found” podczas instalacji), a obrazy mogą zostać przesłane nieprawidłowo. Upewnij się też, że ukryte pliki .htaccess również zostały przesłane - chronią one niektóre katalogi i umożliwiają korzystanie z adresów URL bez index.php na serwerze Apache.
Ustaw uprawnienia do katalogu
Aby skrypt działał poprawnie, potrzebuje określonego dostępu do niektórych katalogów - dotyczy to zwłaszcza systemów Linux/*nix.
- Katalog "/limesurvey/tmp" (oraz wszystkie jego podkatalogi i pliki) jest używany do importu i przesyłania plików i powinien mieć ustawione uprawnienia Odczyt i zapis dla Twojego serwera WWW.
- Katalog "/limesurvey/upload/" (wraz ze wszystkimi jego podkatalogami i plikami) również musi mieć ustawione uprawnienia Odczyt i zapis dla serwera WWW, aby umożliwić przesyłanie plików graficznych i multimedialnych.
- Katalog "/limesurvey/application/config/" również wymaga uprawnień Odczyt i zapis dla Twojego serwera WWW.
- Pozostałe katalogi można ustawić na Tylko do odczytu.
Utwórz użytkownika bazy danych
LimeSurvey utworzy bazę danych i znajdujące się w niej tabele. Aby móc to zrobić, będzie potrzebna nazwa użytkownika i hasło użytkownika bazy danych. Generalnie zalecamy utworzenie użytkownika bazy danych z następującymi uprawnieniami:
- MySQL/MariaDB: SELECT, CREATE, INSERT, UPDATE, DELETE, ALTER, DROP, INDEX
- PostgreSQL: Najprostszym sposobem jest uczynienie użytkownika bazy danych właścicielem bazy danych LimeSurvey. W przeciwnym razie użytkownik potrzebuje uprawnienia CREATE do schematu oraz SELECT, INSERT, UPDATE, DELETE, TRUNCATE, TRIGGER do tabel i USAGE do sekwencji.
- Microsoft SQL Server: Użytkownik bazy danych powinien należeć do roli db_owner bazy danych LimeSurvey. Jeśli chcesz, aby instalator utworzył bazę danych, użytkownik potrzebuje także roli serwera dbcreator.
Uruchom skrypt instalacyjny
Otwórz w przeglądarce adres URL swojej instalacji LimeSurvey (np. https://example.org/limesurvey). Jeśli wszystko zostało skonfigurowane poprawnie, instalator LimeSurvey uruchomi się automatycznie - wystarczy postępować zgodnie z instrukcjami:
- Wybierz język instalatora i zaakceptuj licencję.
- Sprawdź wyniki ekranu Kontrola przed instalacją. Wszystkie wymagane elementy muszą być oznaczone jako OK, zanim będzie można kontynuować.
- Wprowadź Ustawienia bazy danych. LimeSurvey zapyta, czy chcesz utworzyć bazę danych i/lub utworzyć tabele w bazie danych, a następnie utworzy potrzebne tabele.
- Skonfiguruj konto administratora: wprowadź nazwę użytkownika, hasło i adres e-mail administratora, a także nazwę swojej witryny z ankietami i domyślny język.
Połącz się ze skryptem administracyjnym po raz pierwszy
Instalacja została zakończona! Otwórz przeglądarkę i wpisz adres URL panelu administracyjnego LimeSurvey. Zakładając, że jako nazwę katalogu na pliki użyto „limesurvey”, będzie to coś w rodzaju https://www.example.com/limesurvey/admin.
Powinien pojawić się ekran logowania. Zaloguj się, używając nazwy użytkownika i hasła administratora podanych podczas instalacji. Jeśli nie zostały one zmienione w instalatorze, domyślne dane logowania to:
Użytkownik: admin
Hasło: hasło
Jeśli nadal używasz domyślnego hasła, zmień je od razu w ustawieniach swojego konta. Miłej zabawy!
Dalsza konfiguracja
Dodatkowe ustawienia, takie jak konfiguracja poczty e-mail (SMTP) lub ustawienia bezpieczeństwa, opisano na stronach Ustawienia opcjonalne i Ustawienia globalne.
Buforowanie
LimeSurvey domyślnie korzysta z pamięci podręcznej plików Yii, ale można ją skonfigurować tak, aby korzystała z innych silników pamięci podręcznej. Możliwe inne pamięci podręczne to:
- Memcached (CMemCache)
- Redis (CRedisCache)
- APCu (CApcCache)
- Baza danych (CDbCache)
Pełny opis można znaleźć w Yii.
Od wersji LimeSurvey 4.0.0 istnieje także możliwość buforowania obliczeń w ExpressionScript. Może to zapewnić znaczne przyspieszenie w zależności od złożoności badania. Aby włączyć emcache, dodaj to do swojego pliku config.php (tablica komponentów):
'emcache' => array('class' => 'CFileCache'),
Podobnie jak w przypadku głównej pamięci podręcznej Yii, można używać innych systemów pamięci podręcznej.
Co jeśli mam problemy...
Jak wszystkie programy komputerowe, w większości przypadków wszystko będzie działać zgodnie z instrukcjami, ale czasami po prostu tak nie będzie. Istnieje zbyt wiele możliwych powodów, dla których sprawy nie przebiegają zgodnie z planem, aby je tutaj opisać. Jeśli masz problemy, najpierw zapoznaj się z Często zadawanymi pytaniami dotyczącymi instalacji. Jeśli nie znajdziesz tam odpowiedzi, opisz swój problem i wszelkie komunikaty o błędach na forum LimeSurvey, otwórz zgłoszenie do pomocy technicznej (tylko dla klientów korzystających z LimeSurvey Cloud) lub dołącz do naszego kanału Discord.