Inhaltsverzeichnis

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:

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.


brew services restart httpd

IV. ionCube Loader in php.ini einrichten

zend_extension = /opt/homebrew/opt/php@8.3/ioncube/ioncube_loader_mac_8.3.so
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

Die Freigabe in den Systemeinstellungen im Bereich „Sicherheit“ erlauben:

brew services restart httpd

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

: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.

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/.

macOS aktualisieren

macOS: Serverkomponenten aktualisieren und Störungen beheben.