Z
ZHANK
控制流程

文件包含

include/require/include_once/require_once 的区别与使用场景

文件包含

把公共代码(页头/页脚/数据库连接)放进独立文件,需要时包含进来——这是 PHP 最基本的代码复用方式。

学完本章你将: 掌握 include/require、_once 版本的区别。


四种包含语句

php
<?php
include 'header.php';       // 包含文件,如果不存在只警告,继续执行
require 'config.php';       // 包含文件,如果不存在致命错误,停止执行

include_once 'utils.php';   // 同一文件只包含一次
require_once 'config.php';  // 同上(require 版)

区别对比

includerequire
文件不存在Warning,继续运行Fatal Error,停止
适用场景模板、非关键文件配置文件、关键依赖
_once不用 _once
行为同一文件只加载一次每次调用都加载
适用函数/类定义(防重复)模板片段(可重复)

实际应用

php
<?php
// config.php
define('DB_HOST', 'localhost');
define('DB_NAME', 'myapp');
return ['app_name' => 'My App'];  // include/require 有返回值
php
<?php
// index.php
require_once 'config.php';
include 'header.php';
?>

<main>
    <p>我是主内容</p>
</main>

<?php include 'footer.php'; ?>