PHP preg_replace() 函数

封面图 • 2025-10-06 • PHP

`preg_replace()` 是 PHP 中用于执行**正则表达式搜索和替换**的函数。它允许你根据一个正则表达式模式，在字符串中查找匹配的内容，并将其替换为指定的字符串。

---

## ✅ 语法

```php
mixed preg_replace ( mixed $pattern, mixed $replacement, mixed $subject [, int $limit = -1 [, int &$count ]] )
```

### 参数说明：

| 参数 | 类型 | 说明 |
|------|------|------|
| `$pattern` | `string` 或 `array` | 要搜索的正则表达式（可以是单个字符串或数组） |
| `$replacement` | `string` 或 `array` | 替换的内容（可以是单个字符串或数组） |
| `$subject` | `string` 或 `array` | 被搜索和替换的字符串或数组 |
| `$limit` | `int` | 最多替换次数（默认 `-1` 表示无限制） |
| `$count` | `&int` | 如果提供，会返回实际替换的次数 |

---

## 📌 示例

### 1. 基本用法：替换字符串中的某个词

```php
$text = "Hello, world!";
$result = preg_replace("/world/", "PHP", $text);
echo $result; // 输出: Hello, PHP!
```

### 2. 使用正则表达式匹配多个单词

```php
$text = "I like apples, bananas, and oranges.";
$result = preg_replace("/\b[a-zA-Z]+\b/", "$0", $text);
echo $result;
// 输出: I like apples, bananas, and oranges.
```

### 3. 替换多个匹配项（使用数组）

```php
$patterns = ["/apple/", "/banana/"];
$replacements = ["fruit1", "fruit2"];
$text = "I have an apple and a banana.";
$result = preg_replace($patterns, $replacements, $text);
echo $result; // 输出: I have an fruit1 and a fruit2.
```

### 4. 使用回调函数（PHP 5.0+）

```php
$text = "The price is $100.";
$result = preg_replace_callback("/\$(\d+)/", function($matches) {
    return "$" . ($matches[1] * 2);
}, $text);
echo $result; // 输出: The price is $200.
```

---

## 🔍 注意事项：

- 正则表达式需要以 `/` 开头和结尾（例如：`/pattern/`）。
- 如果你的正则表达式中包含 `/`，你需要进行转义，或者使用其他分隔符（如 `#`）：
  
  ```php
  preg_replace("#http://example.com#", "https://example.com", $text);
  ```

- 如果 `$subject` 是数组，`preg_replace()` 会对每个元素进行处理。

---

## 🧠 小技巧：

- 使用 `preg_quote()` 可以对字符串进行转义，避免正则表达式特殊字符被误识别。
- 使用 `preg_match_all()` 可以获取所有匹配项。

---

如果你有具体的使用场景或问题，欢迎告诉我，我可以帮你写更具体的代码 😊