Instalação através de uma interface de linha de comandos (CLI)

Introdução

Ao realizar instalações automatizadas (por exemplo, numa configuração de máquina virtual), podemos utilizar com bons resultados a CLI (interface de linha de comandos) do LimeSurvey (aqui referida a v2.x). Os ficheiros utilizados para este fim (e também para repor senhas) encontram-se na pasta WEBROOT/application/commands, sendo o ficheiro de interesse neste caso o console.php.

Pré-requisitos

• O PHP CLI deve estar disponível
• O ficheiro WEBROOT/application/config/config.php deve estar disponível e preenchido com os parâmetros fornecidos pelo processo de instalação automatizada.
• A disponibilidade das permissões dos módulos PHP deve corresponder às necessidades do LimeSurvey.
• Deve ser criada uma base de dados MySQL vazia e o utilizador deve ter os privilégios adequados para a utilizar.

Utilização

Para fins ilustrativos, assumimos no nosso exemplo que a WEBROOT é /var/www/limesurvey.

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

Isto irá mostrar:

Yii command runner (based on Yii v1.1.14)
Usage: console.php <command-name> [parameters...]

The following commands are available:
 - install
 - message
 - migrate
 - plugin
 - resetpassword
 - shell
 - webapp

To see the individual command help, use the following:
   console.php help <command-name>

Sintaxe

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

• O Nome completo e a senha devem ser colocados entre aspas duplas se contiverem espaços ou outros caracteres especiais.
• Todos os restantes parâmetros, como o nome da base de dados, o tipo de base de dados, o utilizador da base de dados, a senha da base de dados, etc., devem ser preenchidos no ficheiro config.php antes da execução do script.
• O script deve ser executado apenas a partir da pasta WEBROOT/application/commands e dentro da mesma.

Exemplo

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

produz o seguinte texto:

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

e a base de dados deverá ficar corretamente instalada neste momento.