ACHTUNG:
Dieses Tutorial wird nicht mehr weitergeführt, da es auf ältere Versionen des Zend Frameworks aufbaut. Das neue Projekt ist hier:
Zend Framework Tutorial - Wir bauen ein Content Management System (CMS)

Im ersten Teil dieses Tutorials habe ich in einer Einführung den Aufbau dieses Tutorials erläutert und einen Überblick über die in diesem Tutorial verwendeten Zend Framework Komponenten gegeben. Zudem habe ich die Anforderungen an das TravelloBlog, unserer Beispiel-Anwendung, zusammengefasst. Wenn du den ersten Teil noch nicht gelesen hast, hole dies bitte schnell nach.

In diesem zweiten Teil gibt es zunächst etwas Theorie, danach erläutere ich den grundlegenden Systemaufbau für unser TravelloBlog Projekt. Wir werden unsere Verzeichnisstruktur aufbauen und ein erstes "Hallo Welt!" erstellen.

Wenn du über neue Tutorial Teile informiert werden möchtest, abonniere am besten den Feed dieses Blogs. Dann verpasst du garantiert keinen Teil des Tutorials. Es gibt auch Übersicht mit den bisher erschienen Teilen des Tutorials.

Wichtig: Dieses Tutorial setzt die Zend Framework Version von mindestens 1.8.0 voraus und wird bei der Verwendung einer älteren Version unter Umständen nicht zu 100% funktionieren (.z.B. Bootstrapping).

Inhaltsverzeichnis

• Verzeichnisstruktur
• Zend_Tool_Project
• Anlegen eines Projektes unter XAMPP
• Anlegen eines Projektes unter Zend Server
• Unser erstes Projekt
• .htaccess
• Einen VirtualHost einrichten
• Willkommen beim ZF
• Download
• Zusammenfassung
• Changelog
• Navigation
• Kommentare

Verzeichnisstruktur

Im Zend Framework Manual gibt es einen guten Vorschlag für eine Verzeichnisstruktur.

Du kannst du jetzt natürlich alle Verzeichnisse und Dateien manuell anlegen und abtippen - das ist arbeitsintensiv. Die gute Nachricht ist, dass seit der Version 1.8 des Zend Frameworks ein Tool hinzugekommen ist, das dir diese Arbeit abnimmt: Zend_Tool_Project.

Zend_Tool_Project

Mit Zend_Tool steht, wie bereits erwähnt, ein sehr hilfreiches Hilfsmittel zur Verfügung. Mit Zend_Tool_Project kann schnell und unproblematisch ein neues Projekt mit einer standardisierten Verzeichnisstruktur und Standarddateien angelegt. Zusätzlich kam auch noch Zend_Tool_Framework hinzu. Mit diesem Tool kann man bei einem bestehenden Projekt z.B. Controller, Module usw. im Standardformat anlegen.
Zunächst einmal brauchen wir jedoch Zend_Tool_Project.

Ich zeige hier mal die Vorgehensweise auf bei Verwendung von XAMPP und Zend Server. Wenn du auf einer anderen Umgebung arbeitest, sollte es sinngemäß funktionieren.

Anlegen eines Projektes unter XAMPP

Bei allen Pfadangaben gehe ich von der Standard Installation aus. Wenn du XAMPP in einem anderen Pfad installert hast, musst du natürlich die Pfadangaben entsprechend ändern!
Die Anwendung ist denkbar einfach. Der einzige Stolperstein ist, dass der Pfad zu den Zend Libraries gesetzt werden muss. So funktioniert es auf meinem lokalen Rechner:

Zunächst einmal muss die Zend Library irgendwo auf deiner Platte sein. Sinnvoller Weise ist das in dem Verzeichnis, wo auch deine anderen Webapplikationen liegen. Bei mir ist das "c:\xampp\htdocs". Wahrscheinlich hast du dir das komplette Zend Framework geholt. Dann entpacke es in das Verzeichnis "c:\xampp\htdocs" (oder wo immer es bei dir sein mag). Du hast dann das Framework liegen unter: "c:\xampp\htdocs\ZendFramework-1.8.4" (bzw. einer anderen Versionsnummer als der 1.8.4). Wenn du mal in das Zendverzeichnis reingehst, dann siehst du dort (unter Anderem) ein Verzeichnis "/library" und darin "/Zend". Dort sind dann alle die Library Klassen des Zend Frameworks untergebracht.
Ok, die Zend Library liegt also unter "c:\xampp\htdocs\ZendFramework-1.8.4\library". Damit ist dieser Pfad klar.

