PHP 包含文件
这 include
(或者require
) 语句获取指定文件中存在的所有文本/代码/标记,并将其复制到使用 include 语句的文件中。
当您想在网站的多个页面上包含相同的 PHP、HTML 或文本时,包含文件非常有用。
PHP include 和 require 语句
可以使用 include 或 require 语句将一个 PHP 文件的内容插入到另一个 PHP 文件中(在服务器执行它之前)。
除了失败的情况外,include 和 require 语句是相同的:
require
将产生致命错误 (E_COMPILE_ERROR) 并停止脚本include
只会产生一个警告(E_WARNING),脚本将继续
因此,如果您希望执行继续并向用户显示输出,即使缺少包含文件,也请使用 include 语句。否则,对于 FrameWork、CMS 或复杂的 PHP 应用程序编码,请始终使用 require 语句将关键文件包含到执行流程中。这将有助于避免危及应用程序的安全性和完整性,以防万一一个关键文件意外丢失。
包含文件可以节省大量工作。这意味着您可以为所有网页创建标准的页眉、页脚或菜单文件。然后,当需要更新页眉时,您只需更新页眉包含文件即可。
句法
包括 '文件名';
或者
要求 '文件名';
PHP include 示例
示例 1
假设我们有一个名为“footer.php”的标准页脚文件,如下所示:
<?php
回显<p>版权所有 © 1999-“ . date("Y") . “ W3Schools.com</p> “;
?>
要将页脚文件包含在页面中,请使用 include
陈述:
例子
<html>
<body>
<h1>欢迎来到我的主页!</h1>
<p>一些文本。</p>
<p>更多文字。</p>
<?php include 'footer.php';?>
</body>
</html>
运行示例 »示例 2
假设我们有一个名为“menu.php”的标准菜单文件:
<?php
echo '<a href="/default.asp">首页</a>-
<a href="/html/default.asp">HTML 教程</a>-
<a href="/css/default.asp">CSS 教程</a>-
<a href="/js/default.asp">JavaScript 教程</a>-
<a href="default.asp">PHP 教程</a>';
?>
网站中的所有页面都应使用此菜单文件。以下是具体操作方法(我们使用<div>元素,以便菜单稍后可以轻松地使用 CSS 进行样式设置):
例子
<html>
<body>
<div class="menu">
<?php include 'menu.php';?>
</div>
<h1>欢迎来到我的主页!</h1>
<p>一些文本。</p>
<p>更多文字。</p>
</body>
</html>
运行示例 »示例 3
假设我们有一个名为“vars.php”的文件,其中定义了一些变量:
<?php
$color='红色';
$car='宝马';
?>
然后,如果我们包含“vars.php”文件,则可以在调用文件中使用这些变量:
例子
<html>
<body>
<h1>欢迎来到我的主页!</h1>
<?php include 'vars.php';
回显“我有一辆$color $car。”;
?>
</body>
</html>
运行示例 »PHP include 与 require
这 require
语句也用于将文件包含到 PHP 代码中。
但是,include 和 require 之间有一个很大的区别;当文件被包含时 include
语句并且 PHP 找不到它,脚本将继续执行:
例子
<html>
<body>
<h1>欢迎来到我的主页!</h1>
<?php include 'noFileExists.html';
回显“我有一辆$color $car。”;
?>
</body>
</html>
运行示例 »如果我们使用 require
语句,echo 语句将不会被执行,因为脚本执行在require
语句返回了致命错误:
例子
<html>
<body>
<h1>欢迎来到我的主页!</h1>
<?php require 'noFileExists.html';
回显“我有一辆$color $car。”;
?>
</body>
</html>
运行示例 »使用 require
当应用程序需要该文件时。
使用 include
当不需要该文件时,如果找不到该文件,应用程序应该继续。