ملف .htaccess في ووردبريس هو ملف إعدادات على مستوى المجلد تستخدمه خوادم Apache، وتستفيد منه ووردبريس أساسًا في قواعد الروابط الدائمة. يمكن أيضًا أن تضيف بعض إضافات الكاش والأمان قواعد خاصة بها، لذلك أي تعديل يدوي يجب أن يتم بحذر وبعد أخذ نسخة احتياطية.
ما هو ملف .htaccess؟
بحسب توثيق Apache، ملفات .htaccess تسمح بتطبيق إعدادات على مجلد محدد والمجلدات الفرعية دون تعديل ملف إعدادات الخادم الرئيسي. السماح بهذه القواعد يعتمد على إعدادات الخادم مثل AllowOverride.
في ووردبريس، الاستخدام الأشهر هو قواعد Rewrite التي تجعل الروابط الدائمة تعمل بصورة نظيفة بدل الاعتماد على روابط Query String.
هل كل خوادم ووردبريس تستخدم .htaccess؟
لا. الملف مرتبط أساسًا بخوادم Apache والبيئات المتوافقة مع قواعده. خادم Nginx لا يستخدم .htaccess بالطريقة نفسها، بل توضع قواعد Rewrite في إعدادات الخادم. لذلك لا تنسخ كود .htaccess إلى خادم مختلف وتتوقع أن يعمل.
أين يوجد ملف .htaccess؟
في تثبيت ووردبريس المعتاد على Apache ستجده في مجلد الموقع الذي يحتوي على wp-admin وwp-content وwp-includes. يبدأ اسمه بنقطة، لذلك قد يكون مخفيًا في File Manager أو SFTP Client حتى تفعّل عرض الملفات المخفية.
قبل تعديل .htaccess
- نزّل نسخة من الملف الحالي إلى جهازك.
- تأكد أن لديك طريقة بديلة للوصول إلى الملفات إذا أدى الخطأ إلى 500 Error.
- لا تعدّل الملف من خلال كود مجهول المصدر.
- نفّذ تغييرًا واحدًا في كل مرة واختبر الموقع بعده.
- لا تمسح قواعد Plugin أو WordPress دون معرفة من أنشأها.
قواعد ووردبريس الأساسية
ووردبريس قد يكتب قواعده بين التعليقين # BEGIN WordPress و# END WordPress. هذا الجزء يمكن أن تعيد ووردبريس توليده عند تحديث إعدادات Rewrite، لذلك لا تعتمد على وضع قواعد مخصصة داخله إذا كنت تريد الاحتفاظ بها.
للحصول على القواعد الصحيحة لإصدارك وبنيتك، استخدم المرجع الرسمي: WordPress Apache/.htaccess Documentation. لا تنسخ قواعد Multisite إلى موقع Single Site أو العكس.
إعادة إنشاء قواعد الروابط الدائمة
إذا تعطلت Pretty Permalinks بعد تغيير أو استعادة ملف .htaccess، راجع الإعدادات ← الروابط الدائمة. زيارة شاشة Permalinks تؤدي إلى Flush لقواعد Rewrite في ووردبريس، وإذا كان الملف قابلًا للكتابة يمكن للنظام تحديث القواعد المطلوبة.
لا تغيّر بنية الروابط الدائمة في موقع منشور فقط لإجبار Rewrite على العمل؛ تغيير URLs قد يخلق 404 وRedirects غير ضرورية. المطلوب هو إصلاح القواعد، وليس إعادة تسمية المحتوى.
لماذا يظهر 500 Internal Server Error بعد تعديل .htaccess؟
أكثر الأسباب شيوعًا هي Directive غير مدعومة، خطأ نحوي، Module غير متاح، أو قاعدة Rewrite تسبب Loop. إذا ظهر الخطأ مباشرة بعد التعديل:
- استعد النسخة السابقة من الملف.
- تأكد أن الموقع عاد للعمل.
- راجع Error Log.
- اختبر القاعدة الجديدة في Staging أو اسأل مزود الاستضافة عن دعمها.
استخدام Redirects داخل .htaccess
يمكن استخدام mod_rewrite أو Redirect في Apache، لكن إدارة Redirects الكثيرة يدويًا داخل الملف قد تصبح صعبة. إذا كان الموقع يستخدم Plugin SEO أو Redirect Manager موثوقًا، حافظ على مصدر واحد لإدارة التحويلات قدر الإمكان.
لا تنشئ Redirect لكل URL بدون سبب. استخدم 301 عندما انتقل المحتوى بصورة دائمة إلى عنوان بديل حقيقي، وتجنب Chains مثل A → B → C؛ الأفضل أن يشير A مباشرة إلى C عندما يكون ذلك صحيحًا.
منع Hotlinking للصور
يمكن بناء قواعد لمنع مواقع أخرى من تضمين ملفاتك، لكن Hotlink Protection قد يكسر تطبيقات أو CDN أو Google Images أو خدمات مسموحًا لها بالوصول إلى الصور إذا كتبت القاعدة بصورة واسعة. استخدم إعداد الاستضافة أو CDN عندما يوفران تحكمًا واضحًا، واختبر قبل التطبيق على موقع حي.
حماية ملفات حساسة
بعض قواعد Apache يمكنها تقييد الوصول إلى ملفات معينة، لكن يجب تنفيذها وفق توثيق الخادم لأن Syntax يختلف بين الإصدارات والبنى. لا تعتمد على Snippet قديم من الإنترنت في ملف يتحكم في الوصول للموقع بالكامل.
هل تغيير .htaccess يسرّع ووردبريس؟
ليست كل «أكواد التسريع» مناسبة لكل خادم. ضغط المحتوى وBrowser Caching وHeaders قد تتم إدارتها أصلًا بواسطة الخادم أو CDN أو LiteSpeed/Cache Plugin. تكرار القواعد في أكثر من طبقة يمكن أن يؤدي إلى تعارض أو إعدادات غير متوقعة.
ملف .htaccess وملفات الكاش
بعض إضافات الكاش تكتب قواعد داخل .htaccess لتقديم الملفات المخزنة أو تفعيل الضغط والكاش. إذا حذفت هذه القواعد يدويًا قد تتوقف وظيفة الإضافة حتى تعيد حفظ إعداداتها. قبل التنظيف حدد Owner لكل Block داخل الملف.
متى لا تستخدم .htaccess؟
- عندما يعمل الخادم على Nginx ولا يقرأ الملف.
- عندما تستطيع تنفيذ الإعداد من لوحة الخادم أو CDN بطريقة أوضح.
- عندما لا تعرف وظيفة الكود الذي ستضيفه.
- عندما تكون المشكلة في WordPress أو Plugin وليست في Apache Rewrite.
- عندما سيؤدي التعديل إلى تكرار قاعدة موجودة بالفعل.
طريقة آمنة لاختبار أي تعديل
- سجل الوضع الحالي والصفحات المهمة.
- احفظ نسخة من .htaccess.
- أضف أقل تغيير ممكن.
- اختبر الصفحة الرئيسية وwp-admin والروابط الداخلية وREST وCheckout إن كان متجرًا.
- راجع Logs وHTTP status.
- إذا ظهر Regression استعد الملف السابق فورًا.
أسئلة شائعة
هل يمكن حذف .htaccess؟
قد يعمل الموقع أو يمكن لووردبريس إعادة إنشاء قواعد أساسية في بعض البيئات، لكن حذف الملف عشوائيًا قد يمسح قواعد أمان أو كاش أو Redirects أضافتها أنظمة أخرى. اعرف محتواه وخذ Backup أولًا.
هل .htaccess موجود في Nginx؟
Nginx لا يعتمد على ملفات .htaccess لكل مجلد؛ إعداداته تدار في ملفات Configuration الخاصة بالخادم.
أين أضع القواعد المخصصة؟
تجنب وضع قواعد مخصصة داخل Block تديره ووردبريس أو Plugin إذا كان هذا النظام يعيد توليده. استخدم مكانًا موثقًا ولا تكرر نفس القاعدة في أكثر من أداة.
الخلاصة
شرح ملف htaccess في ووردبريس يبدأ بفهم أنه ملف إعداد خادم وليس ملفًا عاديًا داخل القالب. وظيفته الأشهر هي Rewrite للروابط الدائمة، لكنه قد يحمل أيضًا قواعد إضافات وRedirects وحماية. عدّله بأقل تغيير ممكن، مع Backup وLogs واختبار فوري، ولا تستخدمه أصلًا إذا كانت بنية الخادم لا تعتمد عليه.
