تعديل الملفات عبر FTP يصعّب معرفة من غيّر ماذا وكيف يُتراجع عن خطأ. يستطيع cPanel الاحتفاظ بمستودع Git على الحساب ونسخ ملفات مختارة إلى جذر الويب بملف نشر صغير. سير العمل بسيط: أودعوا واختبروا في مكان آخر ثم ادفعوا وحدّثوا من المصدر البعيد وانشروا. أسماء القوائم من معرفتي بـ cPanel وقد تختلف بحسب الإصدار أو الاستضافة؛ لم أنفذ هذه الخطوات على حسابكم.
١. جهّزوا المستودع
احتفظوا بالشيفرة في Git وأبقوا الأسرار وبيانات المستخدمين خارجه. أضيفوا .gitignore قبل أول إيداع:
cat .gitignore
wp-config.php
.env
wp-content/uploads/
wp-content/cache/
node_modules/
vendor/
خذوا نسخة احتياطية للموقع الحي قبل أول نشر؛ راجعوا دليل النسخ الاحتياطي في cPanel.
٢. صِفوا النشر
يقرأ cPanel ملف .cpanel.yml في جذر المستودع وينفذ مهامه عند النشر. انسخوا فقط ما يجب أن يكون في جذر الويب:
# In the repository root: .cpanel.yml
---
deployment:
tasks:
- export DEPLOYPATH=/home/CPANELUSER/public_html/
- /bin/cp -R public/* $DEPLOYPATH
# Never commit wp-config.php, .env or uploads
استبدلوا اسم الحساب والمسارات بما يخصكم واختبروا أولاً على نطاق فرعي staging؛ وللروتينات المرتبطة راجعوا قائمة الصيانة الشهرية.
٣. ادفعوا وانشروا
ادفعوا إلى المصدر البعيد الذي يديره cPanel ثم استخدموا اللوحة للتحديث من المصدر ونشر آخر إيداع:
git status
git log --oneline -n 5
git push origin main
# After a push, use the panel's Update from Remote, then Deploy HEAD Commit
افحصوا الموقع بعدها. وإن ظهرت أخطاء فاقرؤوا السجلات؛ ولمشاكل القواعد الشائعة راجعوا دليل .htaccess.
٤. تراجعوا بأمان
إن عطّل النشر الموقع فاعكسوا الإيداع السيئ وانشروا من جديد مما يُبقي السجل واضحاً:
# Roll back to a known good commit and deploy again
git revert <bad-commit-hash>
git push origin main
# or deploy an earlier commit after checking it out in the repository
git log --oneline -n 10
لا يتراجع Git عن تغييرات قاعدة البيانات فاستعيدوا نسخة القاعدة منفصلة عند الحاجة.
٥. أخطاء يجب تجنبها
تسبب هذه الأخطاء مشاكل:
Committing wp-config.php or .env # secrets end up in history
Deploying straight from a messy working copy # untested code reaches the site
Using cp -R with --delete style rules by guess # may overwrite uploads or user data
No backup before the first deploy # nothing to return to
استخدموا مفاتيح SSH للمصدر البعيد ولا تلصقوا رموزاً أو كلمات مرور في محادثة أو تذكرة.
٦. مثال توضيحي وليس قياساً حقيقياً
افترضوا موقع شركة صغيرة (مختلقاً) يعدله شخصان عبر FTP ويكتب أحدهما أحياناً فوق عمل الآخر. بعد نقل ملفات القالب إلى مستودع مع .cpanel.yml صار لكل تغيير رسالة إيداع ويُتراجع عن نشر معطوب بعكس إيداع واحد لا بالبحث عن الملف القديم.
٧. أخطاء شائعة
- إيداع الأسرار.
- نشر شيفرة غير مختبرة.
- النسخ فوق الرفع أو بيانات المستخدمين.
- عدم النسخ الاحتياطي قبل أول نشر.
- تعديل الملفات مباشرة على الخادم بعد ذلك.
- لصق الرموز في التذاكر.
٨. أسئلة شائعة
هل يعيد Git قاعدة البيانات؟ لا، الملفات فقط.
هل أنشر فرعاً معيناً؟ نعم إن استخرجتم ذلك الفرع في المستودع لكن أبقوا الإنتاج على فرع مستقر.
هل أحتاج SSH؟ للمصادر الخاصة يكون الوصول بالمفاتيح هو الأسلوب الآمن.
هل هو متاح في كل استضافة؟ لا؛ يعتمد على إصدار cPanel وإعدادات الاستضافة.
٩. قائمة تحقق سريعة
- أنشئوا .gitignore.
- أبعدوا الأسرار.
- اكتبوا .cpanel.yml.
- انسخوا احتياطياً أولاً.
- ادفعوا وحدّثوا من المصدر.
- انشروا واختبروا.
- اعكسوا عند الحاجة.
إذا احتجتم إلى مساعدة في مراجعة الأداء أو صيانة الخادم، فراجعوا خدمات إدارة الخوادم.
تجدون المزيد من أدلة الخوادم وووردبريس في أرشيف المقالات.
المراجع الرسمية
cPanel: Git Version Control · cPanel: Guide to Git Deployment · Git: git pull · Git: gitignore
