كيفية إصلاح خطأ dyld مع libicui18n.62.dylib بعد تثبيت Node عبر Brew على Mac

مقدمة: الألم المألوف لكل مطور على Mac

كنت تقوم بتحديث Node.js عبر Homebrew، ثم قمت بتشغيل سكريبت PHP المفضل لديك — وفجأة ترى هذه الرسالة المروعة:

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

هدوء، فقط هدوء! إذا وصلت إلى هذه الصفحة، فأنت لست أول ولا آخر مطور يواجه هذا الخطأ. على Stack Overflow، حصد هذا السؤال آلاف المشاهدات، وليس من دون سبب: المشكلة تنشأ بسبب تعارض إصدارات مكتبة ICU4C (International Components for Unicode for C) بعد تثبيت أو تحديث Node.js عبر Homebrew.

في هذا الدليل، سأعرض لكم ثلاث طرق عملية لإصلاح الخطأ، وسأشرح جذره، وسأقدم توصيات مفيدة حتى لا تروا هذه الرسالة مرة أخرى. هيا بنا!

لماذا يحدث خطأ dyld: Library not loaded؟

قبل أن نبدأ في الإصلاح، دعنا نفهم الأسباب. سيساعدك هذا على فهم أفضل للنظام البيئي لـ macOS و Homebrew.

ما هي ICU4C وما علاقتها بـ PHP؟

ICU4C هي مكتبة لدعم Unicode، التدويل والتوطين. يستخدمها PHP للعمل مع دوال مثل mb_convert_encoding()، وامتداد intl وغيرها. يقوم Homebrew بتثبيت ICU4C كاعتماد للعديد من الحزم، بما في ذلك PHP و Node.js.

سلسلة الأحداث المؤدية إلى الخطأ

\n
1. تقوم بتثبيت أو تحديث Node.js عبر brew install node أو brew upgrade node.
\n
2. يتطلب Node.js إصداراً معيناً من ICU4C (مثل 62.x).
\n
3. يقوم Homebrew بتحديث ICU4C إلى إصدار جديد (مثل 63.x أو 64.x).
\n
4. تتم إزالة المكتبة القديمة libicui18n.62.dylib.
\n
5. PHP، الذي تم تجميعه مع الإصدار 62، لا يمكنه العثور على المكتبة المطلوبة — ويتعطل مع الخطأ.
\n

ببساطة: PHP بقي "في الماضي"، بينما المكتبات أصبحت "في المستقبل".

الطريقة 1: حل سريع — إعادة ربط ICU4C (موصى به للمبتدئين)

هذه هي الطريقة الأسهل والأسرع، والتي تحل المشكلة في 90% من الحالات.

الخطوة 1: تحقق من الإصدار الحالي لـ ICU4C

افتح الطرفية (Terminal) ونفّذ:

brew list --versions icu4c

سترى شيئاً مثل icu4c 63.1 أو 64.2. تذكر الإصدار — ستحتاجه.

الخطوة 2: أعد ربط ICU4C مع PHP

نفّذ الأمر لإعادة الربط:

brew link --force icu4c

إذا رأيت تحذيراً بأن الإصدارات غير متطابقة — لا تقلق. هذا طبيعي. ثم أعد تشغيل PHP:

which php\nphp -v

إذا اختفى الخطأ — أحسنت! إذا لم يختفِ — انتقل إلى الطريقة التالية.

الخطوة 3: بديل — إعادة الربط القسري

إذا لم يعمل الأمر أعلاه، جرب:

brew reinstall icu4c\nbrew link --overwrite icu4c

سيؤدي هذا إلى إعادة تثبيت المكتبة وتحديث جميع الروابط.

الطريقة 2: إعادة تثبيت PHP عبر Homebrew (لمن يحبون النظافة)

إذا لم تساعد إعادة الربط — فهذا يعني أن PHP الخاص بك "مُخيط" تحت الإصدار القديم من ICU4C. أفضل حل هو إعادة تثبيت PHP.

الخطوة 1: احذف الإصدار الحالي من PHP

brew uninstall php

إذا كان لديك عدة إصدارات من PHP (مثل 7.4 و 8.0)، احذفها جميعاً:

brew uninstall php@7.4 php@8.0

الخطوة 2: نظف ذاكرة التخزين المؤقت لـ Homebrew

brew cleanup

الخطوة 3: أعد تثبيت PHP من جديد

brew install php

أو، إذا كنت بحاجة إلى إصدار معين:

brew install php@8.1

الخطوة 4: تحقق من قابلية التشغيل

اكتب سكريبت PHP بسيط للتحقق: