EN
01

ما الذي تقدمه

معرفة مكان تعريف دالة ما، أو الإضافة التي تحمّل سكربتًا بعينه، أو التحقق من وجود نص حذّرك منه أحدهم داخل الإضافات أو القالب، أمر يتطلب عادةً اتصال FTP أو SSH وسطر أوامر. تنقل File Scan Code Search هذا البحث إلى داخل ووردبريس، في شاشة إدارة واحدة ضمن Tools → File Scan.

أنت من يحدد نطاق البحث: مجلد ووردبريس بالكامل، أو wp-content، أو كل الإضافات، أو إضافة واحدة أو قالب واحد، أو مجلد الرفع، أو مجلدًا تكتب مساره بنفسك. وتحدد كذلك أنواع الملفات المقروءة (PHP وJavaScript وCSS افتراضيًا)، وهل يكون البحث بنص عادي أم بتعبير نمطي (Regex). وتعود كل نتيجة بمسار ملفها ورقم سطرها والسطر نفسه مع تمييز الجزء المطابق، ويمكن تحميل القائمة بصيغة CSV أو JSON.

هي أداة بحث وليست ماسحًا للبرمجيات الخبيثة: لا تحمل قائمة بتهديدات معروفة، ولا تحكم على ما تجده؛ أنت من يقرر عمّا يبحث. ولا تكتب شيئًا في أي ملف أو في قاعدة البيانات، وتبقى المجلدات الواقعة خارج ووردبريس مقفلة حتى تفتحها من wp-config.php.

  • للقراءة فقط
  • نص عادي أو Regex
  • تصدير CSV · JSON
  • للمديرين فقط
  • لا تخزّن شيئًا
02

التثبيت

  1. حمّل ملف ZIP.
  2. في ووردبريس افتح Plugins → Add Plugin (واسمها Add New Plugin أو Add New في الإصدارات الأقدم)، واضغط Upload Plugin، واختر الملف، ثم Install Now، ثم Activate Plugin.
  3. افتح Tools → File Scan. ويفتح رابط Settings الظاهر أسفل اسم الإضافة في شاشة الإضافات الشاشةَ نفسها.

لا يلزم أي إعداد قبل أول بحث، فالإضافة لا تحفظ إعدادات خاصة بها. ولا يفتح الشاشة إلا من يملك صلاحية manage_options (المديرون افتراضيًا). نشر الإضافة على wordpress.org مُخطط له، وتُثبَّت حاليًا من ملف ZIP المتاح في هذه الصفحة.

03

طريقة الاستخدام

يجري كل شيء في شاشة واحدة، Tools → File Scan، وفيها ثلاثة تبويبات: Search للبحث نفسه، وAdvanced وفيه سطر wp-config.php الذي يفتح المجلدات الواقعة خارج ووردبريس (بالإنجليزية والعربية والفرنسية والإسبانية)، وHelp وفيه نصائح مختصرة. لا يوجد رمز قصير (Shortcode) ولا مكوّن ولا ودجت، ولا يُضاف شيء إلى واجهة الموقع العامة.

  1. في تبويب Search اكتب ما تبحث عنه في Search Text، كاسم دالة أو base64_decode.
  2. اختر Directory. كلما ضاق المجلد كان البحث أسرع وأشمل، لذا فإن خيارًا واحدًا مثل Plugin: … أو Theme: … أفضل من Plugins أو WordPress root.
  3. راجع File Extensions (القيمة الافتراضية php,js,css). أضف امتدادات أخرى مثل html أو txt أو json، أو htaccess لقراءة ملفات .htaccess.
  4. اترك Max depth على 0 للبحث في كل المجلدات الفرعية، أو أدخل رقمًا يحدد عدد مستويات المجلدات الفرعية التي يشملها البحث تحت المجلد المختار: القيمة 1 تضيف المجلدات الموجودة مباشرة بداخله، والقيمة 2 تضيف أيضًا ما بداخل تلك المجلدات، وهكذا (انظر الإعدادات). فعّل Case sensitive أو Regex عند الحاجة، ثم اضغط Search.
  5. انتظر النتيجة. يجري البحث كله في طلب واحد قد يستغرق نحو 20 ثانية (و60 ثانية مع WordPress root وSite home)، والشريط الظاهر على الشاشة لا يقيس التقدم الفعلي. تظهر النتائج في جدول بأعمدة File Path وLine وSnippet، وإن لم توجد نتائج تظهر نافذة منبثقة تقول «No matches found».
  6. اضغط CSV أو JSON فوق الجدول لتحميل النتائج. لا يُحفظ شيء، فمغادرة الصفحة تمحو النتائج. والمقتطف المُصدَّر هو نسخة HTML المميَّزة، لذا يحتوي على وسوم <mark> ورموز HTML مثل &quot;.

