عرض مصدر PHP/pattern modifiers

<noinclude>{{DISPLAYTITLE:مُعدِّلات النمط Pattern Modifiers‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎}}</noinclude>
فيما يلي مُعدِّلات PCRE الحالية الممكنة. وتشير الأسماء الموجودة بين قوسين إلى أسماء PCRE الداخلية لها. وتُتَجاهل المسافات والسطور الجديدة في المعدّلات، بينما تتسبب الأحرف الأخرى في حدوث خطأ.

== <code>i (PCRE_CASELESS)‎</code> ==
إذا ضُبِط هذا المُعدِّل، تتطابق الحروف في النمط مع الحروف الكبيرة والصغيرة.

== <code>m (PCRE_MULTILINE)‎</code> ==
تعامل PCRE سلسلةَ الهدف افتراضيًا كما لو كانت مكونة من "سطر" واحد من الحروف (حتى إذا كان يحتوي بالفعل على عدة سطور جديدة). ويتطابق الحرف الخاص "بداية السطر" ورمزه <code>^</code> فقط في بداية السلسلة النصية، بينما يتطابق الحرف الخاص "نهاية السطر" ورمزه <code>$</code> فقط في نهايتها، أو قبل نهاية سطر جديد (إلا إذا ضُبِط المُعدّل <code>D</code>). وهو نفسه ما يحدث مع Perl. وإذا ضُبِط هذا المُعدِّل، تتطابق الصيغتان "بداية السطر" و "نهاية السطر" مباشرة بعد أو مباشرة قبل أي سطر جديد في سلسلة الهدف على التوالي، وكذلك في البداية والنهاية. ويعادل هذا المُعدِّل <code>‎/m</code> في Perl. في حالة عدم وجود أحرف <code>"‎\n"</code> في السلسلة الهدف، أو عدم وجود <code>^</code> أو <code>$</code> في النمط، فإن إعدادات هذا المُعدِّل ليس لها أي تأثير.

== <code>s (PCRE_DOTALL)‎</code> ==
إذا ضُبِط هذا المُعدِّل، يتطابق حرف النقطة الخاص في النمط مع جميع الحروف، بما في ذلك السطور الجديدة. وبدونه، تُستبعد السطور الجديدة. ويكافئ هذا الُمعدِّل ‎<code>/s</code> في Perl. وتتطابق فئة سالبة مثل <code>‎[^a]</code>‎ دائمًا مع حرف السطر الجديد، بغض النظر عن إعدادات هذا المُعدّل.

== <code>x ( PCRE_EXTENDED )‎</code> ==
إذا ضُبِط هذا المُعدِّل، فستُتَجاهل أحرف المسافات البيضاء في النمط تمامًا إلا إذا هُرِّبت أو إذا كانت داخل فئة الحرف، وكذلك تُتَجاهل الأحرف بين رمز <code>#</code> غير المُهرَّب خارج فئة الحرف وحتى حرف السطر الجديد التالي له (ويكون مشتملًا عليه). ويكافئ مُعدّل <code>‎/x</code> في Perl، ويُسمح بتضمين تعليقات داخل الأنماط المعقدة. مع ذلك، لاحظ أن هذا ينطبق فقط على حروف البيانات. وقد لا تظهر الأحرف البيضاء في تسلسلات الحروف الخاصة في النمط، على سبيل المثال ضمن التسلسل <code>‎(?(‎</code> الذي يمثل نمطًا فرعيًا شرطيًا.

== <code>e (PREG_REPLACE_EVAL)‎</code> ==
تحذير: أُهمالت هذه الميزة في PHP 5.5.0، وأُزيلت بدءًا من PHP 7.0.0.

إذا ضُبِط هذا المُعدِّل المُهمل، تستبدل الدالة <code>[[PHP/preg replace|preg_replace()‎‎]]</code> المراجع الخلفية بشكل اعتيادي في سلسلة الاستبدال النصية، وتُقيّمه على أنه شفرة PHP، وتستخدم النتيجة لاستبدال سلسلة البحث. ستُهرَّب علامة الاقتباس المفردة وعلامة الاقتباس المزدوجة والشرطة المائلة العكسية (‎<code>\</code>) وحرف NULL بواسطة الشرطة المائلة العكسية في المراجع الخلفية البديلة.

