cvs: peardoc /de/chapters installation.xml

alexmerz Tue Apr 4 07:56:01 2006 UTC Modified files: /peardoc/de/chapters installation.xml Log: sync to en

http://cvs.php.net/viewcvs.cgi/peardoc/de/chapters/installation.xml?r1=1.11&r2=1.12&diff_format=u Index: peardoc/de/chapters/installation.xml diff -u peardoc/de/chapters/installation.xml:1.11 peardoc/de/chapters/installation.xml:1.12 --- peardoc/de/chapters/installation.xml:1.11 Fri Jan 27 18:37:20 2006 +++ peardoc/de/chapters/installation.xml Tue Apr 4 07:56:00 2006 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.38 Maintainer: alexmerz Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.40 Maintainer: alexmerz Status: ready --> <chapter id="installation"> <chapterinfo> <author> @@ -119,13 +119,12 @@ Wenn Sie eine Webseite bei eiem Web-Hoster betreiben und keinen direkten Zugriff auf den Server haben (lokal, Telnet oder SSH), dann k&ouml;nnen Sie den Manager nicht benutzen, wenn Sie nicht zumindest - Version 1.4.x und FTP-Zugang haben (SFTP wird derzeit noch nicht - unterstützt). + Version 1.4.x und FTP-Zugang haben. Mit <classname>PEAR_RemoteInstaller</classname> + ab Version 0.3.0 können Sie auch SFTP- und FTPS-Zugänge nutzen. </para> <warning> <simpara> Achtung: Bei FTP werden Passwörter unverschlüsselt übertragen! - FTP as a protocol is inherently insecure, as passwords are sent unencrypted. </simpara> </warning> <para> @@ -657,14 +656,14 @@ </para> </sect2> <sect2 id="installation.shared.ftp"> - <title>Ein lokales PEAR-Verzeichnis &uuml;ber FTP</title> + <title>Ein lokales PEAR-Verzeichnis &uuml;ber FTP/FTPS/SFTP</title> <para> Es gibt zwei Wege eine lokale PEAR-Installation per FTP auf einen anderen Server zu spiegeln: den alten, schweren Weg und den neuen, einfachen Weg. Der neue Weg erfordert unbedingt ein - Upgrade von PEAR auf Version 1.4.x. + Upgrade von PEAR auf Version 1.4.3. </para> <sect3> - <title>Die neue, verbesserte Methode mit PEAR 1.4.0 und Net_FTP</title> + <title>Die neue, verbesserte Methode mit PEAR 1.4.3+ und PEAR_RemoteInstaller</title> <para> Die Installation einer Kopie einer bestehenden PEAR-Installation über FTP würde mit PEAR 1.4.0 vereinfacht. @@ -673,7 +672,7 @@ Häufig ist es problematisch PEAR auf einem Server zu installieren, zu dem man keinen Shell-Zugang besitzt. Die einzige Möglichkeit ist auf FTP zurückzugreifen. Das führt aber bei manchen Packages zu Problemen, wenn diese auf fortgeschrittene - Funktionen des Installers aufsetzen, wie z.B. der Einsatz von systemspezifischen Ersetzungen + Funktionen des Installers aufsetzen, wie z.B. der Einsatz von systemspezifischen Ersetzungen im Quelltext. </para> <para> @@ -681,14 +680,33 @@ <orderedlist> <listitem> <para> + Sie benötigen unbedingt auf ihrem Rechner PHP 5.0 oder höher. + </para> + </listitem> + <listitem> + <para> + Wenn Sie FTPS benutzen wollen, dann muss in Ihrer lokalen + PHP-Installation die OpenSSL-Erweiterung aktiviert sein. + </para> + </listitem> + <listitem> + <para> + Wenn Sie SFTP benutzen wollen, dann muss in Ihrer lokalen + PHP-Installation die SSH2-Erweiterung aktiviert sein. + </para> + </listitem> + <listitem> + <para> Sie benötigen eine lauffähige CLI-Version von PEAR auf dem lokalen System. Damit ist das <command>pear</command>-Kommando gemeint, nicht das Web-Interface. </para> </listitem> <listitem> <para> - Stellen Sie sicher, dass der FTP-Zugang zum Server funktioniert und Sie - die erforderlichen Zugriffsrechte zum Schreiben besitzen. + Stellen Sie sicher, dass zumindest der FTP-Zugang zum Server funktioniert und Sie + die erforderlichen Zugriffsrechte zum Schreiben besitzen. Die Verwendung + von SFTP oder FTPS wird unbedingt empfohlen, wenn dies möglich ist, + da diese sicherer sind. </para> </listitem> <listitem> @@ -715,7 +733,9 @@ </listitem> <listitem> <para> - Installieren Sie die Packages, die Sie benötigen. + Installieren Sie die Packages, die Sie benötigen. Dazu verwenden + sie die Befehle <command>remote-install</command>, <command>remote-uninstall</command>, + <command>remote-upgrade</command> und <command>remote-upgrade-all</command>. </para> </listitem> </orderedlist> @@ -737,9 +757,7 @@ </para> <para> Das ist unbedingt notwendig - wenn Sie sich mit einem FTP-Programm auf ihrem - Webspace einloggen können, dann haben Sie FTP-Zugang. Der Zugang über SecureFTP - (SFTP) wird derzeit nicht unterstützt, das wird aber funktionieren, wenn das Package - <classname>Net_FTP</classname> SFTP unterstützt. + Webspace einloggen können, dann haben Sie FTP-Zugang. </para> <para> Merken Sie sich den Benutzernamen und das Passwort, mit dem Sie sich einloggen, @@ -822,8 +840,8 @@ </emphasis> </para> <para> - Benutzen Sie einfach ein FTP-Programm Ihrer Wahl zum Hochladen der gerade erzeugten Datei - <filename>.pearrc</filename> in das zu erzeugende Verzeichnis <filename>/home/username/pear/</filename> + Benutzen Sie einfach ein FTP-Programm Ihrer Wahl zum Hochladen der gerade erzeugten + Datei <filename>.pearrc</filename> in das zu erzeugende Verzeichnis <filename>/home/username/pear/</filename>. </para> <para> <emphasis> @@ -832,6 +850,30 @@ </emphasis> </para> <para> + Wenn Sie das normale, nicht verschlüsselte FTP benutzen, dann benutzen Sie + <literal>ftp://</literal> als Stream-Angabe. Soll hingegen FTPS benutzt werden, wählen + Sie <literal>ftps://</literal>, für SFTP schreiben Sie <literal>ssh2.sftp</literal> + als Stream-Angabe. + </para> + <para> + Der vollständige Pfad für die <literal>remote_config</literal>-Variable muss + unter Umständen der vollständige Pfad angegeben: + <screen> +<![CDATA[ +ssh2.sftp://user:pass@myremotehost.com/home/username/.pearrc +]]> + </screen> + </para> + <para> + Wenn die Verbindung fehlschlägt, dann kann auch versucht werden + relative Pfadangaben zu verwenden: + <screen> +<![CDATA[ +ftps://user:pass@myremotehost.com/.pearrc +]]> + </screen> + </para> + <para> Unter Windows: </para> <para> @@ -853,7 +895,9 @@ </para> <para> <emphasis> - 7. Installieren Sie die Packages, die Sie benötigen. + 7. Installieren Sie die Packages, die Sie benötigen. Dazu verwenden + sie die Befehle <command>remote-install</command>, <command>remote-uninstall</command>, + <command>remote-upgrade</command> und <command>remote-upgrade-all</command>. </emphasis> </para> <para> @@ -867,10 +911,14 @@ </emphasis> </para> <para> - Der Installer installiert ein Package zuerst lokal und benutzt dann <classname>Net_FTP</classname>, + Der Installer installiert ein Package zuerst lokal und verwendet dann die + FTP-Stream-Fahigkeiten von PHP, um eine Kopie jeder installierten Datei auf den Server an die korrekte Position hochzuladen. Alle Befehle, welche die Installation betreffen (wie z.B. <command>install</command>, <command>upgrade</command>, - selbst <command>upgrade-all</command>) können genutzt werden. Die Option + selbst <command>upgrade-all</command>) haben entsprechende Gegenstücke zur Verwaltung + der Packages auf dem Server (<command>remote-install</command>, <command>remote-uninstall</command>, + <command>remote-upgrade</command>, <command>remote-upgrade-all</command>). + Die Option <parameter>remote_config</parameter> teilt dem Installer mit, dass die lokale Installation automatisch auf dem Server gespiegelt werden soll. </para> @@ -891,7 +939,10 @@ Einige Packages konfigurieren sich bei der Installation abhängig vom zugrundeliegenden Betriebssystem (Windows vs. Linux). Prüfen Sie vor der Installation, ob dies der Fall ist, bzw. stellen Sie sicher, dass das lokale System und der Server mit dem selben Betriebssystem laufen. - </para> + Desweiteren können lokal installierte Packages bestimmte PHP-Erweiterungen benötigen. + Diese müssen ebenfalls auf dem Server verfügbar sein, dies kann mit + der Ausgabe von <function>phpinfo</function> überprüft werden. + </para> </warning> </sect3> <sect3> @@ -937,6 +988,9 @@ <![CDATA[ <?php ini_set('include_path', '~/pear/lib' . PATH_SEPARATOR . ini_get('include_path')); + +// Ab PHP 4.3.0 und höher sollte man besser diese Variante verwenden: + set_include_path('~/pear/lib' . PATH_SEPARATOR . get_include_path()); ?> ]]> </programlisting>