Installation

Rejoignez-nous sur le chat à l'adresse https://gitter.im/claroline/Claroline.

Exigences
L'installation de la version de développement nécessite au minimum:

PHP >= 5.6 avec les extensions suivantes:

curl
fileinfo
gd
intl
mbstring
mcrypt
xml
json
zip
ffmpeg (optional)
MySQL/MariaDB >=5.0
composer (recent version)
node.js >= 5.5, <6.0
npm >= 3.7

Il est vivement recommandé de développer dans un environnement de type Unix.

Pour mysql >= 5.7, il y a une étape supplémentaire:

mysql -u**** -p
set global sql_mode='';
exit;

Installation

Depuis les sources de la version stable (v 10.x.x)

La procédure d'installation brute comprend plusieurs étapes à suivre dans l'ordre (extraction
des sources php, installation des dépendances dev, construction, création de la base de
données, etc.). À l'exception de l'étape de configuration, la procédure entière se fait au moyen
de scripts composer listés dans le fichier composer.json. Pour une installation à partir de
zéro, les commandes sont:

git clone -b 10.x http://github.com/claroline/Claroline

cd Claroline
php scripts/configure.php

composer update --prefer-dist --no-dev

php vendor/sensio/distribution-
bundle/Sensio/Bundle/DistributionBundle/Resources/bin/build_bootstrap
.php
npm install
npm run bower
npm run webpack

php app/console claroline:install

php app/console assetic:dump
php app/console assets:install

Si vous rencontrez des soucis lors de l'installation venez nous en parler sur gitter :
https://gitter.im/claroline/Claroline

Utilisation
Vous pouvez créer un premier utilisateur admin avec la commande:

php app/console claroline:user:create -a

Mise à jour
Pour mettre à jour une installation de développement existante, faites un "pull" des
changements les plus récents (ou d'une version spécifique) de ce dépôt et utilisez le script
sync-dev:

git pull
composer update --prefer-dist --no-dev

npm install
npm run bower
npm run webpack

php app/console claroline:update

Plugins
Les plugins sont gérés par composer tout comme tous les autres paquets de la plateforme.
Pour installer ou désinstaller les sources d'un plugin, vous l'ajoutez à ou vous l'enlevez de la
section concernée du fichier composer.json et vous lancez un update du composer, ou vous
utilisez des raccourcis comme composer require,...

Une fois que le paquet du plugin se trouve dans votre répertoire vendor, vous pouvez
procéder à l'installation ou la d"sinstallation en utilisant les commandes suivantes:

php app/console claroline:plugin:install FooBarBundle

php app/console claroline:plugin:uninstall FooBarBundle

Attention: Les procédures d'installation et de mise à jour de la plateforme telles que décrites
plus haut ne s'appliquent qu'à la distribution par défaut qui est livrée avec une paquet
déterminé de plugins. Si vous modifiez ce paquet, vous devrez maintenir vos propres fichiers
composer files et lancer composer update et php app/console claroline:update en fonction de
votre configuration.

Support navigateurs
Nous vous conseillons d'utiliser Claroline Connect avec les versions les plus récentes de
Mozilla Firefox ou Chromium.

Nous supportons:

 Mozilla Firefox (version la plus récente)

 Chromium (version la plus récente) et Google Chrome (version la plus récente)
 Microsoft Edge (version la plus récente)
 Microsoft Internet Explorer 11
 Safari (version la plus récente)

Pour une liste complète: http://caniuse.com/#feat=mutationobserver

Documentation
Pour la documentation développeurs, voir
https://github.com/claroline/Distribution/blob/master/doc/index.md.

Développement
Quelques assets de la plateforme sont gérés par webpack. Dans un environnement de
développement, il faut que le webpack dev server soit lancé. Vous pouvez le démarrer avec la
commande:

npm run watch

De toute évidence, vous aurez aussi besoin d'un serveur web intégrant php pour lancer
l'application. Une alternative est disponible:

1. En utilisant le serveur web intégré dans PHP

Ceci est la manière la plus simple et la plus conseillée pour lancer l'application en mode
développement. Pour démarrer le serveur, utilisez la commande fournie par le framework
symfony (plus de détails ici):

php app/console server:start

L'application sera accessible à l'adresse http://localhost:8000.

2. En utilisant un serveur web indépendant

Si vous désirez utiliser Apache ou Nginx pour votre développement, assurez-vous qu'ils
utilisent votre répertoire web et qu'ils accèdent à l'application à l'adresse
http://localhost/example-site/app_dev.php.

Vous devrez certainement régler des droits sur les répertoires suivants:

app/config
app/logs
app/sessions
files
web/uploads
Vous devez avoir les droits d'écriture sur chaque répertoire tant côté serveur que côté client.
Pour plus d'informations sur le sujet, reportez-vous au chapitre sur la configuration dans la
documentation officielle de Symfony.