php语句 include 和 require 都能把另外一个文件包含到当前文件中，它们的区别是什么？怎么避免多次包含同一文件？

封面图 • 2025-11-05 • PHP

在 PHP 中，`include` 和 `require` 都是用来包含其他文件的语句，但它们在处理错误时的行为是不同的。下面是它们的区别以及如何避免多次包含同一文件的方法。

---

### 一、`include` 和 `require` 的区别

| 特性 | `include` | `require` |
|------|------------|-----------|
| **错误处理** | 如果文件找不到或包含失败，会发出警告（warning），脚本继续执行。 | 如果文件找不到或包含失败，会发出致命错误（fatal error），脚本立即停止。 |
| **使用场景** | 用于包含可选的文件（如页面布局、模板等）。 | 用于包含必须的文件（如配置文件、核心函数等）。 |

#### 示例：

```php
// include 示例
include 'config.php'; // 如果 config.php 不存在，会报 warning，脚本继续运行

// require 示例
require 'config.php'; // 如果 config.php 不存在，会报 fatal error，脚本停止
```

---

### 二、如何避免多次包含同一文件？

PHP 默认不会自动防止重复包含同一个文件。如果一个文件被多次 `include` 或 `require`，可能会导致函数、类、变量重复定义，从而引发错误。

#### 方法一：使用 `include_once` 或 `require_once`

PHP 提供了 `include_once` 和 `require_once`，它们的作用是：

- **只包含一次**：即使多次调用，也只会包含一次。
- **适用于类、函数、配置等**，防止重复定义。

##### 示例：

```php
include_once 'functions.php'; // 只包含一次
require_once 'config.php';   // 只包含一次
```

---

#### 方法二：使用 `defined()` 检查常量

你也可以通过定义一个常量来判断是否已经包含过该文件。

##### 示例：

```php
if (!defined('MY_CONFIG_INCLUDED')) {
    include 'config.php';
    define('MY_CONFIG_INCLUDED', true);
}
```

这种方式可以更灵活地控制包含逻辑，尤其在大型项目中非常有用。

---

### 三、总结

| 方法 | 是否重复包含 | 是否推荐 |
|------|----------------|----------|
| `include` | 可能重复 | 适用于非关键文件 |
| `require` | 可能重复 | 适用于关键文件 |
| `include_once` | 不会重复 | 推荐使用 |
| `require_once` | 不会重复 | 推荐使用 |
| `defined()` + 自定义常量 | 不会重复 | 灵活控制 |

---

### 四、最佳实践建议

- 使用 `require_once` 或 `include_once` 来包含类文件、配置文件等关键内容。
- 对于模板、视图等非关键文件，可以用 `include`。
- 避免手动多次包含同一个文件，使用 `include_once` 是最简单有效的方式。

如果你还有关于自动加载（autoload）的问题，也可以问我哦！