الدالة preg_replace() في PHP: الاستبدال بالتعابير النمطية

تجد preg_replace($pattern, $replacement, $subject) كل تطابق لتعبير نمطي في نص وتستبدله. تحوّل preg_replace('/\s+/', ' ', $text) كل سلسلة من المسافات وعلامات الجدولة والأسطر الجديدة إلى مسافة واحدة.

<?php
$text = "Too    many \t spaces\n\nand   lines";
echo preg_replace('/\s+/', ' ', $text), "\n";

// Remove every digit
echo preg_replace('/\d/', '', 'R2-D2 and C-3PO'), "\n";

// Case-insensitive, whole words only
echo preg_replace('/\bcat\b/i', 'dog', 'Cat, cats and a CAT.'), "\n";

لا يتغير النص الأصلي؛ تعيد preg_replace() نصًا جديدًا. ويحدد \b حد كلمة، ولهذا تُترك cats كما هي.

المراجع الخلفية: $1 و${1} و\1

في نص الاستبدال، يمثل $1 ما طابقته مجموعة الالتقاط الأولى، و$2 الثانية، و$0 التطابق كله. استخدمها لإعادة ترتيب النص المطابق.

<?php
// 2026-03-14 to 14/03/2026
echo preg_replace('/(\d{4})-(\d{2})-(\d{2})/', '$3/$2/$1', 'Due: 2026-03-14'), "\n";

// "Lovelace, Ada" to "Ada Lovelace"
echo preg_replace('/^(\w+), (\w+)$/', '$2 $1', 'Lovelace, Ada'), "\n";

// $0 is the whole match: wrap every number in brackets
echo preg_replace('/\d+/', '[$0]', 'Rooms 12 and 305'), "\n";

// ${1} when a digit follows the reference
echo preg_replace('/(\d+)/', '${1}0', 'Multiply 5 and 7 by ten'), "\n";

اكتب نص الاستبدال بين علامتي تنصيص مفردتين. داخل المزدوجتين يصبح "\1" تسلسل هروب ثمانيًا (البايت 0x01) ويُقرأ "${1}" متغيرًا اسمه 1، وهو غير معرّف ويستخدم صيغة نصية مهملة منذ PHP 8.2. يعمل '\1' بين علامتي التنصيص المفردتين مثل '$1'، لكن $1 هي الكتابة الشائعة.

حذف المحارف غير الأبجدية الرقمية

تطابق فئة المحارف المنفية، [^...]، كل ما لم يُذكر. واستبدالها بـ '' يحذفه. وللنصوص بلغات أخرى، استخدم فئات Unicode \p{L} (أي حرف) و\p{N} (أي رقم) مع المعدّل u، وإلا حذفت é وü وكل محرف ياباني.

<?php
$s = 'Héllo, wörld! 日本語 #2026';

echo preg_replace('/[^a-zA-Z0-9]/', '', $s), "\n";           // ASCII only
echo preg_replace('/[^a-zA-Z0-9 ]/', '', $s), "\n";          // keep spaces
echo preg_replace('/[^\p{L}\p{N}]/u', '', $s), "\n";         // any language
echo preg_replace('/[^\p{L}\p{N}\s]/u', '', $s), "\n";       // and spaces

// Digits only, for a phone number typed with spaces and dashes
echo preg_replace('/\D/', '', '+1 (555) 123-4567'), "\n";

صنع رابط مختصر (slug)

تحوّل عدة أنماط متتالية عنوانًا إلى رابط مختصر. حوّل إلى أحرف صغيرة أولًا، واستبدل كل سلسلة من المحارف غير الأبجدية الرقمية بشرطة واحدة، ثم احذف الشرطات من الطرفين:

<?php
function slugify(string $title): string
{
    $slug = mb_strtolower($title);
    $slug = preg_replace('/[^\p{L}\p{N}]+/u', '-', $slug);
    return trim($slug, '-');
}

echo slugify('PHP preg_replace(): A Quick Guide!'), "\n";
echo slugify('  10 Tips & Tricks for 2026  '), "\n";
echo slugify('Café au lait'), "\n";

عدة أنماط وحد وعدّ

يمكن أن يكون $pattern و$replacement مصفوفتين: يُستبدل كل نمط بالبديل الذي في الفهرس نفسه، بالترتيب. ويحدد الوسيط الرابع عدد الاستبدالات لكل نمط (-1 تعني دون حد)، ويتلقى الخامس عدد الاستبدالات التي جرت.

<?php
$text = 'Call 555-1234 or email me at ana@example.com';

$patterns = ['/\d{3}-\d{4}/', '/\S+@\S+/'];
$replacements = ['[phone]', '[email]'];
echo preg_replace($patterns, $replacements, $text), "\n";

// Only the first match
echo preg_replace('/\d+/', '#', 'a1 b2 c3', 1), "\n";

// Count the replacements
$clean = preg_replace('/\s{2,}/', ' ', 'a  b   c d', -1, $count);
echo "$clean ($count replacements)\n";

حساب البديل بـ preg_replace_callback

عندما يعتمد البديل على التطابق، استخدم preg_replace_callback(). تستدعي دالتك مرة لكل تطابق مع مصفوفة $matches وتُدرج ما تعيده الدالة. وتُبقي الدالة السهمية دوال الاستدعاء القصيرة في سطر واحد.

<?php
// Add 10% tax to every price
$menu = 'Coffee $3.50, Cake $4.00, Tea $2.80';
echo preg_replace_callback(
    '/\$(\d+\.\d{2})/',
    fn($m) => '$' . number_format($m[1] * 1.10, 2),
    $menu
), "\n";

// snake_case to camelCase
echo preg_replace_callback('/_([a-z])/', fn($m) => strtoupper($m[1]), 'user_first_name'), "\n";

// Fill {placeholders} from an array, leave unknown ones alone
$vars = ['name' => 'Ada', 'count' => 3];
$template = 'Hi {name}, you have {count} messages. {unknown}';
echo preg_replace_callback(
    '/\{(?<key>\w+)\}/',
    fn($m) => $vars[$m['key']] ?? $m[0],
    $template
), "\n";

تأخذ preg_replace_callback_array() مصفوفة من أزواج pattern => callback عندما يحتاج كل نمط من عدة أنماط إلى دالته الخاصة.

نص الاستبدال من متغير

لـ $ وللشرطة المائلة العكسية في نص الاستبدال معنى، لذا قد يتشوه نص استبدال قادم من مستخدم أو قاعدة بيانات. يُقرأ سعر مثل $10 مرجعًا إلى المجموعة 10، وهي غير موجودة، فيخرج فارغًا:

<?php
$price = '$10';

// Wrong: "$10" is read as backreference 10
echo preg_replace('/PRICE/', $price, 'Only PRICE today'), "\n";

// Right: the callback's return value is used as is
echo preg_replace_callback('/PRICE/', fn() => $price, 'Only PRICE today'), "\n";

// Or, for fixed text, no regex at all
echo str_replace('PRICE', $price, 'Only PRICE today'), "\n";

عندما لا يكون نص البحث ولا البديل نمطًا، تكون str_replace() الخيار الأبسط والأسرع. ولاختبار نمط قبل استبدال أي شيء، راجع preg_match().