View more presentations from Hugo Hamon.

Symfony2: 30 astuces et bonnes pratiques

View more presentations from Noel Guilbert.

Ce n’est pas un plugin, ni un module, ni une application, mais alors, qu’est-ce que c’est ? Je terminerai ce paragraphe quand j’aurai trouvé…

Création d’un bundle

Le bundle se place dans le dossier /src, il faut créer un dossier reprenant le nom de la société (ou du client) et y insérer le dossier du bundle. Par exemple, si je crée le bundle Test pour un client Sylvain, il s’appellera SylvainTestBundle et sera placé dans le répertoire /src/Sylvain/TestBundle.

Il faut un fichier principal pour définir la classe TestBundle dans /src/Sylvain/TestBundle/SylvainTestBundle.php :

<?php

namespace Sylvain\TestBundle;

use Symfony\Component\HttpKernel\Bundle\Bundle;

class SylvainTestBundle extends Bundle
{
}

Ensuite, on crée un controller HelloController dans /src/Sylvain/TestBundle/Controller/HelloController.php :

<?php

namespace Sylvain\TestBundle\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\Controller;
use Symfony\Component\HttpFoundation\Response;

class HelloController extends Controller
{
    public function indexAction()
    {
        return new Response('Hi!');
    }
}

Avec le fichier pour le routing, situé dans /src/Sylvain/TestBundle/Resources/config/routing.yml :

index:
    pattern:    /
    defaults: { _controller: SylvainTestBundle:Hello:index }

Activation d’un bundle

Maintenant, il faut dire à Symfony d’utiliser ce bundle, donc on édite le fichier /app/AppKernel.php et on ajoute une instance du bundle dans le tableau $bundles (méthode registerBundles()) :

<?php

use Symfony\Component\HttpKernel\Kernel;
use Symfony\Component\Config\Loader\LoaderInterface;

class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = array(
            /* ... */
            new Sylvain\TestBundle\SylvainTestBundle(),
        );

        /* ... */
    }
}

Ne pas oublier d’inclure le routing du bundle dans le routing global du projet, dans le fichier /app/config/routing.yml :

SylvainTestBundle:
    resource: "@SylvainTestBundle/Resources/config/routing.yml"

Attention, dans cet exemple, je n’ai pas crée de route particulière, il faut donc désactiver la route _welcome (activée en environnement de développement, dans le fichier /app/config/routing_dev.yml).

Installation simple

Il faut télécharger l’édition standard de Symfony2 à l’adresse suivante : http://symfony.com/download. Comme c’est une première découverte du framework, je ne vais pas aborder le versionning pour l’instant.

L’archive contient un dossier Symfony, il faut extraire le contenu de ce dossier à la racine du serveur Web (ou utiliser un virtualhost en le faisant pointer sur /web, comme en symfony 1).

On se retrouve donc dans un dossier de travail contenant ceci :

/app
/bin
/src
/vendor
/web
deps
deps.lock
LICENSE
README.md

Il suffit d’aller sur http://xxxx/config.php pour avoir un rapide test de la compatibilité du système pour exécuter Symfony2.

Ne pas oublier de donner les droits d’écriture à l’utilisateur Apache aux dossiers /app/cache et /app/logs

Configuration

Il y a un assistant qui facilite la création du fichier app/config/parameters.ini, il faut se rendre à l’adresse http://xxxx/app_dev.php/_configurator/step/0

Ce fichier contient, entre autres, la config BDD et SMTP :

; These parameters can be imported into other config files
; by enclosing the key with % (like %database_user%)
; Comments start with ';', as in php.ini
[parameters]
    database_driver   = pdo_mysql
    database_host     =
    database_name     =
    database_user     =
    database_password =

    mailer_transport  = smtp
    mailer_host       = localhost
    mailer_user       =
    mailer_password   =

    locale            = en

    secret            = ThisTokenIsNotSoSecretChangeIt

Ayé!

Symfony2 est fonctionnel! Et une jolie page d’accueil permet de jouer avec la barre de débug (profiler) et même de découvrir une mini démo de ses fonctionnalités (hello world, sécurité utilisateur) : http://xxxx/app_dev.php

Pour en savoir un peu plus au sujet de la mise en place du versionning d’un projet Symfony2 avec git : How to Create and store a Symfony2 Project in git.

Prochaine étape, découverte des bundles…

• jStat : a Javascript statistical library
• jFormer : form framework to quickly generate beautiful, standards compliant forms
• CamanJS : pure Javascript canvas manipulation
• jQuery Fundamentals
• Top 13 Javascript mistakes
• 15 Powerful jQuery Tips and Tricks for Developers

