Lắp đặt - LimeSurvey CE
From LimeSurvey Manual
Đảm bảo bạn có thể sử dụng LimeSurvey trên trang web của mình
Hãy đảm bảo máy chủ của bạn đáp ứng các yêu cầu sau.
Bộ yêu cầu tối thiểu dành cho LimeSurvey:
- Dung lượng ổ đĩa tối thiểu 500 MB (riêng gói LimeSurvey 7.x sau khi giải nén đã chiếm khoảng 380 MB), cộng thêm dung lượng cho các tệp bạn tải lên và dữ liệu khảo sát.
- MariaDB 10.3.38 trở lên HOẶC MySQL 8 trở lên HOẶC Microsoft SQL Server 2019 trở lên HOẶC Postgres 14 trở lên.
- Yêu cầu phiên bản PHP:
- LS 7.x từ PHP 8.1.29 trở lên (đã thử nghiệm đến PHP 8.5.x)
- LS 6.x từ PHP 8.1.x đến 8.3.x
- LS 5.x từ PHP 7.2.5 đến 8.0.x
- LS 3.x từ PHP 5.5.9 đến 7.4.x
- PHP
memory_limittối thiểu 128 MB. - Các mô-đun/thư viện PHP sau phải được bật:
- Thư viện mở rộng mbstring (Multibyte String Functions).
- Trình điều khiển cơ sở dữ liệu PDO cho MySQL/MariaDB (pdo_mysql) hoặc Postgres (pdo_pgsql) hoặc MSSQL (pdo_sqlsrv cho Windows và pdo_dblib cho Linux).
- GD - xem tài liệu về phần mở rộng thư viện PHP GD
- Zip - xem tài liệu về phần mở rộng PHP Zip
- Zlib - xem tài liệu về phần mở rộng PHP Zlib
- Thư viện Curl
- fileinfo
- JSON
- Ngoài ra, nhìn chung chúng tôi giả định rằng tất cả các thư viện mặc định của PHP đều được bật, ví dụ:
- ctype
- filter
- hash
- openssl
- session
- SimpleXML
- v.v …
- Đối với LimeSurvey 7.x: Định dạng URL phải được đặt thành path (URL dạng index.php/admin). Định dạng URL get cũ (URL dạng index.php?r=admin) không còn được hỗ trợ. Trình cài đặt tự động đặt định dạng path, vì vậy bạn chỉ cần kiểm tra điều này nếu dùng lại tệp config.php cũ có chứa
'urlFormat' => 'get'.
Các phần mở rộng PHP tùy chọn:
- GD-Library với hỗ trợ FreeType và JPEG cần thiết cho captcha, biểu đồ đẹp trong thống kê hoặc để tải hình ảnh lên qua HTML biên tập - xem tài liệu về phần mở rộng thư viện PHP GD
- IMAP cần thiết cho hệ thống theo dõi thư bị trả lại - xem tài liệu về phần mở rộng PHP IMAP. Từ PHP 8.4, phần mở rộng IMAP không còn được đi kèm với PHP và phải được cài đặt riêng từ PECL.
- LDAP cần thiết để tải nhập người tham gia khảo sát bằng LDAP - xem tài liệu PHP LDAP
- Intl được dùng để sắp xếp văn bản đúng theo quy tắc của từng ngôn ngữ - xem tài liệu PHP Intl
- Sodium được khuyến nghị để mã hóa dữ liệu - xem tài liệu PHP Sodium. Nếu thiếu, LimeSurvey sẽ chuyển sang dùng một cách triển khai PHP chậm hơn nhiều.
Cài đặt PHP được khuyến nghị (trình cài đặt sẽ hiển thị cảnh báo nếu giá trị của bạn thấp hơn):
max_input_vars: 5000 trở lênpost_max_size: 32M trở lênupload_max_filesize: 32M trở lên
Trong hầu hết các trường hợp, nhà cung cấp máy chủ web hoặc quản trị viên hệ thống của bạn sẽ có thể trợ giúp bạn với các thành phần tùy chọn này.
Khả năng tương thích của trình duyệt
Đối với bên tham gia khảo sát, chúng tôi hiện hỗ trợ IE11 (không bao gồm chế độ mạng nội bộ) và tất cả các trình duyệt tương đương mới hơn như Edge, FF, Chrome, Opera, v.v. JavaScript được kích hoạt.
Đối với phần quản trị, chúng tôi hiện hỗ trợ Edge và tất cả các trình duyệt tương đương mới hơn như FF, Chrome, Opera, v.v. với JavaScript được kích hoạt.
Kích thước màn hình
Chúng tôi hỗ trợ mọi kích thước màn hình hợp lý để thực hiện khảo sát (360px x 640px trở lên). Độ phân giải màn hình được hỗ trợ tối thiểu cho trang quản trị LimeSurvey là 1280px x 1024px.
Lưu trữ cho LimeSurvey
LimeSurvey sẽ hoạt động với hầu hết các công ty lưu trữ cung cấp PHP và MySQL/MariaDB. Nếu bạn muốn có phiên bản LimeSurvey được cài đặt sẵn và do chúng tôi bảo trì, hãy dùng thử LimeSurvey Cloud. Xem LimeSurvey Cloud so với LimeSurvey CE để biết các điểm khác biệt.
Tải gói LimeSurvey
Tải xuống gói zip LimeSurvey ổn định mới nhất (cũng có các gói gzip, bz2 và 7zip để thuận tiện cho bạn) và lưu nó vào đĩa cục bộ của bạn.
Giải nén gói LimeSurvey
Giải nén tệp zip vào một thư mục/thư mục chuyên dụng bằng phần mềm nén ưa thích của bạn. Khi bạn giải nén tệp, hãy đảm bảo rằng bạn giải nén cấu trúc thư mục chứa các tệp (đây là hành vi mặc định cho hầu hết các chương trình nén). Tên đường dẫn cho thư mục cài đặt không được bao gồm các ký tự đặc biệt '(' hoặc ')' nhưng có thể bao gồm ký tự khoảng trắng.
Thu thập thông tin về máy chủ của bạn
Bạn sẽ cần biết những thông tin sau để cài đặt LimeSurvey trên máy chủ web của mình một cách chính xác:
- URL trang web dự kiến nơi các tập lệnh của bạn sẽ được đặt (ví dụ https://my.domain.com/limesurvey).
- Bạn đang sử dụng phần mềm máy chủ web nào?
- đối với Apache: Cấu hình mẫu LimeSurvey cho Apache
- đối với nginx: vui lòng xem cấu hình mẫu LimeSurvey cho nginx (đã lỗi thời, không hỗ trợ trình soạn thảo)
- Vị trí đĩa vật lý trên máy chủ nơi các tập lệnh của bạn sẽ được đặt (ví dụ /home/usr/htdocs/limesurvey).
- Vị trí IP/mạng của máy chủ cơ sở dữ liệu của bạn (ví dụ localhost).
- Nếu máy chủ cơ sở dữ liệu của bạn sử dụng cổng không chuẩn, hãy tìm hiểu xem đó là cổng nào.
- Tên người dùng và mật khẩu cho máy chủ cơ sở dữ liệu của bạn.
- Với hầu hết các nhà cung cấp, bạn không thể để tập lệnh tạo cơ sở dữ liệu mà phải tự tạo. Nếu bạn đang sử dụng một nhà cung cấp như vậy, vui lòng tự tạo một cơ sở dữ liệu (ví dụ limesurvey). Đối với MySQL/MariaDB, hãy dùng bộ ký tự utf8mb4 với kiểu đối chiếu utf8mb4_unicode_ci.
Tải tập tin lên máy chủ web của bạn
Sử dụng chương trình FTP/SFTP của bạn (ví dụ FileZilla), kết nối với máy chủ web của bạn và tạo một thư mục để lưu trữ các tập lệnh. Sau đó tải các tệp lên theo đúng cấu trúc thư mục chứa chúng. Đảm bảo bạn tải các tệp lên ở chế độ nhị phân (kiểm tra cài đặt của chương trình FTP). Xin lưu ý rằng việc tải lên ở chế độ ASCII có thể dẫn đến các lỗi hiếm gặp (ví dụ: lỗi 'class not found' trong khi cài đặt), đồng thời hình ảnh có thể không được tải lên chính xác. Ngoài ra, hãy đảm bảo các tệp ẩn .htaccess cũng được tải lên - chúng bảo vệ một số thư mục và cho phép dùng URL không có index.php trên Apache.
Đặt quyền thư mục
Để tập lệnh hoạt động chính xác, nó cần có quyền truy cập nhất định vào một số thư mục - điều này đặc biệt áp dụng cho các hệ thống Linux/*nix.
- Thư mục "/limesurvey/tmp" (và tất cả các thư mục con và tệp của nó) được dùng để nhập và tải lên, và phải được đặt thành Đọc & Ghi cho máy chủ web của bạn.
- Thư mục "/limesurvey/upload/" (và tất cả các thư mục con và tệp của nó) cũng phải có quyền Đọc & Ghi cho máy chủ web của bạn để cho phép tải lên các tệp hình ảnh và phương tiện.
- Thư mục "/limesurvey/application/config/" cũng cần quyền Đọc & Ghi cho máy chủ web của bạn.
- Các thư mục khác có thể được đặt thành Chỉ đọc.
Tạo người dùng cơ sở dữ liệu
LimeSurvey sẽ tạo cơ sở dữ liệu và các bảng bên trong cơ sở dữ liệu đó. Để có thể thực hiện việc này, nó sẽ cần tên người dùng và mật khẩu của người dùng cơ sở dữ liệu. Chúng tôi thường khuyên bạn nên tạo người dùng cơ sở dữ liệu với các quyền sau:
- MySQL/MariaDB: SELECT, CREATE, INSERT, UPDATE, DELETE, ALTER, DROP, INDEX
- PostgreSQL: Cách dễ nhất là đặt người dùng cơ sở dữ liệu làm chủ sở hữu của cơ sở dữ liệu LimeSurvey. Nếu không, người dùng cần quyền CREATE trên schema cùng với SELECT, INSERT, UPDATE, DELETE, TRUNCATE, TRIGGER trên các bảng và USAGE trên các sequence.
- Microsoft SQL Server: Người dùng cơ sở dữ liệu nên là thành viên của vai trò db_owner của cơ sở dữ liệu LimeSurvey. Nếu bạn muốn trình cài đặt tạo cơ sở dữ liệu, người dùng cũng cần vai trò máy chủ dbcreator.
Chạy tập lệnh cài đặt
Mở URL của bản cài đặt LimeSurvey trong trình duyệt của bạn (ví dụ https://example.org/limesurvey). Nếu bạn đã cấu hình mọi thứ chính xác, Trình cài đặt LimeSurvey sẽ tự động khởi chạy - chỉ cần làm theo hướng dẫn:
- Chọn ngôn ngữ của trình cài đặt và chấp nhận giấy phép.
- Xem kết quả Kiểm tra trước-cài đặt. Tất cả các mục bắt buộc phải được đánh dấu OK trước khi bạn có thể tiếp tục.
- Nhập Thiết lập cơ sở dữ liệu của bạn. LimeSurvey sẽ hỏi bạn có muốn tạo cơ sở dữ liệu và/hoặc tạo các bảng bên trong cơ sở dữ liệu hay không, sau đó sẽ tạo các bảng cần thiết.
- Thiết lập tài khoản quản trị viên: nhập tên người dùng, mật khẩu và địa chỉ Email của quản trị viên, cũng như tên trang khảo sát của bạn và ngôn ngữ mặc định.
Kết nối tới script quản trị lần đầu
Bạn đã hoàn tất khi quá trình cài đặt kết thúc! Mở trình duyệt của bạn và nhập URL tới trang quản trị LimeSurvey. Giả sử bạn đã sử dụng 'limesurvey' làm tên thư mục để lưu trữ các tệp, URL này sẽ có dạng như https://www.example.com/limesurvey/admin.
Bạn sẽ thấy một màn hình đăng nhập. Đăng nhập bằng tên người dùng và mật khẩu quản trị viên mà bạn đã nhập trong quá trình cài đặt. Nếu bạn không thay đổi chúng trong trình cài đặt, thông tin đăng nhập mặc định là:
Người dùng: admin
Mật khẩu: mật khẩu
Nếu bạn vẫn đang dùng mật khẩu mặc định, hãy đổi ngay trong cài đặt tài khoản của bạn. Chúc bạn vui vẻ!
Cấu hình thêm
Để biết thêm các cài đặt khác, chẳng hạn như cấu hình email (SMTP) hoặc cài đặt bảo mật, xem Cài đặt tùy chọn và Thiết lập toàn cục.
Bộ nhớ đệm
LimeSurvey sử dụng bộ đệm tệp Yii theo mặc định, nhưng nó có thể được cấu hình để sử dụng các công cụ bộ đệm khác. Các bộ đệm khác có thể có là:
- Memcached (CMemCache)
- Redis (CRedisCache)
- APCu (CApcCache)
- Cơ sở dữ liệu (CDbCache)
Vui lòng xem Yii tài liệu để biết mô tả đầy đủ.
Kể từ LimeSurvey 4.0.0, bạn cũng có khả năng lưu các phép tính vào bộ đệm trong ExpressionScript. Điều này có thể giúp tăng tốc đáng kể tùy thuộc vào độ phức tạp của khảo sát. Để bật emcache, hãy thêm phần này vào tệp config.php (mảng thành phần):
'emcache' => array('class' => 'CFileCache'),
Giống như bộ đệm Yii chính, các hệ thống bộ đệm khác có thể được sử dụng.
Nếu tôi gặp vấn đề thì sao...
Giống như tất cả các chương trình máy tính, hầu hết thời gian mọi thứ sẽ hoạt động đúng như hướng dẫn, nhưng đôi khi thì không. Có quá nhiều lý do có thể khiến mọi việc không diễn ra theo đúng kế hoạch để mô tả ở đây. Nếu bạn gặp sự cố, trước tiên hãy xem Câu hỏi thường gặp về cài đặt. Nếu bạn không tìm thấy câu trả lời ở đó, vui lòng đăng vấn đề của bạn và bất kỳ thông báo lỗi nào lên Diễn đàn LimeSurvey, mở một phiếu hỗ trợ (chỉ dành cho khách hàng sử dụng LimeSurvey Cloud), hoặc tham gia kênh Discord của chúng tôi.