[Tutorial] Eigene PEAR Installation bei Shared Hosting Providern

[Cybersmog]

[Tutorial]
Eigene PEAR Installation bei Shared Hosting Providern


Vorbemerkung
Um PEAR sinnvoll nutzen zu können, sollte man schon etwa PHP Erfahrung haben. Auch sonstige Kenntnisse, was Apache und Webprogrammierung angeht, sind sicher nicht verkehrt. Trotzdem möchte ich damit niemanden abschrecken, denn auch Einsteiger können von PEAR profitieren.


Was ist PEAR überhaupt?

PEAR (PHP Extension and Application Repository) ist ein zentrales Archiv für Klassen und Bibliotheken in PHP mit einem hohen Wiederverwendungswert. Innerhalb von PEAR existiert darüber hinaus PECL, in dem Erweiterungen für PHP, die in C und C++ geschrieben sind, enthalten sind.

Der Zweck von PEAR ist die Verbreitung nützlicher, geprüfter und qualitativ hochwertiger objekt orientierter Skripte (Packages) in PHP und Erweiterungen in C, die von allen PHP-Entwicklern genutzt werden können.

Gleichzeit sollen die Standards, die in PEAR definiert werden, dazu dienen, dass Entwickler Code schreiben können, der portabel, auf vielen anderen Systemen und Konfigurationen einsetzbar und gut lesbar ist.

Zitat von http://www.dclp-faq.de/q/q-pear-was.html

PEAR lässt sich also am ehesten mit dem CPAN für Perl vergleichen.
Über den Sinn bzw. Unsinn von PEAR kann man gerne streiten. Ich für meinen Teil benutze PEAR sehr gerne.


PEAR bei Shared Hosting Providern?
Seit PHP > 4.3.0 ist PEAR mit ein paar Basispaketen (DB, Net_Socket, Net_SMTP, Mail, XML_Parser, PHPUnit-0.6.2) bei jeder PHP Installation dabei. Auch ein paar Provider bieten diese Basispakete schon an, z.B. Host Europe. Wenn PEAR aber nun nicht angeboten wird oder man auch andere Pakete nutzen möchte, steht man im Regen. Eine Möglichkeit wäre nun, die Pakete von Hand in den Webspace zu kopieren und in die Skripten einzubinden.

Ich möchte hier aber eine viel komfortablere Möglichkeit erklären, wie man zu seiner eigenen PEAR Installation mit graphischen Frontend kommt. Dazu werde ich die Installation am Beispiel von Host Europe erklären, aber die Anleitung müsste analog auch bei anderen Providern funktionieren.


Vorbereitungen
Als erstes muss der physikalische Document Root des Webservers ermittelt werden. Dazu reicht dieses kleine Skript:

PHP-Code:

<?php
echo $_SERVER['DOCUMENT_ROOT'];
?>

Der Output sollte in etwa so aussehen:

/is/htdocs/00000/www.domain.tld

Mein Beispiel ist jetzt von Host Europe, jeder Provider macht das etwas anders.


Installation von PEAR

1. Als erstes braucht man das Installer Skript. Dazu ruft man http://go-pear.org/ auf (wichtig: ohne www). Man bekommt dann den Quelltext zu sehen, den man sich in einer Datei speichert. Ich nenne sie mal pearinstaller.php.
   
2. Dann erstellt man im eigenen Webspace per FTP Programm ein Verzeichnis im Document Root, z.B. _pear. Auf das erstellte Verzeichnis wendet man dann noch

   chmod 777

   an. Das ist nötig, damit später auch der Webserver Schreibrechte auf das Verzeichnis hat.
   
3. In das erstellte Verzeichnis wird dann die Installerdatei, in meinem Fall pearinstaller.php hochgeladen.
   
4. Per Browser ruft man die Datei dann auf: http://www.domain.tld/_pear/pearinstaller.php
   
5. Man sollte dann das Installer Frontend zu Gesicht bekommen. Mit einem Klick auf next kommt man dann zur Konfiguration.
   Im Feld "Installation prefix" sollte dann schon etwas in dieser Art drinstehen:

   /is/htdocs/00000/www.domain.tld/_pear

   Das Verzeichnis setzt sich aus dem oben ermittelten Document Root und dem Unterverzeichnis, in meinem Fall _pear, zusammen.
   
6. In den Feldern 4 - 7 muss nun

   $php_dir

   gegen

   $prefix

   ausgetauscht werden.
   
   In Feld 10 wird nur

   $prefix

   eingetragen.
   
7. Das Kästchen mit der Frage nach den Standard PEAR Paketen sollte man markiert lassen.
   
