Configuration de Zend Framework pour fonctionner avec un environnement de développement local

Dans ce tutoriel, nous verrons comment installer et configurer Zend Framework pour fonctionner avec votre environnement de développement local. J'utiliserai Wampserver 2.0i sur un ordinateur Windows Vista, mais ces étapes peuvent être adaptées à XAMPP, MAMP ou à toute pile d'Apache, PHP et MySQL que vous utilisez..


Environnement de développement local

La première étape consiste évidemment à vous assurer que votre environnement de développement local, qu'il s'agisse de Wampserver, MAMP, XAMPP, etc., soit installé, configuré et en cours d'exécution, et que vous puissiez charger votre hôte local sans problèmes. Je suppose que vous avez déjà terminé cette partie car ce tutoriel n'est pas destiné à couvrir la configuration de l'environnement.



Télécharger le framework Zend

Le Zend Framework peut être téléchargé sur http://framework.zend.com. Vous pouvez télécharger le serveur de communauté complet, qui comprend une pile Apache, MySQL et PHP, ainsi que le Zend Framework lui-même et est déjà configuré pour vous. Mais si vous avez déjà votre propre environnement de développement, vous ne voudrez probablement pas le faire, ce qui est le but de ce tutoriel. Nous voulons seulement le Zend Framework. Vous pouvez sélectionner le package complet ou le package minimal en fonction de vos besoins. Si vous ne souhaitez pas vous inscrire sur le site, des liens de téléchargement direct sont disponibles au bas de la page de téléchargement..

Une fois le fichier archivé téléchargé, extrayez-le et placez le dossier à l'emplacement de votre choix. Je préfère généralement renommer le dossier extrait et le placer dans le dossier bin de mon dossier wamp. J'ai renommé le dossier zf et je l'ai placé dans mon dossier bin. Où que vous choisissiez de le placer, souvenez-vous de cet endroit car il sera important.


Configuration de l'outil Zend

L'étape suivante consiste à configurer l'outil Zend. Depuis la version 1.8, Zend Framework est désormais livré avec un outil de ligne de commande qui facilite la tâche de création et d’amorçage d’applications Zend Framework. Au lieu de configurer manuellement votre projet, vos contrôleurs, vos modèles, etc. et d'essayer de vous assurer que tout se trouve dans le bon dossier, l'outil Zend automatise ce processus et est très pratique à utiliser.

Pour utiliser l'outil Zend, vous devez pouvoir accéder au fichier… zf \ bin \ zf.bat (ou dans le cas de * nix systems zf.sh) à partir de la ligne de commande. Une façon de faire est de taper le chemin complet du fichier, puis la commande zf. Cependant, ceci est gênant et peu pratique. Au lieu de cela, il est préférable d’ajouter le fichier à votre chemin. Pour ce faire, nous le faisons en ouvrant les variables d’environnement et en ajoutant le chemin d’accès à zf.bat à notre variable PATH. Vous devez également vous assurer que php.exe est également dans votre chemin. La procédure à suivre varie en fonction de votre version de Windows. Si vous utilisez un système d’exploitation différent, cette procédure varie également. Il est important de noter que sous Windows, une fois que vous avez modifié les variables d’environnement, vous devez redémarrer votre ordinateur pour qu’elles prennent effet. Dans mon cas sous Windows Vista, j'ai simplement ajouté C: \ wamp \ bin \ zf \ bin \ zf.bat et c: \ wamp \ bin \ php \ php5.2.11 à ma variable de chemin.



Screencast complet



Créer un nouveau projet en utilisant l'outil Zend

Maintenant que l'outil Zend est configuré et configuré, il est temps de tester l'outil Zend. Accédez à la ligne de commande (ou au shell) et tapez "zf show version". Si l'outil Zend est correctement configuré, vous devriez voir une réponse telle que Zend Framework version 1.9.6. Vous pouvez maintenant procéder à la création d'un nouveau projet. Accédez à la ligne de commande et accédez au répertoire dans lequel vous souhaitez placer votre nouveau projet. Dans mon cas, je navigue vers C: \ wamp \ www, où je crée tous mes projets..

Si vous tapez simplement zf, vous verrez une liste de toutes les choses que vous pouvez faire avec l'outil Zend. Pour créer un nouveau projet nommé myzfproject, tapez simplement "zf create project myzfproject". Après quelques minutes, vous verrez un message indiquant que le projet a été créé. Si vous accédez au projet, vous pouvez voir votre nouveau dossier de projet avec tous les dossiers nécessaires, là où ils doivent être..