خيار المجلدنطاق البحث

WordPress root · Site home
المجلد المثبَّت فيه ووردبريس، والمجلد الرئيسي لموقعك. وهما المجلد نفسه ما لم يكن ووردبريس داخل مجلد فرعي. ولكليهما حدود أعلى (انظر الإعدادات).
wp-admin · wp-includes
مجلدات نواة ووردبريس.
wp-content · Plugins · Must-use plugins · Themes · Uploads · Languages
مجلدات المحتوى المعتادة.
Plugin: … · Theme: …
خيار لكل مجلد إضافة وكل مجلد قالب، لأول 50 من كل منهما بالترتيب الأبجدي. والإضافة المكوَّنة من ملف واحد لا يظهر لها خيار مستقل، ويشملها خيار Plugins.
Active theme · Parent theme
القالب الذي يستخدمه موقعك، وقالبه الأب إن كان قالبًا فرعيًا.
خيارات (advanced)
المجلد الأعلى من ووردبريس (Account root)، وما يصل إلى خمسة مجلدات يسمح بها إعداد open_basedir على الخادم، ومجلد الملفات المؤقتة للنظام، وجذر الخادم، و/home و/var/www و/var و/tmp حيث وُجدت. تظهر في القائمة باهتة حتى يُفعَّل الوضع المتقدم.
Custom path (below)
يفتح خانة لمجلد تكتب مساره بنفسك. انظر الإعدادات لمعرفة ما تقبله.

يعرض كل خيار عدا Custom path مساره الكامل على الخادم، ولا تظهر أغلب الخيارات إلا إذا كان مجلدها موجودًا. ويشمل البحث كل المجلدات الفرعية للمجلد المختار (أو ما يسمح به Max depth من مستويات)، باستثناء المجلدات التي هي روابط رمزية (Symbolic links) والمجلدات التي لا تستطيع PHP فتحها.

04

الإعدادات

لا تحفظ الإضافة أي إعدادات. تُضبط كل عملية بحث من النموذج، وهناك سطر اختياري واحد في wp-config.php يفتح المجلدات الواقعة خارج ووردبريس، أما الحدود فثابتة في الكود.

الإعدادالقيمة الافتراضية

