macOS: Serverkomponenten aktualisieren und Störungen beheben

Diese Seite beschreibt, wie Apache und PHP 8.3 einer bestehenden untermStrich-Installation unter macOS aktualisiert werden. Danach finden Sie die Hinweise, wie Sie Störungen beim Start von Apache, bei der Erreichbarkeit, beim Dateizugriff und bei Homebrew eingrenzen.

Vor jeder Änderung eine vollständige Datensicherung erstellen. Sichern Sie Datenbank, untermStrich-Dateien und Serverkonfiguration. Informieren Sie die Benutzer, da untermStrich während der Arbeiten zeitweise nicht erreichbar ist.

Alle Befehle auf dieser Seite werden im Terminal ausgeführt. Sie finden es unter Programme → Dienstprogramme → Terminal. Befehle mit sudo verlangen das Kennwort des Administrators. Dabei werden keine Zeichen angezeigt; das ist normal.

Ermitteln Sie zunächst die untermStrich- und PHP-Version im Bereich System. Voraussetzungen finden Sie in der macOS-Installationsübersicht und in den Homebrew-Systemvoraussetzungen.

Der Installationspfad von Homebrew wird so ermittelt:

brew --prefix

Auf Apple-Silicon-Rechnern (M1 und neuer) lautet das Ergebnis üblicherweise /opt/homebrew, bei Intel-Rechnern /usr/local. Maßgeblich ist immer die Ausgabe auf Ihrem Server.

Apache kann als Benutzerdienst oder als Systemdienst eingerichtet sein:

  • Benutzerdienst: startet bei der Anmeldung des Benutzers und wird ohne sudo verwaltet.
  • Systemdienst: startet beim Hochfahren des Macs und wird mit sudo verwaltet.

Welche Betriebsart vorliegt, zeigen die beiden Übersichten:

brew services list
sudo brew services list

Der Eintrag httpd erscheint in der Übersicht der tatsächlich verwendeten Betriebsart. Behalten Sie diese bei. Apache sollte nicht gleichzeitig als Benutzer- und als Systemdienst laufen, da beide denselben Port belegen können.

Alle folgenden Befehle zum Stoppen und Starten gelten für diese Betriebsart: ohne sudo beim Benutzerdienst, mit sudo beim Systemdienst.

Die folgenden Befehle gelten für eine vorhandene Homebrew-Installation mit httpd und php@8.3.

brew update
brew outdated

brew update aktualisiert Homebrew selbst und die Liste verfügbarer Pakete. Dabei wird noch nichts installiert. brew outdated zeigt, welche installierten Pakete neuere Versionen haben. Prüfen Sie die Ausgabe, bevor Sie fortfahren.

Benutzerdienst:

brew services stop httpd

Systemdienst:

sudo brew services stop httpd
brew upgrade httpd php@8.3

Der Befehl wird ohne sudo unter dem Benutzer ausgeführt, der die Homebrew-Installation verwaltet. Die Paketnamen sind bewusst angegeben: Ein brew upgrade ohne Paketnamen aktualisiert alle installierten Pakete und kann weitere Komponenten verändern. Benötigte Abhängigkeiten werden automatisch mit aktualisiert.

Prüfen Sie zuerst die Apache-Konfiguration:

"$(brew --prefix httpd)/bin/httpd" -t

Syntax OK bedeutet, dass die Konfiguration formal in Ordnung ist. Eine Fehlermeldung nennt meist Datei und Zeile. Beheben Sie sie, bevor Sie starten.

Starten Sie anschließend Apache in der bisherigen Betriebsart:

Benutzerdienst:

brew services start httpd

Systemdienst:

sudo brew services start httpd

Melden Sie sich danach in untermStrich an. Im Bereich System sollte die erwartete PHP-Version angezeigt werden.

Apache versuchen manuell im Vordergund zu starten:

 /opt/homebrew/bin/httpd -DFOREGROUND

Eine Standardinstallation verwendet Port 8080 für HTTP und 8443 für HTTPS. Prüfen Sie, ob der Port belegt ist:

sudo lsof -i:8080

Ein Eintrag mit (LISTEN) bedeutet, dass ein Prozess auf diesem Port auf Verbindungen wartet. In der Spalte COMMAND steht das Programm, in der Spalte PID die Prozessnummer. Beenden Sie einen Prozess erst, wenn klar ist, zu welcher Anwendung er gehört. Handelt es sich um einen bereits laufenden Apache, wurde der Dienst eventuell doppelt gestartet.

Nach einem Absturz kann eine veraltete Datei den Start verhindern. Die Datei heißt httpd.pid und liegt typischerweise unter:

/opt/homebrew/var/run/httpd/httpd.pid     (Apple Silicon)
/usr/local/var/run/httpd/httpd.pid        (Intel)