Inclure la bibliothèque Zend dans votre projet

Lorsqu'un nouveau projet est créé à l'aide de l'outil Zend, le dossier de la bibliothèque dans le projet est vide par défaut. Pour que votre projet s'exécute, il doit voir la bibliothèque Zend et il y a deux façons principales de rendre cela possible:

  1. Incluez le chemin de la bibliothèque qui se trouve déjà dans votre dossier zf (C: \ wamp \ bin \ zf \ bibliothèque) dans votre fichier php.ini..
  2. Placez une copie de la bibliothèque Zend dans le dossier de la bibliothèque de chaque projet que vous créez.

Chaque méthode a ses propres avantages et inconvénients et les différents développeurs ont leurs propres préférences. Ma préférence personnelle est de placer une copie de la bibliothèque dans chaque projet que je crée, car cela garantit que je maintiens toujours la séparation des versions pour mes projets. Cela conduit toutefois à avoir de nombreuses copies de la bibliothèque sur mon serveur, ce qui peut sembler redondant..

Avec l’outil Zend configuré et opérationnel, la création de modèles, de contrôleurs, etc. consiste simplement à accéder à la ligne de commande et à saisir la commande appropriée, par exemple. "zf crée contrôleur nom-contrôleur", "zf crée modèle nom-modèle", etc..

Si vous tapez simplement zf, vous verrez une liste de toutes les choses que vous pouvez faire avec l'outil Zend. Pour créer un nouveau projet nommé myzfproject, tapez simplement "zf create project myzfproject". Après quelques minutes, vous verrez un message indiquant que le projet a été créé. Si vous accédez au projet, vous pouvez voir votre nouveau dossier de projet avec tous les dossiers nécessaires, là où ils doivent être..


Si vous naviguez maintenant dans votre navigateur vers http: // localhost / myzfproject / public (ou quel que soit le lieu de configuration de votre projet), vous devriez voir la page d'accueil de Zend..



Dernières pensées

  • rewrite_module: La partie avant de votre application sera placée dans le dossier public de votre projet. Pour que cela soit accessible, rewrite_module doit être activé sur votre serveur Apache. Ce n'est pas activé par défaut lorsque vous installez Wampserver, alors assurez-vous de l'activer.
  • Hôtes virtuels: Il est généralement conseillé de créer un hôte virtuel pour votre projet dès le début et de le pointer vers le dossier public..
  • Erreur lors de la création du contrôleur:: Avec la version 1.9+ du Zend Framework, vous devrez peut-être supprimer une ligne de commentaire dans le fichier de configuration de votre application si vous rencontrez des problèmes pour créer des contrôleurs. Vous pouvez obtenir une "erreur fatale ne pouvant pas redéclarer la classe Zend_Loader ...". Je n'ai généralement pas eu ce problème avec 1.8 mais je l'ai rencontré plus d'une fois (et d'autres dans les forums Zend) dans la version 1.9. Cela se produit car il semble y avoir une référence en double à la bibliothèque dans la configuration. Vous pouvez voir qu'il semble y avoir un problème de redéclarer quelque chose, ce qui impliquerait que la chose est déjà déclarée. La solution à ce problème est trouvée dans le fichier de configuration. Ouvrez le fichier application.ini dans le dossier de configuration du projet (dans mon cas, C: \ wamp \ www \ myzfproject \ application \ configs \ application.ini) et mettez cette ligne en commentaire:
    includePaths.library = APPLICATION_PATH "/… / bibliothèque"
    en plaçant un point-virgule devant elle, ainsi:
    ; includePaths.library = APPLICATION_PATH "/… / bibliothèque"
    Vous ne devriez plus avoir cette erreur lorsque vous essayez de créer des contrôleurs, des vues ou des modèles pour votre projet..

Si vous avez terminé toutes les étapes avec succès, vous devriez maintenant pouvoir configurer rapidement des projets à l'aide de l'outil Zend dans votre environnement de développement local sans avoir à installer le serveur Zend..

J'espère que ce tutoriel a été utile et qu'il vous guidera dans la configuration du framework Zend sur votre environnement de développement local afin que vous puissiez commencer à explorer ce framework puissant et à apprendre à le travailler pour développer vos applications PHP..

Je souhaiterais connaître les différences d’installation dans différents environnements, telles que les adaptations que vous avez dû apporter à ces instructions sous XAMPP, MAMP ou votre environnement de développement local. Nous vous invitons donc à laisser des commentaires à propos de votre configuration particulière de la configuration du framework Zend et de l'outil Zend.