Agavi installieren und Projekt erstellen mit Windows und XAMPP

Bei der Installation des Agavi Frameworks unter Windows und XAMPP kann man leicht auf Fehlermeldungen stoßen. Hier ein kurzer Walkthrough der zum Erfolg führt.

Hat man XAMPP installiert, sollte man zuerst prüfen ob phing eingerichtet ist bevor man sich agavi annimmt. Das geht einfach und schnell über die Konsole. Also Start -> Ausführen -> "cmd" und dann in das XAMPP PHP Verzeichnis wechseln. Das ist bei mir "c:\xampp\php".

Ist man da angelangt, kurz die Channels festlegen:

pear.bat channel-discover pear.phing.info
pear.bat channel-discover pear.agavi.org

Als nächstes prüfen ob phing installiert ist:

pear.bat install phing/phing

Jetzt kommt entweder die Nachricht, dass phing bereits installiert ist, oder es folgt der Download- und Installationsprozess. Als nächstes kann jetzt agavi installiert werden. Das geht analog mit

pear.bat install agavi/agavi

Als nächstes muss jetzt ein Projekt erstellt werden. Dazu geht man in den Document Root der XAMPP Installation - bei mir ist das C:\xampp\htdocs und erstellt sich einen neuen Ordner für das neue Projekt, als z.B. "agaviworks". In dem Ordner erstellt man sich dann eine Datei namens "build.properties" um Build fehler abzufangen die Phing fehlschlagen lassen, wenn diese Datei nicht existiert. Danach über die Konsole (Start->Ausführen->"cmd") in den neuerstellten Ordner wechseln und die agavi.bat ausführen. Die liegt natürlich im PHP-verzeichnis, weshalb der korrekte Befehl lauten sollte:

C:\xampp\php\agavi.bat project-wizard

Spätestens hier kann man oft auf die erste Fehlermeldung stoßen: "Error: Phing version could not be determined; Phing 2.4.0 or later required." Alternativ kann beim Aufruf der agavi.bat ohne den Parameter project-wizard auch mal folgender Fehler erscheinen: "Phing.php:811: No VERSION.TXT file found; try setting phing.home environment variable."

Letzterer Fehler sagt auch schon worum es geht. Die VERSION.TXT Datei wird nicht gefunden. Schaut man sich die Phing.php in Zeile 811 an, sieht man auch wo nach der Version.txt Datei gesucht wird. Da liegt die nur leider nicht. Aus irgendeinem Grund existiert neben C:\xampp\php\PEAR\phing noch das Verzeichnis C:\xampp\php\PEAR\data\phing und dort ist auch die Version.TXT zu finden.

Kopiert man jetzt einfach alle Unterordner aus C:\xampp\php\PEAR\data\phing in C:\xampp\php\PEAR\phing (Dubletten können überschrieben werden), dann wird auch beim Aufruf von agavi die phing Version richtig ausgelesen und das Projekt kann erstellt werden.

Den Wizard kann man mit den Standard-Werten durchlaufen lassen. Nach Abschluss kann man das fertige Projekt dann im Browser unter localhost\agaviworks\pub bewundern.