So beheben Sie dyld: Library not loaded: libicui18n.62.dylib auf dem Mac nach der Node-Installation über Brew

Einleitung: Wenn PHP nicht mehr mit Homebrew harmoniert

Haben Sie schon einmal die Situation erlebt, in der alles einwandfrei funktionierte und dann – peng! – Ihr geliebtes PHP-Skript einen Fehler ausgibt, der einem die Haare zu Berge stehen lässt? Wenn Sie ein Entwickler auf macOS sind und kürzlich Node.js über Homebrew installiert haben, haben Sie diese furchterregende Meldung mit Sicherheit gesehen:

dyld: Library not loaded: /usr/local/opt/icu4c/lib/libicui18n.62.dylib\n  Referenced from: /usr/local/bin/php\n  Reason: image not found

Keine Panik! Das ist nicht das Ende der Welt, sondern lediglich ein Versionskonflikt der Bibliothek ICU4C (International Components for Unicode for C). Diese Situation ist so verbreitet, dass diese Frage auf Stack Overflow tausende Aufrufe gesammelt hat. Heute werden wir verstehen, warum das passiert, und vor allem, wie man es ein für alle Mal behebt.

Warum tritt der Fehler libicui18n.62.dylib auf?

Lassen Sie uns die Mechanik analysieren. ICU4C ist eine Bibliothek zur Unicode-Unterstützung, die PHP für die Arbeit mit Internationalisierung verwendet (Funktionen wie intl, mbstring und andere). Wenn Sie PHP über Homebrew installieren, wird es an eine bestimmte Version von ICU4C gebunden, die zum Zeitpunkt der Installation aktuell war.

Das Problem tritt auf, wenn Sie Node.js über Brew installieren (oder aktualisieren). Node.js hängt ebenfalls von ICU4C ab, und Brew kann diese Bibliothek auf eine neue Version aktualisieren und dabei die alte entfernen. Infolgedessen bleibt PHP mit einem „toten Link“ auf die Datei libicui18n.62.dylib zurück, die nicht mehr existiert. Daher der Fehler:

dyld: Library not loaded: /usr/local/opt/icu4c/lib/libicui18n.62.dylib

Im Grunde ist dies ein klassischer Abhängigkeitskonflikt. Aber die gute Nachricht: Es gibt eine Lösung, und sie ist recht einfach.

Lösungswege: Vom Einfachen zum Zuverlässigen

Methode 1: Neulink von ICU4C (schnelle Lösung)

Der schnellste Weg ist, PHP daran zu „erinnern“, wo die Bibliothek jetzt liegt. Homebrew speichert die aktuelle Version von ICU4C an einem anderen Ort, aber wir können einen symbolischen Link erstellen.

\n
1. Finden Sie zunächst heraus, welche Version von ICU4C derzeit installiert ist:
\n

brew list --versions icu4c

Sie sehen etwas wie icu4c 72.1 (die Versionsnummer kann abweichen).

\n
2. Erstellen Sie nun das Verzeichnis, das PHP sucht, und legen Sie einen Symlink an:
\n

sudo mkdir -p /usr/local/opt/icu4c/lib\nsudo ln -s /usr/local/Cellar/icu4c/72.1/lib/libicui18n.dylib /usr/local/opt/icu4c/lib/libicui18n.62.dylib

Wichtig: Ersetzen Sie 72.1 durch Ihre Version von ICU4C. Wenn die Version 73.0 ist, lautet der Befehl wie folgt:

sudo ln -s /usr/local/Cellar/icu4c/73.0/lib/libicui18n.dylib /usr/local/opt/icu4c/lib/libicui18n.62.dylib

Überprüfen Sie, ob PHP funktioniert:

php -v

Wenn Sie die PHP-Version ohne Fehler sehen – hurra, Sie haben gewonnen! Dies ist jedoch eine temporäre Lösung. Beim nächsten Update von ICU4C wird der Link erneut brechen.

Methode 2: Neuinstallation von PHP über Brew (empfohlen)

Ein korrekterer Ansatz ist, PHP dazu zu zwingen, sich mit der aktuellen Version von ICU4C neu zu kompilieren. Dies dauert etwas länger, löst das Problem aber an der Wurzel.

\n
1. Entfernen Sie zunächst die aktuelle PHP-Version (falls vorhanden):
\n

brew uninstall php

\n
2. Installieren Sie PHP dann neu und geben Sie explizit an, dass die aktuelle ICU4C-Version verwendet werden soll:
\n

brew install php

Homebrew zieht automatisch die neueste Version von ICU4C und kompiliert PHP mit den korrekten Links neu. Überprüfen Sie nach der Installation:

php -v\nphp -m | grep intl

Das Modul intl sollte in der Liste sein. Falls nicht – möglicherweise muss es manuell in der php.ini aktiviert werden, aber normalerweise erledigt Brew dies automatisch.

Methode 3: Installation einer bestimmten ICU4C-Version