Zend Tool - Hoe werkt het?

De installatie van Zend_Tool:
Allereerst, zorg ervoor dat je de laatste versie van Zend Framework gedownload hebt. Wanneer je dat niet zeker weet, controleer het dan op deze pagina: Laatste versie Zend Framework.

Wat is Zend_Tool nu precies? Het is command line tool die veel werk uit handen kan nemen! Laten Zend_Tool gaan installeren. Zoals je waarschijnlijk al verwachte dient Zend_Tool voor Windows anders geïnstalleerd te worden dan bij Linux. Hieronder beide installatie mogelijkheden weergegeven:

Windows
Ga naar je HTTP Documentens (htdocs) folder, en extract daar je gedownloade Zend Framework. (Controleer voor de zekerheid of de Tool map in de Zend folder staat)

Wanneer je hem uitgepakt hebt krijg je twee mappen genaamd: `bin` en `library`.

De volgende stap is het toevoegen van de `bin` map aan je 'Environment Variables' (Omgevingsvariabelen). Doe dat als volgt:

- Ga naar je 'Configuratiescherm'.
- Kies dan voor 'Prestaties en onderhoud'.
- Klik daarna op 'Systeem'.

Dan opent er een scherm genaamd 'Systeem eigenschappen'.

- Klik dan op het tabblad 'Geavanceerd'.
- Onderin staat de optie 'Omgevingsvariabelen', klik daarop.

Zoek in het vakje 'Systeemvariabelen' (Onderste) naar de variabele genaamd 'Path' en klik daarop (dubbelklik). Voeg aan het eind aan het eind het volgende toe:

;path\naar\jouw\htdocs\zendframeworkmap\bin

Wees er zeker van dat dit klopt (ook de puntkomma voor het path), anders gaat Zend_Tool nooit werken.

Herstart daarna je computer om de 'Omgevingsvariabelen' te herladen.

Linux:
Kopieer de gedownloade Zend Framework naar je Download folder, (Wanneer deze er nog niet staat) en open het middels een dubbelklik. Kopieer het naar 'usr/local/ZendFramework' door in de Terminal het volgende in te voeren:

sudo cp -r ~/Downloads/ZendFramework/ /usr/local/ZendFramework/

Bewerk daarna middels het volgende je 'bash profile' om een alias aan te maken:

open ~/.bash_profile

Voeg daarna aan het eind van het bestand het volgende toe om een alias te genereren:

zf=/usr/local/ZendFramework/bin/zf.sh

Sla het bestand op en sluit de terminal.

Testen Zend_Tool
Wanneer alles naar behoren is uitgevoerd is Zend_Tool nu gereed voor gebruik. Dat kan worden getest door de volgende code in de terminal / prompt te typen.

zf show version

Wanneer alles naar behoren werkt zal je iets als het volgende op je scherm te zien krijgen:

Zend Framework Version: 1.11.10

Om alle commands van Zend_Tool te kunnen zien, typ het volgende:

zf --help

Het genereren van een project:

Om een nieuw project te genereren typ het volgende:

zf create project denaamvanhetproject

Zend_Tool genereert dan automatisch de volgende mappenstructuur:

- Application
      - Controllers
            > IndexController.php
            > ErrorController.php
      - Models
      - Configs
            > application.ini
      - Views
            - Helpers
            - Scripts
                  - Index
                        > index.phtml
                  - Error
                        > error.phtml
      > Bootstrap.php
- Library
- Public
      > index.php
      > .htaccess (hidden)
- Tests

Wanneer je nu gaat naar `http://localhost/denaamvanhetproject/public/` krijg je een test pagina van Zend Framework te zien. Oftewel, het project is succesvol aangemaakt!

Even wat uitleg oven de mappenstructuur.

In de map 'Application' bevinden zich de Controllers de Models en de Configs. Wanneer je nog niet precies weet wat dat allemaal inhoud raad ik je aan om eerst een paar andere tutorials over het MVC en Zend Framework te lezen.

In de map 'Public' bevindt zich de Javascript en de CSS bestanden. Ook moeten daar de plaatjes worden opgeslagen.

Controllers, Actions, Models, Layouts en Forms:
Tijd om te laten zien hoe met Zend_Tool nu precies Controllers, Actions of Models genereert.

Controller / Action:
Allereerst een controller, stel je wilt een BlogController genereren. Typ dan het volgende in om een Controller te genereren.

zf create controller Blog

En voor een Action het volgende:

zf create action index Blog

De syntax van de 'create' functionaliteit van Zend_Tool is dus als volgt:

zf create <methode> <actionname> <controllername>

In de `BlogController` is na het uitvoeren van het bovenstaande commando een `Index` action toegevoegd. Daarnaast is ook de view `Index` toegevoegd:

- Views
      - Scripts
            - Blog
                  > index.phtml

Models
Tijd om Table / Row objecten te gaan generen middels Zend_Tool. Type het volgende commando:

zf create db-table Blogs blogs

De `create` functie heeft nu een bestand genaamd `Blogs.php` aangemaakt. In de map: `application/models/DbTable`. In het bestand is een class genaamd `Application_Model_DbTable_Blogs` aangemaakt welke de Zend_Db_Table_Abstract extends.

Het toevoegen van methodes aan de `Application_Model_DbTable_Blogs` klasse is naar mijn weten met Zend_Tool niet mogelijk. Deze moet je dus handmatig toevoegen.

Layouts
Ook voor een (default) layout kan je bij Zend_Tool terecht. Middels de volgende code maakt Zend_Tool een default layout aan. (Path: application/layouts)

zf enable layout

Ook heeft Zend_Tool de application.ini geupdate. Daarin is de volgende aan de productie sectie toegevoegd:

resources.layout.layoutPath = APPLICATION_PATH "/layouts/scripts/"

Zend Framework heeft een simpele template aan de (default) layout toegevoegd. Deze kan ten alle tijden worden aangepast naar de juiste template.

Forms:
Zend_Form implementeren. Ook daar draait Zend_Tool zijn hand niet voor om. Middels de volgende code genereert Zend_Tool en nieuw Zend_Form object.

zf create form naamvanjeformulier

Zend_Tool genereert nu een file `naamvanjecformulier.php` in de map: `application/forms`. In de file staat enkel een init() methode waarin je het formulier nog kan uitbreiden.

Conclusie:
Zoals je hebt kunnen lezen is het generen van een applicatie middels Zend_Tool zeer gemakkelijk. Wanneer je vragen en/of opmerkingen hebt hoor ik dat graag zodat ik de tutorial (evt) kan verbeteren.

Bedankt voor het lezen en veel succes met Zend_Tool!