mon-compte

Prérequis

L'environnement de développement requiert les logiciels suivants:

• Node.js
  • coffee-script
  • grunt-cli
  • bower
• Compass
• php et php-cgi
• composer
• mysql ou MariaDb

OSX

• Installer Node.js et les paquets associés
  • Installer Homebrew
    • Dans le terminal, lancer la commande suivante : ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)"
    • Installer les outils de développement en ligne de commande de Xcode si jamais cela vous est demandé.
    • Vérifiez la bonne installation de homebrew avec la commande : brew doctor
    • Corrigez ce qui doit l'être le cas échéant.
  • Installez les paquets npm requis avec la commande : npm install -g coffee-script grunt-cli bower
• Installer Compass
  • Lancez la commande : sudo gem install compass
• Installer MAMP
  • Récupérez et exécutez l'installeur depuis la page de téléchargement.
  • Ajoutez les commandes php dans votre PATH avec la commande : echo -e "\nexport PHP_HOME=/Applications/MAMP/bin/php/php5.4.26\nexport PATH=\$PHP_HOME/bin:\$PATH\n" >> ~/.bash_profile
  • Activez l'affichage des erreurs php en éditant le fichier /Applications/MAMP/bin/php/php5.4.26/conf/php.ini
    • Changez les valeurs suivantes :
      • display_errors = On
      • display_startup_errors = On
• Installer Composer
  • Lancez les commandes suivantes :
    • mkdir ~/.bin
    • curl -sS https://getcomposer.org/installer | php -- --install-dir=$HOME/.bin
    • echo -e "\nexport PATH=\$HOME/.bin:\$PATH\n" >> ~/.bash_profile
• Mettez à jour votre environnement courant avec la commande : source ~/.bash_profile

Linux

• Utilisez le gestionnaire de paquet de votre distrib pour installer node.js, ruby gems, php 5.4 (avec php-cgi) et mysql.
• Installer les paquets npm requis : sudo npm install -g coffee-script grunt-cli bower
• Installer Compass
  • Lancez la commande : sudo gem install compass
• Installer Composer
  • Suivez les instructions officielles.
  • Ajoutez le script (composer.phar) à votre PATH.

Windows

Installez Linux ;-)

• Ubuntu
• Ubuntu Gnome
• Debian

Ou si vous êtes vraiment obligés, vous pouvez installer tous les logiciels requis grâce à Chocolatey.

Cela dit, envisagez quand même linux ;-)

Recommandations optionnelles

• GitX-dev
• gitg
• Sublime Text
• Atom

Mise en place du projet

1. Cloner le dépôt du projet.
2. Dans le dossier du projet, lancer les commandes suivantes :
   • npm install
   • bower install
   • composer.phar install
3. Dans le dossier config
   • Copiez auth-user.json.dist en auth-user.json
   • Copiez local_doctrine.php.dist en local_doctrine.php
   • Modifier les valeurs pertinentes dans les copies des fichiers précédents.

Pour démarrer le serveur de dev, il suffit alors de lancer dans le dossier du projet la commande grunt server.

Une fenêtre de navigateur va alors s'ouvrir automatiquement vers l'adresse du serveur local.

Celui-ci supporte le live reload lorsque les fichiers du projet sont modifiés.

Pour simuler l'authentification Lemonldap, modifiez le userId contenu dans le fichier auth-user.json. Celui-ci est rechargé à chaque requête, vous pouvez donc le modifier sans relancer le serveur.

Déploiement

• Créez un fichier deploy/<NOM_DE_CONF>.conf sur la base de deploy/example.conf.dist.
• Compiler le projet avec la commande grunt
  • Les fichiers compilés seront générés dans le dossier dist.
• Déployez les fichiers compilés avec la commande deploy/rsync.to <NOM_DE_CONF>

####Note : Si dans le fichier de configuration de déploiement la variable TARGET_GROUP est définie, le script tentera d'assigner les droits d'écriture à ce groupe unix sur les fichiers déployés par lui-même.

Si la variable est vide ou absente, aucune modification ne sera effectuée.

License

Mon-compte est distribué sous licence publique générale GNU v2 ou supérieure.