cvs: phpdoc-de /chapters install.apache.xml install.caudium.xml install.commandline.xml install.configure.xml install.fhttpd.xml install.general.xml
install.hpux.xml install.linux.xml install.macosx.xml install.openbsd.xml install.solaris.xml install.unix.xml install.windows.xml install.xml

tom Sat Feb 15 10:41:02 2003 EDT Added files: /phpdoc-de/chapters install.apache.xml install.caudium.xml install.commandline.xml install.configure.xml install.fhttpd.xml install.general.xml install.hpux.xml install.linux.xml install.macosx.xml install.openbsd.xml install.solaris.xml install.unix.xml install.windows.xml Removed files: /phpdoc-de/chapters install.xml Log: split the install.xml

Index: phpdoc-de/chapters/install.apache.xml +++ phpdoc-de/chapters/install.apache.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.16 Maintainer: tom Status: ready --> <sect1 id="install.apache"> <title>Server - Apache</title> <para> Dieser Abschnitt enthält Anmerkungen und Tipps zur Installation von Apache mit PHP, sowohl für die <link linkend="install.apache.unix">Unix</link> als auch für die <link linkend="install.apache.windows">Windows</link> Version. Es gibt auch eine eigene Seite mit <link linkend="install.apache2">instructions and notes for Apache 2</link>. </para> <sect2 id="install.apache.unix"> <title>Details der Installation von PHP mit Apache auf Unix</title> <para> Aus der <link linkend="install.configure">Kompletten Liste der Konfigurationsoptionen</link> können Sie die weitere Argumente für <command>configure</command> in Zeile 10 wählen. Um sicherzustellen, dass die folgenden Instruktionen nicht inkorrekt sind, wurden die Versionsnummern hier weggelassen. Ersetzen Sie bitte die hier angeführten 'xxx' mit den korrekten Werten Ihrer Dateien. </para> <example id="install.apache.unix.longer"> <title> Installationsanweisungen (Apache Modulversion) für PHP 4 </title> <screen> <![CDATA[ 1. gunzip apache_xxx.tar.gz 2. tar -xvf apache_xxx.tar 3. gunzip php-xxx.tar.gz 4. tar -xvf php-xxx.tar 5. cd apache_xxx 6. ./configure --prefix=/www --enable-module=so 7. make 8. make install 9. cd ../php-xxx 10. ./configure --with-mysql --with-apxs=/www/bin/apxs 11. make 12. make install Wenn Sie Ihre Konfigurationsoptionen nach der Installation ändern möchten, müssen Sie nur die letzten 3 Schritte wiederholen. Sie müssen Apache nur neu starten, um das neue Modul einzubinden. Apache neu zu kompilieren ist nicht notwendig. 13. cp php.ini-dist /usr/local/lib/php.ini Sie können Ihre .ini Datei editieren, um PHP Optionen zu setzen. Wenn Sie diese Datei an einer anderen Stelle haben möchten, verwenden Sie --with-config-file-path=/path in Schritt 10. 14. Editieren Sie die httpd.conf oder srm.conf Datei und stellen Sie sicher, dass folgende Zeilen vorhanden und nicht auskommentiert sind: AddType application/x-httpd-php .php LoadModule php4_module libexec/libphp4.so Hier können Sie jede gewünschte Erweiterung auswählen. .php wird vorgeschlagen. Sie können auch .html, und .php3 zwecks Rückwärtskompatibilität auswählen. Der Pfad auf der rechten Seite des LoadModule Satements muss auf den Pfad des PHP Moduls auf Ihrem System zeigen. Das obige Statement passt zu den oben gezeigten Schritten. 15. Starten Sie den Apache Server mittels Ihrer normalen Prozedur. (Sie müssen den Server stoppen und neu starten, und nicht nur mittels eines HUP oder ISR1 Signals einen Reload initiieren.) ]]> </screen> </example> <para> Abhängig von Ihrer Apache Installation und Unix Variante gibt es viele mögliche Wege, den Server zu stoppen und neu zu starten. Nachstehend finden Sie einige typische Zeilen für einen Server Restart auf verschiedenen apache/unix Installationen. Ersetzen Sie <literal>/path/to/</literal> mit dem Pfad zu diesen Applikationen auf Ihrem System. <informalexample> <screen> <![CDATA[ 1. Verschiedene Linux und SysV Varianten: /etc/rc.d/init.d/httpd restart 2. Verwenden von apachectl Skripten: /path/to/apachectl stop /path/to/apachectl start 3. httpdctl und httpsdctl (verwendet OpenSSL), ähnlich wie apachectl: /path/to/httpsdctl stop /path/to/httpsdctl start 4. Verwenden von mod_ssl, oder einem anderem SSL Server möchten Sie vielleicht manuell stoppen und starten: /path/to/apachectl stop /path/to/apachectl startssl ]]> </screen> </informalexample> Die Orte wo sich die Programme apachectl und http(s)dctl befinden, sind oft unterschiedlich. Falls Ihr System über die Kommandos <literal>locate</literal>, <literal>whereis</literal>, oder <literal>which</literal> verfügt, können diese bei der Suche nach den Server Kontrollprogrammen sehr hilfreich sein. </para> <para> Einige Beispiele zum Kompilieren von PHP für Apache: <informalexample> <programlisting role="shell"> <![CDATA[ /configure --with-apxs --with-pgsql ]]> </programlisting> </informalexample> </para> <para> Dies erstellt eine <filename>libphp4.so</filename> Shared Library, welche in den Apache geladen wird, wenn eine LoadModule Zeile in der <filename>httpd.conf</filename> von Apache existiert. Die PostgreSQL Unterstützung ist in der <filename>libphp4.so</filename> Bibliothek eingelagert. </para> <para> <informalexample> <programlisting> <![CDATA[ /configure --with-apxs --with-pgsql=shared ]]> </programlisting> </informalexample> </para> <para> Dies erstellt ebenfalls eine <filename>libphp4.so</filename> Shared Library, jedoch wird zusätzlich auch eine <filename>pgsql.so</filename> Shared Library erstellt. Diese wird entweder aufgrund der Extension Option in der &php.ini;, oder durch die Verwendung der Funktion <function>dl</function> in einem Skript von PHP geladen. </para> <para> <informalexample> <programlisting> <![CDATA[ /configure --with-apache=/path/to/apache_source --with-pgsql ]]> </programlisting> </informalexample> </para> <para> Dies erstellt eine <filename>libmodphp4.a</filename> Bibliothek, eine <filename>mod_php4.c</filename> sowie einige begleitende Dateien, und kopiert diese in das <filename>src/modules/php4</filename> Verzeichnis im Apache Source Tree. Dann kompilieren Sie Apache mit <literal>--activate-module=src/modules/php4/libphp4.a</literal>, und das Apache Build System erstellt <filename>libphp4.a</filename>, und linkt es statisch in die <filename>httpd</filename> Binary. Die PostgreSQL Unterstützung ist in dieser <filename>httpd</filename> Binary inkludiert, was in einer einzigen <filename>httpd</filename> Binary inkl. komplettem Apache und komplettem PHP resultiert. </para> <para> <informalexample> <programlisting> <![CDATA[ /configure --with-apache=/path/to/apache_source --with-pgsql=shared ]]> </programlisting> </informalexample> </para> <para> Wie vorher, außer dass die PostgreSQL Unterstützung nicht direkt in die <filename>httpd</filename> inkludiert, sondern eine <filename>pgsql.so</filename> Shared Library erstellt wird. Diese können Sie entweder mittels der Extension Option in der &php.ini;, oder direkt mittels <function>dl</function> in PHP laden. </para> <para> Bevor Sie sich für eine Methode PHP zu kompilieren entscheiden, sollten Sie die Vor- und Nachteile der jeweiligen Methode bedenken. Die Kompilation als verteiltes Objekt heißt, dass Sie Apache separat kompilieren können, und nicht für alles in PHP hinzugefügte bzw. geänderte neu kompilieren müssen. PHP direkt in Apache einzukompilieren (statische Methode) heißt, dass PHP schneller lädt und schneller läuft. Weitere Informationen finden Sie auf der Apache <ulink url="&url.apachedso;">webpage on DSO support</ulink>. </para> <note> <para> Die httpd.conf von Apache kommt derzeit mit einem Abschnitt wie folgt: <informalexample> <programlisting> <![CDATA[ User nobody Group "#-1" ]]> </programlisting> </informalexample> Wenn Sie diese Gruppe nicht auf "Group nogroup" oder etwas ähnliches ("Group daemon" ist auch weit verbreitet) ändern, kann PHP keine Dateien öffnen. </para> </note> <note> <para> Wenn Sie --with-apxs=/path/to/apxs verwenden, spezifizieren Sie die installierte Version von apxs. Sie sollten die in den Apache Sourcen enthaltene apxs Version NICHT verwenden, sondern jene, welche sich aktuell auf Ihrem System befindet. </para> </note> </sect2> <sect2 id="install.apache.windows"> <title>Installation von PHP auf Windows mit Apache 1.3.x</title> <simpara> Es gibt zwei Arten, PHP mit Apache 1.3.x unter Windows aufzusetzen. Eine ist die Verwendung des CGI Moduls (php.exe), die andere ist der Einsatz der Apache Modul DLL. In beiden Fällen müssen Sie den Apache Server stoppen, und Ihre <filename>srm.conf</filename> oder <filename>httpd.conf</filename> editieren, um Apache für die Zusammenarbeit mit PHP zu konfigurieren. </simpara> <simpara> Es ist erwähnenswert, dass die Stabilität des SAPI Moduls erhöht wurde, und dass wir aufgrund der höheren Transparenz und Sicherheit den Einsatz gegenüber dem CGI Programm bevorzugt empfehlen. </simpara> <simpara> Obwohl einige Variationen in der Konfiguration von PHP unter Apache möglich sind, sollten diese auch für Neulinge einfach genug sein. Für weitere Konfigurationsmöglichkeiten konsultieren Sie bitte die Apache Dokumentation. </simpara> <para> Wenn Sie die PHP Distribution wie im Abschnitt <link linkend="install.windows.manual">Manuelle Installationsschritte</link> beschrieben nach c:\php\ entpackt haben, müssen Sie die folgenden Zeilen in Ihrer Apache Konfigurationsdatei einfügen, um das CGI-Modul aufzusetzen: <itemizedlist> <listitem> <simpara> <literal> ScriptAlias /php/ "c:/php/" </literal> </simpara> </listitem> <listitem> <simpara> <literal> AddType application/x-httpd-php .php .phtml </literal> </simpara> </listitem> <listitem> <simpara> <literal> Action application/x-httpd-php "/php/php.exe" </literal> </simpara> </listitem> </itemizedlist> Beachten Sie, dass die zweite Zeile der obigen Liste in den aktuellen Versionen von <filename>httpd.conf</filename> bereits enthalten, jedoch auskommentiert ist. Vergessen Sie nicht, <filename>c:/php/</filename> durch den aktuellen Pfad zu PHP zu ersetzen. </para> <warning> <para> Wenn Sie das CGI Setup verwenden, ist Ihr Server für verschiedene mögliche Angriffe offen. Informationen, wie Sie sich vor Angriffen schützen können, finden Sie im Abschnitt <link linkend="security.cgi-bin">CGI Sicherheit</link> </para> </warning> <para> Wenn Sie PHP als Apache Modul einsetzen möchten, kopieren Sie die <filename>php4ts.dll</filename> in Ihr windows/system (für Windows 9x/Me) oder winnt/system32 (für Windows NT/2000/XP) Verzeichnis, und überschreiben die dort eventuell bereits existierende Datei. Dann sollten Sie die folgenden zwei Zeilen in Ihrer Apache <filename>httpd.conf</filename> Datei einfügen: <itemizedlist> <listitem> <simpara> <literal> LoadModule php4_module c:/php/sapi/php4apache.dll </literal> </simpara> </listitem> <listitem> <simpara> <literal> AddType application/x-httpd-php .php .phtml </literal> </simpara> </listitem> </itemizedlist> </para> <simpara> Vergessen Sie nicht, nach der Änderung der Konfigurationsdatei den Server neu zu starten, z.B. mit <literal>NET STOP APACHE</literal>, gefolgt von <literal>NET START APACHE</literal> wenn Sie Apache als Windows Service nutzen, oder verwenden Sie Ihre üblichen Shortcuts. </simpara> <warning> <simpara> Nachdem Sie den Windows Installer für Apache benutzt haben könnte es nötig sein, dass Sie die <literal>AddModule</literal> Direktive für <filename>mod_php4.c</filename> in der Konfigurationsdatei (<filename>httpd.conf</filename>) definieren müssen. Dies tun Sie, indem Sie der <literal>AddModule</literal> Liste ziemlich am Anfang der Konfigurationsdatei den Eintrag <literal>AddModule mod_php4.c</literal> hinzufügen. Dies ist speziell dann wichtig, wenn die Direktive <literal>ClearModuleList</literal> definiert ist. Wenn Sie dies nicht tun heißt das, dass PHP nicht als Apache Modul registriert ist. </simpara> </warning> <simpara> Es gibt zwei Arten, wie Sie das Feature Source Code Highlighting verwenden können, auch wenn deren Funktionsfähigkeit von Ihrer Installation abhängt. Wenn Sie Apache so konfiguriert haben, dass er PHP als SAPI Modul verwendet, können Sie dieses Feature verwenden, indem Sie die folgende Zeile in ihre Konfigurationsdatei (<filename>httpd.conf</filename>) einfügen: <literal>AddType application/x-httpd-php-source .phps </literal> </simpara> <simpara> Haben Sie Apache so konfiguriert, dass er PHP als CGI Programm verwendet, müssen Sie die Funktion <function>show_source</function> benutzen. Dies tun Sie, indem einfach ein PHP Skript mit folgendem Code erstellen: <literal>&lt;?php show_source ("original_php_script.php"); ?></literal>. Ersetzen Sie <literal>original_php_script.php</literal> durch den Dateinamen des Skriptes, dessen Source Sie zeigen wollen. </simpara> <note> <simpara> Bei Apache unter Windows müssen alle Backslashes in einer Pfadangabe wie z.B. "c:\directory\file.ext" durch Slashes ersetzt werden, wie z.B. "c:/directory/file.ext". </simpara> </note> </sect2> </sect1> <!-- 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 indent-tabs-mode:nil 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 --> Index: phpdoc-de/chapters/install.caudium.xml +++ phpdoc-de/chapters/install.caudium.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.6 Maintainer: tom Status: ready --> <sect1 id="install.caudium"> <title>Server - Caudium</title> <para> PHP 4 kann als Pike Modul für den <ulink url="&url.caudium;">Caudium Webserver</ulink> erstellt werden, was jedoch mit PHP 3 nicht unterstützt wird. Folgen Sie einfach den nachstehenden Instruktionen, um PHP 4 für Caudium zu installieren. </para> <example id="install.caudium.instructions"> <title>Caudium Installationsanweisungen</title> <screen> <![CDATA[ 1. Installieren Sie Caudium bevor Sie versuchen, PHP 4 zu installieren Damit PHP 4 korrekt läuft, benötigen Sie Pike 7.0.268 oder höher. In diesem Beispiel nehmen wir an, dass Caudium in /opt/caudium/server/ installiert ist. 2. Wechseln Sie in das Verzeichnis php-x.y.z (x.y.z entspricht der Versionsnummer) 3. ./configure --with-caudium=/opt/caudium/server 4. make 5. make install 6. Sollte Caudium gerade laufen, starten Sie ihn neu 7. Öffnen Sie die grafische Konfigurationsoberfläche, und wechseln Sie zu dem virtuellen Server, welcher die PHP 4 Unterstützung bieten soll. 8. Klicken Sie auf Add Module, und fügen Sie das PHP 4 Script Support Modul hinzu. 9. Sollte die Dokumentation meinen 'PHP 4 interpreter isn't available', vergewissern Sie sich, dass der Server neu gestartet wurde. Prüfen Sie /opt/caudium/logs/debug/default.1 auf Fehler in Bezug auf <filename>PHP4.so</filename>. Vergewissern Sie sich ebenfalls, dass <filename>caudium/server/lib/[pike-version]/PHP4.so</filename> vorhanden ist. 10. Konfigurieren Sie das PHP Script Support Module wenn nötig. ]]> </screen> </example> <para> Sie können Ihr Caudium Modul natürlich mit Unterstützung der verschiedenen in PHP 4 verfügbaren Erweiterungen kompilieren. Eine gute Übersicht hierfür bietet die <link linkend="install.configure">Komplette Liste der Konfigurationsoptionen</link>. </para> <note> <para> Wenn Sie PHP 4 mit MySQL Unterstützung kompilieren müssen Sie sicherstellen, dass der normale MySQL Client Code verwendet wird. Andernfalls könnten Konflikte auftreten, wenn Ihr Pike MySQL bereits Unterstützt. Dies tun Sie, indem Sie ein MySQL Installationsverzeichnis mittels der <option role="configure"> --with-mysql</option> spezifizieren. </para> </note> </sect1> <!-- 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 indent-tabs-mode:nil 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 --> Index: phpdoc-de/chapters/install.commandline.xml +++ phpdoc-de/chapters/install.commandline.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.5 Maintainer: tom Status: ready --> <sect1 id="install.commandline"> <title>Server-CGI/Commandline</title> <para> Standardmäßig wird PHP als ein CGI Programm kompiliert. Dies erstellt einen Kommandozeileninterpreter, welcher für CGI Processing oder für nicht webbezogene PHP Skripte verwendet werden kann. Haben Sie einen Webserver im Einsatz für welchen PHP eine Modulunterstützung bietet, sollten sie aus Performancegründen dieses Modul verwenden. Die CGI Version ermöglicht Apache Usern, verschiedene PHP Seiten unter verschiedenen User-IDs laufen zu lassen. Bitte lesen Sie das Kapitel <link linkend="security">Sicherheit</link>, wenn Sie PHP als CGI verwenden. </para> <para> Seit PHP 4.3.0 wurden PHP einige wichtige Dinge hinzugefügt. Es gibt ein neues SAPI, CLI genannt, welches den selben Namen trägt wie das CGI Programm. Was in <literal>{PREFIX}/bin/php</literal> installiert ist, ist von Ihrer 'Configure'-Zeile abhängig. Eine detaillierte Beschreibung dazu finden Sie im Abschnitt <link linkend="features.commandline">Using PHP from the command line</link>. </para> <sect2 id="install.commandline.testing"> <title>Testen</title> <simpara> Wenn Sie PHP als CGI Programm erstellt haben, können Sie Ihren Build mittels <command>make test</command> testen, was generell eine gute Idee ist. Damit können Sie ein eventuelles Problem mit PHP auf Ihrer Plattform erkennen, bevor Sie später damit zu kämpfen haben. </simpara> </sect2> <sect2 id="install.commandline.benchmarking"> <title>Benchmarking</title> <simpara> Haben Sie PHP 3 als CGI Programm erstellt, können Sie Ihren Build mit <command>make bench</command> bewerten. Beachten Sie, dass wenn &safemode; standardmäßig aktiviert ist, der Benchmark nicht fertiggestellt werden kann, sollte dieser länger als die erlaubten 30 Sekunden dauern. Der Grund dafür liegt in der Tatsache, dass <function>set_time_limit</function> in &safemode; nicht benutzt werden kann. Verwenden Sie die Konfigurationsoption <link linkend="ini.max-execution-time">max_execution_time</link>, um diese Zeit für Ihre eigenen Skripte einzustellen. <command>make bench</command> ignoriert die <link linkend="configuration.file">Konfigurationsdatei</link>. </simpara> <note> <simpara> <command>make bench</command> ist nur in PHP 3 verfügbar. </simpara> </note> </sect2> <sect2 id="install.commandline.using-variables"> <title>Variablen verwenden</title> <simpara> Manche vom Server zur Verfügung gestellten Umgebungsvariablen sind nicht der aktuellen <ulink url="&url.cgispec;">CGI/1.1 Spezifikation</ulink> enthalten. Nur die folgenden Variablen sind dort definiert, alles andere sollte als 'Anbieterspezifisch' betrachtet werden: AUTH_TYPE, CONTENT_LENGTH, CONTENT_TYPE, GATEWAY_INTERFACE, PATH_INFO, PATH_TRANSLATED, QUERY_STRING, REMOTE_ADDR, REMOTE_HOST, REMOTE_IDENT, REMOTE_USER, REQUEST_METHOD, SCRIPT_NAME, SERVER_NAME, SERVER_PORT, SERVER_PROTOCOL und SERVER_SOFTWARE </simpara> </sect2> </sect1> <!-- 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 indent-tabs-mode:nil 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 --> Index: phpdoc-de/chapters/install.configure.xml +++ phpdoc-de/chapters/install.configure.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> <sect1 id="install.configure"> <title>Komplette Liste der Konfigurationsoptionen</title> <note> <para> Diese Optionen werden nur zur Kompilierzeit genutzt. Wenn Sie die Laufzeitkonfiguration von PHP ändern möchten, lesen Sie bitte unter <link linkend="configuration">Configuration</link> nach. </para> </note> <para> Nachstehend finden Sie die komplette Liste von Optionen, welche von PHP 4 <filename>configure</filename> Skripten (Stand 4.1.0) unterstützt, und zum Kompilieren in einer Unix-ähnlichen Umgebung verwendet werden. Manche Optionen sind in PHP 3, manche in PHP 4 und manche sind in beiden Versionen verfügbar. Dies ist derzeit noch nicht verzeichnet. <!-- There are many options the names of which have changed between PHP 3 and PHP 4, but which accomplish the same things. These entries are cross-referenced to each other, so if you have a problem getting your PHP 3-era configuration options to work, check here to see whether the names have changed. --> </para> <para> Es gibt generelle Konfigurationsoptionen für das <command>configure</command> Skript, nähere Informationen dazu finden Sie in den Manpages für GNU <command>autoconf</command>, oder den Aufruf von <command>configure --help</command>, welcher eine vollständige und aktuelle Liste bietet. </para> <itemizedlist> <listitem> <para> <link linkend="install.configure.options.databases">Datenbank</link> </para> </listitem> <!-- <listitem> <para> <link linkend="install.configure.options.ecommerce">Ecommerce</link> </para> </listitem> --> <listitem> <para> <link linkend="install.configure.options.graphics">Grafik</link> </para> </listitem> <listitem> <para> <link linkend="install.configure.options.misc">Verschiedenes</link> </para> </listitem> <!-- <listitem> <para> <link linkend="install.configure.options.networking">Networking</link> </para> </listitem> --> <listitem> <para> <link linkend="install.configure.options.php">PHP Verhalten</link> </para> </listitem> <listitem> <para> <link linkend="install.configure.options.servers">Server</link> </para> </listitem> <!-- <listitem> <para> <link linkend="install.configure.options.text">Text and language</link> </para> </listitem> <listitem> <para> <link linkend="install.configure.options.xml">XML</link> </para> </listitem> --> </itemizedlist> <sect2 id="install.configure.options"> <title>Konfigurationsoptionen in PHP 4</title> <note> <para> Diese Optionen werden nur in PHP 4 mit Stand von PHP 4.1.0 verwendet. Manche davon sind auch in älteren Versionen von PHP 4 verfügbar, manche sogar in PHP 3, manche nur in PHP 4.1.0. Sollten Sie eine ältere Version von PHP kompilieren wollen kann es sein, dass manche Optionen nicht verfügbar sind. </para> </note> &chapters.install.configure.databases; &chapters.install.configure.graphics; &chapters.install.configure.misc; &chapters.install.configure.php; &chapters.install.configure.servers; <!-- &chapters.install.configure.xml; --> </sect2> </sect1> <!-- 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 indent-tabs-mode:nil 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 --> Index: phpdoc-de/chapters/install.fhttpd.xml +++ phpdoc-de/chapters/install.fhttpd.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.1 Maintainer: tom Status: ready --> <sect1 id="install.fhttpd"> <title>Server - fhttpd</title> <para> Um PHP als ein fhttpd Modul zu erstellen, beantworten Sie die Frage "Build as an fhttpd module?" mit "yes" (die Konfigurationsoption <link linkend="install.configure.with-fhttpd"> --with-fhttpd</link>=<replaceable>DIR</replaceable>), und geben das Basisverzeichnis des fhttpd Source an. Das Standardverzeichnis ist <filename class="directory">/usr/local/src/fhttpd</filename>. Wenn Sie fhttpd benutzen, bietet das Kompilieren von PHP als Modul eine bessere Performance, mehr Kontrolle, sowie die Möglichkeit zur Remote Execution. </para> </sect1> <!-- 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 indent-tabs-mode:nil 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 --> Index: phpdoc-de/chapters/install.general.xml +++ phpdoc-de/chapters/install.general.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> <sect1 id="install.general"> <title>Generelle Überlegungen zur Installation</title> <para> Noch vor der Installation sollten Sie wissen, wofür Sie PHP einsetzen wollen. Es gibt drei Haupteinsatzbereiche von PHP, wie in dem Abschnitt <link linkend="intro-whatcando">Was kann PHP?</link> beschrieben: <itemizedlist> <listitem><simpara>Serverseitige Skripte</simpara></listitem> <listitem><simpara>Skripte auf der Kommandozeile</simpara></listitem> <listitem><simpara>Clientseitige GUI Applikationen</simpara></listitem> </itemizedlist> </para> <para> Für den ersten und sehr weit verbreiteten Einsatzbereich benötigen Sie drei Dinge: PHP selbst, einen Webserver und einen Webbrowser. Sie haben wahrscheinlich bereits einen Webbrowser, und abhängig von Ihrer Betriebssystemkonfiguration haben Sie vielleicht auch schon einen Webserver (z.B. Apache auf Linux oder IIS auf Windows). Sie können Webspace bei einem Provider mieten. Dann benötigen Sie nichts selbst, sondern schreiben nur Ihre PHP Skripte, laden Sie zu dem gemieteten Server hoch, und sehen sich das Ergebnis in Ihrem Browser an. </para> <para> Wenn Sie Ihren Server und PHP selbst installieren, können Sie zwischen zwei Methoden wählen, wie Sie PHP mit dem Server verbinden. PHP verfügt für viele Server über eine direkte Modulschnittstelle (auch SAPI genannt). Diese Server sind zum Beispiel Apache, Microsoft Internet Information Server, Netscape und iPlanet Server. Viele andere Server unterstützen die Microsoft Modulschnittstelle ISAPI (z.B. OmniHTTPd). Sollte PHP keine Modulschnittstelle für Ihren Webserver unterstützen, können Sie es immer über die CGI Schnittstelle betreiben. Das heißt, dass Sie Ihren Webserver so konfigurieren, dass bei jeder Anforderung von PHP Dateien an den Server das Kommandozeilenprogramm von PHP (<filename>php.exe</filename> auf Windows) zur Abarbeitung der Skripte benutzt wird. </para> <para> Wenn Sie PHP auch für Skripte auf der Kommandozeile benutzen möchten (z.B. für Skripte, die offline entsprechend ein paar von Ihnen übergebenen Parametern automatisch Bilder erzeugen oder Textdateien verarbeiten), benötigen Sie das Kommandozeilenprogramm. Weitere Informationen hierzu finden Sie unter <link linkend="features.commandline">writing command line PHP applications</link>. In diesem Fall benötigen Sie weder einen Server, noch einen Browser. </para> <para> Sie können mit PHP und der PHP-GTK Erweiterung auch clientseitige GUI Applikationen erstellen. Dies ist ein völlig anderer Ansatz als das Schreiben von Webseiten, da Sie zwar kein HTML ausgeben, dafür aber Fenster und Objekte handhaben. Weitere Informationen zu PHP-GTK finden Sie auf der <ulink url="&url.php.gtk;">Webseite zu dieser Erweiterung</ulink>. PHP-GTK ist nicht in offiziellen PHP Distribution enthalten. </para> <para> Von nun an befasst sich dieser Abschnitt mit der Installation von PHP für Webserver auf Unix und Windows mit Servermodulen und CGI Schnittstellen. </para> <para> Den Quellcode von PHP sowie die Binärdistributionen für Windows erhalten Sie unter <ulink url="&url.php;">&url.php;</ulink>. Wir empfehlen, den Download der Distributionen von dem Ihnen am nächsten liegenden <ulink url="&url.mirrors;">Mirror</ulink> durchzuführen. </para> </sect1> <!-- 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 indent-tabs-mode:nil 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 --> Index: phpdoc-de/chapters/install.hpux.xml +++ phpdoc-de/chapters/install.hpux.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.1 Maintainer: tom Status: ready --> <sect1 id="install.hpux"> <title>Unix/HP-UX Installationen</title> <para> Dieser Abschnitt enthält Anmerkungen und Hinweise zur Installation von PHP auf HP-UX Systemen. </para> <example id="install.hpux.example"> <title> Installationsanleitung für HP-UX 10 </title> <screen> <![CDATA[ Von: paul_mckay@clearwater-it.co.uk 04-Jan-2001 09:49 (Diese Tipps sind für PHP 4.0.4 und Apache v1.3.9) Sie wollen also PHP und Apache auf einer HP-UX 10.20 installieren? 1. Sie brauchen gzip, holen Sie sich eine Binärdistribution von http://hpux.connect.org.uk/ftp/hpux/Gnu/gzip-1.2.4a/gzip-1.2.4a-sd-10.20.depot.Z dekomprimieren Sie die Datei, und installieren Sie sie mit swinstall 2. Sie brauchen gcc, holen Sie sich eine Binärdistribution von http://gatekeep.cs.utah.edu/ftp/hpux/Gnu/gcc-2.95.2/gcc-2.95.2-sd-10.20.depot.gz gunzip, und installieren Sie gcc mit swinstall. 3. Sie brauchen die GNU binutils, holen Sie sich eine Binärdistribution von http://hpux.connect.org.uk/ftp/hpux/Gnu/binutils-2.9.1/binutils-2.9.1-sd-10.20.depot.gz gunzip, und installieren Sie sie mit swinstall. 4. Nun benötigen Sie bison, holen Sie sich eine Binärdistribution von http://hpux.connect.org.uk/ftp/hpux/Gnu/bison-1.28/bison-1.28-sd-10.20.depot.gz installieren Sie sie wie o.a. 5. Nun benötigen Sie flex, laden Sie sich den Sourcecode von einem der http://www.gnu.org Mirrors herunter. Er befindet sich in dem non-gnu Verzeichnis der FTP-Site. Downloaden Sie die Datei, gunzip, dann tar -xvf 'en Sie sie. Gehen Sie in das erstellte Verzeichnis flex, und führen ./configure aus, dann make, und dann make install. Sollten dabei Fehler auftreten liegt es vielleicht daran, dass gcc etc. nicht im PATH sind. Ist das der Fall, fügen Sie diese bitte dem PATH hinzu. OK, nun zum schwierigen Teil: 6. Laden Sie die Sourcecodes von PHP und Apache herunter. 7. Führen Sie gunzip und tar -xvf an ihnen aus. Wir müssen einige Dateien ändern, damit sie richtig kompiliert werden können. 8. Erst muss die Konfigurationsdatei geändert werden, denn es scheint als würde sie aus den Augen verlieren, dass sie auf einer hpux Maschine ist. Es gibt sicher einen besseren Weg dies zu tun, aber einfacher Weg ist es, lt_target=hpux10.20 in die Zeile 47286 des configure Skriptes zu schreiben. 9. Als nächstes müssen wir die Apache GuessOS Datei ändern. Unter apache_1.3.9/src/helpers ändern Sie die Zeile 89 von "echo "hp${HPUXMACH}-hpux${HPUXVER}"; exit 0" auf: "echo "hp${HPUXMACH}-hp-hpux${HPUXVER}"; exit 0" 10. Sie können PHP nicht als Shared Object unter HP-UX installieren, weshalb Sie es statisch kompilieren müssen; folgen Sie einfach den Anweisungen auf der Apache Seite. 11. Das Kompilieren von PHP und Apache sollte OK gehen, aber Apache wird nicht starten. Sie müssen einen neuen User für Apache einrichten, z.B. www oder apache. Dann ändern Sie die Zeilen 252 und 253 der conf/httpd.conf in Apache so, dass statt User nobody Group nogroup etwas ähnliches steht wie: User www Group sys Das hat den Grund, dass Sie Apache unter HP-UX nicht als nobody laufen lassen können. Jetzt sollten Apache und PHP laufen. Ich hoffe das hilft jemandem, Paul Mckay. ]]> </screen> </example> </sect1> <!-- 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 indent-tabs-mode:nil 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 --> Index: phpdoc-de/chapters/install.linux.xml +++ phpdoc-de/chapters/install.linux.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.2 Maintainer: tom Status: ready --> <sect1 id="install.linux"> <title>Unix/Linux Installationen</title> <para> Dieser Abschnitt enthält Anmerkungen und Hinweise zur Installation von PHP auf Linux Distributionen. </para> <sect2 id="install.linux.packages"> <title>Pakete verwenden</title> <simpara> Viele Linux Distributionen haben eine Art Paketinstallation, wie z.B. RPM. Das kann beim Setup einer Standardkonfiguration helfen, aber wenn Sie andere Features (wie einen Secure Server, oder einen anderen Datenbanktreiber) benötigen könnte es sein, dass ein Build von PHP und/oder Ihres Webservers nötig ist. Wenn Sie mit dem Erstellen und Kompilieren Ihrer Software nicht vertraut sind, sollten Sie sich nach einer von jemand anders bereits erstellten Paketversion von PHP mit den von Ihnen benötigten Features umsehen. </simpara> </sect2> </sect1> <!-- 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 indent-tabs-mode:nil 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 --> Index: phpdoc-de/chapters/install.macosx.xml +++ phpdoc-de/chapters/install.macosx.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> <sect1 id="install.macosx"> <title>Unix/Mac OS X Installationen</title> <para> Dieser Abschnitt enthält Anmerkungen und Hinweise zur Installation von PHP auf dem Mac OS X Server. </para> <sect2 id="install.macosx.packages"> <title>Pakete verwenden</title> <simpara> Es gibt ein paar vorgefertigte und kompilierte Pakete von PHP für Mac OS X. Das ist hilfreich um eine Standardkonfiguration aufzusetzen, doch sollten Sie eine davon abweichende Konfiguration benötigen (wie z.B. einen Secure Server oder einen anderen Datenbanktreiber), müssen Sie evtl. PHP und/oder Ihren Webserver selbst erstellen. Wenn Sie mit dem Erstellen und Kompilieren Ihrer Software nicht vertraut sind, sollten Sie sich nach einer von jemand anders bereits erstellten Paketversion von PHP mit den von Ihnen benötigten Features umsehen. </simpara> </sect2> <sect2 id="install.macosx.compile"> <title>Kompilieren für OS X Server</title> <simpara> Es gibt zwei leicht unterschiedliche Versionen von Mac OS X, den Client und den Server. Die folgende Beschreibung ist für OS X Server. </simpara> <example id="install.macosx.compile.example"> <title>Mac OS X Server Installation</title> <screen> <![CDATA[ 1. Beschaffen Sie sich die aktuellen Distributionen von Apache und PHP 2. Untar'en Sie sie, und starten configure an Apache wie folgt ./configure --exec-prefix=/usr \ --localstatedir=/var \ --mandir=/usr/share/man \ --libexecdir=/System/Library/Apache/Modules \ --iconsdir=/System/Library/Apache/Icons \ --includedir=/System/Library/Frameworks/Apache.framework/Versions/1.3/Headers \ --enable-shared=max \ --enable-module=most \ --target=apache 4. Sie können auch folgende Zeile hinzufügen: setenv OPTIM=-O2 Wenn Sie wollen, dass der Compiler Optimierungen durchführt. 5. Wechseln Sie in das Verzeichnis mit dem PHP Source und führen configure aus ./configure --prefix=/usr \ --sysconfdir=/etc \ --localstatedir=/var \ --mandir=/usr/share/man \ --with-xml \ --with-apache=/src/apache_1.3.12 Wenn Sie andere Ergänzungen haben (MySQL, GD, etc.), fügen Sie diese hier hinzu. Geben Sie bei der Option --with-apache den Pfad zu dem Verzeichnis mit Ihrem Apache Source an, z.B. "/src/apache_1.3.12". 6. make 7. make install Dies fügt Ihrem Apache Source Verzeichnis das Verzeichnis src/modules/php4 hinzu. 8. Nun konfigurieren Sie Apache neu, inkl. PHP 4 Modul. ./configure --exec-prefix=/usr \ --localstatedir=/var \ --mandir=/usr/share/man \ --libexecdir=/System/Library/Apache/Modules \ --iconsdir=/System/Library/Apache/Icons \ --includedir=/System/Library/Frameworks/Apache.framework/Versions/1.3/Headers \ --enable-shared=max \ --enable-module=most \ --target=apache \ --activate-module=src/modules/php4/libphp4.a Sollten Sie eine Meldung erhalten, dass libmodphp4.a nicht mehr gültig ist, wechseln Sie in Ihrem Apache Source Verzeichnis zu src/modules/php4 und führen folgenden Befehl aus: ranlib libmodphp4.a Gehen Sie dann in das Hauptverzeichnis des Apache Source zurück, und führen den obigen configure Befehl erneut aus. Das aktualisiert die Linktabelle. 9. make 10. make install 11. Kopieren Sie die Datei php.ini-dist von Ihrem Verzeichnis mit dem PHP 4 Source in Ihr "bin" Verzeichnis, und benennen Sie sie um: cp php.ini-dist /usr/local/bin/php.ini oder (wenn Sie kein lokales Verzeichnis haben) cp php.ini-dist /usr/bin/php.ini ]]> </screen> </example> <!-- <simpara> TODO: Someone with Mac OS X skills needs to improve this DOC Also, these links are 404 and outdated anyways and stepwise doesn't support PHP anymore. See also bug #14732 Other examples for <ulink url="&url.stepwise.macosx-client;">Mac OS X client</ulink> and <ulink url="&url.stepwise.macosx-client;">Mac OS X server</ulink> are available at <ulink url="&url.stepwise;">Stepwise</ulink>. </simpara> --> </sect2> <sect2 id="install.macosx.client"> <title>Kompilieren für MacOS X Client</title> <simpara> Diese Tipps wurden freundlicherweise von <ulink url="&url.macosx;">Marc Liyanage</ulink> zur Verfügung gestellt. </simpara> <simpara> Das PHP Modul für den Apache Webserver ist in Mac OS X inkludiert. Diese Version unterstützt die MySQL und PostgreSQL Datenbanken. </simpara> <simpara> Anmerkung: Vorsicht wenn Sie dies tun, Sie könnten Ihren Apache Webserver vermurksen! </simpara> <para> Installationsschritte: <itemizedlist> <listitem> <simpara> 1. Öffnen Sie ein Terminalfenster </simpara> </listitem> <listitem> <simpara> 2. Geben Sie "wget http://www.diax.ch/users/liyanage/software/macosx/libphp4.so.gz" ein, und warten Sie bis der Download beendet ist </simpara> </listitem> <listitem> <simpara> 3. Geben Sie "gunzip libphp4.so.gz" ein </simpara> </listitem> <listitem> <simpara> 4. Geben Sie "sudo apxs -i -a -n php4 libphp4.so" ein </simpara> </listitem> </itemizedlist> Nun geben Sie "<literal>sudo open -a TextEdit /etc/httpd/httpd.conf</literal>" ein. TextEdit öffnet daraufhin die Konfigurationsdatei des Webservers. Suchen Sie diese beiden Zeilen in Richtung Dateiende: (Benutzen Sie den Befehl Find) <programlisting role="apache"> <![CDATA[ #AddType application/x-httpd-php .php #AddType application/x-httpd-php-source .phps ]]> </programlisting> Entfernen Sie die beiden Rautezeichen (<literal>#</literal>), speichern die Datei, und beenden TextEdit. </para> <para> Starten Sie mit "<literal>sudo apachectl graceful</literal>" den Webserver neu. </para> <para> PHP sollte nun laufen. Sie können dies testen, indem Sie in Ihrem Verzeichnis "Sites" eine Datei mit dem Namen "test.php" erstellen und folgende Zeile hineinschreiben: "<literal>&lt;?php phpinfo() ?&gt;</literal>". </para> <para> Nun öffnen Sie <literal>127.0.0.1/~your_username/test.php</literal> in Ihrem Webbrowser. Sie sollten nun eine Tabelle mit Informationen über das PHP Modul sehen. </para> </sect2> </sect1> <!-- 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 indent-tabs-mode:nil 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 --> Index: phpdoc-de/chapters/install.openbsd.xml +++ phpdoc-de/chapters/install.openbsd.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> <sect1 id="install.openbsd"> <title>Unix/OpenBSD Installation</title> <para> Dieser Abschnitt enthält Anmerkungen und Hinweise zur Installation von PHP auf <ulink url="&url.openbsd;">OpenBSD 3.2</ulink>. </para> <sect2 id="install.openbsd.packages"> <title>Binärpakete verwenden</title> <simpara> Die Installation von PHP auf OpenBSD mittels Binärpaketen ist die empfohlene und auch einfachste Methode. Das Kernpaket wurde von den verschiedenen Modulen getrennt, wodurch jedes Paket unabhängig von den anderen installiert und entfernt werden kann. Die nötigen Dateien finden Sie auf Ihrer OpenBSD CD oder auf der FTP Site. </simpara> <simpara> Das zur Installation benötigte Hauptpaket ist <filename>php4-core-4.2.3.tgz</filename>, welches das Basisprogramm (plus gettext und iconv) enthält. Achten Sie als nächstes auf die Modulpakete, wie <filename>php4-mysql-4.2.3.tgz</filename> oder <filename>php4-imap-4.2.3.tgz</filename>. Sie müssen das <command>phpxs</command> Kommando verwenden, um diese Module in Ihrer &php.ini; zu aktivieren bzw. zu deaktivieren. </simpara> <example id="install.openbsd.ports.example"> <title>OpenBSD Paket Installationsbeispiel</title> <programlisting> <![CDATA[ # pkg_add php4-core-4.2.3.tgz # /usr/local/sbin/phpxs -s # cp /usr/local/share/doc/php4/php.ini-recommended /var/www/conf/php.ini (in mysql hinzufügen) # pkg_add php4-mysql-4.2.3.tgz # /usr/local/sbin/phpxs -a mysql (in imap hinzufügen) # pkg_add php4-imap-4.2.3.tgz # /usr/local/sbin/phpxs -a imap (mysql als Test entfernen) # pkg_delete php4-mysql-4.2.3 # /usr/local/sbin/phpxs -r mysql (Installation der PEAR Bibliotheken) # pkg_add php4-pear-4.2.3.tgz ]]> </programlisting> </example> <simpara> Weitere Informationen über Binärpakete auf OpenBSD finden Sie in der manpage <ulink url="&url.openbsd.packages;">packages(7)</ulink>. </simpara> </sect2> <sect2 id="install.openbsd.ports"> <title>Ports verwenden</title> <simpara> Sie können PHP auch unter Verwendung des <ulink url="&url.openbsd.ports;">ports tree</ulink> kompilieren. Dies wird jedoch nur Benutzern empfohlen, die mit OpenBSD vertraut sind. Der PHP4 Port ist in drei Unterverzeichnisse aufgeteilt: core, extensions und pear. Das Verzeichnis extensions generiert Sub-Pakete für alle unterstützten PHP Module. Wenn Sie keines dieser Module erstellen möchten, verwenden Sie den <command>no_*</command> FLAVOR. Um z.B. den Build des imap Moduls zu verhindern, setzen Sie den FLAVOR auf <command>no_imap</command>. </simpara> </sect2> <sect2 id="install.openbsd.older"> <title>Ältere Versionen</title> <simpara> Ältere Versionen von OpenBSD verwendeten das FLAVORS System, um PHP statisch verlinkt zu kompilieren. Da es schwer ist, Binärpakete mit dieser Methode zu erstellen, wird von dieser Methode abgeraten. Wenn Sie möchten, können Sie die alten stabilen Ports Trees weiterhin verwenden, jedoch werden diese von dem OpenBSD Team nicht unterstützt. Sollten Sie dazu Anmerkungen haben: Der derzeitige Verantwortliche für den Port ist <ulink url='mailto:avsm@openbsd.org'>Anil Madhavapeddy</ulink>. </simpara> </sect2> </sect1> <!-- 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 indent-tabs-mode:nil 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 --> Index: phpdoc-de/chapters/install.solaris.xml +++ phpdoc-de/chapters/install.solaris.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.2 Maintainer: tom Status: ready --> <sect1 id="install.solaris"> <title>Unix/Solaris Installation</title> <para> Dieser Abschnitt enthält Anmerkungen und Hinweise zur Installation von PHP auf Solaris Systemen. </para> <sect2 id="install.solaris.required"> <title>Benötigte Software</title> <para> Solaris Installationen mangelt es oft an C Compilern und deren zugehörigen Tools. Sie benötigen folgende Software: <itemizedlist> <listitem> <simpara> gcc (empfohlen, andere C Compiler können ebenfalls funktionieren) </simpara> </listitem> <listitem> <simpara> make </simpara> </listitem> <listitem> <simpara> flex </simpara> </listitem> <listitem> <simpara> bison </simpara> </listitem> <listitem> <simpara> m4 </simpara> </listitem> <listitem> <simpara> autoconf </simpara> </listitem> <listitem> <simpara> automake </simpara> </listitem> <listitem> <simpara> perl </simpara> </listitem> <listitem> <simpara> gzip </simpara> </listitem> <listitem> <simpara> tar </simpara> </listitem> <listitem> <simpara> GNU sed </simpara> </listitem> </itemizedlist> Zusätzlich werden Sie für die Installation (und vielleicht auch zum Kompilieren) eine andere, für Ihre Konfiguration spezifische Software benötigen, wie z.B. Oracle oder MySQL. </para> </sect2> <sect2 id="install.solaris.packages"> <title>Pakete verwenden</title> <simpara> Sie können den Installationsprozess auf Solaris vereinfachen, indem Sie pkgadd zur Installation der meisten benötigten Komponenten verwenden. </simpara> </sect2> </sect1> <!-- 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 indent-tabs-mode:nil 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 --> Index: phpdoc-de/chapters/install.unix.xml +++ phpdoc-de/chapters/install.unix.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.1 Maintainer: tom Status: ready --> <sect1 id="install.unix"> <title>Installation auf UNIX Systemen</title> <para> Dieser Abschnitt wird Sie durch die Konfiguration und Installation von PHP auf UNIX Systemen führen. Bevor Sie mit dem Prozess beginnen, lesen Sie bitte alle für Ihre Plattform oder Webserver relevanten Abschnitte. </para> <para> Erforderliche Kenntnisse und Software: <itemizedlist> <listitem> <simpara> Grundlegende UNIX-Kenntnisse (Sie sollten in der Lage sein, mit "make" und einem C-Compiler umzugehen, wenn Sie kompilieren) </simpara> </listitem> <listitem> <simpara> Einen ANSI C Compiler (wenn Sie kompilieren) </simpara> </listitem> <listitem> <simpara> flex (zum kompilieren) </simpara> </listitem> <listitem> <simpara> bison (zum kompilieren) </simpara> </listitem> <listitem> <simpara> Einen Web Server </simpara> </listitem> <listitem> <simpara> Alle modulspezifischen Komponenten (wie z.B. gd, pdf libs, etc.) </simpara> </listitem> </itemizedlist> </para> <para> Es gibt verschiedene Wege, PHP auf der Unix Plattform zu installieren. Entweder mit einem Kompilier- und Konfigurationsprozess, oder mittels verschiedener vorgefertigter Pakete. Diese Dokumentation ist hauptsächlich auf den Prozess des Kompilierens und Konfigurierens von PHP fokussiert. </para> <para> Der Anfang des PHP Installations- und Konfigurationsprozesses wird von den Eingabeoptionen für das <filename>configure</filename> Skript gesteuert. Diese Seite umreißt die Verwendung der meisten allgemeinen Optionen, aber es gibt noch viele andere als Spielraum. Eine umfassende Übersicht finden Sie in der <link linkend="install.configure">Kompletten Liste der Konfigurationsoptionen</link>. Es gibt verschiedene Wege, PHP zu installieren: <itemizedlist> <listitem> <simpara> Als ein <link linkend="install.apache">Apache Modul</link> </simpara> </listitem> <listitem> <simpara> Als ein <link linkend="install.fhttpd">fhttpd Modul</link> </simpara> </listitem> <listitem> <simpara> Zur Verwendung mit <link linkend="install.otherhttpd">AOLServer, NSAPI, phttpd, Pi3Web, Roxen, thttpd, oder Zeus.</link> </simpara> </listitem> <listitem> <simpara> Als ein <link linkend="install.commandline">CGI Programm</link> </simpara> </listitem> </itemizedlist> </para> <sect2 id="install.unix.apache-module"> <title>Apache Modul - Kurzanleitung</title> <para> PHP kann auf unterschiedliche Arten kompiliert werden, aber eine der populärsten ist die als Apache Modul. Es folgt ein kurzer Überblick über die Installation. </para> <example id="install.unix.apache-module.quick"> <title> Kurzanleitung zur Installation von PHP 4 (Apache Modul Version) </title> <programlisting role="shell"> <![CDATA[ 1. gunzip apache_1.3.x.tar.gz 2. tar xvf apache_1.3.x.tar 3. gunzip php-x.x.x.tar.gz 4. tar xvf php-x.x.x.tar 5. cd apache_1.3.x 6. ./configure --prefix=/www 7. cd ../php-x.x.x 8. ./configure --with-mysql --with-apache=../apache_1.3.x --enable-track-vars 9. make 10. make install 11. cd ../apache_1.3.x 12. ./configure --activate-module=src/modules/php4/libphp4.a 13. make 14. make install 15. cd ../php-x.x.x 16. cp php.ini-dist /usr/local/lib/php.ini 17. Editieren Sie nun Ihre httpd.conf oder srm.conf, und fügen Sie hinzu: AddType application/x-httpd-php .php 18. Starten Sie den Apache Web Server neu. (Sie müssen den Server beenden und neu starten, ein einfacher Reload mittels HUP oder USR1 Signal reicht nicht aus.) ]]> </programlisting> </example> </sect2> <sect2 id="install.building"> <title>Building</title> <simpara> Wenn PHP konfiguriert ist, können Sie die ausführbare CGI Datei erstellen. Das Kommando <command>make</command> sollte das für Sie erledigen. Sollte dies scheitern und Sie nicht erkennen können warum, lesen Sie im Abschnitt <link linkend="install.problems"> Problem-Sektion</link> weiter. </simpara> </sect2> </sect1> <!-- 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 indent-tabs-mode:nil 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 --> Index: phpdoc-de/chapters/install.windows.xml +++ phpdoc-de/chapters/install.windows.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.25 Maintainer: tom Status: ready --> <sect1 id="install.windows"> <title>Installation auf Windows Systemen</title> <para> Dieser Abschnitt behandelt Windows 98/Me und Windows NT/2000/XP PHP läuft nicht auf 16 Bit-Plattformen wie z.B. Windows 3.1, und manchmal sprechen wir bei den unterstützten Plattformen von Win32. Seit PHP 4.3.0 wird auch Windows 95 nicht mehr unterstützt. </para> <para> Es gibt zwei Wege PHP für Windows zu installieren: entweder <link linkend="install.windows.manual">manuell</link>, oder mittels dem <link linkend="install.windows.installer">InstallShield</link> Installer. </para> <para> Wenn Sie Microsoft Visual Studio besitzen, können Sie auch den Source Code von PHP selbst <link linkend="install.windows.build">kompilieren</link>. </para> <para> Haben Sie PHP erst einmal auf Ihrem Windows System installiert, können Sie als Erweiterung der Funktionalität auch verschiedene <link linkend="install.windows.extensions">Erweiterungen laden</link>. </para> <sect2 id="install.windows.installer"> <title>Windows InstallShield</title> <para> Der auf der Downloadseite <ulink url="&url.php.downloads;">&url.php.downloads;</ulink> erhältliche Windows PHP Installer installiert die <emphasis>CGI Version</emphasis> von <literal>PHP</literal>, und konfiguriert auch die Webserver IIS, PWS, und Xitami. </para> <note> <para> Beachten Sie bitte, dass der InstallShield Installer zwar eine einfache Art der Installation von <literal>PHP</literal> ist, gleichzeitig aber auch in verschiedenen Aspekten eingeschränkt ist, wie z.B. ein automatisches Setup von Erweiterungen nicht unterstützt wird. Das gesamte Angebot an unterstützten Erweiterungen ist nur verfügbar, wenn Sie die Binärdistribution im zip-Format herunterladen. </para> </note> <simpara> Installieren Sie Ihren gewünschten <acronym>HTTP</acronym> Server auf Ihrem System und stellen Sie sicher, dass er läuft. </simpara> <simpara> Starten Sie nun das Installationsprogramm, und folgen Sie den Instruktionen des Installation Wizards. Es werden zwei Installationsarten unterstützt: Standard bietet zweckmäßige Standardeinstellungen wo dies möglich ist, und Advanced (erweitert), welche die gewünschten Einstellungen während der Installation abfragt. </simpara> <simpara> Der Installation Wizard sammelt genug Informationen, um die &php.ini; zu erstellen, und den Webserver für den Einsatz von PHP zu konfigurieren. Für IIS und auch PWS auf Windows NT Workstation wird eine Liste mit den Knoten auf dem Server, sowie eine Liste mit den Script Mappings angezeigt aus welcher Sie die gewünschten Knoten auswählen können, auf denen PHP in die Script Mappings eingetragen werden soll. </simpara> <simpara> Wenn die Installation fertig ist informiert Sie der Installer, ob Sie Ihr System oder den Server neu starten sollen, oder ob Sie einfach mit der Nutzung von PHP beginnen können. </simpara> <warning> <para> Seien Sie sich darüber im Klaren, dass dieses Setup von PHP nicht sicher ist. Wenn Sie ein sicheres Setup von PHP möchten, setzen Sie PHP manuell auf, und wählen jede Option sorgfältig aus. Dieses automatische Setup bietet Ihnen eine sofort lauffähige PHP Installation, ist jedoch nicht für den Einsatz auf Online-Servern gedacht. </para> </warning> </sect2> <sect2 id="install.windows.manual"> <title>Manuelle Installationsschritte</title> <simpara> Diese Installationsanleitung hilft Ihnen, PHP auf Ihrem Windows Webserver manuell zu installieren und zu konfigurieren. Laden Sie sich hierfür bitte die gezippte Distribution von der Downloadseite <ulink url="&url.php.downloads;">&url.php.downloads;</ulink> herunter. Die Originalversion dieser Anleitung wurde von &link.bob; verfasst, welche Sie auf <ulink url="&url.win32install;">&url.win32install;</ulink> finden. </simpara> <para> Diese Anleitung unterstützt Sie bei der manuellen Installation für: <itemizedlist> <listitem> <para> Personal Web Server 3 und 4 oder neuer </para> </listitem> <listitem> <para> Internet Information Server 3 und 4 oder neuer </para> </listitem> <listitem> <para> Apache 1.3.x </para> </listitem> <listitem> <para> OmniHTTPd 2.0b1 und höher </para> </listitem> <listitem> <para> Oreilly Website Pro </para> </listitem> <listitem> <para> Xitami </para> </listitem> <listitem> <para> Netscape Enterprise Server, iPlanet </para> </listitem> </itemizedlist> </para> <para> PHP 4 für Windows gibt es in zwei Varianten - ein CGI Modul (php.exe), und verschiedene SAPI Module (z.B. php4isapi.dll). Letztere ist neu in PHP 4, und bietet eine signifikant höhere Performance, sowie neue Funktionalitäten. Zusätzlich gibt es eine CLI Version, die im Abschnitt <link linkend="features.commandline">Using PHP from the command line</link> näher beschrieben ist. </para> <warning> <simpara> Die Qualität der SAPI Module wurde in PHP 4.1 signifikant erhöht. In älteren Systemen könnte es vorkommen, dass beim Server Fehlermeldungen auftreten, oder dass andere Servermodule wie z.B. ASP nicht funktionieren. </simpara> </warning> <simpara> Wenn Sie eines der SAPI Module unter Windows 95 einsetzen möchten, holen Sie sich das DCOM Update von den <ulink url="&url.dcom.update;">Microsoft DCOM Seiten</ulink>. Für das ISAPI Modul wird ein ISAPI 4.0 kompatibler Webserver benötigt (getestet wurden IIS 4.0, PWS 4.0 und IIS 5.0). IIS 3.0 wird <emphasis>NICHT</emphasis> unterstützt. Wenn Sie gediegene PHP Unterstützung wünschen, sollten Sie In diesem Fall den Windows NT 4.0 Option Pack mit IIS 4.0 downloaden. </simpara> <para> Die folgenden Schritte sollten vor den serverspezifischen Instruktionen an allen Installationen durchgeführt werden. <itemizedlist> <listitem> <simpara> Entpacken Sie die in der Distribution enthaltenen Dateien in ein Verzeichnis Ihrer Wahl. Wir empfehlen <filename>c:\php\</filename>. Sie sollten jedoch keinen Pfad wählen, in dem sich Leerzeichen befinden (z.B. c:\program files\php ist keine gute Idee), da sonst manche Webserver abstürzen könnten. </simpara> </listitem> <listitem> <simpara> Stellen Sie sicher, dass die von PHP verwendeten DLLs gefunden werden können. Welche DLLs benötigt werden, hängt von dem verwendeten Webserver ab, und ob Sie PHP als CGI- oder Server-Modul einsetzen. <filename>php4ts.dll</filename> wird immer verwendet. Wenn Sie ein Server-Modul benutzen (z.B. ISAPI oder Apache), dann brauchen Sie die entsprechende DLL des <filename>sapi</filename> Verzeichnisses. Wenn Sie PHP extension DLLs benutzen, benötigen Sie diese ebenfalls. Um sicherzugehen, dass diese auch gefunden werden, können Sie sie entweder in das Systemverzeichnis (z.B. <filename>winnt/system32</filename> oder <filename>windows/system</filename>) kopieren, oder Sie können sie in das gleiche Verzeichnis stellen, in welchem sich auch die von Ihrem Webserver benutzte EXE- bzw. DLL-Datei befindet (z.B. <filename>php.exe</filename>, <filename>php4apache.dll</filename>). </simpara> <para> Die PHP Programmdatei, die SAPI Module, und einige Erweiterungen benötigen externe DLLs. Stellen Sie sicher, dass diese DLLs der Distribution in einem Verzeichnis liegen, welches im Windows PATH liegt. Wenn Sie z.B. <literal>php_oci8.dll</literal> in der &php.ini; aktivieren, dann muss das Oracle Heimatverzeichnis im PATH sein, sodass PHP die <literal>oci.dll</literal> finden kann. </para> <para> Der einfachste Weg dazu ist, die nachstehenden Dateien in Ihr Systemverzeichnis zu kopieren. Dieses heißt gewöhnlich: <simplelist> <member> <filename>c:\windows\system</filename> auf Windows 9x/ME </member> <member> <filename>c:\winnt\system32</filename> auf Windows NT/2000 </member> <member> <filename>c:\windows\system32</filename> auf Windows XP </member> </simplelist> Die zu kopierenden Dateien sind: <simplelist> <member> <filename>php4ts.dll</filename>. Wenn sie dort bereits existiert, überschreiben Sie sie. </member> <member> Die Dateien in dem Verzeichnis &apos;dlls&apos; Ihrer Distribution. Sollten diese Dateien bereits auf Ihrem System installiert sein, überschreiben Sie diese nur, wenn etwas nicht korrekt läuft (Vor dem Überschreiben empfehlen wir ein Backup, oder verschieben diese Dateien in ein anderes Verzeichnis - nur für den Fall dass etwas schiefgeht). </member> </simplelist> </para> <para> Holen Sie sich die letzte Version der Microsoft Data Access Components (MDAC) für Ihre Plattform, speziell wenn Sie Windows 9x/NT4 benutzen. MDAC finden Sie unter <ulink url="&url.mdac;">&url.mdac;</ulink>. </para> </listitem> <listitem> <para> Kopieren Sie die gewünschte ini Datei (siehe unten) in Ihr &apos;%WINDOWS%&apos; Verzeichnis auf Windows 9x/ME, oder in Ihr &apos;%SYSTEMROOT%&apos; Verzeichnis unter Windows NT/2000/XP, und benennen Sie sie in &php.ini; um. Ihr &apos;%WINDOWS%&apos; oder &apos;%SYSTEMROOT%&apos; Verzeichnis ist normalerweise: <simplelist> <member><filename>c:\windows</filename> auf Windows 9x/ME/XP</member> <member><filename>c:\winnt</filename> oder <filename>c:\winnt40</filename> auf NT/2000 Servern</member> </simplelist> </para> <para> In der Zip-Datei befinden sich zwei ini Dateien: <filename>php.ini-dist</filename> und <filename>php.ini-optimized</filename>. Wir empfehlen, die <filename>php.ini-optimized</filename> zu verwenden, da in dieser Datei die Default-Einstellungen für Performance und Sicherheit optimiert sind. Am besten ist es, all die <link linkend="configuration.file">ini Einstellungen</link> selbst manuell vorzunehmen. Wenn Sie die bestmögliche Sicherheit erreichen wollen ist dies der Weg für Sie, auch wenn PHP mit den Standardeinstellungen gut läuft. </para> </listitem> <listitem> <para> Editieren Sie Ihre Datei &php.ini;: <itemizedlist> <listitem> <simpara> Tragen Sie bei 'extension_dir' Ihr PHP Installationsverzeichnis oder den Pfad zu Ihren <filename>php_*.dll</filename> Dateien ein. Bitte vergessen Sie nicht den letzten Rückstrich (Backslash). z.B.: <filename>c:\php\extensions\</filename> </simpara> </listitem> <listitem> <simpara> Wenn Sie OmniHTTPd benutzen, überspringen Sie diesen Schritt. Geben Sie bei 'doc_root' das Dokumentenverzeichnis des Webservers an. z.B.: <filename>c:\apache\htdocs</filename> oder <filename>c:\webroot</filename>. </simpara> </listitem> <listitem> <simpara> Wählen Sie nun die Erweiterungen (Module) aus, die beim Start von PHP geladen werden sollen. Lesen Sie in <link linkend="install.windows.extensions">Windows Erweiterungen</link> wie Sie eine davon aktivieren können, und welche bereits inkludiert sind. Bei einer Neuinstallation ist es ratsam, erst PHP zu installieren und zu testen, bevor Sie Erweiterungen in der &php.ini; aktivieren. </simpara> </listitem> <listitem> <simpara> Bei PWS und IIS können Sie auch <filename>browscap.ini</filename> auf <filename>c:\windows\system\inetsrv\browscap.ini</filename> unter Windows 9x/Me, <filename>c:\winnt\system32\inetsrv\browscap.ini</filename> unter NT/2000, und <filename>c:\windows\system32\inetsrv\browscap.ini</filename> unter XP. setzen. </simpara> </listitem> <listitem> <simpara> Beachten Sie, dass das <filename>mibs</filename> Verzeichnis in der Windows Distribution Dateien für die SNMP Unterstützung enthält. Dieses Verzeichnis sollte nach <filename>DRIVE:\usr\mibs</filename> verschoben werden (<filename>DRIVE:</filename> ist das Laufwerk, auf dem PHP installiert ist). </simpara> </listitem> <listitem> <simpara> Wenn Sie NTFS auf Windows NT, 2000 oder XP benutzen, stellen Sie sicher, dass der Benutzer unter dem der Webserver läuft, eine Leseberechtigung auf die &php.ini; hat (z.B. können Sie diese für alle zum Lesen freigeben). </simpara> </listitem> </itemizedlist> </para> </listitem> <listitem> <para> Bei PWS erteilen Sie das Recht zum Ausführen auf das Web-Hauptverzeichnis: <itemizedlist> <listitem> <simpara> Starten Sie den PWS Web Manager </simpara> </listitem> <listitem> <simpara> Editieren Sie die Einstellungen des "Home"-Verzeichnisses </simpara> </listitem> <listitem> <simpara> Wählen Sie das "execute" Auswahlkästchen aus </simpara> </listitem> </itemizedlist> </para> </listitem> </itemizedlist> </para> </sect2> <sect2 id="install.windows.build"> <title>Den Source kompilieren</title> <para> Bevor wir beginnen lohnt es sich, folgende Frage zu beantworten: "Warum ist das Kompilieren unter Windows so schwer?" Zwei Gründe drängen sich auf: </para> <orderedlist> <listitem> <simpara> Windows genießt (noch) keine große Gemeinschaft von Entwicklern welche auch bereit sind, deren Sourcecode frei zur Verfügung zu stellen. Als Ergebnis wurden die nötigen Investitionen in die für solche Entwicklungen nötige Infrastruktur nicht getätigt. Das meiste was verfügbar ist, wurde durch die Portierung der nötigen Werkzeuge von Unix möglich gemacht. Seien Sie deshalb nicht überrascht, wenn manches aus diesem Erbe von Zeit zu Zeit durchscheint. </simpara> </listitem> <listitem> <simpara> Fast alle der folgenden Instruktionen sind von der Art "Einstellen und vergessen". Deshalb lehnen Sie sich zurück, und folgen den nachstehenden Instruktionen so gewissenhaft wie möglich. </simpara> </listitem> </orderedlist> <sect3 id="install.windows.build.requirement"> &reftitle.required; <para> Um <literal>PHP</literal> kompilieren und erstellen zu können, benötigen eine Microsoft Entwicklungsumgebung. Microsoft Visual C++ 6.0 wird empfohlen. Um die heruntergeladenen Dateien entpacken zu können, brauchen Sie ein Programm zum Dekomprimieren. Sollten Sie über kein derartiges Programm verfügen, erhalten Sie eine freie Version von <ulink url="&url.infozip;">InfoZip</ulink>. </para> <para> Bevor Sie beginnen, müssen Sie einiges downloaden... </para> <itemizedlist> <listitem> <simpara> ..die win32 buildtools von der <literal>PHP</literal> Seite auf <ulink url="&url.win32.buildtools;">&url.win32.buildtools;</ulink>. </simpara> </listitem> <listitem> <simpara> ..den Sourcecode für die von <literal>PHP</literal> benutzte DNS Namensauflösung unter <ulink url="&url.win32.dnsresolver;"> &url.win32.dnsresolver;</ulink>. Dies ist ein Ersatz für die in <filename>win32build.zip</filename> enthaltene Bibliothek <filename>resolv.lib</filename>. </simpara> </listitem> <listitem> <simpara> Sollten Sie <literal>PHP</literal> als ein Apache-Modul kompilieren wollen, benötigen Sie auch die <ulink url="&url.apache.source;">Apache Sourcecodes</ulink>. </simpara> </listitem> </itemizedlist> <simpara> Letztendlich benötigen Sie noch die Sourcecodes von PHP 4 selbst. Sie erhalten die letzte Entwicklerversion mittels <ulink url="&url.php.anoncvs;">anonymen CVS</ulink>, einem sog. <ulink url="&url.php.snapshots;">Snapshot</ulink>, oder dem <ulink url="&url.php.downloads;">Sourcecode</ulink> der letzten offiziellen Version. </simpara> </sect3> <sect3 id="install.windows.build.install"> <title>Alles zusammenfügen</title> <para> Nach dem Download der benötigten Pakete dekomprimieren Sie diese an einer geeigneten Stelle. <itemizedlist> <listitem> <simpara> Erstellen Sie ein Arbeitsverzeichnis, in dem sich nach dem Dekomprimieren alle Dateien befinden werden, z.B. <filename>c:\work</filename>. </simpara> </listitem> <listitem> <simpara> Erstellen Sie das Verzeichnis <filename>win32build</filename> unter Ihrem Arbeitsverzeichnis (<filename>c:\work</filename>), und dekomprimieren Sie die <filename>win32build.zip</filename> hinein. </simpara> </listitem> <listitem> <simpara> Erstellen Sie das Verzeichnis <filename>bindlib_w32</filename> unter Ihrem Arbeitsverzeichnis (<filename>c:\work</filename>), und dekomprimieren Sie die <filename>bindlib_w32.zip</filename> hinein. </simpara> </listitem> <listitem> <simpara> Dekomprimieren Sie den PHP Sourcecode in Ihr Arbeitsverzeichnis (<filename>c:\work</filename>). </simpara> </listitem> </itemizedlist> Diesen Schritten folgend, sollte Ihre Verzeichnisstruktur wie folgt aussehen: <informalexample> <programlisting> <![CDATA[ +--c:\work | | | +--bindlib_w32 | | | | | +--arpa | | | | | +--conf | | | | | +--... | | | +--php-4.x.x | | | | | +--build | | | | | +--... | | | | | +--win32 | | | | | +--... | | | +--win32build | | | | | +--bin | | | | | +--include | | | | | +--lib ]]> </programlisting> </informalexample> Erstellen Sie das Verzeichnis <filename>c:\usr\local\lib</filename>, und kopieren Sie <filename>bison.simple</filename> von <filename>c:\work\win32build\bin</filename> nach <filename>c:\usr\local\lib</filename>. </para> <note> <simpara> Benutzer von <ulink url="&url.cygwin;">Cygwin</ulink> können den letzten auslassen. Eine entsprechend installierte Cygwin Umgebung bietet die erforderlichen Dateien <filename>bison.simple</filename> und <filename>bison.exe</filename>. </simpara> </note> </sect3> <sect3 id="install.windows.build.configure"> <title>MVC ++ konfigurieren</title> <para> Der nächste Vorbereitungsschritt ist die Konfiguration von MVC ++. Starten Sie Microsoft Visual C++, und wählen Sie im Menü Tools =&gt; Options aus. Wählen Sie in dem Dialog den Verzeichnis-Tab aus. Wechseln Sie zu Executables, Includes, and Library files. Ihre Einträge sollten wie folgt aussehen: <itemizedlist> <listitem> <simpara> Executable files: <filename>c:\work\win32build\bin</filename>, Cygwin users: <filename>cygwin\bin</filename> </simpara> </listitem> <listitem> <simpara> Include files: <filename>c:\work\win32build\include</filename> </simpara> </listitem> <listitem> <simpara> Library files: <filename>c:\work\win32build\lib</filename> </simpara> </listitem> </itemizedlist> </para> </sect3> <sect3 id="install.windows.build.resolvlib"> <title>resolv.lib erstellen</title> <para> Sie müssen die <filename>resolv.lib</filename> Bibliothek erstellen. Entscheiden Sie, ob Sie die debug symbols verfügbar haben möchten (bindlib - Win32 Debug) oder nicht (bindlib - Win32 Release). Erstellen Sie die folgende Konfiguration: <itemizedlist> <listitem> <simpara> Als Benutzer des GUI starten Sie VC++ und wählen Datei =&gt; Arbeitsbereich öffnen aus, navigieren zu <filename>c:\work\bindlib_w32</filename> und selektieren <filename>bindlib.dsw</filename>. Dann wählen Sie Erstellen =&gt; Setze aktuelle Konfiguration und die gewünschte Konfiguration aus. Zum Schluss wählen Sie Erstellen =&gt; Rebuild All. </simpara> </listitem> <listitem> <simpara> Als Benutzer der Kommandozeile stellen Sie sicher, dass Sie entweder die C++ Umgebungsvariablen registriert, oder <command>vcvars.bat</command> ausgeführt haben. Dann führen Sie eines der folgenden Kommandos aus: </simpara> <itemizedlist> <listitem> <simpara> <userinput>msdev bindlib.dsp /MAKE "bindlib - Win32 Debug"</userinput> </simpara> </listitem> <listitem> <simpara> <userinput>msdev bindlib.dsp /MAKE "bindlib - Win32 Release"</userinput> </simpara> </listitem> </itemizedlist> </listitem> </itemizedlist> Nun sollten Sie eine verwendbare <filename>resolv.lib</filename> in Ihrem <filename>c:\work\bindlib_w32\Debug</filename> oder <filename>Release</filename> Unterverzeichnis haben. Kopieren Sie diese Datei nach <filename>c:\work\win32build\lib</filename>, und überschreiben Sie die dort vorhandene Datei mit dem selben Namen. </para> </sect3> <sect3 id="install.windows.build.compile"> <title>Kompilieren</title> <simpara> Der einfachste Weg zu beginnen, ist das Erstellen der CGI Version. </simpara> <itemizedlist> <listitem> <simpara> Wenn Sie das GUI benutzen: Starten Sie VC++, selektieren Sie Datei =&gt; Arbeitsbereich öffnen, und wählen Sie <filename>c:\work\php-4.x.x\win32\php4ts.dsw</filename> aus. Dann selektieren Sie Erstellen =&gt; Setze aktuelle Konfiguration, und wählen die gewünschte Konfiguration aus (entweder <literal>php4ts - Win32 Debug_TS</literal> oder <literal>php4ts - Win32 Release_TS</literal>). Letztendlich wählen Sie Erstellen =&gt; Rebuild All. </simpara> </listitem> <listitem> <simpara> Wenn Sie die Kommandozeile benutzen stellen Sie sicher, dass die C++ Environmentvariablen registriert sind oder starten Sie <command>vcvars.bat</command>, und führen in dem Verzeichnis <filename>c:\work\php-4.x.x\win32</filename> eines der folgenden Kommandos aus: </simpara> <itemizedlist> <listitem> <simpara> <userinput>msdev php4ts.dsp /MAKE "php4ts - Win32 Debug_TS"</userinput> </simpara> </listitem> <listitem> <simpara> <userinput>msdev php4ts.dsp /MAKE "php4ts - Win32 Release_TS"</userinput> </simpara> </listitem> <listitem> <simpara> Nun sollten Sie entweder in Ihrem <filename>Debug_TS</filename> oder <filename>Release_TS</filename> Unterverzeichnis eine verwendbare <filename>php.exe</filename> haben. </simpara> </listitem> </itemizedlist> </listitem> </itemizedlist> <simpara> Durch editieren der <filename>main/config.win32.h.in</filename> ist es möglich, kleinere Adaptierungen zum Prozess des Erstellens vorzunehmen. So können Sie z.B. die inkludierten Erweiterungen, den Ort der &php.ini;, etc. ändern. </simpara> <simpara> Als nächstes möchten Sie vielleicht die CLI Version erstellen, die für den Einsatz auf der Kommandozeile konzipiert wurde (<link linkend="features.commandline">PHP from the command line</link>). Die Schritte sind die gleichen wie bei der CGI Version, außer dass Sie die Projektdateien <literal>php4ts_cli - Win32 Debug_TS</literal> bzw. <literal>php4ts_cli - Win32 Release_TS</literal> auswählen müssen. Nach dem erfolgreichen Kompilieren finden Sie die <filename>php.exe</filename> entweder in dem Verzeichnis <filename>Release_TS\cli\</filename> oder in <filename>Debug_TS\cli\</filename>. </simpara> <note> <simpara> Wenn Sie PEAR und das komfortable Installationsprogramm benutzen möchten, ist das CLI-SAPI erforderlich. Weitere Informationen zu PEAR und dem Installationsprogramm finden Sie in der Dokumentation auf der <ulink url="&url.php.pear;manual/">PEAR</ulink> Webseite. </simpara> </note> <simpara> Um das SAPI Modul <filename>php4isapi.dll</filename> zur Integration von PHP mit Microsoft IIS zu erstellen, setzen Sie aktive Konfiguration auf <filename>php4isapi-wasimmer-config</filename>, und kompilieren Sie die gewünschte dll. </simpara> </sect3> </sect2> <sect2 id="install.windows.extensions"> <title>Installation von Windows Erweiterungen</title> <para> Sind PHP und ein Webserver einmal auf Windows installiert, möchten Sie vielleicht einige Erweiterungen mit zusätzlicher Funktionalität installieren. Die folgende Tabelle beschreibt einige der verfügbaren Erweiterungen. Sie können Erweiterungen auswählen, welche beim Start von PHP geladen werden, indem Sie das Kommentarzeichen (';') in den entsprechenden 'extension=php_*.dll' Zeilen in der &php.ini; entfernen. Sie können ein Modul mittels <function>dl</function> auch dynamisch laden. </para> <para> Die DLLs für PHP Erweiterungen enthalten als Präfix 'php_' (und 'php3_' in PHP 3), um Verwechslungen zwischen PHP Erweiterungen und deren unterstützenden Bibliotheken zu vermeiden. </para> <note> <para> In PHP 4.0.6 ist die Unterstützung für BCMath, Calendar, COM, FTP, MySQL, ODBC, PCRE, Session, WDDX und XML <emphasis>inkludiert</emphasis>. Um diese Funktionen zu benutzen, brauchen Sie keine zusätzlichen Erweiterungen zu laden. Eine Liste der bereits inkludierten Module befindet sich in der <filename>README.txt</filename> oder <filename>install.txt</filename> Ihrer Distribution. </para> </note> <note> <para> Einige Erweiterungen benötigen externe DLLs, wovon bereits einige im Verzeichnis &apos;dlls&apos; der PHP Distribution enthalten sind. Manche Erweiterungen benötigen jedoch DLLs, welche nicht in der PHP Distribution enthalten sind, wie z.B. Oracle (php_oci8.dll). </para> <para> Kopieren Sie die DLLs vom Verzeichnis &apos;dlls&apos; in Ihren Windows PATH, gute Plätze sind: <simplelist> <member>c:\windows\system auf Windows 9x/Me</member> <member>c:\winnt\system32 auf Windows NT/2000</member> <member>c:\windows\system32 auf Windows XP</member> </simplelist> Sollten diese Dateien bereits auf Ihrem System installiert sein, überschreiben Sie diese nur, wenn etwas nicht korrekt läuft (Vor dem Überschreiben empfehlen wir ein Backup, oder verschieben diese Dateien in ein anderes Verzeichnis - nur für den Fall dass etwas schiefgeht). </para> </note> <para> <table> <title>PHP Erweiterungen (Extensions)</title> <tgroup cols="3"> <thead> <row> <entry>Erweiterung</entry> <entry>Beschreibung</entry> <entry>Anmerkungen</entry> </row> </thead> <tbody> <row> <entry>php_bz2.dll</entry> <entry><link linkend="ref.bzip2">bzip2</link> Komprimierungsfunktionen</entry> <entry>Keine</entry> </row> <row> <entry>php_calendar.dll</entry> <entry><link linkend="ref.calendar">Kalender</link> Umwandlungsfunktionen</entry> <entry>Ist seit PHP 4.0.3 integriert</entry> </row> <row> <entry>php_cpdf.dll</entry> <entry><link linkend="ref.cpdf">ClibPDF</link> Funktionen</entry> <entry>Keine</entry> </row> <row> <entry>php_crack.dll</entry> <entry><link linkend="ref.crack">Crack</link> Funktionen</entry> <entry>Keine</entry> </row> <row> <entry>php3_crypt.dll</entry> <entry>Verschlüsselungsfunktionen</entry> <entry>Keine</entry> </row> <row> <entry>php_ctype.dll</entry> <entry><link linkend="ref.ctype">ctype</link> Funktionen</entry> <entry>Keine</entry> </row> <row> <entry>php_curl.dll</entry> <entry><link linkend="ref.curl">CURL</link>, Client URL Bibliotheksfunktionen</entry> <entry>Benötigt libeay32.dll, ssleay32.dll (bundled)</entry> </row> <row> <entry>php_cybercash.dll</entry> <entry><link linkend="ref.cybercash">Cybercash</link> Zahlungssystem Funktionen</entry> <entry>Keine</entry> </row> <row> <entry>php_db.dll</entry> <entry><link linkend="ref.dbm">DBM</link> Funktionen</entry> <entry>Veraltet, verwenden Sie stattdessen DBA (php_dba.dll)</entry> </row> <row> <entry>php_dba.dll</entry> <entry><link linkend="ref.dba">DBA</link> Datenbank (dbm-style) Abstraktions-Funktionen</entry> <entry>Keine</entry> </row> <row> <entry>php_dbase.dll</entry> <entry><link linkend="ref.dbase">dBase</link> Funktionen</entry> <entry>Keine</entry> </row> <row> <entry>php3_dbm.dll</entry> <entry>Berkeley DB2 Bibliothek</entry> <entry>Keine</entry> </row> <row> <entry>php_domxml.dll</entry> <entry><link linkend="ref.domxml">DOM XML</link> Funktionen</entry> <entry>Benötigt libxml2.dll (bundled)</entry> </row> <row> <entry>php_dotnet.dll</entry> <entry><link linkend="ref.dotnet">.NET</link> Funktionen</entry> <entry>Keine</entry> </row> <row> <entry>php_exif.dll</entry> <entry><link linkend="function.read-exif-data">Liest EXIF</link> Headers einer JPEG-Grafik</entry> <entry>Keine</entry> </row> <row> <entry>php_fbsql.dll</entry> <entry><link linkend="ref.fbsql">FrontBase</link> Funktionen</entry> <entry>Keine</entry> </row> <row> <entry>php_fdf.dll</entry> <entry><link linkend="ref.fdf">FDF</link> Forms Data Format Funktionen.</entry> <entry>Benötigt fdftk.dll (bundled)</entry> </row> <row> <entry>php_filepro.dll</entry> <entry><link linkend="ref.filepro">filePro</link> Funktionen</entry> <entry>Nur Lesezugriff</entry> </row> <row> <entry>php_ftp.dll</entry> <entry><link linkend="ref.ftp">FTP</link> Funktionen</entry> <entry>Ist seit PHP 4.0.3 integriert</entry> </row> <row> <entry>php_gd.dll</entry> <entry><link linkend="ref.image">GD</link> Bibliotheksfunktionen</entry> <entry>Keine</entry> </row> <row> <entry>php_gd2.dll</entry> <entry><link linkend="ref.image">GD2</link> Bibliotheksfunktionen zur Bildmanipulation</entry> <entry>Keine</entry> </row> <row> <entry>php_gettext.dll</entry> <entry><link linkend="ref.gettext">Gettext</link> Funktionen</entry> <entry>Benötigt gnu_gettext.dll (bundled)</entry> </row> <row> <entry>php_hyperwave.dll</entry> <entry><link linkend="ref.hyperwave">HyperWave</link> Funktionen</entry> <entry>Keine</entry> </row> <row> <entry>php_iconv.dll</entry> <entry><link linkend="ref.iconv">ICONV</link> Zeichensatzumwandlung</entry> <entry>Benötigt iconv-1.3.dll (bundled)</entry> </row> <row> <entry>php_ifx.dll</entry> <entry><link linkend="ref.ifx">Informix</link> Funktionen</entry> <entry>Benötigt Informix Bibliotheken</entry> </row> <row> <entry>php_iisfunc.dll</entry> <entry>IIS Managementfunktionen</entry> <entry>keine</entry> </row> <row> <entry>php_imap.dll</entry> <entry><link linkend="ref.imap">IMAP</link> POP3 und NNTP Funktionen</entry> <entry>PHP 3: php3_imap4r1.dll</entry> </row> <row> <entry>php_ingres.dll</entry> <entry><link linkend="ref.ingres">Ingres II</link> Funktionen</entry> <entry>Benötigt Ingres II Bibliotheken</entry> </row> <row> <entry>php_interbase.dll</entry> <entry><link linkend="ref.ibase">InterBase</link> Funktionen</entry> <entry>Benötigt gds32.dll (bundled)</entry> </row> <row> <entry>php_java.dll</entry> <entry><link linkend="ref.java">Java</link> extension</entry> <entry>Benötigt jvm.dll (bundled)</entry> </row> <row> <entry>php_ldap.dll</entry> <entry><link linkend="ref.ldap">LDAP</link> Funktionen</entry> <entry>Benötigt libsasl.dll (bundled)</entry> </row> <row> <entry>php_mhash.dll</entry> <entry><link linkend="ref.mhash">Mhash</link> Funktionen</entry> <entry>Keine</entry> </row> <row> <entry>php_ming.dll</entry> <entry><link linkend="ref.ming">Ming</link> Funktionen für Flash</entry> <entry>Keine</entry> </row> <row> <entry>php_msql.dll</entry> <entry><link linkend="ref.msql">mSQL</link> Funktionen</entry> <entry>Benötigt msql.dll (bundled)</entry> </row> <row> <entry>php3_msql1.dll</entry> <entry>mSQL 1 Client</entry> <entry>unknown</entry> </row> <row> <entry>php3_msql2.dll</entry> <entry>mSQL 2 Client</entry> <entry>unknown</entry> </row> <row> <entry>php_mssql.dll</entry> <entry><link linkend="ref.mssql">MSSQL</link> Funktionen</entry> <entry>Benötigt ntwdblib.dll (bundled)</entry> </row> <row> <entry>php3_mysql.dll</entry> <entry><link linkend="ref.mysql">MySQL</link> Funktionen</entry> <entry>In PHP 4 integriert</entry> </row> <row> <entry>php3_nsmail.dll</entry> <entry>Netscape Mail Funktionen</entry> <entry>unknown</entry> </row> <row> <entry>php3_oci73.dll</entry> <entry>Oracle Funktionen</entry> <entry>unknown</entry> </row> <row> <entry>php_oci8.dll</entry> <entry><link linkend="ref.oci8">Oracle 8</link> Funktionen</entry> <entry>Benötigt Oracle 8 Client Bibliotheken</entry> </row> <row> <entry>php_openssl.dll</entry> <entry><link linkend="ref.openssl">OpenSSL</link> Funktionen</entry> <entry>Benötigt libeay32.dll (bundled)</entry> </row> <row> <entry>php_oracle.dll</entry> <entry><link linkend="ref.oracle">Oracle</link> Funktionen</entry> <entry>Benötigt Oracle 7 Client Bibliotheken</entry> </row> <row> <entry>php_pdf.dll</entry> <entry><link linkend="ref.pdf">PDF</link> Funktionen</entry> <entry>Keine</entry> </row> <row> <entry>php_pgsql.dll</entry> <entry><link linkend="ref.pgsql">PostgreSQL</link> Funktionen</entry> <entry>Keine</entry> </row> <row> <entry>php_printer.dll</entry> <entry><link linkend="ref.printer">Printer</link> Funktionen</entry> <entry>Keine</entry> </row> <row> <entry>php_xslt.dll</entry> <entry><link linkend="ref.xslt">XSLT</link> Funktionen</entry> <entry>Benötigt sablot.dll (bundled)</entry> </row> <row> <entry>php_snmp.dll</entry> <entry><link linkend="ref.snmp">SNMP</link> get and walk Funktionen</entry> <entry>Nur NT!</entry> </row> <row> <entry>php_sybase_ct.dll</entry> <entry><link linkend="ref.sybase">Sybase</link> Funktionen</entry> <entry>Benötigt Sybase Client Bibliotheken</entry> </row> <row> <entry>php_yaz.dll</entry> <entry><link linkend="ref.yaz">YAZ</link> Funktionen</entry> <entry>Keine</entry> </row> <row> <entry>php_zlib.dll</entry> <entry><link linkend="ref.zlib">ZLib</link> Komprimierungsfunktionen</entry> <entry>Keine</entry> </row> </tbody> </tgroup> </table> </para> </sect2> </sect1> <!-- 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 indent-tabs-mode:nil 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 -->