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 …ohnesudo. 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: Homebrew-Dokumentation zu brew services.
I. Homebrew installieren
Homebrew installieren Sie laut der offiziellen Anleitung auf 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.
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
LoadModule rewrite_module lib/httpd/modules/mod_rewrite.so
LoadModule env_module lib/httpd/modules/mod_env.so
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 <FilesMatch \.php$> SetHandler application/x-httpd-php </FilesMatch>
AllowOverride aktivieren
Im Abschnitt <Directory „/opt/homebrew/var/www“> den Wert None durch All ersetzen.
- 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: ionCube Loader herunterladen.
- Entpacken Sie die Datei. Das Verzeichnis
ioncubekopieren 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.
- Die Freigabe in den Systemeinstellungen im Bereich „ Datenschutz & Sicherheit“ erlauben:
- Starten Sie den Server erneut
brew services restart httpd
- Anschließend erneut auf „Öffnen“ oder „Dennoch öffnen“ klicken:
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
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.
VII. untermStrich herunterladen und installieren
Die aktuelle Version von untermStrich finden Sie unter 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/.