تنبيه: تعمل الدالة <code>[[PHP/addslashes|addslashes()‎‎]]</code> على كل مرجع خلفي مطابق قبل حدوث الاستبدال. على هذا النحو، عند استخدام المرجع الخلفي كسلسلة مقتبسة، تتحول الحروف المُتجاهَلة إلى نفسها حرفيًا. ومع ذلك سوف تحتفظ الحروف المُهرَّبة والتي لا يجب تحويلها عادةً بشرطتها المائلة. الأمر الذي يجعل استخدام هذا المعدل معقدًا للغاية.

تنبيه

تأكد من أن <code>replacement</code> يشكل سلسلة صالحة لشيفرة PHP، وإلا سوف يشكو PHP من خطأ في التحليل في السطر الذي يحتوي على <code>[[PHP/preg replace|preg_replace()]]</code>‎‎.

تنبيه: استخدام هذا المُعدِّل غير مُحبَّذ، نظرًا لأنه قد يسبب ثغرات أمنية بسهولة:<syntaxhighlight lang="php-brief">
<?php
$html = $_POST['html'];

// uppercase headings
$html = preg_replace(
    '(<h([1-6])>(.*?)</h\1>)e',
    '"<h$1>" . strtoupper("$2") . "</h$1>"',
    $html
);
</syntaxhighlight>يمكن استغلال شيفرة المثال أعلاه بسهولة عن طريق تمرير لها سلسلة نصية مثل <code><nowiki><h1>{${eval($_GET[php_code])}}</h1></nowiki></code>. الأمر الذي يعطي المُهاجم القدرة على تنفيذ شيفرة PHP عشوائيًا، وعلى هذا النحو يتيح له الوصول الكامل تقريبًا لخادمك.

لمنع هذا النوع من ثغرات تنفيذ التعليمات البرمجية عن بُعد، يجب استخدام الدالة <code>[[PHP/preg replace callback|preg_replace_callback()‎‎]]</code> بدلاً من ذلك:<syntaxhighlight lang="php">
<?php
$html = $_POST['html'];

// uppercase headings
$html = preg_replace_callback(
    '(<h([1-6])>(.*?)</h\1>)',
    function ($m) {
        return "<h$m[1]>" . strtoupper($m[2]) . "</h$m[1]>";
    },
    $html
);
</syntaxhighlight>ملاحظة: فقط الدالة <code>[[PHP/preg replace|preg_replace()]]‎‎</code> تستخدم هذا المًعدِّل؛ بينما تتجاهلها دوال PCRE الأخرى.

== <code>A (PCRE_ANCHORED)‎</code> ==
إذا ضُبِط هذا المُعدِّل، سيُفرّض على النمط أن يكون "مُرتكِزًا"، أي أن يكون مقيَّدًا بحيث يتطابق فقط عند بداية السلسلة المراد البحث فيها ("السلسلة الهدف"). ويمكن تحقيق هذا التأثير أيضًا من خلال التركيبات المناسبة في النمط نفسه، وهو الطريقة الوحيدة لفعل ذلك في Perl.

== <code>D (PCRE_DOLLAR_ENDONLY)‎</code> ==
إذا ضُبِط هذا المُعدِّل، يتطابق الحرف الخاص <code>$</code> في النمط فقط في نهاية سلسلة الهدف. وبدون هذا المُعدِّل، يتطابق رمز $ أيضًا مباشرة قبل الحرف الأخير إذا كان السطر جديدًا (ولكن ليس قبل أي سطر جديد آخر). ويُتَجاهل هذا المُعدِّل إذا ضُبط المُعدِّل <code>m</code>. ولا يوجد ما يُكافئ هذا المعدل في Perl.

