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.

Homebrew kann Apache als Benutzer-Dienst oder als Systemdienst verwalten:

  • Benutzer-Dienst: Start mit brew services … ohne sudo. 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.

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.

brew --version
brew doctor

Homebrew niemals als root oder mittels sudo starten. Eventuelle Fehlermeldungen mit der Systembetreuung oder der Homebrew-Community klären.

brew install httpd
brew install php@8.3
brew link --force php@8.3

Die Befehle ohne sudo ausführen.

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.

Die Datei /opt/homebrew/etc/httpd/httpd.conf mit einem Texteditor öffnen.

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

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>

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
  • Die Datei entpacken. Das Verzeichnis ioncube sollte sich anschließend unter /Users/IHR_BENUTZERNAME/Downloads/ioncube befinden.
  • Das Verzeichnis ioncube nach /opt/homebrew/opt/php@8.3/ kopieren. Anschließend sollte /opt/homebrew/opt/php@8.3/ioncube vorhanden sein.

  • Die Datei /opt/homebrew/etc/php/8.3/php.ini bearbeiten. 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
  • 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:

brew services restart httpd

Falls Apache noch nicht als Benutzer-Dienst eingerichtet ist:

brew services start httpd

A

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

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

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