Qu'est-ce que ZFTool ?
ZFTool est un utilitaire qui facilite la gestion d'un projet ZF2 lors du développement.
Cet outil permet de :
- créer un projet de ZF2 par l'installation d'une application squelette;
- créer un nouveau module dans une application de ZF2 existante;
- obtenir la liste de tous les modules installés à l'intérieur d'une application;
- obtenir le fichier de configuration d'une application ZF2;
- installer la bibliothèque ZF2 en précisant une version spécifique.
Comment l'installer pour l'utiliser dans un projet ?
Sous windows, il faut placer le fichier zftool.phar dans la répertoire qui va contenir le projet.
php composer.phar require zendframework/zftool:dev-master
./composer.json has been updated
Loading composer repositories with package information
Updating dependencies (including require-dev)
- Installing zendframework/zendframework (2.2.5)
Loading from cache- Installing zendframework/zftool (dev-master d73bf6f)
Cloning d73bf6f0ae6ce9b92acc72ecc8f336e2352f3ae0zendframework/zendframework suggests installing doctrine/annotations (Doctrine Annotations >=1.0 for annotation features)
zendframework/zendframework suggests installing ircmaxell/random-lib (Fallback random byte generator for Zend\Math\Rand if OpenSSL/Mcrypt extensions are unavail
able)
zendframework/zendframework suggests installing ocramius/proxy-manager (ProxyManager to handle lazy initialization of services)
zendframework/zendframework suggests installing zendframework/zendpdf (ZendPdf for creating PDF representations of barcodes)
zendframework/zendframework suggests installing zendframework/zendservice-recaptcha (ZendService\ReCaptcha for rendering ReCaptchas in Zend\Captcha and/or Zend\
Form)
Writing lock file
Generating autoload filesD:\www\monprojet>
Utilisation de ZFTool
L'installation de ZFToll a créé un dossier vendor\zendframework\zftool\.
On lancera les commandes en exécutant le fichier zf.php de ce dossier.
- Liste des modules du projet
- php vendor\zendframework\zftool\zf.php modules list
- Version de ZendFramework
- php vendor\zendframework\zftool\zf.php version
- Diagnostic
- php vendor\zendframework\zftool\zf.php diag [options] [module name]
[module name] (Optionnel) nom du module à tester.
-v --verbose Affiche des informations détaillées.
-b --break Arrête le test à la première erreur.
-q --quiet N'affiche rien sauf les erreurs.
--debug Affiche les information de débogage provenant des tests. - Création d'un projet
- php vendor\zendframework\zftool\zf.php create project <path>
<path> Dossier dans lequel on veut créer le projet. - Création d'un module
- php vendor\zendframework\zftool\zf.php create module <name> [<path>]
<name> Nom du module à créer.
<path> (Optionnel) Dossier racine de l'application ZF2. - Création d'un contrôleur
- php vendor\zendframework\zftool\zf.php create controller <name> <module> [<path>]
<name> Nom du module à créer.
<module> Le module dans lequel le contrôleur doit être créé.
<path> (Optionnel) Dossier racine de l'application ZF2. - Création d'une action
- php vendor\zendframework\zftool\zf.php create action <name> <controller> <module> [<path>]
<name> Nom du module à créer.
<controller> Nom du contrôleur dans lequel l'action doit être créée.
<module> Le module dans lequel le contrôleur doit être créé.
<path> (Optionnel) Dossier racine de l'application ZF2. - Configuration de l'application
-
php vendor\zendframework\zftool\zf.php config list
liste des options de configuration.
php vendor\zendframework\zftool\zf.php config get <name>
affiche la valeur de l'option demandée.
php vendor\zendframework\zftool\zf.php config set <name> <value>
enregistre une option et l'affecte de sa valeur. - Générateur de classmap
- php vendor\zendframework\zftool\zf.php classmap generate <directory> <classmap file> [--append|-a] [--overwrite|-w]
<directory> Le répertoire à scanner pour les classes PHP (mettre "." pour analyser le répertoire courrant)
<classmap file> Nom du fichier à generer. S'il n'est pas fourni, par défaut ce sera 'autoload_classmap.php' dans.
--append | -a Ajoute au fichiers'il existe.
--overwrite | -w Indique si on remplacera le fichiers'il existe. - Installation de la bibliothèque ZF2
- php vendor\zendframework\zftool\zf.php zf <path> [<version>]
<path> Le répertoire où doit être installé la bibliothèque ZF2.
<version> La version à installer, si non spécifiée la dernière version disponible sera installée.