PHP str_replace(): Dizgede Metin Değiştirme

str_replace($search, $replace, $subject) $search değerinin her geçişi $replace ile değiştirilmiş bir $subject kopyası döndürür. str_replace('world', 'PHP', 'Hello world') "Hello PHP" döndürür.

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

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

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

Fonksiyon yeni dizgeyi döndürür; verdiğiniz değişkeni değiştirmez. Sonucu, aynı değişkene bile olsa atayın: $text = str_replace(...).

Söz dizimi

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

İlk üç argümanın her biri bir dizge veya bir dizi olabilir. $subject bir diziyse değiştirme her elemanda çalışır ve aynı anahtarlara sahip bir dizi geri alırsınız: str_replace('.txt', '.md', ['a.txt', 'b.txt']) ['a.md', 'b.md'] döndürür. Arama büyük küçük harfe duyarlıdır ve kalıpları değil düz metni eşleştirir. Kalıplar için preg_replace() kullanın.

Aynı anda birkaç dizgeyi değiştirme

$search ve $replace için diziler verin. İlk arama değeri ilk değiştirme değeriyle, ikincisi ikinciyle değiştirilir ve böyle devam eder. $replace tek bir dizgeyse her arama değeri onunla değiştirilir; bu, bir karakter kümesini silmenin kısa yoludur.

<?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";

Sıra tuzağı ve strtr()

Dizilerle str_replace() değiştirmeleri tüm dizge üzerinde birbiri ardına çalıştırır. Sonraki bir arama, önceki bir değiştirmenin az önce eklediği metinle eşleşebilir. Bir diziyle strtr() her şeyi tek geçişte değiştirir, önce en uzun anahtarları dener ve zaten değiştirdiği metne asla dokunmaz.

<?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";

Yer değiştirmeler ve değerlerin içinde görünebilecek şablon yer tutucuları için strtr() kullanın.

Değiştirmeleri sayma

Dördüncü argüman yapılan değiştirme sayısıyla doldurulur. Bir değişken verin; PHP onun içine yazar.

<?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 ile büyük küçük harfe duyarsız değiştirme

str_ireplace() aynı argümanları alır ve eşleştirirken büyük küçük harfi yok sayar. Değiştirme değeri tam olarak yazdığınız gibi eklenir.

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

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

str_ireplace() yalnızca ASCII harflerde büyük küçük harfi eşitler. Aksanlı veya Kiril harflerinde büyük küçük harfe duyarsız değiştirme için i ve u değiştiricileriyle preg_replace() kullanın.

Yalnızca ilk geçişi değiştirme

str_replace() her zaman her şeyi değiştirir. Yalnızca ilk eşleşmeyi değiştirmek için onu strpos() ile bulun ve substr_replace() ile kesip çıkarın:

<?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";

Son geçiş için strpos() yerine strrpos() kullanın.

Boşlukları, yeni satırları ve diğer karakterleri silme

Boş bir dizgeyle değiştirmek metni siler. Yaygın bir temizlik satır sonlarını veya tüm boşlukları siler; Japonca girdi ise çoğu zaman normal bir " " aramasının eşleşmediği tam genişlikte boşluklar (　, U+3000) içerir.

<?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

Dizide "\r\n" değerini "\n" ve "\r" değerlerinden önce koyun, böylece bir Windows satır sonu iki değil tek boşluk olur.