Konfiguration von macOS – ab M1 mit PHP 8.3 (als Server)
| |
|---|
| 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! |
| |
| 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 …ohnesudo. 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: 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 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.
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
LoadModule rewrite_module lib/httpd/modules/mod_rewrite.so
LoadModule env_module lib/httpd/modules/mod_env.so
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 <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 als Benutzer-Dienst neu starten:
brew services restart httpd
IV. ionCube Loader in php.ini einrichten
- Die Datei entpacken. Das Verzeichnis
ioncubesollte sich anschließend unter/Users/IHR_BENUTZERNAME/Downloads/ioncubebefinden. - Das Verzeichnis
ioncubenach/opt/homebrew/opt/php@8.3/kopieren. Anschließend sollte/opt/homebrew/opt/php@8.3/ioncubevorhanden sein.
- Die Datei
/opt/homebrew/etc/php/8.3/php.inibearbeiten. 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.
Die Freigabe in den Systemeinstellungen im Bereich „Sicherheit“ erlauben:
- Starten Sie den Server erneut
brew services restart httpd
- Anschließend erneut auf „Öffnen“ klicken:
Falls angezeigt, 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
A
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
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.
VII. untermStrich herunterladen und installieren
Die aktuelle Version von untermStrich finden Sie unter 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/.










