PHP str_replace(): thay thế chuỗi và ký tự trong chuỗi

str_replace($search, $replace, $subject) trả về một bản sao của $subject trong đó mọi lần xuất hiện của $search được thay bằng $replace. str_replace('world', 'PHP', 'Hello world') trả về "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

Hàm trả về chuỗi mới; nó không sửa biến bạn truyền vào. Hãy gán kết quả, kể cả gán lại cho chính biến đó: $text = str_replace(...).

Cú pháp

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

Mỗi đối số trong ba đối số đầu có thể là chuỗi hoặc mảng. Nếu $subject là mảng, phép thay chạy trên từng phần tử và bạn nhận lại một mảng với cùng các khóa: str_replace('.txt', '.md', ['a.txt', 'b.txt']) trả về ['a.md', 'b.md']. Việc tìm kiếm phân biệt hoa thường và so khớp văn bản thuần, không phải mẫu. Với mẫu, hãy dùng preg_replace().

Thay nhiều chuỗi cùng lúc

Truyền mảng cho $search và $replace. Giá trị tìm thứ nhất được thay bằng giá trị thay thứ nhất, giá trị thứ hai bằng giá trị thứ hai, và cứ thế. Nếu $replace chỉ là một chuỗi, mọi giá trị tìm đều được thay bằng chuỗi đó, đây là cách ngắn gọn để xóa một nhóm ký tự.

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

Cái bẫy thứ tự và strtr()

Với mảng, str_replace() chạy lần lượt từng phép thay trên toàn bộ chuỗi. Một giá trị tìm phía sau có thể khớp với đoạn văn bản mà phép thay trước đó vừa chèn vào. strtr() với một mảng thay mọi thứ trong một lượt duy nhất, thử các khóa dài nhất trước, và không bao giờ đụng vào đoạn văn bản đã được thay.

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

Hãy dùng strtr() để hoán đổi giá trị và cho các chỗ giữ trong template mà có thể xuất hiện trong chính các giá trị.

Đếm số lần thay

Đối số thứ tư được điền số lần thay đã thực hiện. Truyền vào một biến; PHP sẽ ghi vào đó.

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

Thay không phân biệt hoa thường với str_ireplace

str_ireplace() nhận cùng các đối số và bỏ qua hoa thường khi so khớp. Chuỗi thay được chèn vào đúng như bạn đã viết.

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

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

str_ireplace() chỉ xử lý hoa thường cho chữ cái ASCII. Để thay không phân biệt hoa thường với chữ có dấu (như tiếng Việt) hay chữ Kirin, hãy dùng preg_replace() với các modifier i và u.

Chỉ thay lần xuất hiện đầu tiên

str_replace() luôn thay tất cả. Để chỉ thay phần khớp đầu tiên, tìm nó bằng strpos() rồi cắt ra bằng 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";

Với lần xuất hiện cuối cùng, dùng strrpos() thay cho strpos().

Xóa khoảng trắng, dấu xuống dòng và các ký tự khác

Thay bằng một chuỗi rỗng là xóa đoạn văn bản đó. Một bước làm sạch phổ biến là xóa dấu xuống dòng hoặc mọi khoảng trắng, và dữ liệu nhập bằng tiếng Nhật thường chứa khoảng trắng toàn độ rộng (　, U+3000) mà một phép tìm " " thông thường không khớp được.

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

Đặt "\r\n" trước "\n" và "\r" trong mảng, để một dấu xuống dòng kiểu Windows trở thành một khoảng trắng chứ không phải hai.