Ihre Wunschadresse: www.
  Sie sind hier:  » McAc.net  » FAQs  » Technische FAQs  » PEAR 

PEAR

Was ist PEAR?

PEAR ("PHP Extension and Application Repository") ist eine Bibliothek von Modulen und Erweiterungen für die Skriptsprache PHP, die es PHP-Entwicklern durch die enthaltenen Scripte ermöglicht, auf erprobte Standardlösungen für zahlreiche Anwendungsgebiete zurückgreifen zu können. Die Verwendung von PEAR kann somit unter Umständen zu einer deutlichen Reduzierung des Entwicklungsaufwandes bei der Programmierung von PHP-Applikationen führen.

Bei den in PEAR enthaltenen Projekten handelt es sich um frei verwendbare OpenSource-Anwendungen.

Nach oben

Ist PEAR bei McAc.net installiert?

Nein, die PEAR-Bibliothek ist bei McAc.net nicht installiert. Sie können jedoch in jedem scriptfähigen Tarif bei Bedarf selbst PEAR installieren und nutzen!

Wie Sie PEAR installieren und konfigurieren, können Sie nachfolgend in Erfahrung bringen.

Nach oben

Wie kann ich PEAR installieren?

Sie können PEAR sowohl über FTP und ein Webinterface, als auch über SSH installieren. Bitte beachten Sie hierbei, dass SSH ausschließlich in den McServer-Tarifen verfügbar ist.

Nach oben

Installation von PEAR per FTP / Webinterface

Installation unter PHP 4:

PEAR kann unter PHP 4 nicht per FTP installiert werden. Die Installation bricht mit einer Fehlermeldung ab. Bitte nutzen Sie mindestens PHP 5, um PEAR zu installieren.

Installation unter PHP 5.3:

Falls Sie PEAR unter PHP 5.3.x installieren, sollten sie vorher im Opens internal link in current windowPHP.INI-Editor oder über eine eigenen PHP.INI-Datei im Installationsverzeichnis display_errors = Off setzen. Die Einstellung bewirkt, dass keine Fehlermeldungen von PHP im Browser ausgegeben werden. So tauchen keine Deprecated-Meldungen bei der Installation auf.

1. Laden Sie sich das PEAR-Konfigurationsscript herunter. Gehen Sie hierzu bitte auf http://pear.php.net/go-pear und speichern nun die im Textformat angezeigte Konfigurationsdatei auf Ihrer Festplatte. Am einfachsten kann dies mittels der "Speichern unter"-Funktion Ihres Browsers geschehen.

2. Nennen Sie die gespeicherte Datei in "pear.php" um.

3. Loggen Sie sich per FTP auf Ihren Webspace ein und erstellen Sie dort ein Verzeichnis, in welchem PEAR installiert werden soll. Laden Sie anschließend das Konfigurationsskript in das zuvor erstellte Verzeichnis und weisen der Datei die Zugriffsrechte "777" zu.

4. Rufen Sie nun bitte über einen Browser das Konfigurationsskript auf. Achten Sie bitte darauf, dass Sie abhängig vom gewählten Verzeichnis u.U. zunächst eine Subdomain erstellen müssen, um das zuvor erstellte Verzeichnis und somit auch die Konfigurationsdatei aufrufen zu können.

5. Im ersten Schritt der Konfiguration klicken Sie bitte einfach auf "Next".

6. Auf der nun folgenden Seite sind im Einzelnen die folgenden Angaben zu machen:

Überprüfen Sie den "Installation prefix" (Punkt 1). Dieser muss mit dem absoluten Serverpfad Ihres Accounts bei McAc.net übereinstimmen. Den absoluten Serverpfad können Sie in Ihrem Kundenmenü unter "Informationen" einsehen.

  • Bei "Documentation Base Directory" (Punkt 4) ersetzen Sie "$php_dir/docs" bitte durch "$prefix/docs".
  • Bei "Data base directory" (Punkt 5) ersetzen Sie "$php_dir/data" bitte durch "$prefix/data".
  • Bei "Test base directory" (Punkt 6) ersetzen Sie "$php_dir/tests" bitte durch "$prefix/tests".
  • Bei " PEAR Installer cache directory" (Punkt 7) ersetzen Sie "$php_dir/cache" bitte durch "$prefix/cache".
  • Bei " php.exe path, optional (CLI command tools)" (Punkt 10) geben Sie bitte "$prefix" ein.

Weitere Angaben sind auf der Seite nicht erforderlich (auch das erste Feld "HTTP Proxy" muss nicht ausgefüllt werden) und Sie können nun auf den "Install"-Button am Ende der Seite klicken.

7. Nun erfolgt die Installation des PEAR-Pakets auf Ihrem Webspace. Dieser Vorgang kann einige Zeit in Anspruch nehmen und unter Umständen sogar unvollständig abgebrochen werden. Sollte dies der Fall sein, so benutzen Sie bitte einfach die "Zurück"-Taste Ihres Browsers und klicken erneut auf den "Install"-Button. Wenn beide Balken die "100%"-Marke erreicht haben und Ihnen am Ende der Seite der Link "Start Web Frontend of the PEAR Installer >>" angezeigt wird, ist die Installation vollständig abgeschlossen worden.

Bevor Sie auf den Link "Start Web Frontend of the PEAR Installer" klicken, passen Sie bitte zunächst die Datei "index.php" an, die sich im Installationsverzeichnis befindet. Laden Sie die Datei dafür herunter, öffnen Sie sie und suchen Sie nach der Zeile 

$pear_dir = '@pear_dir@'; // default of install