8. Nachdem alle Einstellungen gemacht sind, kann die Installation gestartet werden.
   
9. Die Installation läuft jetzt vollautomatisch ab. Da die ganzen Pakete erst runtergeladen werden müssen, kann das eine Weile dauern. Die Installation ist fertig, wenn man am Ende der Seite den Link Start Web Frontend of the PEAR Installer zu sehen bekommt. Auf den Link klickt man dann natürlich.
   
10. Wenn alles geklappt hat, bekommt man nun den Packet Manager zu sehen. Bevor man eigene Pakete installieren kann, müssen aber nochmals Einstellungen gemacht werden. Dazu klickt man links auf den Link Configuration.
    
11. Auf der Konfigurationsseite müssen nun noch 3 Felder angepasst werden:

    PEAR documentation directory: => /is/htdocs/00000/www.domain.tld/_pear/docs
    PEAR data directory: => /is/htdocs/00000/www.domain.tld/_pear/data
    PEAR test directory: => /is/htdocs/00000/www.domain.tld/_pear/tests

    Die Änderungen werden dann mit einem Klick auf den Go! Button gespeichert.
    
12. Damit ist die Installation abgeschlossen und man kann loslegen.

Nach der Installation
Nach der PEAR Installation sollte man als erstes die Installer Datei (pearinstaller.php) löschen. Außerdem sollte man das Installationsverzeichnis unbedingt per .htaccess vor unberechtigtem Zugriff schützen.


Installation von PEAR Paketen
Die Pakete lassen sich über das Package Mangament nun ganz einfach per Klick auf das grüne Kreuz installieren, bzw. per Klick auf den Mülleimer deinstallieren. Über die Info Buttons kommt man an weiter Informationen.

Es empfiehlt sich, von Zeit zu Zeit auch mal auf den Link list avail. upgrades zu klicken, um an die neuesten Versionen der installierten Pakete zu kommen.


Einbinden von PEAR Paketen in eigene Skripten
Um PEAR nun nutzen zu können, müssen die Pakete natürlich auch in den Quelltext eingebunden werden. Dazu gibt es 3 Möglichkeiten:

1. Man fügt in jede einzelne PHP Datei den Pfad manuell ein, z.B. so:
   PHP-Code:

   require_once '/is/htdocs/00000/www.domain.tld/_pear/PEAR/Mail/mime.php' 

2. Eine andere Möglichkeit ist, am Anfang jeder PHP Datei, in der man PEAR Pakete braucht, diese Zeile einzügen:
   PHP-Code:

   ini_set('include_path', '/is/htdocs/00000/www.domain.tld/_pear/PEAR/'); 

   Die einzelnen Module kann man dann relativ einfach einbinden:
   PHP-Code:

   require_once 'Mail/mime.php' 

3. Die eleganteste Methode meiner Meinung nach ist, sich eine .htaccess Datei mit folgendem Inhalt anzulegen:

   php_value include_path /is/htdocs/00000/www.domain.tld/_pear/PEAR/

   Diese Datei lädt man dann per FTP in das Document Root Verzeichnis hoch. Dadurch steht dann der PEAR Include Pfad überall zur Verfügung und man braucht in den einzlnen PHP Dateien nur noch das Modul selbst einbinden:
   PHP-Code:

   require_once 'Mail/mime.php' 


Schlußbemerkung
Was sich jetzt relativ aufwendig anhört, ist in Wirklichkeit nicht sehr schwer. Meiner Meinung nach lohnt sich der Aufwand, denn man kann jetzt jederzeit PEAR Pakete installieren, updaten oder löschen.

Allen Interessierten sei auf jeden Fall die offizielle PEAR Homepage ans Herz gelegt. Dort finden sich viele weitere Informationen und natürlich auch ein (englisches) Handbuch.

Feedback auf dieses Tutorial ist jederzeit erwünscht. Eventuell vorhandene Fehler werde ich natürlich korrigieren.

[rechtschreibfan]

genial! dankeschön

[HaZuLiD0]

yo thx... ich habe vor mich demnächst in pear reinzuarbeiten

[dassoud]

ab in den tutorial bereich damit!

[Cybersmog]

Schon längst passiert

Guckst du hier:
Eigene PEAR Installation bei Shared Hosting Providern

[marioN@deSEIN]

bitte um eure hilfe....
habe schon pear.net,http://www.pear-forum.de/, gegoogelt und weiss der teufel was für sites aufgesucht, aber keine lösung gefunden...
ganz am anfang der installation kriege ich die meldung

PHP-Code:

loading zlib failed 