Im Zend Framework Verzeichnis liegt ebenfalls das Verzeichnis "bin". Dort findest du drei Dateien: zf.bat, zf.php und zf.sh. Kopiere diese Dateien in das Verzeichnis, in dem bei dir das PHP liegt. Bei mir ist das "c:\xampp\php". Nun musst du auf die Commandebene wechseln - unter Windows ist das Start->Ausführen->cmd - und in dein PHP Verzeichnis gehen (cd c:\xampp\php).

Bevor wir nun unser Projekt mit der Default-Struktur des Frameworks anlegen können, müssen wir noch den Pfad zur Zend Library setzen. Gebe dazu auf der Commandline ein:
set zend_tool_include_path=c:\xampp\htdocs\zendframework-1.8.4\library

Damit ist der Pfad gesetzt. Wenn die Library bei dir woanders liegt, musst du natürlich deinen Pfad eingeben.

Und wenn du schon beim eingeben des Pfades bist, dann setze auch gleich den Pfad zum PHP-Verzeichnis (wo ja deine zf.* Dateien drinliegen). Dann brauchst du später zf nicht mehr mit Angabe des Pfades aufzurufen.
Unter Windows setzt man den Pfad wie folgt:
Start->Einstellungen->Systemsteuerung->System->Erweitert->Umgebungsvariablen
Und dort den Pfad zum PHP-Verzeichnis eintragen.

Jetzt können wir unser erstes Projekt erstellen. Dazu gebe bitte ein:
zf create project c:\xampp\htdocs\travelloblog

Es erscheint eine Meldung
Creating project at C:\xampp\htdocs\travelloblog
und nach einem kurzen Moment ist das Projekt angelegt.

Sollte das Projekt nicht angelegt worden sein, bzw. werden können, bekommst du eine Fehlermeldung. Das ist immer dann der Fall, wenn php.exe nicht gefunden wird bzw. der Pfad zur Library falsch ist.

Ersteres können wir fast ausschließen, da die zf.xxx Dateien ja im php-Verzeichnis liegen, also liegt es dann normalerweise am falschen Pfad zur Library. Bei der Fehlermeldung wird der gesetzte Pfad angezeigt, damit kannst du schon mal kontrollieren, ob dieser stimmt. Sollte es - warum auch immer - Probleme beim Setzen des Pfades per DOS-Befehl SET geben (siehe oben), kannst du den Pfad auch in der php.ini fest eintragen.
Öffne dazu die php.ini (ist im php-Verzeichnis) und suche dort nach folgendem Eintrag:

;;;;;;;;;;;;;;;;;;;;;;;;;
; Paths and Directories ;
;;;;;;;;;;;;;;;;;;;;;;;;;
	
; UNIX: \"/path1:/path2\"
;include_path = \".:/php/includes\"
;
; Windows: \"\path1;\path2\"
;include_path = \".;c:\php\includes\"

Trage dort den Pfad zur Library ein. Dazu aktivierst du das include_path indem du das Semikolen (also den Strichpunkt) am Zeilenanfang entfernst und den Pfad zur Library einträgst. Mehrere Pfade hintereinander werden durch Semikolon getrennt.

Das Ganze könnte dann so aussehen (so ist es zumindest bei mir):

;;;;;;;;;;;;;;;;;;;;;;;;;
; Paths and Directories ;
;;;;;;;;;;;;;;;;;;;;;;;;;
	
; UNIX: \"/path1:/path2\"
;include_path = \".:/php/includes\"
;
; Windows: \"\path1;\path2\"
include_path = \".;c:\xampp\htdocs\library\;c:\xampp\htdocs\zend_1.8.4\library\\"

Anlegen eines Projektes unter Zend Server

