يدير Composer مكتبات PHP التي يحتاجها المشروع. تظهر المشاكل عادة على الخادم: إصدار PHP مختلف أو غياب ملف القفل أو حزم تطوير في الإنتاج أو ملفات مملوكة لـ root. النمط الآمن بسيط: حددوا الإصدارات على جهاز التطوير والتزموا بملف القفل ودعوا الخادم يثبّت ما فيه بالضبط. الأوامر وفق وثائق Composer؛ لم أشغّلها على خادمكم وبعض الاستضافات المشتركة تحدّ من صلاحية الصدفة.
١. افحصوا PHP وComposer أولاً
يعمل Composer بإصدار PHP لسطر الأوامر وقد يختلف عن PHP الويب:
php -v
composer --version
composer validate
composer diagnose
لمعرفة كيف يُختار PHP الويب راجعوا دليل إصدار PHP ودليل PHP-FPM.
٢. حدّدوا الإصدارات على جهاز التطوير
أضيفوا الحزم وحدّثوها حيث تستطيعون الاختبار والتزموا بالملفين ليتمكن الخادم من إعادة إنتاج النتيجة:
# Development machine: add or update, then commit composer.json AND composer.lock
composer require monolog/monolog:^3.0
composer update monolog/monolog --with-dependencies
git add composer.json composer.lock
تحدد قيود الإصدار في composer.json ما هو مسموح؛ ويسجل ملف القفل ما اختُبر.
٣. ثبّتوا على الخادم من ملف القفل
على الخادم استخدموا install لا update. تخطّوا حزم التطوير وحسّنوا المحمّل التلقائي:
# Server: install exactly what the lock file says
cd /var/www/example
composer install --no-dev --prefer-dist --optimize-autoloader --no-interaction
composer show --installed | head
شغّلوه بمستخدم التطبيق لا root. وخذوا نسخة احتياطية قبل النشر؛ راجعوا دليل النسخ الاحتياطي.
٤. افحصوا وتحققوا
افحصوا الثغرات المعروفة وتأكدوا أن التطبيق يُحمَّل:
composer audit
composer outdated --direct
php -r 'require "vendor/autoload.php"; echo "autoload ok\n";'
إن فشل شيء بعد النشر فاقرؤوا سجل الأخطاء؛ ولسجلات الخدمات راجعوا دليل journalctl.
٥. أخطاء يجب تجنبها
تجعل هذه العادات النشر غير متوقع:
composer update on the production server # installs versions nobody tested
Running composer as root # creates root-owned files
vendor/ folder served from the web root # exposes library code and files
No composer.lock in git # every deploy can differ
أبقوا مجلد vendor خارج جذر الويب العام حين يسمح إطار العمل.
٦. مثال توضيحي وليس قياساً حقيقياً
افترضوا تطبيق PHP صغيراً (مختلقاً) يعمل محلياً لكنه يتعطل على الخادم بعد النشر. نفّذ الخادم composer update وجلب إصداراً أحدث من مكتبة يحتاج PHP أحدث. بعد الالتزام بـ composer.lock وتحويل النشر إلى composer install يثبّت الخادم الإصدارات المختبرة بالضبط.
٧. أخطاء شائعة
- تشغيل composer update في الإنتاج.
- عدم الالتزام بـ composer.lock.
- استخدام إصدار PHP CLI خاطئ.
- تشغيل Composer بـ root.
- تثبيت حزم التطوير على الخادم.
- كشف vendor في جذر الويب.
٨. أسئلة شائعة
install أم update؟ استخدموا update على جهاز التطوير وinstall على الخادم.
هل ألتزم بـ vendor؟ عادة لا؛ التزموا بـ composer.json وcomposer.lock.
ماذا يفعل –no-dev؟ يتخطى الحزم المدرجة تحت require-dev.
هل يمكن في استضافة مشتركة؟ فقط إن وفرت الاستضافة صدفة أو أداة نشر.
٩. قائمة تحقق سريعة
- افحصوا إصدار PHP CLI.
- حدّثوا على جهاز التطوير.
- التزموا بملف القفل.
- استخدموا composer install على الخادم.
- استخدموا –no-dev.
- نفّذوا composer audit.
- اختبروا التطبيق.
إذا احتجتم إلى مساعدة في مراجعة الأداء أو صيانة الخادم، فراجعوا خدمات إدارة الخوادم.
تجدون المزيد من أدلة الخوادم وووردبريس في أرشيف المقالات.
المراجع الرسمية
Composer: Basic usage · Composer: install command · Composer: composer.lock · Composer: Autoloader optimization