Die Datei nur löschen, wenn beide Bedingungen zutreffen: Apache läuft nachweislich nicht, und die Datei ist veraltet. Im Zweifel prüft der Systembetreuer den Pfad aus der tatsächlichen Konfiguration.

Dieser Fall liegt vor, wenn Apache läuft, die Adresse im Browser aber nicht erreichbar ist. Prüfen Sie zunächst, ob die Adresse den richtigen Port enthält, zum Beispiel http://server:8080/ustrich/.

Die Netzwerkeinstellung steht in der Konfigurationsdatei httpd.conf:

/opt/homebrew/etc/httpd/httpd.conf     (Apple Silicon)
/usr/local/etc/httpd/httpd.conf        (Intel)

Die bisherige Anleitung nennt dort folgende Zeile:

Listen 0.0.0.0:8080

Diese Zeile lässt Apache auf Port 8080 an allen IPv4-Netzwerkschnittstellen auf Verbindungen warten. Ob das für Ihre Installation passt, hängt von Netzwerk und Firewall ab. Ändern Sie die Zeile nur nach Absprache mit dem Systembetreuer. Nach einer Änderung prüfen Sie die Konfiguration mit dem Test aus dem Abschnitt „Apache und PHP aktualisieren“ und starten Apache neu.

Dieser Fall liegt vor, wenn die Anmeldung funktioniert, Dateien aber nicht geöffnet, erstellt oder gespeichert werden können. Meist fehlen dem Apache-Benutzer ausreichende Rechte auf das Verzeichnis, oder macOS blockiert den Zugriff auf einen geschützten Speicherort.

Wählen Sie im Finder das Daten- bzw. Projektverzeichnis aus und öffnen Sie Ablage → Informationen. Der Benutzer, unter dem Apache läuft, benötigt dort Lese- und Schreibrechte. Eingebundene Netzwerkverzeichnisse müssen erreichbar sein. Rechteänderungen sollten mit dem Systembetreuer abgestimmt werden.

Seit macOS 10.15 (Catalina) fragt macOS vor dem Zugriff auf Dokumente, Downloads, den Schreibtisch, iCloud Drive oder Netzwerkvolumes um Erlaubnis. Diese Freigabe gilt pro Programm und ist unter Systemeinstellungen → Datenschutz & Sicherheit → Dateien & Ordner einsehbar.

Der Festplattenvollzugriff unter Systemeinstellungen → Datenschutz & Sicherheit erlaubt einem Programm deutlich mehr Zugriff. Aktivieren Sie ihn nur, wenn die Fehlermeldung darauf hinweist, und nur für das tatsächlich benötigte Programm.

Wenn Homebrew-Befehle Fehler melden, kann die Ursache bei den Command Line Tools für Xcode, bei einer Abhängigkeit oder bei der Installation liegen.

brew doctor

Nicht jede Warnung erfordert eine Änderung. Bewerten Sie die Ausgabe im Zusammenhang mit der konkreten Fehlermeldung.

Veraltete oder unpassende Command Line Tools können Homebrew-Fehler auslösen. Sie werden entfernt und anschließend neu installiert:

sudo rm -rf /Library/Developer/CommandLineTools

Bestätigen Sie danach den Installationsdialog von macOS. Das Entfernen sollte nur nach Rücksprache mit dem Systembetreuer erfolgen.

Bei der Meldung _apr_crypto_block_cleanup hilft folgender Befehl:

brew reinstall apr-util

Dieser Befehl ist nur für diesen konkreten Fehler vorgesehen. Danach wird Apache wie im Abschnitt „Apache und PHP aktualisieren“ beschrieben aktualisiert.

Eine Neuinstallation sollte nur erfolgen, wenn die übrigen Maßnahmen nicht helfen, und nur mit dem Systembetreuer und nach Datensicherung:

brew remove httpd
brew install httpd
brew install php@8.3

Die bisherigen Anleitungen für Big Sur, Mojave und Catalina beschreiben frühere Serverumgebungen. Sie belegen nicht, dass diese Umgebungen heutige Anforderungen erfüllen. Maßgeblich bleibt die macOS-Installationsübersicht.

  • Feste Pfade unter /usr/local passen nicht automatisch zu Apple Silicon. Verwenden Sie den mit brew –prefix ermittelten Pfad.
  • brew cleanup entfernt alte Paketversionen und Zwischenspeicher. Der Befehl ist kein allgemeiner Reparaturschritt.
  • Der frühere Hinweis, Homebrew am Basepath /usr/local/var/www/ zu erkennen, ist nicht zuverlässig. Das Standardverzeichnis bei Apple Silicon lautet /opt/homebrew/var/www/.
  • Die frühere Installation von php@7.4 ist nicht mehr vorgesehen.