CSS

• Top 10 CSS 3 forms tutorials
• 10 techniques avancées et secrets de CSS2
• 20 useful collections of CSS3 cheat sheet, tips and resources
• The 30 CSS Selectors you Must Memorize
• 10+ useful tools to simplify CSS3 development
• CSS 3 Cheat Sheet (PDF)
• Vignetting effect with CSS3 radial gradient

HTML 5

• HTML5 Microdata: What is it, and why should you care?
• HTML5 : A technical specification for Web developers
• 50 useful HTML5 tutorials, techniques and examples for Web developers
• When to use the HTML5 “section” element?
• The current state of HTML5 forms

Et un petit dernier pour la route : HTML5/CSS3 cheatsheet.

Installation de MySecureShell

Il faut ajouter une source APT au fichier /etc/apt/sources.list :

deb http://mysecureshell.free.fr/repository/index.php/debian testing main

Et ajouter la clé du dépot :

gpg --keyserver hkp://pool.sks-keyservers.net --recv-keys E328F22B; gpg --export E328F22B | sudo apt-key add -
sudo apt-get update
sudo apt-get install mysecureshell

Ajout d’un utilisateur

sudo adduser --home /home/toto --shell /bin/MySecureShell toto

Impossible de transférer des fichiers, erreur exitcode 10

En cas de message d’erreur exitcode 10 lors de la copie de fichiers, il faut augmenter le nombre de connexions autorisées en éditant le fichier /etc/ssh/sftp_config :

LimitConnectionByUser 3

Sources

• http://forum.ubuntu-fr.org/viewtopic.php?id=441546
• http://doc.ubuntu-fr.org/mysecureshell_sftp-server

• 0,10% pour les commerçants ;
• 0,30% pour les artisans (hors Alsace) ;
• 0,17% pour les artisans (en Alsace) ;
• 0,20% pour les profession libérales.

Ce taux s’applique au CA. La contribution est due quel que soit le montant de chiffre d’affaires déclaré. Le paiement de cette contribution est effectué suivant la périodicité, selon les règles et sous les garanties et sanctions applicables au recouvrement des cotisations et contributions de Sécurité sociale du régime micro social simplifié. Cette contribution s’ajoute aux cotisations et contributions acquittées au titre de ce régime. (source : URSSAF).

J’utilise pour cela le logiciel Adobe Lightroom 3 qui gère assez bien les fichiers RAW de différents constructeurs. Un point qui me manque pour les fichiers .nef de Nikon, c’est que Lightroom n’arrive pas à indiquer la zone de mise au point, mais ce n’est pas très bloquant.

Tout d’abord, je m’occupe de l’importation des fichiers car sans cette étape, on ne pourra pas aller bien loin. Lightroom gère la connexion USB de mon Nikon D3000 et l’affiche dans la liste des sources de données (alors que mon appareil n’est pas reconnu en tant que mass-storage par le finder). Je stocke ensuite toutes les photos de la journée dans un dossier précis (dans ce cas : date + nom du modèle). Sur l’impression d’écran ci-dessous, les vignettes sont en noir et blanc, cela est du au fait que mon appareil photo était paramétré pour appliquer un filtre monochrome sur les photos (mais comme c’est du RAW, les informations de couleurs sont quand même enregistrées).

Ensuite, je m’occupe des mots-clés que j’associe aux différentes photos, sans aucun filtre, car j’ai pour habitude de ne rien supprimer, donc il faut que toutes les photos soient tagguées afin de facilement les repérer à l’avenir (dans ce cas, j’utilise les mots-clés suivants : paris, bastille, modèle, nom du modèle).

Si vous voulez intégrer ces mots-clés aux fichiers RAW (pour les utiliser avec un autre programme par exemple), clic-droit sur les photos concernées, puis « Métadonnées » et ensuite « Enregistrer les métadonnées dans les fichiers ».

Je sélectionne mes photos par source de lumière et j’applique un paramètre de balance des blancs prédéfini (auto, lumière naturelle, temps nuageux, etc…). En général, cela est suffisant, mais dans certains cas, il faut ouvrir la photo et le faire manuellement (sur la page de développement, appuyez sur la touche W et cliquez sur une zone blanche de la photo).

Maintenant, je peux parcourir les photos et leur assigner un libellé (rouge pour celles qui ne m’intéressent pas, vert pour celles qui m’intéressent) et éventuellement supprimer celles qui sont vraiment ratées ou hors-sujet.