Bei allen Pfadangaben gehe ich von der Standard Installation aus. Wenn du Zend Server in einem anderen Pfad installert hast, musst du natürlich die Pfadangaben entsprechend ändern!
Die Anwendung ist denkbar einfach. Der einzige Stolperstein ist, dass der Pfad zu den Zend Libraries gesetzt werden muss. So funktioniert es auf meinem lokalen Rechner:

Zunächst einmal muss die Zend Library irgendwo auf deiner Platte sein. Diese liegt bei Zend Server unter
"c:\Programme\Zend\ZendServer\share\ZendFramework\library". Wenn du mal in das Zendverzeichnis reingehst, dann siehst du dort (unter Anderem) ein Verzeichnis "/library" und darin "/Zend". Dort sind dann alle die Library Klassen des Zend Frameworks untergebracht.
Ok, die Zend Library liegt also unter "c:\Programme\Zend\ZendServer\share\ZendFramework\library". Damit ist dieser Pfad klar.

Im ZendFramework Verzeichnis liegt ebenfalls das Verzeichnis "bin". Dort findest du drei Dateien: zf.bat, zf.php und zf.sh. Kopiere diese Dateien in das Verzeichnis, in dem die php.exe liegt. Das ist in "c:\Programme\Zend\ZendServer\bin". Nun musst du auf die Commandebene wechseln - unter Windows geht das mit: Start->Ausführen->cmd - und in dein PHP Verzeichnis gehen (cd c:\programme\zend\zendserver\bin).

Bevor wir nun unser Projekt mit der Default-Struktur des Frameworks anlegen können, müssen wir noch den Pfad zur Zend Library setzen. Gebe dazu auf der Commandline ein:
set zend_tool_include_path=c:\programme\zend\zendserver\share\zendframework\library

Damit ist der Pfad gesetzt. Wenn die Library bei dir woanders liegt, musst du natürlich deinen Pfad eingeben.

Und wenn du schon beim eingeben des Pfades bist, dann setze auch gleich den Pfad zum PHP-Verzeichnis (wo ja deine zf.* Dateien drinliegen). Dann brauchst du später zf nicht mehr mit Angabe des Pfades aufzurufen.
Unter Windows setzt man den Pfad wie folgt:
Start->Einstellungen->Systemsteuerung->System->Erweitert->Umgebungsvariablen
Und dort den Pfad zum PHP-Verzeichnis eintragen.

Jetzt brauchen wir den Pfad, wo du deine Webseiten speicherst. Standardmäßig ist das bei Zend Server in "c:\Programme\Zend\Apache2\htdocs".

Jetzt können wir unser erstes Projekt erstellen. Dazu gebe bitte ein:
zf create project c:\programme\zend\apache2\htdocs\travelloblog

Es erscheint eine Meldung
Creating project at C:\programme\zend\apache2\htdocs\travelloblog
und nach einem kurzen Moment ist das Projekt angelegt.

Sollte das Projekt nicht angelegt worden sein, bzw. werden können, bekommst du eine Fehlermeldung. Das ist immer dann der Fall, wenn php.exe nicht gefunden wird bzw. der Pfad zur Library falsch ist.

Ersteres können wir fast ausschließen, da die zf.xxx Dateien ja im php-Verzeichnis liegen, also liegt es dann normalerweise am falschen Pfad zur Library. Bei der Fehlermeldung wird der gesetzte Pfad angezeigt, damit kannst du schon mal kontrollieren, ob dieser stimmt. Sollte es - warum auch immer - Probleme beim Setzen des Pfades per DOS-Befehl SET geben (siehe oben), kannst du den Pfad auch in der php.ini fest eintragen.
Öffne dazu die php.ini (im Verzeichnis "c:\Programme\Zend\ZendServer\etc") und suche dort nach folgendem Eintrag:

;;;;;;;;;;;;;;;;;;;;;;;;;
; Paths and Directories ;
;;;;;;;;;;;;;;;;;;;;;;;;;
	
; UNIX: \"/path1:/path2\"
;include_path = \".:/php/includes\"
;
; Windows: \"\path1;\path2\"
;include_path = \".;c:\php\includes\"

