Como corrigir dyld: Library not loaded: libicui18n.62.dylib no Mac após instalar Node via Brew

Introdução: quando o PHP para de fazer amizade com o Homebrew

Você já passou pela situação em que tudo funcionava perfeitamente e, de repente, seu script PHP favorito exibe um erro de dar arrepios? Se você é desenvolvedor no macOS e instalou recentemente o Node.js via Homebrew, com certeza já viu essa mensagem assustadora:

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

Não entre em pânico! Isso não é o fim do mundo, mas sim um conflito de versões da biblioteca ICU4C (International Components for Unicode for C). Essa situação é tão comum que no Stack Overflow essa pergunta já acumulou milhares de visualizações. Hoje vamos entender por que isso acontece e, principalmente, como corrigir de uma vez por todas.

Por que o erro libicui18n.62.dylib ocorre?

Vamos entender a mecânica. A ICU4C é uma biblioteca para suporte a Unicode usada pelo PHP para trabalhar com internacionalização (funções como intl, mbstring e outras). Quando você instala o PHP via Homebrew, ele vincula-se a uma versão específica do ICU4C que estava atual no momento da instalação.

O problema surge quando você instala (ou atualiza) o Node.js via Brew. O Node.js também depende do ICU4C, e o Brew pode atualizar essa biblioteca para uma versão mais nova, removendo a antiga. Como resultado, o PHP fica com um "link morto" para o arquivo libicui18n.62.dylib, que já não existe mais. Daí o erro:

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

Na prática, é um clássico conflito de dependências. A boa notícia é que a solução existe e é bem simples.

Soluções: do simples ao definitivo

Solução 1: Religar o ICU4C (correção rápida)

A maneira mais rápida é "lembrar" ao PHP onde a biblioteca está agora. O Homebrew armazena a versão atual do ICU4C em outro local, mas podemos criar um link simbólico.

\n
1. Primeiro, descubra qual versão do ICU4C está instalada:
\n

brew list --versions icu4c

Você verá algo como icu4c 72.1 (o número da versão pode variar).

\n
2. Agora, crie o diretório que o PHP procura e faça o symlink:
\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

Importante: Substitua 72.1 pela sua versão do ICU4C. Se a versão for 73.0, o comando será:

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

Teste se o PHP funciona:

php -v

Se aparecer a versão do PHP sem erros — parabéns, você conseguiu! Mas essa é uma solução temporária. Na próxima atualização do ICU4C, o link vai quebrar novamente.

Solução 2: Reinstalar o PHP via Brew (recomendado)

A abordagem mais correta é forçar o PHP a ser recompilado com a versão atual do ICU4C. Isso leva um pouco mais de tempo, mas resolve o problema de raiz.

\n
1. Primeiro, remova a versão atual do PHP (se existir):
\n

brew uninstall php

\n
2. Em seguida, reinstale o PHP, indicando explicitamente que deve usar a versão atual do ICU4C:
\n

brew install php

O Homebrew baixará a versão mais recente do ICU4C e recompilará o PHP com os links corretos. Após a instalação, verifique:

php -v\nphp -m | grep intl

O módulo intl deve aparecer na lista. Caso contrário, talvez seja necessário ativá-lo manualmente no php.ini, mas geralmente o Brew faz isso automaticamente.

Solução 3: Instalar uma versão específica do ICU4C