Cette étape peut prendre du temps, et il faut parfois prendre du recul pour éviter d’exclure de bonnes images. Quand je suis en mode « grille », j’utilise un filtre d’attribut pour n’afficher que les photos « sans libellé » et voir la liste diminuer au fur-et-à-mesure de mes sélections :

Pour être sûr, il est préférable de faire plusieurs passes, même sur les photos libellées « rouge ».

Ensuite, je ne m’occupe que des photos libellées « vertes » et je commence le recadrage des photos qui en ont besoin (touche R). Sur l’exemple ci-dessous, j’en ai profité pour redresser légèrement la photo et placer correctement le sujet en respectant la règle des tiers.

Après, je peux passer à la phase de développement (touche D). Cette phase n’est pas toujours nécessaire et peut prendre beaucoup de temps si on commence à jouer avec la multitude d’outils proposées par Lightroom (ce qui peut devenir dangereux, il ne faut pas en abuser).

Sur cette image, j’ai augmenté la vibrance (+50) pour la rendre très colorée, et j’ai saturé le rouge (+50) pour faire ressortir le sac à main (seul élément rouge de l’image). Je rajoute également un vignettage, ce qui attire encore plus le regard sur le sujet de l’image. Une fois que la photo est à votre goût, appuyez sur la touche P pour la marquer comme retenue (drapeau blanc en bas de la fenêtre de développement et de la grille).

Si les paramètres affectés à une image vous conviennent et que vous ne voulez pas perdre de temps à les réappliquer sur chaque différente image de la série (même lieu, même lumière…), vous pouvez les synchroniser. Il suffit pour cela, de cliquer l’image servant de référence, puis, en maintenant la touche ⌘ enfoncée, sélectionner les images qui recevront les paramètres. Sur cet exemple, on reconnait l’image de référence (l’image n°1) car elle apparaît avec un fond gris plus clair.

Ensuite, cliquez sur le bouton « Synch. param. » situé en bas à droite de l’écran et sélectionnez les paramètres. Ils seront copiés de la première image sélectionnée vers les autres images faisant partie de la sélection.

Cependant, dans certains cas, il peut ne pas être conseillé de synchroniser tous les paramètres aveuglément, car l’exposition peut varier d’une image à l’autre et donner un résultat différent.

Au fur et à mesure de mes différents essais, je continue à filtrer les photos en les acceptant (touche P) ou en les rejetant (touche X). Ce qui est intéressant, quand on travaille avec un logiciel comme Lightroom (ainsi que des fichiers aux format RAW), c’est que rien n’est supprimé (les photos rejetées, les paramètres de base, les métadonnées, etc…), donc il est toujours possible de revenir en arrière.

Et voilà, au bout d’un moment, je me retrouve avec une vingtaine de photos, alors qu’à l’origine, j’en avais 150, et ce sont celles que j’ai estimées les plus réussies. Je peux maintenant les exporter, les utiliser, etc…

sudo apt-get install pure-ftpd-mysql

Connectez-vous au serveur MySQL :

mysql -u root -p

Créez l’utilisateur MySQL ftp (en changeant le mot de passe) :

CREATE USER 'ftp'@'localhost' IDENTIFIED BY 'mot_de_passe';
GRANT USAGE ON *.* TO 'ftp'@'localhost' IDENTIFIED BY 'mot_de_passe';
CREATE DATABASE IF NOT EXISTS `ftp` DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
GRANT ALL PRIVILEGES ON `ftp`.* TO 'ftp'@'localhost';

Ensuite, créez la table qui contiendra les utilisateurs :

USE `ftp`;
CREATE TABLE `users` (
`login` varchar(16) COLLATE utf8_unicode_ci NOT NULL DEFAULT '',
`is_active` enum('0','1') COLLATE utf8_unicode_ci NOT NULL DEFAULT '0',
`password` varchar(64) COLLATE utf8_unicode_ci NOT NULL DEFAULT '',
`uid` varchar(11) COLLATE utf8_unicode_ci NOT NULL DEFAULT '-1',
`gid` varchar(11) COLLATE utf8_unicode_ci NOT NULL DEFAULT '-1',
`home` varchar(128) COLLATE utf8_unicode_ci NOT NULL DEFAULT '',
`up_bandwidth_kbps` smallint(5) NOT NULL DEFAULT '0',
`down_bandwidth_kbps` smallint(5) NOT NULL DEFAULT '0',
`comment` tinytext COLLATE utf8_unicode_ci NOT NULL,
`quota_megabytes` smallint(5) NOT NULL DEFAULT '0',
PRIMARY KEY (`login`)
) ENGINE=MyISAM DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci;
exit;