wahrscheinlich hat das was damit zu tun...?
wie gehe ich hier vor...

thanx für eure rückantwort

marioN

[Cybersmog]

Ich geh mal davon aus, dass bei dir PHP ohne zlib Unterstützung kompiliert wurde. Die brauchts aber für den PEAR Installer.

Lass dir mal mit

PHP-Code:

<?php phpinfo(); ?>

die PHP Konfiguration anzeigen.
Da muss oben bei Configure Command der Flag --with-zlib auftauchen.
Weiter unten sollte dann unter dem Punkt zlib das hier stehen:
ZLib Support enabled

Gruß
Peter

[marioN@deSEIN]

danke für deine antwort - es deutet nichts auf zlib ext hin,
was kann ich hier tun? >> ausser manuell installieren?

marioN

[Cybersmog]

Wenn du bei einem Provider bist, kannst du den versuchen zu Bitten, PHP mit zlib Unterstützung zu installieren. Ansonsten bleibt dir nur die manuelle Installation.

Gruß
Peter

[Thorkel]

Hallo,

bei mir schlägt die Installation leider fehl, ich habe die config angepasst wie vorgeschlagen, aber am Ende des Installscripts bekomme ich den Fehler

Warning: copy(/home/www/doc/5725/xxxxxxxx.de/www/_pear): failed to open stream: Is a directory in /home/www/doc/5725/xxxxxxxx.de/www/_pear/pearinstall.php on line 927

Der Link zum Web-Frontend zeigt auch auf mein DOCUMENTROOT; ergo geht dann logischerweise auch meine normale Index.php auf und nicht das Web-Frontend. Im angelegten _pear-Verzeichnis steht neben den Verzeichnissen nur eine conf.php, ebenfalls kein Hinweis auf Web-Frontend.

Was kann da falsch gelaufen sein? Bei den anderen Teilnehmern hier scheint es ja gefunzt zu haben ...

Th mas

[firstlord18]

hast du schreibrechte?

[Thorkel]

ja, 777 auf das angelegte _pear-Verzeichnis und es wurde auch artig gefüllt.
Nur das WebFrontend File konnte nicht geschrieben werden (sorry. die Zeile fehlte eben):


install ok: channel://pear.php.net/PHPUnit-1.3.2
Writing WebFrontend file ...

Warning: copy(/home/www/doc/5725/xxxxxxxx.e/www/_pear): failed to open stream: Is a directory in /home/www/doc/5725/xxxxxxxx.de/www/_pear/pearinstall.php on line 927

Was ich nicht verstehe, ist aber zB, daß ich in der Config ja den Wert für
10. Filename of WebFrontend => auf $prefix geändert habe - das ist ja aber bei mir das neue /home/www/doc/5725/xxxxxxxx.e/www/_pear Verzeichnis.

Dort finde ich kein Web Frontend wegen des o.g. fehlers (wie hieße es denn? index.php?). Und wieso zeigt trotz dieser Einstellung der Link zum Webfrontend bei mir eine Ebene höher ins DOCUMENTROOT??

Rätsel ...

Thomas

[Thorkel]

ok, beim dritten Versuch habe ich jetzt doch

10. Filename of WebFrontend => auf $prefix/index.php stehen lassen und jetzt hat es funktioniert. Vielleicht hatte ich es nur falsch verstanden.

Danke !

Th mas

[guraco]

Hi Leute,

habe das alles nach dieser Anleitung gemacht aber irgendwie kommt bei der Installation trotzdem eine Fehlermedung:

Error

Downloading package: PEAR-stable......

Warning: fopen() [function.fopen]: SAFE MODE Restriction in effect. The script whose uid is 0 is not
allowed to access /srv/www/htdocs/web1/html/_pear/gopeImqpwc owned by uid 30 
in /srv/www/htdocs/web1/html/_pear/pearinstaller.php on line 1051



Warning: fopen(PEAR-1.5.0.tgz) [function.fopen]: failed to open stream: No such file or directory 
in /srv/www/htdocs/web1/html/_pear/pearinstaller.php on line 1051



could not open PEAR-1.5.0.tgz for writing

Die Rechte sind alle vergeben, weiss aber nicht wo das Problem liegt!

Ich bitte um Eure Hilfe.

Gruß Peter

[Cybersmog]

Die Fehlermeldung sagt doch schon, was los ist:

SAFE MODE Restriction in effect.

Also entweder den safe mode ausschalten (sofern möglich) oder den Zugriff auf die entsprechenden Verzeichnisse erlauben. Mehr zum Thema: http://de3.php.net/manual/de/features.safe-mode.php

Gruß
Peter