Installation using a command line interface (CLI)

Introduction

When doing automated installs like in a Virtual Machine setup, we can use use LimeSurvey's (v2.x referred to here) CLI (Command Line interface) to good effect. The files used for this purpose (and for resetting passwords as well) are in the WEBROOT/application/commands folder, the one of interest here being console.php.

Pre-requisites

• PHP CLI should be available
• WEBROOT/application/config/config.php should be available and populated with the automated install's parameters.
• Folder permissions PHP Modules availability should match LimeSurvey needs
• Empty MySQL database should be created and the database use user should be properly privileged for it.

Применение

В демонстрационном примере предполагается, что WEBROOT (корень Web-сервера) это директория /var/www/limesurvey

cd /var/www/limesurvey/application/commands
php console.php

Будет показано:

Yii command runner (based on Yii v1.1.14)
Применение: console.php <command-name> [parameters...]

Доступны следующие команды:
 - install
 - message
 - migrate
 - plugin
 - resetpassword
 - shell
 - webapp

Чтобы посмотреть помощь по каждой конкретной команде, используйте следующий синтаксис:
   console.php help <command-name>

Синтаксис

php console.php <Admin User Name> <Admin User Password> <Full Name> <EMail ID>

• Полное имя и пароль заключенные в двойные кавычки, если они содержат пробелы или специальные символы.
• Все прочие параметры, такие как: имя базы, тип базы, имя пользователя БД, пароль пользователя БД, и т.д. объявляются в файле config.php прежде чем скрипт будет запущен.
• Скрипт должен быть выполнен только из директории WEBROOT/application/commands.

Пример

cd /var/www/limesurvey/application/commands
php console.php install limeadmin pwd123 Admin admin@mydomain.com

выведет следующий текст:

/var/www/limesurvey/installer/sql/create-mysql.sql

и база данных должна быть установлена.