Inhalt

1. Einleitung
2. Die lokale Testumgebung mit Zend Server CE
3. Ein neues Projekt mit Zend_Tool erstellen

1. Einleitung

Viele, die sich mit Hilfe des Zend-Frameworks eine Web-Anwendung erstellen wollen, stehen vor der Frage, wie sie am einfachsten loslegen können. Diese Anleitung soll einen schnellen Einstieg für Windows-Benutzer zeigen.

Zunächst einmal ist eine lokale Testumgebung, d. h. ein lokaler Webserver wie Apache2 mit PHP5 (5.2.4 oder neuer) Unterstützung nötig. Oft möchte man auch noch eine Datenbank wie MySQL verwenden. Ein fertig geschnürtes Paket stellt XAMPP dar. Dennoch sind nach der Installation von XAMPP etliche Einstellungen nötig, bevor man mit dem ersten Projekt starten kann. Zu XAMPP möchte ich nur soviel sagen, dass es das Zend Framework enthält, aber nicht immer in der aktuellsten Version. So kann es zu unerwarteten Fehlern beim Ausführen der Web-Anwendung kommen. Das Zend Framework liegt in XAMPP in einem PAER-Ordner und sollte als erstes durch die aktuelle Version ersetzt werden.

2. Die lokale Testumgebung mit Zend Server CE

Eine sehr viel besser zugeschnittene Testumgebung stellt Zend Server CE (Community Edition) zur Verfügung, das auch den Apache2 Server als Webserver verwendet. Bei der Installation sollte man den Custom-Modus wählen und das phpMyAdmin- und MySQL-Paket zusätzlich zur Installation auswählen. Das Zend Framework wird automatisch mit installiert.

Hier die einzelnen Schritte als Screenshots:

1. 
   
2. 
   
3. 
   
4. 
   
5. 
   
6. 
   
7. 
   
8. Diese Meldung sehen Windows Vista Benutzer. Wenn ihr keinen öffentlich erreichbaren Webserver installieren wollt (das ist die Regel), klickt auf blockieren.
   
9. 
   

Nachdem Zend Server CE installiert ist, wollen wir unser erstes Projekt erstellen. Ich empfehle neue Projekte ausschließlich mit Zend_Tool zu erstellen. Ob das funktioniert, lässt sich ganz einfach testen: Wir öffnen die Konsole (Windows Vista: Konsole öffnen; Windows XP: Start › Ausführen › "cmd" eingeben) und tippen zf show version ein. Wird die installierte Version des Zend Frameworks ausgegeben, dann ist alles richtig eingerichtet um Zend_Tool verwenden zu können. So sieht die Ausgabe aus:

>zf show version
Zend Framework Version: 1.10.1

3. Ein neues Projekt mit Zend_Tool erstellen

Jetzt erstellen wir unser erstes Projekt mit dem Namen Test. Dazu wechseln wir in der noch geöffneten Konsole in das htdocs-Verzeichnis des Apache-Servers. In der Standardinstallation von Zend Server CE sieht der Pfad so aus: C:Program FilesZendApache2htdocs (Windows Vista) bzw. C:ProgrammeZendApache2htdocs (Windows XP). In diesem Verzeichnis führen wir den Befehl zur Erstellung eines neuen Projekts aus und wechseln anschließend in dieses Verzeichnis:

>zf create project test
>cd test

Auf Grundlage dieser Basis-Anwendung können wir jetzt unsere eigene Web-Anwendung entwickeln und weitere Befehle von Zend_Tool nutzen. Eine Liste möglicher Befehle ist im Handbuch aufgeführt.

Damit Fehler und Warnungen lokal vollständig angezeigt werden, müssen wir noch den Entwicklungsstatus unserer Web-Anwendung auf development setzen. Ist dagegen später eure Web-Anwendung fertig und ihr ladet sie auf einen Webserver, der über das Internet erreicht werden kann, dann soll der Besucher nur eingeschränkte Fehlerdetails angezeigt bekommen. Dazu setzt ihr den Status auf production. Und wo? In der .htaccess im public-Ordner im Projektverzeichnis. Am Anfang der Datei fügt ihr ein:

SetEnv APPLICATION_ENV "development"

Abschließend richten wir noch einen vHost (Virtual Host) ein. Welchen Vorteil bringt uns das? Wir können mit einem vHost unser Projekt zum Beispiel unter der Adresse http://projektname.test/ im Browser aufrufen. Dazu öffnen wir die Datei C:Program FilesZendApache2confhttpd.conf (Windows Vista) bzw. C:ProgrammeZendApache2confhttpd.conf (Windows XP) mit einem Editor und fügen am Ende folgende Zeilen ein:

NameVirtualHost 127.0.0.1:80

<VirtualHost 127.0.0.1:80>
    DocumentRoot "C:Program FilesZendApache2/htdocs" # Web-Root Verzeichnis (htdocs)
    ServerName localhost
</VirtualHost>

<VirtualHost 127.0.0.1:80>
    DocumentRoot "C:Program FilesZendApache2/htdocs/test/public" # Hier den Pfad anpassen
    ServerName projektname.test                                     # Hier die Adresse anpassen
    <Directory "C:Program FilesZendApache2/htdocs/test/public">  # Hier den Pfad anpassen
        DirectoryIndex index.php
        AllowOverride All
        Order allow,deny
        Allow from all
    </Directory>
</VirtualHost>

Als nächstes öffnen wir mit einem Editor die Datei C:WINDOWSsystem32driversetchosts und fügen am Ende folgende Zeile hinzu:

127.0.0.1 projektname.test

Dies veranlasst euer Betriebssystem dazu, die Adresse http://projektname.test/ lokal zu suchen. Der Apache-Server leitet die Anfrage des Browsers dann in das Projektverzeichnis um, dass wir in der Datei httpd.conf festgelegt haben.

Nun müssen wir erstmal den Apache-Server neustarten. Dies funktioniert am einfachsten über das Apache-Symbol im System-Tray neben der Uhr.

Ich hoffe diese Anleitung konnte euch weiterhelfen. Kommentare sind wie immer willkommen.