Search Text
حقل إلزامي بلا قيمة افتراضية. نص عادي، أو نمط عند تفعيل Regex. ويُنظَّف قبل البحث كأي مُدخل في نموذج: تُحذف وسوم HTML، فلا يعثر بحث يحتوي على < (مثل <?php أو <script) على ذلك النص في الكود، وتتحول علامات الجدولة والمسافات المتكررة إلى مسافة واحدة، وتُحذف الرموز المبدوءة بعلامة % مثل %20.
Directory
WordPress root. أي خيار مفعَّل من القائمة السابقة، أو Custom path (below).
Custom path
فارغ. مجلد موجود داخل مجلد موقعك، وإن كتبت مسار ملف بحثت الإضافة في المجلد الذي يحتويه. ودون الوضع المتقدم يُرفض المجلد الأعلى لموقعك نفسه (أو ملف موجود فيه مباشرة)، فاستخدم له WordPress root أو Site home. وتسري على المسارات المخصصة الحدود القياسية.
File Extensions
php,js,css، وتُستخدم أيضًا إذا تُركت الخانة فارغة. قائمة مفصولة بفواصل دون نقاط، بأي حالة أحرف. لا يُقرأ الملف إلا إذا انتهى اسمه بأحدها: فـmin.js تعمل، وhtaccess تعثر على ملفات .htaccess، أما الملفات التي بلا امتداد فلا يمكن البحث فيها.
Max depth
0، أي البحث في كل المجلدات الفرعية. والرقم من 1 إلى 100 يحدد عدد مستويات المجلدات الفرعية التي يشملها البحث تحت المجلد المختار: 1 يضيف المجلدات الموجودة مباشرة بداخله، و2 يضيف ما بداخلها أيضًا، وهكذا. ولا تُقرأ الملفات الأعمق، فالرقم الأصغر يُسرّع البحث في المجلدات العميقة.
Case sensitive
غير مفعَّل. عند تفعيله يجب أن تتطابق الأحرف الكبيرة والصغيرة تمامًا، في النص العادي وفي وضع Regex.
Regex
غير مفعَّل. عند تفعيله يصبح Search Text تعبيرًا نمطيًا بصيغة PHP (PCRE) دون محددات، مثل eval\s*\(. اكتب الشرطات المائلة كما هي، فالإضافة تتولى تهريبها. والنمط غير الصالح يوقف البحث برسالة «Invalid regex pattern». ويُختبر كل سطر على حدة، فلا يمكن للنمط أن يمتد عبر أكثر من سطر.
الوضع المتقدم
غير مفعَّل. أضف define( 'FSC_ALLOW_OUTSIDE_WP', true ); إلى wp-config.php فوق سطر «stop editing» لتفعيل خيارات (advanced) والمسارات المخصصة خارج موقعك. ويجب أن تبقى المسارات الخارجية المكتوبة مجلدات قابلة للقراءة، وداخل مجلدات open_basedir إن كان الخادم يحددها. تُتخطى المجلدات الفرعية التي لا تستطيع PHP فتحها، وإن تعذر فتح المجلد المختار نفسه توقف البحث برسالة تفيد بأن المجلد غير قابل للقراءة. ولا تكتب الإضافة هذا السطر بنفسها أبدًا، واحذفه لتعيد قفل تلك المجلدات.
الحدود (ثابتة)
800 نتيجة لكل بحث. ويتوقف البحث كذلك بعد 12,000 ملف ومجلد أو 20 ثانية، أيهما أسبق، وترتفع الحدود مع WordPress root وSite home إلى 60,000 و60 ثانية. وتُتخطى الملفات الأكبر من 1 MB. لا يوجد خيار لتغيير هذه الحدود، ولا تُنبهك الشاشة إذا قطع أحدها البحث.
05

آلية العمل

  1. عند فتح الشاشة يبني الخادم قائمة بالمواقع التي يعثر عليها: مجلدات ووردبريس، وما يصل إلى 50 مجلد إضافة و50 مجلد قالب، ومجلدات الخادم (advanced) التي تبقى معطلة حتى توافق على فتحها.
  2. الضغط على Search يرسل طلبًا واحدًا إلى ووردبريس (admin-ajax.php) يحمل النص ومعرّف الموقع المختار والخيارات ورمز أمان.
  3. يتحقق الخادم من الطلب (انظر ضمانات الأمان)، ويأخذ مسار المجلد من قائمته هو لا من المتصفح. أما المسار المخصص فيُتحقق منه أولًا.
  4. يتنقل في المجلد ومجلداته الفرعية، كلها أو بقدر ما يسمح به Max depth، دون الدخول إلى المجلدات التي هي روابط رمزية. ويقرأ كل ملف ينتهي اسمه بأحد الامتدادات المحددة وحجمه 1 MB أو أقل، ويفحصه سطرًا سطرًا. وتُتخطى المجلدات والملفات التي لا تستطيع PHP فتحها، وإن تعذر فتح المجلد المختار نفسه توقف البحث برسالة «This directory cannot be read. Check that it exists and that PHP has permission to read it.»
  5. عند بلوغ 800 نتيجة، أو 12,000 ملف ومجلد، أو 20 ثانية (60,000 و60 ثانية مع WordPress root وSite home) يتوقف ويعيد ما وجده حتى تلك اللحظة.
  6. تعود كل نتيجة بمسارها (نسبةً إلى مجلد ووردبريس إن كانت داخله) ورقم سطرها والسطر نفسه، مُهرَّبًا للعرض مع تمييز الجزء المطابق. ويُضاف التمييز بعد التهريب، لذا فالنتيجة التي تحتوي على علامة اقتباس أو & أو < أو > تظهر في القائمة دون تمييز. ويُبنى الجدول وملفا CSV وJSON داخل متصفحك، ولا يُحفظ شيء على الخادم.
06

ضمانات الأمان

  • للمديرين فقط. لا تحمّل الإضافة كود البحث إلا داخل لوحة التحكم، وتتطلب الشاشة وكل عملية بحث صلاحية manage_options. ولا توجد أي نقطة وصول للزوار غير المسجلين.
  • كل بحث موثَّق. يحمل كل طلب رمز nonce من ووردبريس يُتحقق منه قبل أي شيء آخر، وكل قيمة قادمة من المتصفح تُنقّى قبل استخدامها.
  • الخادم هو من يحدد المجلد. لا يرسل المتصفح إلا معرّف الموقع، ويأخذ الخادم المسار من قائمته. والمسار المكتوب يُحوَّل أولًا إلى موقعه الحقيقي، فلا يمكن لـ../ الخروج منه، ويجب أن يقع داخل مجلد موقعك.
  • ما خارج ووردبريس مغلق افتراضيًا. تظهر مجلدات الخادم باهتة وتُرفض، وتُرفض المسارات المخصصة الواقعة خارج موقعك، حتى تضيف سطر wp-config.php. وحتى بعدها يجب أن يكون المسار الخارجي المكتوب مجلدًا قابلًا للقراءة ضمن حدود open_basedir إن كان الخادم يحددها.
  • للقراءة فقط. تُقرأ الملفات فحسب، وليس في الإضافة كود يكتب ملفًا أو يعيد تسميته أو يحذفه، ولا تخزّن شيئًا في قاعدة البيانات.
  • عرض آمن للنتائج. يُهرَّب كل سطر بصيغة HTML قبل تمييز النتيجة، وتُدرج مسارات الملفات نصًا عاديًا، فالكود الموجود في الملف يُعرض ولا يُنفَّذ في متصفحك أبدًا.
  • حدود صارمة. الحدود المفروضة على النتائج والملفات والوقت، وتخطي الملفات الأكبر من 1 MB، تمنع أي بحث من الاستمرار بلا نهاية.
  • اعرف ما يمكن أن تكشفه. كل من يفتح الشاشة يستطيع عرض أي سطر من أي ملف يصل إليه البحث. وخيار WordPress root يشمل عادةً wp-config.php بما فيه كلمة مرور قاعدة البيانات ومفاتيح الأمان، فاقصر حسابات المديرين على من تثق بهم. وفي الشبكات متعددة المواقع (Multisite) يشمل ذلك مديري كل موقع تعمل عليه الإضافة.
07

للمطورين

  • الفلتر file_scan_code_search_detected_locations: يستقبل قائمة المواقع مفهرسة بالمعرّف، وكل عنصر فيها بالشكل ['label' => string, 'path' => string, 'enabled' => bool]. يعمل عند بناء الشاشة ومرة أخرى حين تحدد كل عملية بحث مجلدها، لذا يمكن البحث في أي عنصر تضيفه أو تفعّله هنا. استخدم معرّفات بأحرف صغيرة (حروف وأرقام و_ و-)، لأن المعرّف العائد من المتصفح يمر عبر sanitize_key(). والعنصر المفعَّل هنا يمكن البحث فيه حتى دون FSC_ALLOW_OUTSIDE_WP، وتسري عليه الحدود القياسية.
  • تُرسل عمليات البحث إلى admin-ajax.php بالإجراء fsc_search_code، للمستخدمين المسجلين فقط، ويُتحقق منها مقابل إجراء nonce fsc_admin_nonce. ويرد البحث بـwp_send_json_success() مع قائمة من {file, line, snippet}، أو بـwp_send_json_error() مع رسالة، أما فشل التحقق من nonce فيعيد -1 مع رمز HTTP 403.
  • لا يُحمَّل ملف CSS والسكربت المبني على jQuery إلا في شاشة الإضافة نفسها (tools_page_file-scan-code-search).
  • التخزين: لا شيء. لا خيارات ولا Transients ولا جداول مخصصة ولا Meta ولا مهام Cron ولا ملفات. وليس لدى uninstall.php ما يحذفه، فحذف الإضافة لا يترك أثرًا سوى سطر wp-config.php إن كنت أضفته.
  • النصوص القابلة للترجمة تستخدم نطاق الترجمة file-scan-code-search. أما النوافذ المنبثقة في المتصفح («No matches found» و«AJAX error») فمكتوبة بالإنجليزية داخل الكود.
08

أسئلة شائعة

هل تعدّل أي ملفات أو تحذفها؟

لا. تفتح الملفات لقراءتها فقط، وليس فيها كود يكتب ملفًا أو يعيد تسميته أو يحذفه، ولا تكتب شيئًا في قاعدة البيانات.

هل هي ماسح للبرمجيات الخبيثة؟

لا. لا تحمل قائمة ببرمجيات خبيثة معروفة، ولا تقيّم ما تجده. لكنها تساعدك أثناء تنظيف الموقع على البحث عن نص أُعطي لك، كنطاق مشبوه أو دالة مثل base64_decode، إضافةً تلو أخرى أو عبر مجلد كامل، وتعرض لك الملفات والأسطر بدقة. أما الحكم على خطورة النتيجة فيعود إليك.

لماذا تظهر «No matches found» وأنا متأكد من وجود النص؟

غالبًا لأحد هذه الأسباب: امتداد الملف ليس ضمن File Extensions، أو حجم الملف يتجاوز 1 MB، أو النص موزع على سطرين، أو الملف أعمق مما يسمح به Max depth أو داخل مجلد هو رابط رمزي أو لا تستطيع PHP فتحه، أو أن تنظيف المُدخلات غيّر نص البحث (انظر السؤال التالي والإعدادات)، أو أن المجلد كبير لدرجة أن البحث بلغ أحد حدوده (انظر الإعدادات) قبل الوصول إلى الملف. ولا تُنبهك الشاشة عند بلوغ أي حد، فاختر Directory أضيق، كإضافة واحدة، وأعد البحث.

لماذا لا يعثر البحث عن <?php أو <script على شيء؟

يُنظَّف نص البحث كأي مُدخل في نموذج: تُحذف وسوم HTML، وتتحول علامة < المنفردة إلى الرمز &lt;، فيفقد البحث تلك العلامة. ابحث دونها (script src)، أو فعّل Regex واكتب العلامة بالصيغة \x3c، فـ\x3cscript يعثر على <script.

هل تبطئ موقعي؟

لا بالنسبة إلى الزوار، فخارج لوحة التحكم لا ترتبط بأي شيء ولا تحمّل سكربتات أو أنماطًا. وعملية البحث تُشغل عملية PHP واحدة حتى تنتهي، لمدة تصل إلى نحو 20 ثانية، أو 60 ثانية مع WordPress root وSite home. وبعض الخوادم توقف الطلبات الطويلة قبل ذلك، فتظهر رسالة «AJAX error»، وعندها ابحث في مجلد أصغر.

تحميل File Scan Code Search الإصدار 1.0.5