-
Notifications
You must be signed in to change notification settings - Fork 39
/
bundled.xml
224 lines (221 loc) · 8.64 KB
/
bundled.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 12081e88fbd683e58a029153afd57f043df9721b Maintainer: wiesemann Status: ready -->
<!-- Reviewed: yes -->
<!-- Rev-Revision: 1.0 Reviewer: samesch -->
<sect1 xml:id="install.macosx.bundled" xmlns="http://docbook.org/ns/docbook">
<title>Verwendung des mitgelieferten PHP vor macOS Monterey</title>
<simpara>
PHP ist seit macOS X (10.0.0) und vor macOS Monterey (12.0.0) in macOS
enthalten. Um PHP mit dem Standard-Webserver zu verwenden, müssen nur ein
paar Zeilen in der Apache-Konfigurationsdatei
<filename>httpd.conf</filename> auskommentiert werden.
<acronym>CGI</acronym> und/oder <acronym>CLI</acronym> sind standardmäßig
aktiviert (einfach zugänglich über das Terminal-Programm).
</simpara>
<simpara>
Die folgende Anleitung, um PHP zu aktivieren, ermöglicht ein einfaches und
schnelles Aufsetzen einer lokalen Entwicklungsumgebung. Es wird
<emphasis>dringend empfohlen</emphasis>, PHP immer auf dem neusten Stand
zu halten. Wie für die meisten Anwendungen werden auch für PHP regelmäßig
neue Versionen erstellt, um Fehler zu beseitigen und um den Funktionsumfang
zu erweitern. Für weitere Informationen sollten Sie die entsprechende
macOS-Installations-Dokumentation lesen. Die folgende Anleitung richtet
sich an Anfänger, um eine Standardkonfiguration aufzusetzen. Allen Benutzern
wird empfohlen, neuere Paket-Versionen zu installieren oder selbst zu
kompilieren.
</simpara>
<simpara>
Die normale Installation beinhaltet die Aktivierung des mitgelieferten
mod_php für den Apache-Webserver (der Standard-Webserver, der über die
Systemeinstellungen von macOS zugänglich ist) und umfasst folgende Schritte:
</simpara>
<para>
<orderedlist>
<listitem>
<simpara>
Öffnen Sie die Apache-Konfigurationsdatei. Normalerweise finden Sie diese
unter: <filename>/private/etc/apache2/httpd.conf</filename>
</simpara>
<simpara>
Über den <literal>Finder</literal> oder <literal>Spotlight</literal> wird
die Datei nur schwer zu finden sein, da sie geschützt ist und den Rechten
des <literal>root</literal>-Benutzers unterliegt.
</simpara>
<note>
<simpara>
Ein Weg, um die Datei zu öffnen, ist, im Terminal einen Unix-basierten
Texteditor, z. B. <literal>nano</literal>, zu verwenden. Da die Datei
dem Benutzer root gehört, sollten Sie den Befehl <literal>sudo</literal>
zum Öffnen (mit Root-Rechten) verwenden. Z. B. können Sie Folgendes im
<literal>Terminal</literal>-Programm eingeben (danach werden Sie nach
dem Passwort gefragt):
<literal>sudo nano /private/etc/apache2/httpd.conf</literal>
</simpara>
<simpara>
Nennenswerte Befehle für nano: <literal>^w</literal> (suchen),
<literal>^o</literal> (speichern), und <literal>^x</literal> (schließen)
wobei <literal>^</literal> für die Strg-Taste steht.
</simpara>
</note>
<note>
<simpara>
Versionen von Mac OS X vor 10.5 enthielten ältere Versionen von PHP und
Apache. Daher kann sich die Apache-Konfigurationen auf solchen
älteren Maschinen im folgenden Verzeichnis befinden:
<filename>/etc/httpd/httpd.conf</filename>.
</simpara>
</note>
</listitem>
<listitem>
<para>
Mit einem Texteditor müssen Sie nur die Zeilen einkommentieren (durch
Entfernen von #), die ähnlich wie die folgenden aussehen (die beiden
Zeilen sind oft ein Stück voneinander getrennt):
<screen>
<![CDATA[
# LoadModule php5_module libexec/httpd/libphp5.so
# AddModule mod_php5.c
]]>
</screen>
Beachten Sie die Dateipfade. Wenn Sie zukünftig PHP selbst kompilieren,
sollten die beiden Dateien ersetzt oder wieder auskommentiert werden.
</para>
</listitem>
<listitem>
<para>
Stellen Sie sicher, dass die gewünschten Dateiendungen durch PHP geparst
werden (z. B.: .php .html und .inc)
</para>
<para>
Durch die folgenden bereits in der Datei <filename>httpd.conf</filename>
enthaltenen Angaben (ab Mac Panther) werden Dateien mit der Endung
<filename>.php</filename> nach dem Aktivieren von PHP automatisch
geparst.
<screen>
<![CDATA[
<IfModule mod_php5.c>
# Wenn PHP aktiviert wurde, werden .php- und .phps-Dateien berücksichtigt.
AddType application/x-httpd-php .php
AddType application/x-httpd-php-source .phps
# Da die meisten Benutzer index.php verwenden möchten, aktivieren
# wir ebenso automatisch die index.php
<IfModule mod_dir.c>
DirectoryIndex index.html index.php
</IfModule>
</IfModule>
]]>
</screen>
</para>
<note>
<para>
Vor Mac OS X 10.5 (Leopard) war PHP 4 statt PHP 5 enthalten, weswegen
die oben genannten Anweisungen angepasst werden müssen (Ersetzen der "5"
durch die "4").
</para>
</note>
</listitem>
<listitem>
<simpara>
Stellen Sie sicher, dass durch DirectoryIndex die gewünschten
vorgegebenen Index-Dateien geladen werden.
</simpara>
<simpara>
Dies kann auch in <filename>httpd.conf</filename> definiert werden.
Normalerweise werden <filename>index.php</filename> und
<filename>index.html</filename> verwendet. Wie oben bereits gezeigt, ist
<filename>index.php</filename> standardmäßig aktiviert. Passen Sie es wie
gewünscht an.
</simpara>
</listitem>
<listitem>
<simpara>
Den Pfad zur &php.ini; setzen oder den Standard verwenden
</simpara>
<simpara>
Der Standardpfad unter macOS ist
<filename>/usr/local/php/php.ini</filename>, was durch einen Aufruf von
<function>phpinfo</function> geprüft werden kann. Wenn keine &php.ini;
angegeben wird, verwendet PHP die Standardwerte. Lesen Sie dazu die
entsprechende FAQ:
<link linkend="faq.installation.phpini">Wo sollte sich meine php.ini befinden?</link>.
</simpara>
</listitem>
<listitem>
<simpara>
Finden oder Setzen des <literal>DocumentRoot</literal>
</simpara>
<simpara>
Dies ist das Wurzelverzeichnis für alle Web-Dateien. Dateien in diesem
Verzeichnis werden durch den Webserver ausgeliefert. PHP-Dateien werden
geparst, bevor sie an einen Browser ausgeliefert werden. Der
standardmäßig gesetzte Pfad ist
<filename>/Library/WebServer/Documents</filename> und kann in der
<filename>httpd.conf</filename> auf einen beliebigen Pfad gesetzt werden.
Alternativ ist der standardmäßige Pfad zum
<filename>DocumentRoot</filename> für die einzelnen Benutzer:
<filename>/Users/ihr_benutzername/Sites</filename>
</simpara>
</listitem>
<listitem>
<simpara>
Erstellen einer <function>phpinfo</function>-Datei
</simpara>
<para>
Die Funktion <function>phpinfo</function> zeigt Informationen über PHP
an. Erstellen Sie eine Datei im DocumentRoot mit dem folgenden Inhalt:
<programlisting role="php">
<![CDATA[
<?php phpinfo(); ?>
]]>
</programlisting>
</para>
</listitem>
<listitem>
<simpara>
Starten Sie den Apache neu und laden Sie die eben erzeugte PHP-Datei.
</simpara>
<para>
Um neu zu starten, können Sie entweder <literal>sudo apachectl
graceful</literal> im Terminal aufrufen oder die Stop-/Start-Option des
"Personal Web Server" in den macOS-Systemeinstellungen verwenden.
Standardmäßig sollte folgende <acronym>URL</acronym> zum Laden von
lokalen Dateien im Webbrowser genügen:
<filename>http://localhost/info.php</filename> Alternativ, um Dateien aus
dem DocumentRoot eines lokalen Benutzers zu laden:
<filename>http://localhost/~ihr_benutzername/info.php</filename>
</para>
</listitem>
</orderedlist>
</para>
<simpara>
Das <acronym>CLI</acronym> (oder <acronym>CGI</acronym> in älteren
Versionen) heißt entsprechend <filename>php</filename> und existiert
wahrscheinlich als <filename>/usr/bin/php</filename>. Öffnen Sie das
Terminal, lesen Sie das Kapitel
<link linkend="features.commandline">PHP auf der Kommandozeile</link> des
PHP-Handbuchs und führen Sie <literal>php -v</literal> aus, um die
PHP-Version dieses PHP-Binärprogramms zu sehen. Ein Aufruf von
<function>phpinfo</function> enthält diese Information ebenfalls.
</simpara>
</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:"~/.phpdoc/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
-->