Installation en ligne de commande (CLI)

Introduction

Pour des installations automatisées (pour des images de machines virtuelles par exemple), nous pouvons, depuis LS v2.x, utiliser l'interface en ligne de commande (CLI) de LimeSurvey. Tous les fichiers nécessaires (et pour réinitialiser les mots de passe aussi) sont dans le répertoire WEBROOT/application/commands, le plus important étant console.php.

Les pré-requis

• PHP CLI doit être disponible;
• WEBROOT/application/config/config.php doit être accessible et alimenté par le processus d'installation automatique avec les bons paramètres;
• Les permissions sur les modules PHP doivent respecter les conditions nécessaires pour LimeSurvey;
• Une base MySQL dédiée doit être créée et l'utilisateur doit avoir les privilèges nécessaires pour l'utiliser.

Utilisation

Pour ces exemples d'illustration, nous considérerons que le répertoire WEBROOT sera /var/www/limesurvey.

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

Ce qui aura en sortie :

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

Les commandes suivantes sont disponibles :
 - install
 - message
 - migrate
 - plugin
 - resetpassword
 - shell
 - webapp

Pour avoir l'aide individuelle de chaque commande tapez :
   console.php help <command-name>

Syntaxe

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

• Le nom complet et la mot de passe sont entre guillemets s'ils contiennent des espaces ou bien d'autres caractères spéciaux;
• les autres paramètres, tels que le nom de la base de données, son type, son utilisateur, son mot de passe, etc, doivent être renseignés dans le fichier config.php avant l'exécution du script;
• le script doit être exécuté seulement depuis le répertoire WEBROOT/application/commands.

Exemple

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

aura pour sortie :

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

et la base de données sera alors créée ensuite.