Jobeet ZF2 - Jour 1 - Démarrage du projet

Chaque chapitre (ou jour) sera l'occasion d'apprendre Zend Framework 2 (ZF2) en codant un vrai site, de A à Z. Un cas concret, un peu poussé (ce n'est pas le tutoriel d'un n-ième "blog"), sera plus explicite que quelques exemples parsemés par-ci par-là.
Nous allons installer dans un premier temps un squelette ZF2

Prérequis

Dans un premier temps, vous avez besoin d'un environnement de développement comprenant:

• un serveur Web (Apache par exemple)
• PHP 5.3.3 ou supérieur
• une base de données (mysql, postgresql)
• Git
• une bière (à consommer avec modération) un café

De nombreuses ressources existent sur internet pour mettre en place un tel environnement, je n'aborderais donc pas ce point dans ce tutoriel

Pour ma part, voici mon environnement de développement:

• Debian 6 "Squeeze"
• Apache 2.2.16
• PHP 5.3.17
• MySQL 5.5.28

Installation du squelette ZendSkeletonApplication

Pour commencer on va récupérer le squelette d’application standard Zend. On fait donc un clone du dépôt via GIT dans le répertoire de notre projet. (pour moi, dans /home/project/jobeet)

git clone --recursive https://github.com/zendframework/ZendSkeletonApplication.git ./

Je créé ensuite un lien symbolique jobeet dans /var/www (qui pointera sur /home/project/jobeet/public)

ln -s /home/project/jobeet/public/ /var/www/jobeet

Nous devons maintenant créer notre hôte virtuel pour l'application afin que http://jobeet.localhost pointe sur le fichier index.php dans le répertoire /var/www/jobeet/

<VirtualHost *:80>
    ServerName jobeet.lxc
    DocumentRoot /var/www/jobeet
    # This should be omitted in the production environment
    SetEnv APPLICATION_ENV development
 
    <Directory "/var/www/jobeet">
        Options -Indexes -MultiViews +FollowSymLinks
        AllowOverride None
        Order allow,deny
        Allow from all

        RewriteEngine On
        RewriteCond %{REQUEST_FILENAME} -s [OR]
        RewriteCond %{REQUEST_FILENAME} -l [OR]
        RewriteCond %{REQUEST_FILENAME} -d
        RewriteRule ^.*$ - [NC,L]
        RewriteRule ^.*$ /index.php [NC,L]
</Directory>
</VirtualHost>

La section en gras active la ré-écriture d'URL. Le contenu provient du fichier .htaccess présent dans le repertoire public/ de l'application. Vous pouvez maintenant supprimer ce fichier .htaccess.

Si l'installation a fonctionné, vous devriez voir ça dans votre navigateur (http://jobeet.localhost)

Installation OK

Voyons un peu la structure du projet ainsi créé:

• - config: Ce répertoire contient tous nos fichiers de configuration
• application.config.php : Chargement des modules de notre applications
• autoload/*.php : Fichier des configurations spécifique à l'environnement (database.local.php, database.global.php..), ou lié à un module
• - data: Ce répertoire va contenir toutes les "écritures" de l'application (cache, logs, ...)
• - module: Nos différents modules
• - public: Toutes les ressources "publiques" (les images, les scripts javascript, les feuilles de style, ...)
• index.php: L'entrée de toute application ZF2
• - vendor: Contient toutes les librairies externes

Installation de ZendDeveloperTools (optionnel)

Il s'agit d'un module ZF2 destiné au debuggage de l'application
Une excellente source pour l'installation du ZendDeveloperTools pour ZF2

PS: Le tuto demande, lors de l'installation deBjyProfiler, de modifier le fichier de configuration de la base de données. J'ai du, pour cela, créer un fichier database.local.php dans le repertoire config/autoload

Installation de PHPUnit (optionnel)

Je ne parlerais pas dans ce cours de Développement Dirigé par les Tests (TDD pour Test-Driven Development): ce n'est pas le but de ces cours, et de nombreuses ressources sont présentes sur internet.
Mais je souhaiterais vous montrer comment Zend Framework et PHPUnit cohabitent, pour tester quelques-un de nos développements. Dans les prochains tutoriaux, les sections traitants des tests unitaires pourront être laissé de coté si cela ne vous intéresse pas, ou si vous êtes déjà un cador des tests unitaires (ce que je suis très loin d'être): cela n'aura pas d'incidence sur la suite des tutoriaux :-)

Voyons rapidement comment installer PHPUnit:

pear channel-discover pear.phpunit.de
pear channel-discover pear.symfony.com
pear install phpunit/PHPUnit

Nous avons maintenant un squelette d'application ZF2 fonctionnelle, ainsi qu'une barre de debug.

Vous pouvez récupérer les sources sur mon compte Github

Jour 2 - Le projet