Tragen Sie dort den Pfad zum Verzeichnis "PEAR" in Ihrer PEAR-Installation ein. Der Pfad setzt sich aus dem absoluten Serverpfad, etwaigen Unterverzeichnissen und dem Verzeichnis PEAR zusammen. Also beispielsweise: 

$pear_dir = '/kunden/mcac.net/rp-hosting/XXXX/XXXX/software/pear/PEAR';

Laden Sie die geänderte Datei "index.php" anschließend wieder im Installationsverzeichnis auf den Server und überschreiben Sie die alte Version der Datei.

Klicken Sie nun auf der Installationsseite auf den Link "Start Web Frontend of the PEAR Installer >>", um zum Webinterface zu gelangen.

8. Sie befinden sich nun im Paketmanager Ihrer PEAR-Installation. Bitte klicken Sie links auf "Configuration", um dort die folgenden, abschließende Angaben zu tätigen:

  • Bei "System Configuration File" ersetzen Sie bitte "/usr/local/etc/pear.conf" durch "/ihr-absoluter-serverpfad/etwaige-unterverzeichnisse/pear.conf"

Klicken Sie anschließend auf "Go", um die Änderungen zu übernehmen. Es kann hierbei zur Anzeige einer Fehlermeldung kommen, dieser müssen Sie jedoch keine weitere Beachtung schenken.

9. Löschen Sie das Installationsskript "pear.php" wieder von Ihrem Webspace.

10. Erstellen Sie aus Sicherheitsgründen einen Zugangsschutz mittels einer .htaccess-Datei für das Verzeichnis Ihrer PEAR-Installation. Informationen zu .htaccess finden Sie hier: Opens internal link in current windowFAQ zu .htaccess

Geschafft! Die Installation von PEAR ist nun abgeschlossen und Sie können im Webinterface über "Package Management" mit einem Klick auf das grüne Krezu-Symbol die gewünschten Bibliotheken und Extensions aktivieren!

Nach oben

Installation von PEAR per SSH

Wenn Sie über einen SSH-fähigen Tarif verfügen bzw. einen SSH-Zugang per Addon hinzugebucht haben, so können Sie die Installation von PEAR auch per SSH vornehmen:

1. Öffnen Sie die Shell und verbinden Sie sich mittels Ihrer Zugangsdaten auf den Webserver.

2. Wechseln Sie in das Verzeichnis, in dem Sie PEAR installieren möchten.

3. Um die Installation von PEAR zu starten geben Sie bitte den folgenden Befehl ein:

wget pear.php.net/go-pear.phar

4. Nach dem Herunterladen führen Sie folgenden Befehl aus, um die Installation zu starten:

php53 ./go-pear.phar

5. Sie bekommen nun eine Auswahlmenü mit verschiedenen Optionen angeboten.

 

  • Geben Sie auf der Shell die Zahl 1 ein und ändern den vorgegebenen Pfad auf Ihren Serverpfad, z.B. ""/ihr-absoluter-serverpfad/etwaige-unterverzeichnisse/".
  • Passen Sie auch die Optionen 2 und 3 ("Temporary directory for processing" und "Temporary directory for downloads")  folgendermaßen an: /serverpfad/etwaige-unterverzeichnisse/install
    Ersetzen Sie dabei "/serverpfad/etwaige unterverzeichnisse/" durch den Pfad Ihrer PEAR-Installation.

6. Nach Abschluss der Änderungen betätigen Sie bitte erneut die Eingabetaste. 

7. Geben Sie bei der Frage nach der PHP.INI-Datei "n" ein und bestätigen Sie die folgende Abfrage mit Enter. 

8. Öffnen Sie nun die Datei "/bin/pear", die Sie im Verzeichnis Ihrer PEAR-Installation finden. Suchen Sie dort die folgende Stelle:

# first find which PHP binary to use
if test "x$PHP_PEAR_PHP_BIN" != "x"; then
  PHP="$PHP_PEAR_PHP_BIN"
else
  if test "/usr/local/bin/php" = '@'php_bin'@'; then
    PHP=php
else
  PHP="/usr/local/bin/php"
  fi
fi

Fügen Sie nach dieser Stelle folgende neue Zeile ein und speichern Sie die Änderung:

PHP="php53"

9. Führen Sie nun ein Channel-Update durch, indem Sie folgenden Befehl ausführen:

/serverpfad/etwaige-unterverzeichnisse/bin/pear channel-update pear.php.net

Ersetzen Sie dabei "serverpfad" wieder durch Ihren Serverpfad und "etwaige-unterverzeichnisse" durch Unterverzeichnisse, in denen Sie PEAR installiert haben.

10. Nun ist die Installation abgeschlossen. Nach der Installation erhalten Sie mit dem Befehl "pear" eine Übersicht über die Optionen von PEAR.

11. Wie Sie PEAR in Ihren Skripten einbinden, erfahren Sie bei einer Frage weiter unten auf dieser Seite.

Nach oben

Wie kann ich PEAR in meine Scripte einbinden?

Um nach der Installation und Konfiguration PEAR in Ihren Skripten verwenden zu können, ist ein zusätzlicher Eintrag in Ihre php.ini-Datei erforderlich. Ergänzen Sie die php.ini-Datei bitte um folgende Zeile:

include_path = ".:/usr/local/lib/php:/ihr-absoluter-serverpfad/etwaige-unterverzeichnisse/

Bitte beachten Sie, dass die Verwendung von PEAR das Vorhandensein einer php.ini-Datei und dort die Angabe des obenstehenden include-Paths zwingend erfordert.

Nähere Informationen zu php.ini-Dateien finden Sie beispielsweise hier: php.ini-Editor

Nach oben

Wo finde ich weitergehende Informationen zu PEAR?

Weitergehende Informationen über PEAR finden Sie hier:

pear.php.net

Nach oben