====== Konfiguration von macOS – ab M1 mit PHP 8.5 (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 Nichtbenutzung dieser Anleitung entstehen.
* **ACHTEN SIE AUF DIE SICHERHEIT IHRES SERVERS!** Apache, PHP und MySQL müssen wie auch untermStrich aktuell gehalten werden. Dies gilt besonders, wenn der Server im Internet erreichbar sein soll.
Benötigt untermStrich ONE 15.2.4 für PHP 8.5
===== Hinweis zum Start von Apache =====
Homebrew kann Apache als Benutzer-Dienst oder als Systemdienst verwalten:
* **Benutzer-Dienst:** Befehle ''brew services ...'' ohne ''sudo''. Der Dienst startet beim Anmelden des Benutzers.
* **Systemdienst:** Befehle ''sudo brew services ...''. Der Dienst startet beim Hochfahren des Macs, unabhängig von einer Anmeldung.
:!: Diese Anleitung verwendet standardmäßig den **Benutzer-Dienst**. Starten Sie niemals beide Varianten gleichzeitig, da sie denselben Port (8080) belegen. Weitere Informationen: [[https://docs.brew.sh/Manpage|Homebrew-Dokumentation zu brew services]].
===== I. Homebrew installieren =====
Homebrew installieren Sie laut der offiziellen Anleitung auf [[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 installieren Sie niemals als Root oder mit ''sudo''. Die Installation kann je nach Netzwerkverbindung einige Minuten dauern.
Zur Kontrolle der Installation:
brew --version
brew doctor
Die Meldungen von ''brew doctor'' sind nicht automatisch Fehler. Relevant sind nur Meldungen, die Ihre Installation betreffen. Bei Unklarheiten wenden Sie sich an Ihre Systembetreuung.
===== II. Webserver und PHP installieren =====
**Unbestätigt:** Die Homebrew-Formel ''php@8.5'' konnte zum Zeitpunkt der Erstellung nicht geprüft werden. Bitte vor der Installation prüfen, ob sie verfügbar ist.
brew install httpd
brew install php@8.5
brew link --force php@8.5
Führen Sie diese Befehle ohne ''sudo'' aus.
==== Apache starten und testen ====
Apache starten Sie als Benutzer-Dienst:
brew services start httpd
Ist Apache bereits als Benutzer-Dienst aktiv, starten Sie ihn neu:
brew services restart httpd
Der Zugriff erfolgt über **Port 8080**. Öffnen Sie dazu am Server: [[http://localhost:8080|http://localhost:8080]].
===== III. httpd.conf konfigurieren =====
Öffnen Sie die Datei ''/opt/homebrew/etc/httpd/httpd.conf'' mit einem Texteditor.
==== 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 ====
Fügen Sie direkt nach den Modulzeilen folgende Konfiguration ein:
LoadModule php_module /opt/homebrew/opt/php@8.5/lib/httpd/modules/libphp.so
SetHandler application/x-httpd-php
==== AllowOverride aktivieren ====
Im Abschnitt '''' den Wert ''None'' durch ''All'' ersetzen.
{{:de:installation:mac14_web3.png?500}}
\\
* Nach Änderungen an der Apache-Konfiguration Apache neu starten:
brew services restart httpd
===== IV. ionCube Loader einrichten =====
**Unbestätigt:** Ob für PHP 8.5 ein ionCube Loader zur Verfügung steht, ist nicht geprüft. Die folgenden Angaben gelten nur, wenn ein passender Loader vorhanden ist.
* Laden Sie den ionCube Loader für macOS (ARM64) herunter: [[https://downloads.ioncube.com/loader_downloads/ioncube_loaders_mac_arm64.zip|ionCube Loader herunterladen]].
* Entpacken Sie die Datei. Das Verzeichnis ''ioncube'' kopieren Sie nach ''/opt/homebrew/opt/php@8.5/''.
Anschließend muss ''/opt/homebrew/opt/php@8.5/ioncube'' vorhanden sein.
* Bearbeiten Sie die Datei ''/opt/homebrew/etc/php/8.5/php.ini''. Die Datei muss existieren.
* Tragen Sie unter dem Abschnitt ''[PHP]'' (direkt zu Beginn) folgende Zeile ein:
zend_extension = /opt/homebrew/opt/php@8.5/ioncube/ioncube_loader_mac_8.5.so
Passen Sie außerdem folgende Werte an:
upload_max_filesize = 50M
post_max_size = 55M
Starten Sie Apache danach neu:
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 > Unterscheidet sich in der MacOS Version
* :!: Die Meldung kann mehrmals erscheinen.
{{:de:installation:mac_bigusr0.png?300}}
* Die Freigabe in den Systemeinstellungen im Bereich „ Datenschutz & Sicherheit“ erlauben:
{{:de:installation:mac_bigusr2.png?400}}
* Starten Sie den Server erneut
brew services restart httpd
* Anschließend erneut auf „Öffnen“ oder „Dennoch öffnen“ klicken:
{{:de:installation:mac_bigusr3.png?400}}
{{: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
==== 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
===== 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]]. Entpacken Sie die Datei ''ustrich.4.zip'' nach ''/opt/homebrew/var/www''. Das Verzeichnis muss anschließend ''ustrich'' heißen.
Setzen Sie die Rechte:
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]].