== <code>S</code> ==
عند استخدام نمطٍ ما عدة مرات، يجدر قضاء المزيد من الوقت في تحليله لتسريع الوقت الذي يستغرقه في المطابقة. إذا ضُبِط هذا المُعدِّل، فسيُجرِى هذا التحليل الإضافي. في الوقت الحالي، تعتبر دراسة النمط مفيدة فقط في حالة الأنماط غير المُرتَكزة التي لا تحتوي على حرف بداية ثابت واحد.

== <code>U (PCRE_UNGREEDY)‎</code> ==
يُغيّر هذا المُعدِّل من "جشع (greediness)" المُحدِدات الكَمّية بحيث لا تكون جشعة بشكل افتراضي، بل تصبح جشعة إذا تبعها الرمز <code>?.</code> وهو غير متوافق مع Perl. ويمكن أيضًا أن يحدد بواسطة [[PHP/regular expressions#.D8.A5.D8.B9.D8.AF.D8.A7.D8.AF.D8.A7.D8.AA .D8.A7.D9.84.D8.AE.D9.8A.D8.A7.D8.B1.D8.A7.D8.AA .D8.A7.D9.84.D8.AF.D8.A7.D8.AE.D9.84.D9.8A.D8.A9|إعدادات المُعدِّل في النمط]] ‎<code>(?U)</code>‎ أو علامة استفهام وراء مُحدِد الكمية (على سبيل المثال. <code>‎*?‎</code> ).

ملاحظة: عادة ما يكون غير ممكن مطابقة أكثر من عدد يساوي <code>[[PHP/pcre configuration#ini.pcre.backtrack limit|pcre.backtrack_limit]]</code> حرف في الوضع غير الجشع (ungreedy).

== <code>X (PCRE_EXTRA)‎</code> ==
يُفعِّل هذا المُعدِّل وظائف إضافية لـ PCRE غير المتوافقة مع Perl. وتتسبب أي شرطة مائلة عكسية في نمط يتبعه حرف ليس له معنىً خاصًا في حدوث خطأ، وبالتالي حجز هذه المجموعات للتوسعات المستقبلية. وبشكل افتراضي، وكما هو الحال في Perl، تُعامَل الشرطة المائلة العكسية المتبوعة بحرف بدون معنى خاص على أنه الحرف ذاته حرفيًا. ولا يتحكم هذا المُعدِّل حاليًا بأي ميزات أخرى.

== <code>J (PCRE_INFO_JCHANGED)‎</code> ==
ضبط الخيار ‎<code>(?J)</code>‎ يغير إعدادات الخيار الداخلي لخيار <code>PCRE_DUPNAMES</code> المحلي. يسمح بأسماء مكررة للأنماط الفرعية. واعتبارًا من PHP 7.2.0 يُدعم <code>J</code> كمُعدِّل أيضًا.

== <code>u (PCRE_UTF8)‎</code> ==
يُفعِّل هذا المُعدِّل وظائف إضافية لـ PCRE غير المتوافقة مع Perl. وتُعامل الأنماط وسلاسل الهدف على أنها UTF-8. ستؤدي سلسلة هدف غير صالحة إلى عدم تطابق الدالة <code>preg_*‎</code> مع أي شيء؛ وسيؤدي نمط غير صالح إلى حدوث خطأ بالمستوى <code>E_WARNING</code>. وتُعد التسلسلات خمسة و ستة الثُمانية من UTF-8 غير صالحة منذ PHP 5.3.4 ‎(resp. PCRE 7.3 2007-08-28)‎؛ وكانت تُعد سابقا كتسلسلات UTF-8 صالحة.

== مصادر ==
* [http://php.net/manual/en/reference.pcre.pattern.modifiers.php صفحة ‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎مُعدِّلات النمط لصياغة PCRE regex في توثيق PHP الرسمي].
[[تصنيف:PHP]]
[[تصنيف:PHP PCRE]]
[[تصنيف:PHP Regular Expressions]]