Inhaltsverzeichnis

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:

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


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.

Anschließend muss /opt/homebrew/opt/php@8.5/ioncube vorhanden sein.

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

brew services restart httpd

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.

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

macOS aktualisieren

macOS: Serverkomponenten aktualisieren und Störungen beheben.