cvs: peardoc /de/chapters installation.xml
| From: | Alexander Merz | Date: | Thu, 12 Feb 2004 14:02:19 +0000 |
| Subject: | cvs: peardoc /de/chapters installation.xml | ||
| Groups: | php.pear.doc | ||
| Request: | Send a blank email to pear-doc+get-2535@lists.php.net to get a copy of this message | ||
alexmerz Thu Feb 12 09:02:19 2004 EDT
Added files:
/peardoc/de/chapters installation.xml
Log:
initial german
http://cvs.php.net/co.php/peardoc/de/chapters/installation.xml?r=1.1&p=1 Index: peardoc/de/chapters/installation.xml +++ peardoc/de/chapters/installation.xml <?xml version="1.0" encoding="iso-8859-1" ?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.16 --> <!-- WORK IN PROGRESS, THERE IS PROBABLY LITTLE POINT IN TRANSLATING THIS DOCUMENT YET. --> <chapter id="installation"> <docinfo> <author> <firstname>Martin</firstname> <surname>Jansen</surname> </author> <date>2002-02-10</date> </docinfo> <title>Installation</title> <simpara> Diese Kapitel beschreibt wie man Packages von PEAR installiert </simpara> <sect1 id="installation.introduction"> <title>Einführung</title> <para> Bevor Sie dieses Kapitel lesen, sollten Sie mit der <link linkend="about.pear">Idee</link> von PEAR vertraut sein. </para> <para> Die auf den <link linkend="about-pfc">PFC</link> basierende Installation von PEAR als Bestandteil der PHP-Distribution enthält bereits alles, um die PEAR-Werkzeuge für die Installation zu nutzen. Mit einer einer aktuellen PHP-Installation können Sie sich zurücklegen: Die PEAR-Basis-Installation ist bereits vorhanden - es sei denn Sie haben PHP installiert mt der <command>./configure</command>-Einstellung <literal>--without-pear</literal>. </para> <para> Die Packages, die nicht zu den PFC gehören, können Sie mit dem PEAR-Package-Manager installieren. Er ist vergleichbar mit Debian's <quote><ulink url="&url.debian.apt;">apt-get</ulink></quote>. Zur Wiederholung: Mit einer aktuellen PHP-Installation (> 4.3.0) können Sie den nächsten Abschnitt überspringen. Nur wenn Sie die PHP-Version 4.2.* oder frühere benutzen, müsssen Sie den Manager von Hand installieren. </para> <para> Neben der Package-Installation übernimmt der PEAR-Package-Manager weitere Aufgaben: Er kann neue Packages erzeugen auf ihrem Computer, verwaltet eine Datenbank der installierten PAckages, überprüft Abhängigkeiten; und er kann über den <ulink url="&url.xmlrpc;">XML-RPC</ulink>-Service auf pear.php.net einige weitere Aufgaben übernehmen. </para> </sect1> <sect1 id="installation.getting"> <title>Den Manager herunterladen</title> <sect2> <title>Unix/Linux/BSD</title> <para> Mit PHP >= 4.3.0 ist der PEAR-Package-Manager bereits installiert, ausser es wurde bei <command>./configure</command> die Einstellung <literal>--without-pear</literal> angegeben. </para> <para> Für alle Versionen vor 4.3.0 oder für eine erneute Installation des Package-Managers können Sie folgerdermaßen vorgehen: <screen> <userinput> $ lynx -source http://go-pear.org/ | php </userinput> </screen> </para> <note> <para> Einige Linux-Distributionen (z.B. Redhat) benutzen <filename>links</filename> anstatt <filename>lynx</filename> als Namen für den Kommandozeilen-HTML-Browser. ändern Sie in diesem Fall die obige Anweisung entsprechend um. </para> </note> </sect2> <sect2> <title>Windows</title> <para> Nach dem Herunterladen und der Installation von PHP müssen Sie eine Batch-Datei <filename>go-pear.bat</filename> ausführen. Diese befindet sich im Verzeichniss ihrer PHP-Installation, z.B.: <filename>c:\php\go-pear.bat</filename>. Es werden ihnen einige Fragen gestellt, danach wird der PEAR-Package-Manager installiert in einem Pfad entsprechend ihrer Angaben. Zum Schluß müssen Sie den Installations-Pfad, der auf ihre PEAR-Installation zeigt, der Umgebungsvariable PATH <!-- PRüFEN !!!!!!!!!!!!!!! --> zuweisen (Start > Einstellungen > System > Umgebungsvariablen). Danach können Sie den PEAR-Package-Manager über die Kommandozeile unter Windows benutzen mit dem Aufruf von <literal>pear</literal>. </para> <para> Um ihre PEAR-Installation auf den neusten Stand zu bringen, rufen Sie in ihrem Browser die URL http://go-pear.org/ auf und speichern die Ausgabe in der Datei <filename>go-pear.php</filename>. Danach rufen Sie auf: <screen> <userinput> php go-pear.php </userinput> </screen> auf der Kommandozeile, um das Update durchzuführen. </para> </sect2> <sect2> <title>PEAR und Web-Hoster</title> <para> Wenn Sie eine Webseite bei eiem Web-Hoster betreiben und keinen direkten Zugriff auf den Server haben (lokal, Telnet oder SSH), dann können Sie den Manager nicht benutzen. Wenn Sie Kunden bei einem guten Web-Hoster sind, haben Sie gute Chancen, das häufig genutzte PEAR-Packages bereits installiert sind. Ist das nicht der Fall bzw. benötigen Sie weitere Packages, frageb Sie ihren Hoster, ob er sie installieren will. Sollte er sich weigern, schauen Sie sich nach einem neuen Anbieter um, oder versuchen Sie die Packages <link linkend="installation.manually">manuell zu installieren</link>. </para> </sect2> </sect1> <sect1 id="installation.cli"> <title>Der Kommandozeilen-Installer</title> <titleabbrev>CLI-Installer</titleabbrev> <para> <warning id="installation.web.prerequesite"> <title>Vorrausetzungen</title> <para> Die folgende Beschreibung geht davon aus, dass die neuste Version des <link linkend="installation.getting">PEAR-Package-Managers</link> installiert ist. </para> </warning> </para> <para> Die Installation über die Kommandozeile ist der schnellste Weg PEAR-Packages auf ihrem System zu installieren: Dazu verbindet sich der Manager mit dem PEAR-Package-Server über HTTP, lädt das Package herunter und installiert das Package gemäß ihren Einstellungen. </para> <sect2> <title>Die voll-automatische Installation</title> <para> Der CLI-Installer ist einfach zu benutzen. Tippen Sie folgendes in ihre Kommandozeile: </para> <para> <screen> <userinput> $ pear install <package> </userinput> </screen> </para> <para> <package> müß durch den Namen des Packages ersetzt werden, dass Sie installieren wollen (z.B. HTTP_Upload). Um eine Liste aller verfügbaren Packages zu bekommen, schauen Sie entweder auf die <ulink url="&url.pear.package.browse;">PEAR-Package-übersicht</ulink> oder führen Sie diesen Befehl aus: </para> <para> <screen> <userinput> $ pear remote-list </userinput> </screen> </para> <para> Dieses Kommando holt sich die Liste aller Packages, die zur Zeit in PEAR verfügbar sind. </para> </sect2> <sect2> <title>Halb-automatische Installation</title> <para> Wenn Sie ein Package von <ulink url=" http://pear.php.net/">pear.php.net</ulink> heruntergeladen haben als gezipptes Tar-Archiv, können Sie es ebenfalls lokal installieren, dazu geben Sie auf der Kommandozeile ein: </para> <para> <screen> <userinput> $ pear install <file>.tgz </userinput> </screen> </para> <para> Dieses Kommando wird das Package installieren ohne dass eine Online-Verbindung notwendig ist. <filename><file>.tgz</filename> muss durch den Namen der heruntergeladenen Datei ersetzt werden. </para> </sect2> </sect1> <sect1 id="installation.shared"> <title>Installation eines lokalen PEAR-Verzeichnisses bei fremden Web-Hostern</title> <para> Viele Benutzer sind bei Web-Hostern mit einer system-weiten PEAR-Installation. In einigen Fällen kann es notwendig sein, eine eigene PEAR-Installation zu verwalten, z.B. zur Installation nicht vorhandener Packages. Das ist möglich entweder über Telnet/SSH oder allein per FTP. </para> <sect2 id="installation.shared.shell"> <title>Ein lokales PEAR-Verzeichniss über Telnet</title> <para> Um ein lokales PEAR über Telnet zu installieren, führen Sie folgende Befehle aus: </para> <para> <screen> <userinput> $ pear -s -c ~/.pearrc -d doc_dir=~/pear/docs -d ext_dir=~/pear/ext -d php_dir=~/pear/lib -d data_dir=~/pear/data -d test_dir=~/pear/tests -d cache_dir=~/pear/cache -d bin_dir=~/pear/bin </userinput> </screen> </para> <para> Damit erzeugen Sie eine lokales Konfigurations-Datei in ihrem Home-Verzeichniss; sie heißt <filename>.pearrc</filename>. Dazu wird in ihrem Home-Verzeichniss ein Verzeichniss <filename>pear</filename> erzeugt, dass die zukünftigen Packages aufnimmt. </para> <para> Wenn Sie dann in <filename>.bashrc</filename> im Path-Eintrag das Verzeichniss <command>~/pear/bin</command> hinzufügen, müsste nachfolgender Aufruf funktionieren. Die Path-Angabe muß an erster Stelle in der Datei stehen! (Lautet ihr Startup-Datei anders, müssen Sie den Eintrag natürlich dort machen.) </para> <para> <screen> <userinput> $ pear -c ~/.pearrc install Archive_Tar PEAR Console_Getopt XML_RPC </userinput> </screen> </para> <para> Damit erzeugen Sie eine lokale PEAR-Installation, die oberhalb der systemweiten liegt. Damit die lokalen Packages auch benutzt werden, müssen Sie die include_path-Einstellung von PHP anpassen: </para> <para> <programlisting role="php"> <![CDATA[ <?php ini_set('include_path', '~/pear/lib' . PATH_SEPARATOR . ini_get('include_path')); ?> ]]> </programlisting> </para> <para> Alternativ können Sie dies auch in der <filename>.htaccess</filename> für Apache vornehmen über die Einstellung <literal>php_value</literal>. </para> </sect2> <sect2 id="installation.shared.ftp"> <title>Ein lokales PEAR-Verzeichniss über FTP</title> <para> Die Vorrausetzung für die Installation über FTP ist ein FTP-Programm, dass die Zugriffsrechte setzten kann. Erzeugen Sie zuerst ein Verzeichniss, dass NICHT in ihrem öffentlich zugänglichen Web-Verzeichniss liegt; die Benennung ist egal. Es muß für jeden les- und schreibbar sein (Zugriffsrechte: 0777). Holen Sie sich dann das <filename>go-pear.php</filename>-Skript von http://go-pear.org und laden Sie es in ein öffentlich zugängliches Unter-Verzeichniss ihres Web-Verzeichnisses. Sie sollten dieses Verzeichniss unbedingt über die <filename>.htaccess</filename> mit einem Passwort schützen. </para> <para> Rufen Sie als zweites über den Browser das <filename>go-pear.php</filename>-Skript auf. Ist die URL ihrer Webseite http://www.example.com, und befindet sich das Skript in <filename>public_html/install/go-pear.php</filename>; und http://www.example.com zeigt die Inhalte von public_html/, dann rufen Sie auf: http://www.example.com/install/go-pear.php. Folgen Sie den Installations-Anweisungen. Wenn Sie gefragt werden, wohin Sie PEAR installieren wollen, wählen Sie das Verzeichniss, das für jeden les- und schreibbar ist. Ausserdem werden Sie gefragt, wo sich die Kommandozeilen-Version von PHP befindet. Führen Sie dazu auf dem Server folgendes PHP-Skript über den Browser aus und übernehmen die Ausgabe: </para> <para> <programlisting role="php"> <![CDATA[ <?php echo `which php`; // if this does not work, also try echo PHP_BIN; ?> ]]> </programlisting> </para> <para> Nachdem PEAR installiert wurde, können Sie über den Web-Installer Packages installieren und aktualisieren wie mit jeder anderen PEAR-Installation. Um die installierten Packages zu benutzen, müssen Sie ebenfalls den Include-Path anpassen. </para> <para> <programlisting role="php"> <![CDATA[ <?php ini_set('include_path', '~/pear/lib' . PATH_SEPARATOR . ini_get('include_path')); ?> ]]> </programlisting> </para> </sect2> </sect1> <sect1 id="installation.manually"> <title>Manuelle Installation</title> <para> Packages manuell zu installieren ist nicht empfohlen, aber viele haben immer wieder Probleme mit der automatischen Installation, besonders wenn es sich um die Installation bei Web-Hoster handelt. </para> <para> In den nächsten Absätzen werden wir demonstrieren wie Sie Packages von Hand auf ihrer Webseite installieren. Wir gehen von diesem Schema aus: Der Document-Root der Seite ist <filename>/var/www/www.example.com/htdocs/</filename>. Auf der gleichen Ebene von <filename>htdocs</filename> befindet sich ein Verzeichniss <filename>includes</filename>. Auf dieses Verzeichniss kann nicht über <acronym>HTTP</acronym> zugegriffen, aber über <acronym>FTP</acronym> oder WebDAV. </para> <para> Die Installation besteht aus den folgenden Schritten. The installation consists of some easy to follow steps: <orderedlist> <listitem> <simpara> Das Package herunterladen: </simpara> <para> Sie können das Package herunterladen von der <ulink url="&url.pear;">PEAR-Homepage</ulink> über den Web-Browser. Wenn Sie die <acronym>URL</acronym> der Package-Seite nicht kennen, gehen Sie über den <ulink url="&url.pear.package.browse;">Package-Browser</ulink>. </para> </listitem> <listitem> <simpara> Hochladen des Package-Quellcodes </simpara> <para> Nach dem Sie die .tgz-Datei des Packages heruntergeladen haben, müssen Sie den Inhalt der Datei auf ihrem eigenem Computer entpacken. Laden Sie danach den entpackten Quellcode über <acronym>FTP</acronym>, WebDAV oder eine andere Methode in das Verzeichniss <filename>/var/www/www.example.com/includes/</filename>. Der Quellcode für Mail_Mime z.B. sollte sich dann befinden in <filename>/var/www/www.example.com/includes/Mail/</filename>. </para> </listitem> <listitem> <simpara> Anpassen des include_path </simpara> <para> Jetzt müssen Sie den include-path von PHP so anpassen, dass er den Namen des Verzeichnisse enthält, in dem der Quellcode liegt. Wenn Sie Zugriff auf die <filename>php.ini</filename> für ihre Webseite haben, müssen Sie das Verzeichniss <filename>/var/www/www.example.com/includes/</filename> in der Einstellung ergänzen. Wenn Sie keinen Zugriff darauf haben, müssen Sie diese Einstellung in jedem ihrer Skript setzen, um das PAckage zu benutzen: </para> <para> <programlisting role="php"> ini_set("include_path", '/var/www/www.example.com/includes/' . PATH_SEPARATOR . ini_get("include_path")); </programlisting> </para> </listitem> <listitem> <simpara> Nach dem Sie diese Schritte durchgeführt haben, können Sie das Package ein ihre Skripte einbinden: </simpara> <para> <programlisting role="php"> require_once "Mail/Mime.php"; $mime = ... </programlisting> </para> </listitem> </orderedlist> </para> <para> Wenn Sie weiter Fragen zur manuellen Installation haben, fragen Sie auf der <ulink url="&email.pear.general;">Mailing-Liste für PEAR-User</ulink>. </para> </sect1> <sect1 id="installation.cvs"> <title>CVS installer</title> <para> Dieser Abschnitt beschreibt, wie Sie ein PEAR-Package aus dem CVS heraus installieren. </para> <para> Sie sollten keine Packages direkt aus dem CV heraus in Produktions-Umgebungen laufen lassen! Es sind keine offiziellen Releases, deshalb: <itemizedlist> <listitem> <simpara>können Sie weder mit Hilfe vom Maintainer rechnen, noch von irgendjemand anderem.</simpara> </listitem> <listitem> <simpara>können diese den PEAR-Installer dureinanderbringen bei Updates, da CVS-Releases keine eindeutigen Versionsnummer besitzen.</simpara> </listitem> </itemizedlist> </para> <para> Sie sollten ein Package aus dem CVS heraus nur benutzen, wenn: <itemizedlist> <listitem> <simpara>Der Maintainer ist ihnen empfohlen hat.</simpara> </listitem> <listitem> <simpara>Sie bei der Entwicklung des Packages helfen wollen.</simpara> </listitem> <listitem> <simpara>Sie wirklich einen bestimmten Patch oder eine Funktion benötigen, die in einem Release nicht enthalten ist.</simpara> </listitem> </itemizedlist> </para> <para> Wenn Sie immer noch ein Package aus dem CVS installieren wollen, müssen die selben Schritte gehen, die auch ein Package-Maintainer tut, wenn er ein neues Release erzeugt. Wenn Sie Probleme bei den nächsten Punkten haben, werfen Sie einen Blick in den <link linkend="guide-developers">Entwickler-Leitfaden</link> des Handbuchs. </para> <orderedlist> <listitem> <para> Holen Sie sich die zum Package gehörenden Dateien wie es auf <ulink url="http://www.php.net/anoncvs.php">http://www.php.net/anoncvs.php</ulink> beschrieben ist. </para> <para> Der NAme des Moduls zum auschecken lautet <filename>pear/<packagename></filename>, z.B. <command> cvs -d :pserver:cvsread@cvs.php.net:/repository checkout pear/HTTP_Client</command>. </para> </listitem> <listitem> <para> überprüfen Sie die Datei <filename>package.xml</filename>, inbesondere die <literal>fileset</literal> benannten Einträge. Sie müssen die existierenden Dateien und Verzeichnisse wiederspiegeln. Wenn sie es nicht tun, nehmen Sie Kontakt mit dem Maintainer auf, und bitten ihn die <filename>package.xml</filename> anzupassen. </para> </listitem> <listitem> <para> Erzeugen Sie ein korrektes PEAR-Package mit dem PEAR-Installer <command>pear package <path to package.xml></command> </para> </listitem> <listitem> <para> ist das Package bereits installiert: entfernen Sie es, um Versions-Probleme zu vermeiden. <command>pear uninstall <package></command> </para> </listitem> <listitem> <para> Installieren Sie die erzeugte Package-Datei Install your package archive: <command>pear install <package-file></command> </para> <para> Jetzt ist die CVS-Version installiert! </para> </listitem> </orderedlist> <para> So früh wie möglich sollten Sie wieder ein offizielles Release installieren. Achten Sie darauf vor dem Installieren, die CVS-Version zu deinstallieren. </para> </sect1> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
http://cvs.php.net/co.php/peardoc/de/chapters/installation.xml?r=1.1&p=1 Index: peardoc/de/chapters/installation.xml +++ peardoc/de/chapters/installation.xml <?xml version="1.0" encoding="iso-8859-1" ?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.16 --> <!-- WORK IN PROGRESS, THERE IS PROBABLY LITTLE POINT IN TRANSLATING THIS DOCUMENT YET. --> <chapter id="installation"> <docinfo> <author> <firstname>Martin</firstname> <surname>Jansen</surname> </author> <date>2002-02-10</date> </docinfo> <title>Installation</title> <simpara> Diese Kapitel beschreibt wie man Packages von PEAR installiert </simpara> <sect1 id="installation.introduction"> <title>Einführung</title> <para> Bevor Sie dieses Kapitel lesen, sollten Sie mit der <link linkend="about.pear">Idee</link> von PEAR vertraut sein. </para> <para> Die auf den <link linkend="about-pfc">PFC</link> basierende Installation von PEAR als Bestandteil der PHP-Distribution enthält bereits alles, um die PEAR-Werkzeuge für die Installation zu nutzen. Mit einer einer aktuellen PHP-Installation können Sie sich zurücklegen: Die PEAR-Basis-Installation ist bereits vorhanden - es sei denn Sie haben PHP installiert mt der <command>./configure</command>-Einstellung <literal>--without-pear</literal>. </para> <para> Die Packages, die nicht zu den PFC gehören, können Sie mit dem PEAR-Package-Manager installieren. Er ist vergleichbar mit Debian's <quote><ulink url="&url.debian.apt;">apt-get</ulink></quote>. Zur Wiederholung: Mit einer aktuellen PHP-Installation (> 4.3.0) können Sie den nächsten Abschnitt überspringen. Nur wenn Sie die PHP-Version 4.2.* oder frühere benutzen, müsssen Sie den Manager von Hand installieren. </para> <para> Neben der Package-Installation übernimmt der PEAR-Package-Manager weitere Aufgaben: Er kann neue Packages erzeugen auf ihrem Computer, verwaltet eine Datenbank der installierten PAckages, überprüft Abhängigkeiten; und er kann über den <ulink url="&url.xmlrpc;">XML-RPC</ulink>-Service auf pear.php.net einige weitere Aufgaben übernehmen. </para> </sect1> <sect1 id="installation.getting"> <title>Den Manager herunterladen</title> <sect2> <title>Unix/Linux/BSD</title> <para> Mit PHP >= 4.3.0 ist der PEAR-Package-Manager bereits installiert, ausser es wurde bei <command>./configure</command> die Einstellung <literal>--without-pear</literal> angegeben. </para> <para> Für alle Versionen vor 4.3.0 oder für eine erneute Installation des Package-Managers können Sie folgerdermaßen vorgehen: <screen> <userinput> $ lynx -source http://go-pear.org/ | php </userinput> </screen> </para> <note> <para> Einige Linux-Distributionen (z.B. Redhat) benutzen <filename>links</filename> anstatt <filename>lynx</filename> als Namen für den Kommandozeilen-HTML-Browser. ändern Sie in diesem Fall die obige Anweisung entsprechend um. </para> </note> </sect2> <sect2> <title>Windows</title> <para> Nach dem Herunterladen und der Installation von PHP müssen Sie eine Batch-Datei <filename>go-pear.bat</filename> ausführen. Diese befindet sich im Verzeichniss ihrer PHP-Installation, z.B.: <filename>c:\php\go-pear.bat</filename>. Es werden ihnen einige Fragen gestellt, danach wird der PEAR-Package-Manager installiert in einem Pfad entsprechend ihrer Angaben. Zum Schluß müssen Sie den Installations-Pfad, der auf ihre PEAR-Installation zeigt, der Umgebungsvariable PATH <!-- PRüFEN !!!!!!!!!!!!!!! --> zuweisen (Start > Einstellungen > System > Umgebungsvariablen). Danach können Sie den PEAR-Package-Manager über die Kommandozeile unter Windows benutzen mit dem Aufruf von <literal>pear</literal>. </para> <para> Um ihre PEAR-Installation auf den neusten Stand zu bringen, rufen Sie in ihrem Browser die URL http://go-pear.org/ auf und speichern die Ausgabe in der Datei <filename>go-pear.php</filename>. Danach rufen Sie auf: <screen> <userinput> php go-pear.php </userinput> </screen> auf der Kommandozeile, um das Update durchzuführen. </para> </sect2> <sect2> <title>PEAR und Web-Hoster</title> <para> Wenn Sie eine Webseite bei eiem Web-Hoster betreiben und keinen direkten Zugriff auf den Server haben (lokal, Telnet oder SSH), dann können Sie den Manager nicht benutzen. Wenn Sie Kunden bei einem guten Web-Hoster sind, haben Sie gute Chancen, das häufig genutzte PEAR-Packages bereits installiert sind. Ist das nicht der Fall bzw. benötigen Sie weitere Packages, frageb Sie ihren Hoster, ob er sie installieren will. Sollte er sich weigern, schauen Sie sich nach einem neuen Anbieter um, oder versuchen Sie die Packages <link linkend="installation.manually">manuell zu installieren</link>. </para> </sect2> </sect1> <sect1 id="installation.cli"> <title>Der Kommandozeilen-Installer</title> <titleabbrev>CLI-Installer</titleabbrev> <para> <warning id="installation.web.prerequesite"> <title>Vorrausetzungen</title> <para> Die folgende Beschreibung geht davon aus, dass die neuste Version des <link linkend="installation.getting">PEAR-Package-Managers</link> installiert ist. </para> </warning> </para> <para> Die Installation über die Kommandozeile ist der schnellste Weg PEAR-Packages auf ihrem System zu installieren: Dazu verbindet sich der Manager mit dem PEAR-Package-Server über HTTP, lädt das Package herunter und installiert das Package gemäß ihren Einstellungen. </para> <sect2> <title>Die voll-automatische Installation</title> <para> Der CLI-Installer ist einfach zu benutzen. Tippen Sie folgendes in ihre Kommandozeile: </para> <para> <screen> <userinput> $ pear install <package> </userinput> </screen> </para> <para> <package> müß durch den Namen des Packages ersetzt werden, dass Sie installieren wollen (z.B. HTTP_Upload). Um eine Liste aller verfügbaren Packages zu bekommen, schauen Sie entweder auf die <ulink url="&url.pear.package.browse;">PEAR-Package-übersicht</ulink> oder führen Sie diesen Befehl aus: </para> <para> <screen> <userinput> $ pear remote-list </userinput> </screen> </para> <para> Dieses Kommando holt sich die Liste aller Packages, die zur Zeit in PEAR verfügbar sind. </para> </sect2> <sect2> <title>Halb-automatische Installation</title> <para> Wenn Sie ein Package von <ulink url=" http://pear.php.net/">pear.php.net</ulink> heruntergeladen haben als gezipptes Tar-Archiv, können Sie es ebenfalls lokal installieren, dazu geben Sie auf der Kommandozeile ein: </para> <para> <screen> <userinput> $ pear install <file>.tgz </userinput> </screen> </para> <para> Dieses Kommando wird das Package installieren ohne dass eine Online-Verbindung notwendig ist. <filename><file>.tgz</filename> muss durch den Namen der heruntergeladenen Datei ersetzt werden. </para> </sect2> </sect1> <sect1 id="installation.shared"> <title>Installation eines lokalen PEAR-Verzeichnisses bei fremden Web-Hostern</title> <para> Viele Benutzer sind bei Web-Hostern mit einer system-weiten PEAR-Installation. In einigen Fällen kann es notwendig sein, eine eigene PEAR-Installation zu verwalten, z.B. zur Installation nicht vorhandener Packages. Das ist möglich entweder über Telnet/SSH oder allein per FTP. </para> <sect2 id="installation.shared.shell"> <title>Ein lokales PEAR-Verzeichniss über Telnet</title> <para> Um ein lokales PEAR über Telnet zu installieren, führen Sie folgende Befehle aus: </para> <para> <screen> <userinput> $ pear -s -c ~/.pearrc -d doc_dir=~/pear/docs -d ext_dir=~/pear/ext -d php_dir=~/pear/lib -d data_dir=~/pear/data -d test_dir=~/pear/tests -d cache_dir=~/pear/cache -d bin_dir=~/pear/bin </userinput> </screen> </para> <para> Damit erzeugen Sie eine lokales Konfigurations-Datei in ihrem Home-Verzeichniss; sie heißt <filename>.pearrc</filename>. Dazu wird in ihrem Home-Verzeichniss ein Verzeichniss <filename>pear</filename> erzeugt, dass die zukünftigen Packages aufnimmt. </para> <para> Wenn Sie dann in <filename>.bashrc</filename> im Path-Eintrag das Verzeichniss <command>~/pear/bin</command> hinzufügen, müsste nachfolgender Aufruf funktionieren. Die Path-Angabe muß an erster Stelle in der Datei stehen! (Lautet ihr Startup-Datei anders, müssen Sie den Eintrag natürlich dort machen.) </para> <para> <screen> <userinput> $ pear -c ~/.pearrc install Archive_Tar PEAR Console_Getopt XML_RPC </userinput> </screen> </para> <para> Damit erzeugen Sie eine lokale PEAR-Installation, die oberhalb der systemweiten liegt. Damit die lokalen Packages auch benutzt werden, müssen Sie die include_path-Einstellung von PHP anpassen: </para> <para> <programlisting role="php"> <![CDATA[ <?php ini_set('include_path', '~/pear/lib' . PATH_SEPARATOR . ini_get('include_path')); ?> ]]> </programlisting> </para> <para> Alternativ können Sie dies auch in der <filename>.htaccess</filename> für Apache vornehmen über die Einstellung <literal>php_value</literal>. </para> </sect2> <sect2 id="installation.shared.ftp"> <title>Ein lokales PEAR-Verzeichniss über FTP</title> <para> Die Vorrausetzung für die Installation über FTP ist ein FTP-Programm, dass die Zugriffsrechte setzten kann. Erzeugen Sie zuerst ein Verzeichniss, dass NICHT in ihrem öffentlich zugänglichen Web-Verzeichniss liegt; die Benennung ist egal. Es muß für jeden les- und schreibbar sein (Zugriffsrechte: 0777). Holen Sie sich dann das <filename>go-pear.php</filename>-Skript von http://go-pear.org und laden Sie es in ein öffentlich zugängliches Unter-Verzeichniss ihres Web-Verzeichnisses. Sie sollten dieses Verzeichniss unbedingt über die <filename>.htaccess</filename> mit einem Passwort schützen. </para> <para> Rufen Sie als zweites über den Browser das <filename>go-pear.php</filename>-Skript auf. Ist die URL ihrer Webseite http://www.example.com, und befindet sich das Skript in <filename>public_html/install/go-pear.php</filename>; und http://www.example.com zeigt die Inhalte von public_html/, dann rufen Sie auf: http://www.example.com/install/go-pear.php. Folgen Sie den Installations-Anweisungen. Wenn Sie gefragt werden, wohin Sie PEAR installieren wollen, wählen Sie das Verzeichniss, das für jeden les- und schreibbar ist. Ausserdem werden Sie gefragt, wo sich die Kommandozeilen-Version von PHP befindet. Führen Sie dazu auf dem Server folgendes PHP-Skript über den Browser aus und übernehmen die Ausgabe: </para> <para> <programlisting role="php"> <![CDATA[ <?php echo `which php`; // if this does not work, also try echo PHP_BIN; ?> ]]> </programlisting> </para> <para> Nachdem PEAR installiert wurde, können Sie über den Web-Installer Packages installieren und aktualisieren wie mit jeder anderen PEAR-Installation. Um die installierten Packages zu benutzen, müssen Sie ebenfalls den Include-Path anpassen. </para> <para> <programlisting role="php"> <![CDATA[ <?php ini_set('include_path', '~/pear/lib' . PATH_SEPARATOR . ini_get('include_path')); ?> ]]> </programlisting> </para> </sect2> </sect1> <sect1 id="installation.manually"> <title>Manuelle Installation</title> <para> Packages manuell zu installieren ist nicht empfohlen, aber viele haben immer wieder Probleme mit der automatischen Installation, besonders wenn es sich um die Installation bei Web-Hoster handelt. </para> <para> In den nächsten Absätzen werden wir demonstrieren wie Sie Packages von Hand auf ihrer Webseite installieren. Wir gehen von diesem Schema aus: Der Document-Root der Seite ist <filename>/var/www/www.example.com/htdocs/</filename>. Auf der gleichen Ebene von <filename>htdocs</filename> befindet sich ein Verzeichniss <filename>includes</filename>. Auf dieses Verzeichniss kann nicht über <acronym>HTTP</acronym> zugegriffen, aber über <acronym>FTP</acronym> oder WebDAV. </para> <para> Die Installation besteht aus den folgenden Schritten. The installation consists of some easy to follow steps: <orderedlist> <listitem> <simpara> Das Package herunterladen: </simpara> <para> Sie können das Package herunterladen von der <ulink url="&url.pear;">PEAR-Homepage</ulink> über den Web-Browser. Wenn Sie die <acronym>URL</acronym> der Package-Seite nicht kennen, gehen Sie über den <ulink url="&url.pear.package.browse;">Package-Browser</ulink>. </para> </listitem> <listitem> <simpara> Hochladen des Package-Quellcodes </simpara> <para> Nach dem Sie die .tgz-Datei des Packages heruntergeladen haben, müssen Sie den Inhalt der Datei auf ihrem eigenem Computer entpacken. Laden Sie danach den entpackten Quellcode über <acronym>FTP</acronym>, WebDAV oder eine andere Methode in das Verzeichniss <filename>/var/www/www.example.com/includes/</filename>. Der Quellcode für Mail_Mime z.B. sollte sich dann befinden in <filename>/var/www/www.example.com/includes/Mail/</filename>. </para> </listitem> <listitem> <simpara> Anpassen des include_path </simpara> <para> Jetzt müssen Sie den include-path von PHP so anpassen, dass er den Namen des Verzeichnisse enthält, in dem der Quellcode liegt. Wenn Sie Zugriff auf die <filename>php.ini</filename> für ihre Webseite haben, müssen Sie das Verzeichniss <filename>/var/www/www.example.com/includes/</filename> in der Einstellung ergänzen. Wenn Sie keinen Zugriff darauf haben, müssen Sie diese Einstellung in jedem ihrer Skript setzen, um das PAckage zu benutzen: </para> <para> <programlisting role="php"> ini_set("include_path", '/var/www/www.example.com/includes/' . PATH_SEPARATOR . ini_get("include_path")); </programlisting> </para> </listitem> <listitem> <simpara> Nach dem Sie diese Schritte durchgeführt haben, können Sie das Package ein ihre Skripte einbinden: </simpara> <para> <programlisting role="php"> require_once "Mail/Mime.php"; $mime = ... </programlisting> </para> </listitem> </orderedlist> </para> <para> Wenn Sie weiter Fragen zur manuellen Installation haben, fragen Sie auf der <ulink url="&email.pear.general;">Mailing-Liste für PEAR-User</ulink>. </para> </sect1> <sect1 id="installation.cvs"> <title>CVS installer</title> <para> Dieser Abschnitt beschreibt, wie Sie ein PEAR-Package aus dem CVS heraus installieren. </para> <para> Sie sollten keine Packages direkt aus dem CV heraus in Produktions-Umgebungen laufen lassen! Es sind keine offiziellen Releases, deshalb: <itemizedlist> <listitem> <simpara>können Sie weder mit Hilfe vom Maintainer rechnen, noch von irgendjemand anderem.</simpara> </listitem> <listitem> <simpara>können diese den PEAR-Installer dureinanderbringen bei Updates, da CVS-Releases keine eindeutigen Versionsnummer besitzen.</simpara> </listitem> </itemizedlist> </para> <para> Sie sollten ein Package aus dem CVS heraus nur benutzen, wenn: <itemizedlist> <listitem> <simpara>Der Maintainer ist ihnen empfohlen hat.</simpara> </listitem> <listitem> <simpara>Sie bei der Entwicklung des Packages helfen wollen.</simpara> </listitem> <listitem> <simpara>Sie wirklich einen bestimmten Patch oder eine Funktion benötigen, die in einem Release nicht enthalten ist.</simpara> </listitem> </itemizedlist> </para> <para> Wenn Sie immer noch ein Package aus dem CVS installieren wollen, müssen die selben Schritte gehen, die auch ein Package-Maintainer tut, wenn er ein neues Release erzeugt. Wenn Sie Probleme bei den nächsten Punkten haben, werfen Sie einen Blick in den <link linkend="guide-developers">Entwickler-Leitfaden</link> des Handbuchs. </para> <orderedlist> <listitem> <para> Holen Sie sich die zum Package gehörenden Dateien wie es auf <ulink url="http://www.php.net/anoncvs.php">http://www.php.net/anoncvs.php</ulink> beschrieben ist. </para> <para> Der NAme des Moduls zum auschecken lautet <filename>pear/<packagename></filename>, z.B. <command> cvs -d :pserver:cvsread@cvs.php.net:/repository checkout pear/HTTP_Client</command>. </para> </listitem> <listitem> <para> überprüfen Sie die Datei <filename>package.xml</filename>, inbesondere die <literal>fileset</literal> benannten Einträge. Sie müssen die existierenden Dateien und Verzeichnisse wiederspiegeln. Wenn sie es nicht tun, nehmen Sie Kontakt mit dem Maintainer auf, und bitten ihn die <filename>package.xml</filename> anzupassen. </para> </listitem> <listitem> <para> Erzeugen Sie ein korrektes PEAR-Package mit dem PEAR-Installer <command>pear package <path to package.xml></command> </para> </listitem> <listitem> <para> ist das Package bereits installiert: entfernen Sie es, um Versions-Probleme zu vermeiden. <command>pear uninstall <package></command> </para> </listitem> <listitem> <para> Installieren Sie die erzeugte Package-Datei Install your package archive: <command>pear install <package-file></command> </para> <para> Jetzt ist die CVS-Version installiert! </para> </listitem> </orderedlist> <para> So früh wie möglich sollten Sie wieder ein offizielles Release installieren. Achten Sie darauf vor dem Installieren, die CVS-Version zu deinstallieren. </para> </sect1> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->