PHP 包含文件 - include - PHP 中级教程

PHP 允许在一个 PHP 文件中包含另一个文件

PHP 提供了以下语句用于包含另一个文件

语句	说明
require	包含另一个文件，如果发生错误，则脚本停止运行
include	包含另一个文件，如果发生错误，忽略错误继续运行脚本
require_once	只包含另一个文件一次，如果发生错误，则脚本停止运行
include_once	只包含另一个文件一次，如果发生错误，忽略错误继续运行脚本

PHP include 和 require 语句

PHP 语言中，我们可以在服务器执行 PHP 文件之前在该文件中插入一个文件的内容

PHP 提供了 include 和 require 语句用于在执行流中插入写在其他文件中的有用的代码

include 和 require 除了处理错误的方式不同之外，在其他方面都是相同的：

require 生成一个致命错误 (E_COMPILE_ERROR )，在错误发生后脚本会停止执行
include 生成一个警告 ( E_WARNING )，在错误发生后脚本会继续执行

因此，如果你希望即使发生错误也要继续执行，并向用户输出结果，即使包含文件已丢失，那么请使用 include

否则，在框架、CMS 或者复杂的 PHP 应用程序编程中，请始终使用 require 向执行流引用关键文件

require 语句在某个关键文件意外丢失的情况下，有助于提高应用程序的安全性和完整性，

文件包含可以节省大量的工作，因为我们可以为所有网页创建标准页头、页脚或者菜单文件，然后，在页头需要更新时，只更新这个页头包含文件即可

语法

PHP include 语句语法格式如下

<?php
include 'filename';

PHP require 语句语法格式如下

<?php 
require 'filename';

范例 1

首先，创建一个标准的 HTML 页头文件 php_include_header.php

然后在 php_include_1.php 文件中使用 include/require 引入 php_include_header.php 文件

php_include_header.php

<!DOCTYPE html>
<meta charset="utf-8">
<title>简单教程(www.twle.cn)</title>

php_include_1.php

<?php include 'php_include_header.php'; ?>
<h1>欢迎来到我的主页!</h1>
<p>一些文本</p>
<p>PHP 基础教程 - 简单教程(www.twle.cn)</p>

运行范例 »

运行以上 PHP 范例，输出结果如下

范例 2

首先，我们创建通用的菜单文件 php_include_menu.php

php_include_menu.php

<a href="/">主页</a><br/>
<a href="/yufei/html">HTML 基础教程</a><br/>
<a href="/yufei/php">PHP 基础教程</a><br/>

然后网站中的所有页面均应引用该菜单文件

php_include_2.php

<?php include 'php_include_header.php'; ?>
<div class="leftmenu">
<?php include 'php_include_menu.php'; ?>
</div>
<h1>欢迎来到我的主页!</h1>
<p>一些文本</p>
<p>PHP 基础教程 - 简单教程(www.twle.cn)</p>

运行范例 »

运行以上 PHP 范例，输出结果如下

范例3

假设我们有一个定义变量的包含文件 php_include_vars.php

php_include_vars.php

<?php
$color = 'red';
$car = 'BMW';

这些变量可用在调用文件中

php_include_3.php

<?php include 'php_include_header.php'; ?>
<div class="leftmenu">
<?php include 'php_include_menu.php'; ?>
</div>
<h1>欢迎来到我的主页!</h1>
<p>一些文本</p>

<?php 
include 'php_include_vars.php';
echo "<p>I have a $color $car</p>"; // I have a red BMW
?>

<p>PHP 基础教程 - 简单教程(www.twle.cn)</p>

运行范例 »

运行以上 PHP 范例，输出结果如下