كيفية تجميع وحدات PHP

عند استخدام ServBay لتطوير PHP، قد تحتاج إلى تجميع وتثبيت وحدات PHP إضافية لتوسيع ميزات PHP. ستتناول هذه المقالة كيفية تجميع وحدات PHP في بيئة ServBay، بما في ذلك تجميع وحدة imagick ووحدة sqlsrv.

المتطلبات المسبقة

تحذير

يرجى التأكد من إجراء إعداد بيئة التجميع وتعيين المتغيرات البيئية في النظام وفقًا للمقالة أدناه، وإلا فإن العمليات التالية ستفشل!

قبل البدء في تجميع وحدات PHP، تأكد من أنك قد أنجزت إعداد بيئة التجميع. لمزيد من التفاصيل حول كيفية إعداد بيئة التجميع، يُرجى الرجوع إلى الوثيقة استخدام ServBay لإعادة التجميع.

أهمية تحديد إصدار PHP

تأتي ServBay مع عدة إصدارات من PHP، لذا عند استخدام أدوات مثل phpize وphp-config، من الضروري تحديد إصدار PHP الذي تستخدمه. وذلك لأن إصدارات PHP المختلفة قد تحتوي على إعدادات واعتمادات مختلفة، واختيار الإصدار الصحيح يمكن أن يتجنب أخطاء التجميع ومشكلات التشغيل.

سيتم استخدام إصدار PHP 8.3 كنموذج.

تجميع وحدة PHP imagick

وحدة imagick هي امتداد لـ PHP يتيح معالجة العمليات المتعلقة بالصور. فيما يلي خطوات تجميع وحدة imagick:

الخطوة 1: تحميل الكود المصدري

أولاً، قم بتحميل حزمة الكود المصدري لوحدة imagick من PECL.

wget https://pecl.php.net/get/imagick-3.7.0.tgz

الخطوة 2: فك ضغط الحزمة المصدرية

قم بفك ضغط الحزمة المصدرية التي تم تنزيلها.

tar zxvf imagick-3.7.0.tgz
cd imagick-3.7.0

الخطوة 3: إنشاء ملف التكوين

استخدم phpize لإنشاء ملف التكوين. خلال هذه العملية، تأكد من تحديد إصدار PHP الذي تستخدمه. على سبيل المثال، إذا كنت تستخدم PHP 8.3، يرجى تنفيذ الأمر التالي:

${SERVBAY_PACKAGE_FULL_PATH}/php/8.3/current/bin/phpize

الخطوة 4: إعداد خيارات التجميع

قم بإعداد خيارات التجميع وحدد مسار إعدادات PHP.

./configure --with-php-config=${SERVBAY_PACKAGE_FULL_PATH}/php/8.3/current/bin/php-config

الخطوة 5: التجميع والتثبيت

قم بتجميع وتثبيت وحدة imagick.

make -j ${CPU_NUMBER}
make install

الخطوة 6: تفعيل الوحدة

قم بإنشاء ملف imagick.ini في دليل conf.d الخاص بـ PHP لتفعيل وحدة imagick. على سبيل المثال:

echo "extension=imagick.so" > /Applications/ServBay/package/etc/php/8.3/conf.d/imagick.ini

الخطوة 7: التحقق من تحميل الوحدة

أعد تشغيل خدمة PHP من خلال لوحة إدارة ServBay، ثم تحقق عبر سطر الأوامر مما إذا كانت الوحدة قد تم تحميلها بنجاح:

php-8.3 -m | grep imagick

إذا تم تحميل الوحدة بنجاح، يجب أن ترى imagick تظهر في نتائج الإخراج.

تجميع وحدة PHP sqlsrv

تحذير

المتطلبات المسبقة: لتجميع sqlsrv على نظام macOS، تحتاج أولاً إلى تثبيت برنامج تشغيل ODBC من مايكروسوفت msodbcsql18 وmssql-tools18.

لا تأتي ServBay مع MS ODBC، لذا يُرجى استخدام homebrew للتثبيت.

brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release
brew update
HOMEBREW_ACCEPT_EULA=Y brew install msodbcsql18 mssql-tools18

وحدة sqlsrv هي امتداد لـ PHP يتيح التفاعل مع Microsoft SQL Server. فيما يلي خطوات تجميع وحدة sqlsrv:

الخطوة 1: تحميل الكود المصدري

أولاً، قم بتحميل حزمة الكود المصدري لوحدة sqlsrv من PECL.

wget https://pecl.php.net/get/sqlsrv-5.12.0.tgz

الخطوة 2: فك ضغط الحزمة المصدرية

قم بفك ضغط الحزمة المصدرية التي تم تنزيلها.

tar zxvf sqlsrv-5.12.0.tgz
cd sqlsrv-5.12.0

الخطوة 3: إنشاء ملف التكوين

استخدم phpize لإنشاء ملف التكوين. خلال هذه العملية، تأكد من تحديد إصدار PHP الذي تستخدمه. على سبيل المثال، إذا كنت تستخدم PHP 8.3، يرجى تنفيذ الأمر التالي:

${SERVBAY_PACKAGE_FULL_PATH}/php/8.3/current/bin/phpize

الخطوة 4: إعداد خيارات التجميع

قم بإعداد خيارات التجميع وحدد مسار إعدادات PHP.

export LDFLAGS="-L/opt/homebrew/lib ${LDFLAGS}"
export CPPFLAGS="-I/opt/homebrew/opt/unixodbc/include ${CPPFLAGS}"
./configure --with-php-config=${SERVBAY_PACKAGE_FULL_PATH}/php/8.3/current/bin/php-config

الخطوة 5: التجميع والتثبيت

قم بتجميع وتثبيت وحدة sqlsrv.

make -j ${CPU_NUMBER}
make install

الخطوة 6: تفعيل الوحدة

قم بإنشاء ملف sqlsrv.ini في دليل conf.d الخاص بـ PHP لتفعيل وحدة sqlsrv. على سبيل المثال:

echo "extension=sqlsrv.so" > /Applications/ServBay/package/etc/php/8.3/conf.d/sqlsrv.ini

الخطوة 7: التحقق من تحميل الوحدة

أعد تشغيل خدمة PHP من خلال لوحة إدارة ServBay، ثم تحقق عبر سطر الأوامر مما إذا كانت الوحدة قد تم تحميلها بنجاح:

php-8.3 -m | grep sqlsrv

إذا تم تحميل الوحدة بنجاح، يجب أن ترى sqlsrv تظهر في نتائج الإخراج.

الخلاصة

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