Framework Turbulences : TUTORIEL D'INSTALLATION

L'entreprise dans laquelle je fais mon stage utilise pour son application le framework turbulences
Le framework est très peu documenté donc plus on en parle, mieux ce sera. Voici comment installer Turbulences sur votre machine ubuntu :

Installation de Turbulences

Pré-requis

• Linux (Ubuntu 8.10 par exemple)
  
• Apache 2
  
  • "mod rewrite" activé
  
  
• MySQL version 5 ou +
• ImageMagick
  
• PHP version 5.2 ou + avec le module
  
  • mbstring
  
  

Installation

• Se mettre en mode Super Utilisateur (commande : su )
  
• Créer un répertoire pour le projet (par exemple sur le bureau)
  

  $ mkdir myproject
  $ cd myproject
  

  
  
• Installer une copie du framework
  
  

  $ svn export -rHEAD svn://turb.ulenc.es/turb/trunk .
  $ ls -l
  trunk
  $ cd trunk
  $ ls -1
  base
  whitecopy
  

  
  
• Vous avez 2 répertoires : base qui contient toutes les librairies du framework et whitecopy qui est un squelette de votre application. Il faut donc renommer ce :
  

  $ rename whitecopy myapp
  

  
  

Créer une base de donnée dans http://localhost/phpmyadmin et appelez là turb_db

Faire les liens symbolics

Créer le dossier var dans votre dossier de projet. Dans votre dossier var, créez aussi le dossier data, log, tmp et users.

Dans le dossier logs, créez un fichier appelé app.log, dans tmp, créez un dossier appelé compile.

Créez les liens symboliques pour l'appli :
#lien symb dans dyb_app/
ln -s var/tmp tmp

#lien symb dans dyb_app/public
ln -s ../var/data/public var

#lien symb dans dyb_app/public/script
ln -s ../../tmp/cache/script cache

#lien symb dans dyb_app/public/style
ln -s ../../tmp/cache/style cache

Configurer

Maintenant, on va configurer l'application

Le virtualhost

Configurer un virtualhost dans la config d'apache (/etc/apache2/httpd.conf)

• Vérifiez que ces variables soient bien parametrées :
• AllowOverride -> All
• DocumentRoot to myproject/myapp/public
  

Voici le code à entrer pour définir le virtualhost :

• 
  

  NameVirtualHost dyb.local
  <VirtualHost dyb.local>
  ServerAdmin l.bernard@doyoubuzz.com
  
  DocumentRoot /home/leny/workspace/dybmig/public/
  <Directory /home/leny/workspace/dybmig/public/>
  Options Indexes FollowSymLinks MultiViews
  AllowOverride All
  Order allow,deny
  allow from all
  </Directory>
  
  ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/
  <Directory "/usr/lib/cgi-bin">
  AllowOverride All
  Options  ExecCGI -MultiViews  SymLinksIfOwnerMatch
  Order allow,deny
  Allow from all
  </Directory>
  
  
  LogLevel warn
  </VirtualHost>
  
  
  

  
  

Le fichier myapp/var/host

Créer le fichier host dans le dossier var du dossier myapp et l'éditer. Mettre le nom du virtualhost et le nomero du port si besoin dans le fichier.
touch /myapp/var/host
gedit /myapp/var/host

écrirer turbapp et quitter

Le fichier myapp/conf/conf.yaml

Mettre à jour le fichier de configuration conf.yaml( myproject/myapp/conf/conf.yaml):

• la section "env" permet de définir la liste des environnements (dev, test, prod), La liste commence par "vhost:port": nom_de_lenvironnement
• Ensuite, il faut définir la configuration détaillée comme ci-dessous :
  

  
  app:
      id: myapp
      name: myapp
      version: 0.1
  env:
      vhosts:
          'turbapp': dev
      dev:
          public_url: http://$vhost/
          db:
              user: root
              pass: 
              base: turb_db
              host: localhost
              privileges: ALL
          imagemagick_path: /usr/bin/
          mysql_filename: /usr/bin/mysql
  
  

  
  

Permissions FS

Maintenant, assurez vous que les permissions de myapp/var sont correctement parametrés :

$ chgrp -R www-data myapp/var
$ chmod -R g+w myapp/var
$ find myapp/var -type d -exec chmod g+s {} \;

Lancez le script d'installation :

$ php myapp/script/install

Le script va controler que tout est bien parametré et va installer la base de données correctement.

Modifiez maintenant le fichier /etc/hosts et ajouter à la suite de localhost trubapp ou le nom de votre vhost

$ sudo gedit /etc/hosts
127.0.0.1 localhost turbapp

L'installation est finie. Testez en allant sur http://turbapp dans firefox. Si une page avec un logo rosé écrit turbulences apparait et que le message suivant apparait :

Your setup succeeded!

Vous pouvez alors vous attaquer au premier tutoriel. Sinon, relisez attentivement le tutoriel d'installation et au besoin écrivez un ticket sur le site de tubulences.com
Sources : turbulences.com