php str_ireplace函数介绍

封面图 • 2025-10-12 • PHP

`str_ireplace()` 是 PHP 中用于字符串替换的函数，它的作用与 `str_replace()` 类似，但区别在于 `str_ireplace()` 是**不区分大小写**的。

---

## ✅ 函数语法

```php
str_ireplace($search, $replace, $subject, &$count = null): string|array
```

### 参数说明：

- **`$search`**: 要查找的字符串或数组（可以是单个字符串或多个字符串的数组）。
- **`$replace`**: 用来替换的字符串或数组（如果 `$search` 是数组，则 `$replace` 也必须是数组，并且长度相同）。
- **`$subject`**: 被搜索和替换的字符串或数组。
- **`$count`**（可选）: 如果提供这个参数，它将被设置为替换发生的次数（按引用传递）。

---

## 📌 示例

### 示例 1：基本用法

```php
$string = "Hello World!";
$result = str_ireplace("hello", "Hi", $string);
echo $result; // 输出: Hi World!
```

> 注意：`str_ireplace` 不区分大小写，所以 `"hello"` 和 `"Hello"` 都会被替换。

---

### 示例 2：替换多个字符串

```php
$search = ["apple", "banana"];
$replace = ["fruit1", "fruit2"];
$subject = "I like apple and banana.";
$result = str_ireplace($search, $replace, $subject);
echo $result; // 输出: I like fruit1 and fruit2.
```

---

### 示例 3：使用数组作为输入

```php
$search = ["PHP", "HTML"];
$replace = ["Programming", "Markup"];
$subject = ["This is PHP.", "HTML is a markup language."];
$result = str_ireplace($search, $replace, $subject);
print_r($result);
// 输出:
// Array
// (
//     [0] => This is Programming.
//     [1] => Markup is a markup language.
// )
```

---

## ⚠️ 注意事项：

- `str_ireplace()` 是不区分大小写的，而 `str_replace()` 是区分大小写的。
- 如果你希望区分大小写，请使用 `str_replace()`。
- 如果 `$search` 和 `$replace` 是数组，它们的长度必须一致。
- `str_ireplace()` 在 PHP 5.0 及以上版本中可用。

---

## 🧠 对比 `str_replace()` 和 `str_ireplace()`

| 特性             | `str_replace()`        | `str_ireplace()`       |
|------------------|------------------------|------------------------|
| 是否区分大小写   | 区分                   | 不区分                 |
| 返回值           | 字符串或数组           | 字符串或数组           |
| 支持数组         | 支持                   | 支持                   |
| 大小写敏感       | 是                     | 否                     |

---

如果你有具体的使用场景或问题，欢迎继续提问！