Trage dort den Pfad zur Library ein. Dazu aktivierst du das include_path indem du das Semikolen (also den Strichpunkt) am Zeilenanfang entfernst und den Pfad zur Library einträgst. Mehrere Pfade hintereinander werden durch Semikolon getrennt.

Das Ganze könnte dann so aussehen (so ist es zumindest bei mir):

;;;;;;;;;;;;;;;;;;;;;;;;;
; Paths and Directories ;
;;;;;;;;;;;;;;;;;;;;;;;;;
	
; UNIX: \"/path1:/path2\"
;include_path = \".:/php/includes\"
;
; Windows: \"\path1;\path2\"
include_path = \".;c:\programme\zend\zendserver\share\zendframework\library\\"

Unser erstes Projekt

So, nachdem wir das Projekt erfolgreich angelegt haben, schauen wir uns das auch mal an.
Wenn du in das Verzeichnis "travelloblog" gehst, sollte es so ausschauen:

/travelloblog
    /application
        /configs
            application.ini
        /controllers
            ErrorController.php
            IndexController.php
        /models
        /views
            /helpers
            /scripts
                /error
                    error.phtml
                /index
                    index.phtml
        Bootstrap.php
    /library
    /public
        .htaccess
        index.php
    .zfproject.xml

Das Verzeichnis "/travelloblog/application" beinhaltet alle Dateien für die Konfiguration sowie unsere Model-View-Controller Dateien (mehr dazu im nächsten Teil des Tutorials).

In das "/travelloblog/library" Verzeichnis kommen alle Bibliotheken, die wir für unser TravelloBlog benötigen. Kopiere das komplette Verzeichnis "Zend" mit allen Dateien und Unterverzeichnisse aus dem Verzeichnis "ZendFramework-1.8.4/library/" in dein Projektverzeichnis "/travelloblog/library".
Dass wir die Zend-Bibliotheken im Unterverzeichnis Zend anlegen hat den Vorteil, dass wir später auch andere Bibliotheken (Smarty, eZ components usw.) dort ablegen können.

Alle Dateien, die über den Webserver erreichbar sein sollen, kommen in das Verzeichnis "/travelloblog/public". Dies wären unsere index Datei sowie alle Grafiken, CSS und Java Script Dateien.
Dafür habe ich das Verzeichnis "public" noch ein wenig erweitert, damit es später übersichtlich wird.
Das Verzeichnis "_files" in "/travelloblog/public/" beginnt übrigens mit einem Unterstrich, damit wir später beim Routing keine Probleme bekommen, falls wir mal einen Controller mit Namen "FilesController" verwenden möchten. Zu den Controllern kommen wir jedoch erst in einem späteren Teil dieses Tutorials.

Erstelle bitte noch die restlichen Verzeichnisse, damit dann dein fertiges /public-Verzeichnis wie folgt aussieht:

/travelloblog
    [...]
    /public
        /_files
            /css
            /images
            /js
        .htaccess
        index.php

Wer noch ein wenig über das Zend_Tool nachlesen möchte, es gibt in der Zend DevZone einen Kommentar direkt vom Entwickler Ralph Schindler darüber zu dessen Einführung:
Zend_Tool and ZF 1.8

.htaccess

Mit Hilfe der .htaccess Dateien, die der Apache Webserver aus jedem Verzeichnis lesen kann, können wir bestimmte Regeln festlegen, inwieweit ein Verzeichnis gelesen werden kann.

Damit niemand auf die Dateien in den Verzeichnissen "/travelloblog/application" und "/travelloblog/library" zugreifen kann, lege dort jeweils eine .htaccess Datei mit folgendem Inhalt an:

deny from all

Hierdurch stellen wir sicher, dass kein Besucher über den Webserver direkt auf diese Verzeichnisse zugreifen kann.

Im Verzeichnis "/travelloblog/public" wurde bereits durch Zend_Tool_Project eine .htaccess Datei mit folgendem Inhalt angelegt:

Hierbei wird geprüft, ob die aufgerufene Datei in der angegebenen URL existiert. Wenn nicht, wird die Anfrage auf die Datei index.php in diesem Verzeichnis umgeleitet.

