Comment corriger l'erreur dyld avec libicui18n.62.dylib après l'installation de Node via Brew sur Mac

Introduction : La douleur familière de tout développeur sur Mac

Vous avez mis à jour Node.js via Homebrew, lancé votre script PHP préféré — et soudain, vous voyez ce message glaçant :

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

Du calme, rien que du calme ! Si vous êtes arrivé sur cette page, c'est que vous n'êtes ni le premier ni le dernier développeur à rencontrer cette erreur. Sur Stack Overflow, cette question a recueilli des milliers de vues, et ce n'est pas pour rien : le problème survient à cause d'un conflit de versions de la bibliothèque ICU4C (International Components for Unicode for C) après l'installation ou la mise à jour de Node.js via Homebrew.

Dans ce tutoriel, je vais vous montrer trois méthodes efficaces pour corriger l'erreur, expliquer sa cause profonde et vous donner des recommandations utiles pour que vous ne voyiez plus jamais ce message. C'est parti !

Pourquoi l'erreur dyld : Library not loaded se produit-elle ?

Avant de vous précipiter pour corriger, comprenons les causes. Cela vous aidera à mieux comprendre l'écosystème macOS et Homebrew.

Qu'est-ce qu'ICU4C et quel est son rapport avec PHP ?

ICU4C est une bibliothèque pour la prise en charge d'Unicode, de l'internationalisation et de la localisation. PHP l'utilise pour des fonctions comme mb_convert_encoding(), l'extension intl et d'autres. Homebrew installe ICU4C comme dépendance pour de nombreux paquets, y compris PHP et Node.js.

La chaîne d'événements menant à l'erreur

\n
1. Vous installez ou mettez à jour Node.js via brew install node ou brew upgrade node.
\n
2. Node.js nécessite une version spécifique d'ICU4C (par exemple, 62.x).
\n
3. Homebrew met à jour ICU4C vers une nouvelle version (par exemple, 63.x ou 64.x).
\n
4. L'ancienne bibliothèque libicui18n.62.dylib est supprimée.
\n
5. PHP, qui a été compilé avec la version 62, ne trouve pas la bibliothèque nécessaire — et plante avec une erreur.
\n

En termes simples : PHP est resté « dans le passé », tandis que les bibliothèques sont déjà « dans le futur ».

Méthode 1 : Solution rapide — relier ICU4C (recommandé pour les débutants)

C'est la méthode la plus simple et la plus rapide, qui résout le problème dans 90 % des cas.

Étape 1 : Vérifiez la version actuelle d'ICU4C

Ouvrez le Terminal et exécutez :

brew list --versions icu4c

Vous verrez quelque chose comme icu4c 63.1 ou 64.2. Notez la version — elle vous sera utile.

Étape 2 : Reliez ICU4C avec PHP

Exécutez la commande pour relier :

brew link --force icu4c

Si vous voyez un avertissement indiquant que les versions ne correspondent pas — ne paniquez pas. C'est normal. Ensuite, redémarrez PHP :

which php\nphp -v

Si l'erreur a disparu — bravo ! Sinon, passez à la méthode suivante.

Étape 3 : Variante alternative — relier de force

Si la commande ci-dessus n'a pas fonctionné, essayez :

brew reinstall icu4c\nbrew link --overwrite icu4c

Cela réinstallera la bibliothèque et mettra à jour tous les liens.

Méthode 2 : Réinstallation de PHP via Homebrew (pour ceux qui aiment la propreté)

Si le reliage n'a pas aidé — cela signifie que votre PHP est « figé » sur une ancienne version d'ICU4C. La meilleure solution est de réinstaller PHP.

Étape 1 : Supprimez la version actuelle de PHP

brew uninstall php

Si vous avez plusieurs versions de PHP (par exemple, 7.4 et 8.0), supprimez-les toutes :

brew uninstall php@7.4 php@8.0

Étape 2 : Nettoyez le cache de Homebrew

brew cleanup

Étape 3 : Réinstallez PHP

brew install php

Ou, si vous avez besoin d'une version spécifique :

brew install php@8.1

Étape 4 : Vérifiez le fonctionnement

Écrivez un script PHP simple pour vérifier :<