====== Konfiguration von macOS – ab M1 mit PHP 8.3 (als Server) ======
^ **:!: ACHTUNG: ANLEITUNG OHNE GEWÄHR. ** ^
| Die Firma untermStrich software gmbh übernimmt keine Haftung für etwaige Schäden oder Fehler die direkt oder indirekt durch die Benutzung oder nicht Benutzung dieser Anleitung entstehen! |
^ ** :!: ACHTEN SIE AUF DIE SICHERHEIT IHRES SERVERS!! ** ^
| Apache, PHP, MySQL muss wie auch untermStrich aktuell gehalten werden. Dies gilt besonders, wenn der Server im Internet verfügbar sein soll. |
===== Hinweis zum Start von Apache =====
Homebrew kann Apache als Benutzer-Dienst oder als Systemdienst verwalten:
* **Benutzer-Dienst:** Start mit ''brew services ...'' ohne ''sudo''. Der Dienst wird beim Anmelden des Benutzers gestartet.
* **Systemdienst:** Start mit ''sudo brew services ...''. Der Dienst wird als Systemdienst eingerichtet und beim Hochfahren des Macs gestartet.
Für diese Anleitung wird standardmäßig der **Benutzer-Dienst** verwendet. Root- und Benutzer-Dienst nicht gleichzeitig starten, da beide denselben Port belegen könnten. Weitere Informationen: [[https://docs.brew.sh/Manpage|Homebrew-Dokumentation zu brew services]].
===== I. Homebrew installieren =====
Falls Probleme mit bereits installierten CommandLineTools auftreten, kann deren Entfernung erforderlich sein:
sudo rm -rf /Library/Developer/CommandLineTools
**Achtung:** Dieser Befehl löscht die CommandLineTools. Nur ausführen, wenn dies zur Fehlerbehebung tatsächlich erforderlich ist.
Siehe [[https://brew.sh/index_de|brew.sh]]. Typischerweise erfolgt die Installation mit:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Homebrew niemals als root oder mittels ''sudo'' installieren. Je nach Netzwerkverbindung kann die Installation einige Minuten dauern.
==== Version und Installation prüfen (optional) ====
brew --version
brew doctor
Homebrew niemals als root oder mittels ''sudo'' starten. Eventuelle Fehlermeldungen mit der Systembetreuung oder der Homebrew-Community klären.
===== II. Webserver und PHP installieren =====
brew install httpd
brew install php@8.3
brew link --force php@8.3
Die Befehle ohne ''sudo'' ausführen.
==== Apache starten und testen ====
Apache erstmals als Benutzer-Dienst starten:
brew services start httpd
Wenn Apache bereits als Benutzer-Dienst läuft, neu starten:
brew services restart httpd
Der Zugriff erfolgt über **Port 8080**. Am Server öffnen: [[http://localhost:8080|http://localhost:8080]].
===== III. httpd.conf konfigurieren =====
Die Datei ''/opt/homebrew/etc/httpd/httpd.conf'' mit einem Texteditor öffnen.
==== Apache-Module aktivieren ====
Die Kommentarzeichen ''#'' vor den folgenden drei Modulen entfernen (auskommentieren):
LoadModule expires_module lib/httpd/modules/mod_expires.so
{{:de:installation:mac14_web7_1.png?900}}
LoadModule rewrite_module lib/httpd/modules/mod_rewrite.so
{{:de:installation:mac14_web7_2.png?900}}
LoadModule env_module lib/httpd/modules/mod_env.so
{{:de:installation:mac14_web7_3.png?900}}
==== PHP-Modul einfügen ====
Direkt nach den Modulzeilen folgende Konfiguration einfügen:
LoadModule php_module /opt/homebrew/opt/php@8.3/lib/httpd/modules/libphp.so
SetHandler application/x-httpd-php
{{:de:installation:httpc.conf.png}}
==== AllowOverride aktivieren ====
Im Abschnitt '''' den Wert ''None'' durch ''All'' ersetzen.
{{:de:installation:mac14_web3.png?500}}
\\
* Nach Änderungen an der Apache-Konfiguration Apache als Benutzer-Dienst neu starten:
brew services restart httpd
===== IV. ionCube Loader in php.ini einrichten =====
* [[https://downloads.ioncube.com/loader_downloads/ioncube_loaders_mac_arm64.zip|ionCube Loader herunterladen]].
* Die Datei entpacken. Das Verzeichnis ''ioncube'' sollte sich anschließend unter ''/Users/IHR_BENUTZERNAME/Downloads/ioncube'' befinden.
* Das Verzeichnis ''ioncube'' nach ''/opt/homebrew/opt/php@8.3/'' kopieren. Anschließend sollte ''/opt/homebrew/opt/php@8.3/ioncube'' vorhanden sein.
{{:de:installation:mac_goto.png?300}}
* Die Datei ''/opt/homebrew/etc/php/8.3/php.ini'' bearbeiten. Diese Datei muss existieren.
* Unter dem Abschnitt ''[PHP]'' folgende Zeile eintragen:
zend_extension = /opt/homebrew/opt/php@8.3/ioncube/ioncube_loader_mac_8.3.so
* In der Datei folgende Werte finden und anpassen:
upload_max_filesize = 50M
post_max_size = 55M
Nach Änderungen an ''php.ini'' Apache als Benutzer-Dienst neu starten:
brew services restart httpd
==== ionCube unter macOS freigeben ====
* Unter macOS kann beim ersten Start eine Meldung erscheinen, ob die ionCube-Datei in den Papierkorb gelegt werden soll.
* **Abbrechen** oder **Fertig** wählen.
* :!: Die Meldung kann mehrmals erscheinen.
{{:de:installation:mac_bigusr0.png?300}}
Die Freigabe in den Systemeinstellungen im Bereich „Sicherheit“ erlauben:
{{:de:installation:mac_bigusr1.png?300}}
{{:de:installation:mac_bigusr2.png?300}}
* Starten Sie den Server erneut
brew services restart httpd
* Anschließend erneut auf „Öffnen“ klicken:
{{:de:installation:mac_bigusr3.png?400}}
Falls angezeigt, auf „Öffnen“ oder „Dennoch öffnen“ klicken:
{{:de:installation:mac_bigusr3_2.png?400}}
===== V. Apache neu starten =====
brew services restart httpd
Falls Apache noch nicht als Benutzer-Dienst eingerichtet ist:
brew services start httpd
A
==== V. Alternative: Apache als Systemdienst starten ====
:righty: Nur verwenden, wenn Apache bereits beim Hochfahren des Macs und unabhängig von einer Benutzeranmeldung verfügbar sein soll. Dies startet den Dienst im Root-Kontext:
sudo brew services start httpd
Einen bereits gestarteten Systemdienst neu starten:
sudo brew services restart httpd
Für diesen Systemdienst die Verwaltungsbefehle ebenfalls mit ''sudo'' ausführen. Nicht gleichzeitig zusätzlich den Benutzer-Dienst starten.
===== VI. Apache-Seite öffnen =====
Der Zugriff erfolgt über **Port 8080**. Am Server öffnen: [[http://localhost:8080|http://localhost:8080]].
===== VII. untermStrich herunterladen und installieren =====
Die aktuelle Version von untermStrich finden Sie unter [[https://webservices.untermstrich.com/update/|untermStrich Updates]].
Die Datei ''ustrich.4.zip'' nach ''/opt/homebrew/var/www'' entpacken. Sicherstellen, dass das Verzeichnis ''ustrich'' heißt.
Die Rechte setzen:
chmod a+rx /opt/homebrew/var/www/ustrich
Der Zugriff erfolgt über Port 8080: [[http://localhost:8080/ustrich/|http://localhost:8080/ustrich/]].
===== macOS aktualisieren =====
[[de:installation:mac_update|macOS: Serverkomponenten aktualisieren und Störungen beheben]].