Pour créer un utilisateur FTP, il faut exécuter la requête suivante :

INSERT INTO `users` (`login`, `is_active`, `password`, `uid`, `gid`, `home`, `up_bandwidth_kbps`, `down_bandwidth_kbps`, `comment`, `quota_megabytes`) VALUES('login', '1', md5('password'), '1000', '1000', '/home/login', 0, 0, '', 0);

Maintenant que MySQL est prêt, il faut configurer pure-ftp en éditant le fichier /etc/pure-ftpd/db/mysql.conf avec les paramètres MySQL crées précédement :

# Optional : MySQL server name or IP. Don't define this for unix sockets.
# MYSQLServer     127.0.0.1

# Optional : MySQL port. Don't define this if a local unix socket is used.
# MYSQLPort       3306

# Optional : define the location of mysql.sock if the server runs on this host.
MYSQLSocket      /var/run/mysqld/mysqld.sock

# Mandatory : user to bind the server as.
MYSQLUser       ftp

# Mandatory : user password. You must have a password.
MYSQLPassword   mot_de_passe

# Mandatory : database to open.
MYSQLDatabase   ftp

# Mandatory : how passwords are stored
# Valid values are : "cleartext", "crypt", "md5" and "password"
# ("password" = MySQL password() function)
# You can also use "any" to try "crypt", "md5" *and* "password"
MYSQLCrypt      md5

# In the following directives, parts of the strings are replaced at
# run-time before performing queries :
#
# \L is replaced by the login of the user trying to authenticate.
# \I is replaced by the IP address the user connected to.
# \P is replaced by the port number the user connected to.
# \R is replaced by the IP address the user connected from.
# \D is replaced by the remote IP address, as a long decimal number.
#
# Very complex queries can be performed using these substitution strings,
# especially for virtual hosting.

# Query to execute in order to fetch the password
MYSQLGetPW      SELECT password FROM users WHERE login="\L" AND is_active="1"

# Query to execute in order to fetch the system user name or uid
MYSQLGetUID     SELECT uid FROM users WHERE login="\L" AND is_active="1"

# Optional : default UID - if set this overrides MYSQLGetUID
#MYSQLDefaultUID 1000

# Query to execute in order to fetch the system user group or gid
MYSQLGetGID     SELECT gid FROM users WHERE login="\L" AND is_active="1"

# Optional : default GID - if set this overrides MYSQLGetGID
#MYSQLDefaultGID 1000

# Query to execute in order to fetch the home directory
MYSQLGetDir     SELECT home FROM users WHERE login="\L" AND is_active="1"

# Optional : query to get the maximal number of files
# Pure-FTPd must have been compiled with virtual quotas support.
# MySQLGetQTAFS  SELECT QuotaFiles FROM users WHERE login="\L" AND is_active="1"

# Optional : query to get the maximal disk usage (virtual quotas)
# The number should be in Megabytes.
# Pure-FTPd must have been compiled with virtual quotas support.
MySQLGetQTASZ  SELECT quota_megabytes FROM users WHERE login="\L" AND is_active="1"

# Optional : ratios. The server has to be compiled with ratio support.
# MySQLGetRatioUL SELECT ULRatio FROM users WHERE login="\L" AND is_active="1"
# MySQLGetRatioDL SELECT DLRatio FROM users WHERE login="\L" AND is_active="1"

# Optional : bandwidth throttling.
# The server has to be compiled with throttling support.
# Values are in KB/s .
MySQLGetBandwidthUL SELECT up_bandwidth_kbps FROM users WHERE login="\L" AND is_active="1"
MySQLGetBandwidthDL SELECT down_bandwidth_kbps FROM users WHERE login="\L" AND is_active="1"

# Enable ~ expansion. NEVER ENABLE THIS BLINDLY UNLESS :
# 1) You know what you are doing.
# 2) Real and virtual users match.
# MySQLForceTildeExpansion 1

# If you upgraded your tables to transactionnal tables (Gemini,
# BerkeleyDB, Innobase...), you can enable SQL transactions to
# avoid races. Leave this commented if you are using the
# traditionnal MyIsam databases or old (< 3.23.x) MySQL versions.
# MySQLTransactions On

Il reste à configurer certaines options de pure-ftp en créant un fichier par paramètre avec sa valeur. Les noms sont assez explicites :

