preg_replace() ב-PHP: החלפה עם regex והפניות לאחור

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" הופך לרצף escape אוקטלי (הבית 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 לכתובת URL

כמה תבניות ברצף הופכות כותרת ל-slug לכתובת URL. המירו קודם לאותיות קטנות, החליפו כל רצף של תווים שאינם אותיות או ספרות במקף אחד, ואז קצצו מקפים מהקצוות:

<?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 ומכניסה את מה שהפונקציה מחזירה. פונקציית חץ שומרת callbacks קצרים בשורה אחת.

<?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().