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

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: Homebrew-Dokumentation zu brew services.

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.

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

Öffnen Sie die Datei /opt/homebrew/etc/httpd/httpd.conf mit einem Texteditor.

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

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>

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

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.

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

brew services restart httpd

Falls Apache noch nicht als Benutzer-Dienst eingerichtet ist:

brew services start httpd

: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

Der Zugriff erfolgt über Port 8080. Am Server öffnen: http://localhost:8080.

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