Wenn du deinem Browser die Adresse "http://localhost/travelloblog/public/" aufrufst, wird deine Applikation aufgerufen. Du kannst auch beliebige andere Adressen ausprobieren, wie z.B. "http://localhost/travelloblog/public/geht/das" oder "http://localhost/travelloblog/public/script.php?foo=bar". Jedes Mal wird deine Applikation aufgerufen.

Wichtig:
Damit das Rewrite (die Umleitung) auch funktioniert, muss es beim Apache aktiviert sein. Dazu musst du die Konfigurationsdatei des Apachen öffnen. Die liegt bei XAMPP unter "c:/xampp/apache/conf/" und heisst httpd.conf. Bei Zend Server ist die httpd.conf unter "c:\Programme\Zend\Apache2\conf" zu finden. Wenn du die Datei geöffnet hast, findest du ziemlich am Anfang eine ganze Menge Einträge, die mit LoadModule beginnen. Suche dort nach der Zeile LoadModule rewrite_module modules/mod_rewrite.so. Wenn am Anfang der Zeile ein '#' steht, dann ist dieses Module deaktiviert. Lösche in dem Fall das # und damit haben wir das Rewrite Modul freigeschaltet.

Weiter unten findest du bei XAMPP den Eintrag: bzw. bei Zend Server. Dort findest du eine Zeile mit AllowOverride. Dieser Eintrag darf nicht auskommentiert sein, d.h. wenn dort ein '#' am Anfang steht, lösche dies. Zudem muss AllowOverride auf All enden: AllowOverride All. Sollte bei dir AllowOverride None stehen, dann ändere dies bitte.

Du musst jetzt den Apachen noch neu starten, damit die Änderungen auch aktiviert werden.

Wer sich näher mit dem Rewrite beschäftigen möchte, kann sich diese beiden Seiten durchlesen:
Apache Module mod_rewrite
URL Rewriting Guide

Einen VirtualHost einrichten

Wenn du statt der etwas unhandlichen Adresse "http://localhost/travelloblog/public/" lieber eine kürzere Adresse wie z.B. "http://travelloblog/" hättest, kannst du dir auch einen entsprechenden VirtualHost einrichten. Dazu musst du Zugriff auf die dafür notwendige Konfigurationsdatei von Apache haben. Die heißt (bei mir) "httpd-vhosts.conf" und liegt bei XAMPP unter "c:/xampp/apache/conf/extra" und bei Zend Server unter "c:\Programme\Zend\Apache2\conf\extra".
Öffne die Datei und suche nach der folgenden Passage - ggf. musst du das Kommentarzeichen '#' entfernen:

NameVirtualHost *:80

Am Ende musst du dann noch folgendes einfügen:

    ServerName travelloblog
    DocumentRoot C:/xampp/htdocs/travelloblog/public/
    ErrorLog logs/travelloblog-error_log
    CustomLog logs/travelloblog-access_log common

Bei Zend Server wäre der DocumentRoot: "DocumentRoot c:/Programme\Zend\Apache2/htdocs/travelloblog/public/".

Wichtig:
Damit die Datei "httpd-vhosts.conf" auch verarbeitet wird, darf sie (in der httpd.conf) nicht deaktiviert sein.
Öffne bitte nochmals die Datei "httpd.conf" und ziemlich am Ende findest du den Eintrag:

# Virtual hosts
Include conf/extra/httpd-vhosts.conf

Sollte vor dem Include ein # sein, dann lösche es. Damit ist die Einbindung der Datei "httpd-vhosts.conf" aktiviert.

Jetzt musst du den Apache nochmals neu starten, damit alle Änderungen auch wirksam werden.

Noch eine Zusatzinfo für Windows-Benutzer:
Diese Info hat Simon in den Kommentaren reingeschrieben (danke für die Info). Anscheinend kann es notwendig sein, dass in der Datei:
"C:\WINDOWS\system32\drivers\etc\hosts"
der Eintrag
127.0.0.1 travelloblog
hinzugefügt werden muss, damit es klappt.

Ist bei mir zwar nicht notwendig, aber probiert es aus, falls ihr Probleme haben solltet.