Tipps & Tricks
Hilfestellungen rund um die Themen Internet & Programmierung
WAMP-Tutorial, Teil 8: So installieren Sie PEAR mit PHP 5 lokal unter Windows
Das "PHP Extension and Application Repository", kurz "PEAR" genannt, bietet Ihnen viele nützliche Klassen und Funktionen um verschiedenste Aufgaben zu erfüllen. Die Pakete sind kostenlos und können sofort in Ihren Scripten eingesetzt werden.
Wer beispielsweise schon einmal nach einer Möglichkeit gesucht hat, ZIP-Archive mit PHP zu erstellen, der wird wahrscheinlich bei der Recherche auf PEAR gestoßen sein. Deshalb werden wir PEAR anhand dieses Beispiels installieren und einbinden.
Installation
In Ihrem PHP-Ordner, bei mir unter "C:/WAMP/PHP/", finden Sie die Datei "go-pear.bat". Starten Sie diese
durch einen Doppelklick. Es erscheint ein DOS-Fenster. Dieses wird Sie nun durch die erste Konfiguration
leiten und Ihnen dabei ein paar Fragen stellen.
Beantworten Sie diese Fragen wie folgt:
Frage 1: system-wide or local copy
Als Antwort tippen Sie ein: system. Bestätigen Sie immer mit der Enter-Taste.
Frage 2: File layout (Pfade)
Antwort: 1.
Nun wird der gewünschte Haupt-Pfad Ihrer PEAR-Installation abgefragt. Er muss geändert werden, da PEAR unterhalb
Ihres htdocs-Ordners installiert werden muss, damit die PHP-Scripte lauffähig sind.
Erstellen Sie also zunächst einen Ordner namens PEAR in Ihrem htdocs-Verzeichnis. Dann wählen Sie diesen
über das Fenster, dass sich gerade geöffnet hat, aus.
Die Pfade 1-6 sollten nun auf den korrekten Ordner zeigen. Bei 7 müssen Sie evtl. den Pfad anpassen, falls
sich Ihr Windows-Ordner nicht dort befindet, wo das Fenster ihn vorschlägt. Gleiches gilt für den Pfad zu ihrer
php.exe unter 8.
Bestätigen Sie mit der Enter-Taste, wenn Sie fertig sind.
Frage 3: alter php.ini
Antwort: Y
Danach drücken Sie noch zweimal Enter und das Fenster schließt sich wieder.
Rufen Sie nun in Ihrem Browser die Adresse http://pear.php.net/go-pear auf. Sie erhalten dort eine Ausgabe von PHP-Quellcode. Kopieren den kompletten Code, erstellen Sie mit Ihrem PHP-Editor eine leere Datei und fügen Sie den Code vollständig in diese Datei ein. Speichern Sie die Datei in Ihrem vorhin erstellten PEAR-Ordner (der jetzt alle PEAR-Dateien enthält) unter dem Namen "go-pear.php". Rufen Sie die Datei dann über Ihren Server auf, also über http://127.0.0.1/PEAR/go-pear.php.
Sie sehen jetzt das Web-Frontend des PEAR-Installers. Klicken Sie auf "Next", lassen Sie dann alle Pfade unverändert und klicken Sie unten auf den "Install"-Button. PEAR lädt nun alle fehlenden Programmdateien und Updates herunter. Wenn beide Fortschrittsbalken 100% anzeigen, können Sie unten auf den Link "Start Web Frontend..." klicken.
Häufige Fehler und Probleme
Keines der in diesem Tutorial beschriebenen WAMP-Module verursacht bei der Installation so viele Komplikationen wie PEAR. Ich möchte deshalb an dieser Stelle ein paar Hinweise zu häufig auftretenden Problemen geben:
- Grundsätzlich gilt: Wenn Sie Probleme mit der go-pear.bat-Datei oder dem DOS-Kommandofenster haben, überspringen Sie diesen Schritt einfach. Machen Sie sofort mit http://pear.php.net/go-pear weiter. Achten Sie dann aber unbedingt (im Gegensatz zu dem, was oben geschrieben steht!) darauf, die Pfade entsprechend Ihrer Installation anzupassen.
- Wenn Sie im Kommandofenster bei Frage 2 als Antwort "1" eintippen und die Fehlermeldung "C:\Dokumente.. hat keine Dateierweiterung" erhalten, geben Sie stattdessen "all" ein und hangeln Sie sich durch alle Pfade durch. Das klappt meistens.
- Wenn Sie PEAR installiert haben und ins Frontend wechseln, dabei aber einen 404-Fehler erhalten, prüfen Sie, ob die angezeigte URL im Browser evtl. "http://127.0.0.1/PEAR/pear/index.php" heißt. In dem Fall entfernen Sie das kleingeschriebene "pear/" aus dem Pfad.
- Manchmal erscheint nach dem Aufruf des Frontends die Fehlermeldung "Can not find config file, please specify the $pear_user_config variable in ...".
In diesem Fall öffnen Sie die Datei "index.php", die sich in Ihrem "htdocs/PEAR"-Ordner befindet. Kommentieren Sie die folgende Zeile ein:
//$pear_user_config = '';
und setzen Sie dann den kompletten Pfad zu Ihrer "pear.conf"-Datei ein, was in unserem Beispiel so aussieht:
$pear_user_config = 'C:\WAMP\Apache2.2\htdocs\PEAR\pear.conf';
PEAR-Pakete installieren
Sie befinden sich nun im PEAR-Frontend. Über den Navigationspunkt "Package Search" können Sie jetzt ein neues
Paket installieren. Für unser Beispiel benötigen wir das Paket "File_Archive", sodass wir genau diesen Namen
oben in der "fast search" eingeben.
In der Ergebnisliste finden Sie ein grünes Plus-Zeichen. Klicken Sie darauf, um das Paket herunterzuladen und zu installieren.
Wenn Sie anschließend auf den Navigationspunkt "Package Management" klicken, sollte Ihr neues Paket dort in der Liste erscheinen. Über einen Klick auf einen der Info-Buttons erhalten Sie mehr Informationen zu dem Paket. In diesem Fall erscheint dort ein Link zur Webseite der Entwickler, auf der wir nun erfahren können, wie man die neuen Klassen verwendet: http://poocl.la-grotte.org/.
ZIP-Archiv mit PHP erstellen
Für unser Beispiel möchte ich eine Bilddatei als ZIP packen. Dazu verwende ich folgendes Script:
<?php
require_once "File/Archive.php";
File_Archive::setOption("zipCompressionLevel", 0);
$files[0] = 'C:\WAMP\Apache2.2\htdocs\testprojekt\testbild.jpg';
File_Archive::extract(
$files,
File_Archive::toArchive("testarchiv.zip", File_Archive::toFiles())
);
?>
Sie können nun aus allen PHP-Scripten auf die PEAR-Klassen zugreifen, da der Batch-Installer vorhin automatisch den Include-Pfad Ihrer PHP-Installation modifiziert hat. Sie müssen nur
require_once "File/Archive.php";
Nächster Schritt
Wenn Sie möchten, können Sie Ihr WAMP jetzt noch für Ihre individuellen Ansprüche konfigurieren: Schritt 9: Ergänzungen