cd /etc/pure-ftpd-conf
sudo echo ,21 > Bind
sudo echo 4500 4600 > PassivePortRange
sudo echo yes > ChrootEveryone
sudo echo yes > ProhibitDotFilesRead
sudo echo yes > ProhibitDotFilesWrite
sudo echo yes > NoChmod
sudo echo yes > BrokenClientsCompatibility
sudo echo 4 > MaxClientsPerIP
sudo echo 20 > MaxClientsNumber
sudo echo no > PAMAuthentication
sudo echo no > UnixAuthentication
sudo /etc/init.d/pure-ftpd restart

Et c’est tout. Source : How to install and configure pure-ftpd

Côté serveur

Il faut tout simplement installer OpenSSH (qui a de fortes chances d’être déjà installé) :

sudo apt-get install ssh

Si le réseau de votre boulot bloque le port SSH (ce qui est fort possible), il faudra changer le port utilisé par le serveur en éditant le fichier /etc/ssh/sshd_config (en utilisant le port 443 par exemple, ou tout autre port non utilisé) :

# What ports, IPs and protocols we listen for
Port 443

Et c’est tout, le serveur est maintenant prêt à faire suivre les requêtes TCP d’un client SSH.

Côté client

Client MacOS

Le petit utilitaire SSHTunnel est parfait pour cela et assez simple à configurer.

Client Linux

Il existe un outil Gnome pour configurer graphiquement les tunnels SSH sur une machine Linux : gstm (SSH Tunnel Manager), qui se contente de lancer la commande suivante :

ssh -N -f user@serveur -p 443 -D9999

Toutes les requêtes envoyées vers localhost:9999 seront maintenant encapsulées dans des paquets SSH et redirigées via serveur:443. Les options -N -f servent à éviter d’ouvrir la console SSH distante.

Client Windows

Sous Windows, il y a le célèbre PuTTY, et un tutorial assez simple pour le configurer pour une utilisation avec un tunnel.

Pour plus d’informations

Vous pouvez trouver plus d’informations sur ces différents liens :

• Quick-Tip: SSH Tunneling Made Easy
• Comment constituer des tunnels ssh, pour utiliser POP, IMAP, SMTP, FTP, et plus encore depuis l’extérieur ?
• Tunnel ssh : ssh -L (local) et ssh -R (remote) en bref
• [Tuto] Tunnel SSH et Firefox & Co

L’option --skip-extended-insert permet d’avoir un enregistrement par ligne, ce qui sera très pratique pour les diff SVN et l’option --skip-dump-date retire le timestamp à la fin du fichier, et évite ainsi de créer une nouvelle version du fichier si il n’y a eu aucune modification sur la base.

J’ai fait ce script vite fait hier soir, et il fonctionne bien pour moi, je pense pouvoir l’améliorer à l’avenir et suis ouvert à toute proposition ;) Il suffit juste de configurer les 6 variables au début du fichier et de le mettre dans une crontab, et le tour est joué!

#!/bin/bash

export SVN_USERNAME='svn_user'
export SVN_PASSWORD='svn_pwd'
export SVN_REPOSITORY='http://my_svn_repository.com/'
export MYSQL_USERNAME='mysql_user'
export MYSQL_PASSWORD='mysql_pwd'
export TMP_DIRECTORY='/tmp/mysqlsvn_backup_tmp'

if [ -d $TMP_DIRECTORY ]; then
        echo "Cleaning tmp directory"
        rm -Rf $TMP_DIRECTORY
fi;

echo "Initializing tmp directory"
mkdir $TMP_DIRECTORY
cd $TMP_DIRECTORY

echo "Checking out repository"
svn co $SVN_REPOSITORY . --username=$SVN_USERNAME --password=$SVN_PASSWORD

for DB_NAME in `echo 'SHOW DATABASES;' | mysql -u$MYSQL_USERNAME -p$MYSQL_PASSWORD --batch -N`; do
        export filename=$DB_NAME.sql

        echo "Dumping '$DB_NAME' database"
        mysqldump -u$MYSQL_USERNAME -p$MYSQL_PASSWORD --skip-extended-insert --skip-dump-date $DB_NAME > $filename

        svn add $filename
done

echo "Sending files to repository"
svn ci -m "Automatic backup $(date +%Y)-$(date +%m)-$(date +%d) $(date +%H):$(date +%M)" 

echo "Removing tmp directory"
rm -Rf $TMP_DIRECTORY