str_replace() ב-PHP: החלפת טקסט במחרוזת

str_replace($search, $replace, $subject) מחזירה עותק של $subject שבו כל מופע של $search הוחלף ב-$replace. str_replace('world', 'PHP', 'Hello world') מחזירה "Hello PHP".

<?php
$text = 'I like cats. cats are great.';

$new = str_replace('cats', 'dogs', $text);

echo $new, "\n";
echo $text, "\n";   // the original is unchanged

הפונקציה מחזירה את המחרוזת החדשה; היא לא משנה את המשתנה שמעבירים לה. הציבו את התוצאה, גם בחזרה לאותו משתנה: $text = str_replace(...).

תחביר

str_replace(
    array|string $search,
    array|string $replace,
    string|array $subject,
    int &$count = null
): string|array

כל אחד משלושת הארגומנטים הראשונים יכול להיות מחרוזת או מערך. אם $subject הוא מערך, ההחלפה רצה על כל איבר ומקבלים בחזרה מערך עם אותם מפתחות: str_replace('.txt', '.md', ['a.txt', 'b.txt']) מחזירה ['a.md', 'b.md']. החיפוש רגיש לרישיות ומתאים טקסט פשוט, לא תבניות. לתבניות השתמשו ב-preg_replace().

החלפת כמה מחרוזות בבת אחת

העבירו מערכים ל-$search ול-$replace. ערך החיפוש הראשון מוחלף בהחלפה הראשונה, השני בשנייה, וכן הלאה. אם $replace הוא מחרוזת אחת, כל ערך חיפוש מוחלף בה, וזו הדרך הקצרה להסיר קבוצת תווים.

<?php
$template = 'Hello {name}, your order {id} has shipped.';

echo str_replace(['{name}', '{id}'], ['Ada', '#1042'], $template), "\n";

// One replacement for every search value: remove punctuation
echo str_replace(['.', ',', '!', '?'], '', 'Hi, there! Ready? Yes.'), "\n";

// Fewer replacements than searches: the missing ones are ""
echo str_replace(['a', 'b', 'c'], ['1'], 'abcabc'), "\n";

מלכודת הסדר ו-strtr()

עם מערכים, str_replace() מריצה החלפה אחרי החלפה על כל המחרוזת. חיפוש מאוחר יכול להתאים לטקסט שהחלפה מוקדמת בדיוק הכניסה. strtr() עם מערך מחליפה הכול במעבר אחד, מנסה קודם את המפתחות הארוכים ביותר, ואף פעם לא נוגעת בטקסט שכבר הוחלף.

<?php
$s = 'apple banana';

// apple -> banana, then every banana (including the new one) -> cherry
echo str_replace(['apple', 'banana'], ['banana', 'cherry'], $s), "\n";

// One pass: each original word is replaced once
echo strtr($s, ['apple' => 'banana', 'banana' => 'cherry']), "\n";

השתמשו ב-strtr() להחלפות הדדיות ולממלאי מקום בתבניות שעשויים להופיע בתוך הערכים.

ספירת ההחלפות

הארגומנט הרביעי מתמלא במספר ההחלפות שבוצעו. העבירו משתנה; PHP כותבת לתוכו.

<?php
$text = 'one fish, two fish, red fish, blue fish';

$result = str_replace('fish', 'cat', $text, $count);

echo $result, "\n";
echo "Replaced $count times\n";

החלפה בלי תלות ברישיות עם str_ireplace

str_ireplace() מקבלת את אותם ארגומנטים ומתעלמת מרישיות בהתאמה. ההחלפה מוכנסת בדיוק כפי שכתבתם אותה.

<?php
$text = 'PHP, php and Php';

echo str_replace('php', 'Python', $text), "\n";
echo str_ireplace('php', 'Python', $text), "\n";

str_ireplace() מקפלת רק אותיות ASCII. להחלפה בלי תלות ברישיות של אותיות עם סימנים דיאקריטיים או אותיות קיריליות, השתמשו ב-preg_replace() עם המשנים i ו-u.

החלפה של המופע הראשון בלבד

str_replace() תמיד מחליפה הכול. כדי להחליף רק את ההתאמה הראשונה, מצאו אותה עם strpos() וחתכו אותה עם substr_replace():

<?php
function replaceFirst(string $search, string $replace, string $subject): string
{
    $pos = strpos($subject, $search);
    if ($pos === false) {
        return $subject;
    }
    return substr_replace($subject, $replace, $pos, strlen($search));
}

echo replaceFirst('a', 'A', 'banana'), "\n";

// The same with a regex and a limit of 1
echo preg_replace('/' . preg_quote('a', '/') . '/', 'A', 'banana', 1), "\n";

למופע האחרון, השתמשו ב-strrpos() במקום ב-strpos().

הסרת רווחים, ירידות שורה ותווים אחרים

החלפה במחרוזת ריקה מסירה את הטקסט. ניקוי נפוץ מסיר ירידות שורה או את כל הרווחים, וקלט ביפנית מכיל לעיתים קרובות רווחים ברוחב מלא (　, U+3000) שחיפוש רגיל של " " לא מתאים להם.

<?php
$text = "line one\r\nline two\nline three";
echo str_replace(["\r\n", "\n", "\r"], ' ', $text), "\n";

$phone = '090 1234 5678';
echo str_replace(' ', '', $phone), "\n";

$name = '山田　太郎';
echo str_replace('　', ' ', $name), "\n";   // full-width space to normal space

שימו את "\r\n" לפני "\n" ו-"\r" במערך, כך שירידת שורה של Windows תהפוך לרווח אחד ולא לשניים.