require(),include(),require_once()和include_once()区别


Posted in PHP onMarch 27, 2008

我把这两个语句放在一起介绍,读者可以比较学习。
1.require()语句
require()语句用于指定的文件代替语句本身,就象C语言中的include()语句一样。如果php配置文件php.ini中的URL fopen wrappers 是打开的(默认情况下是打开的),就可以使用URL来指定文件的位置从而实现远程文件的调用。
有一点就是使用require()和include()语句时要特别的注意。那就是在被包含的文件中,处理器是按照html模式来解释其中的内容的,处理完被包含的内容后又恢复到php模式。所以如果需要在被包含文件中使用php语法,就要使用正确的php开始和结束标记来把这些语句包含进去。
require()和include()知识php中的一种语言特性,而不是函数。它们和函数有许多不同的地方。
比如:require()所包含的文件中不能包含控制结构,而且不能使用return这样的语句。在require()所包含的文件中使用return语句会产生处理错误。
不象include()语句,require()语句会无条件地读取它所包含的文件的内容,而不管这些语句是否执行。所以如果你想按照不同的条件包含不同的文件,就必须使用include()语句。当然,如果require()所在位置的语句不被执行,require()所包含的文件中的语句也不会被执行。
require()不能在循环体中根据条件的不同而包含不同的文件。require()语句只会在第一次执行时调用它所包含的文件中的内容替换本身这条语句,当再次被执行时只能执行第一次所包含的语句。但是include()语句可以在循环体中来包含不同的文件。
require()语句中的变量继承require()语句所在位置的变量作用域。所有在require()语句的位置可以访问的变量,在require()语句所包含的文件中都可以访问。如果require()语句位于一个函数内部,那么被包含文件内的语句都相当于定义在函数内部。
require()语句在PHP程序执行前就会将使用require引用的文件读入,因此require通常放到程序的开始处。因此要特别注意一点,require语句有一点强,不管程序是否真的需要引用的文件,只要你使用require语句,它都会把他们包含进来!即使你是在条件控制语句中使用这个函数进行包含,那怕是那个条件不为真,引用文件也会被包含进来!形成了僵尸,在运行过程中这些僵尸是不起任何可见作用的,但是很明显它会加重负担,所以这一点要特别注意!如果使用require语句发生了包含错误,那么程序将输出出错信息并停止运行!!

如果require()语句通过声明文件的URL来包含远程文件,而且远程服务器按照php代码来解释该文件的话,本地php文件中所包含的内容是在远程服务器上处理以后的结果。例如:

/* 
这个例子假设some_server服务器可以解释.php文件,而不对.txt文件进行解释。在远程文件中 
需要变量$varfirst和$varsecond 
*/ 
/*不能正确执行,远程服务器不处理.txt文件*/ 
require("http://some_server/file.txt?varfirst=1&varsecond=2"); /*不正确,这样只能在本地机上寻找file.php文件*/ 
require("file.php?varfirst=1&varsecond=2"); 
/*正确的语句*/ 
require("http://some_server/file.php?varfirst=1&varsecond=2"); 
$varfirst=1; 
$varsecond=2; 
require("file.txt"); /*正确的语句*/ 
require("file.php"); /*正确的语句*/

本来在php3.0中,require()所包含的文件可以使用return语句,但条件是return语句不能出现在{}内部,而必须出现在被包含文件的全局范围内。在php4.0中已经取消了require()的这个功能,但是仍然可以使用include()来实现。

2.include()语句
include()语句和require()语句有许多相同的地方。凡是在上边require()语句中没有明确说明不能适用于include()的部分外,require()语句的功能完全适用于include()语句。下边介绍require()语句所没有的include()语句的功能和特点。
include语句只有在被执行时才会读入要包含的文件。在错误处理方便,使用include语句,如果发生包含错误,程序将跳过include语句,虽然会显示错误信息但是程序还是会继续执行!
php处理器会在每次遇到include()语句时,对它进行重新处理,所以可以根据不同情况的,在条件控制语句和循环语句中使用include()来包含不同的文件。
例如:

<?php 
$files=array('first.php','second.php','third.php'); 
for($i=0;$i<count($files);$i++) 
{ 
include $files[$i]; 
} 
?>

在php3.0和php4.0中include()语句所包含的文件中都可以使用return语句来返回一个值,并停止执行被包含文件下面的内容。但php3.0和php4.0在处理这样的情况时有所不同。在php3.0中return语句不能包含在{}内,除非它在一个函数中,因为这时它表示函数的返回值而不是文件的返回值。而在php4.0中就没有了这样的限制,用户甚至可以在文件中返回一个数字,就象函数的返回值一样。这样的语句在

php3.0中通常会报告错误。以下举例说明:
假设被包含的文件为test.inc和主文件main.php位于一个目录中。test.inc的内容如下:
test.inc

<?php 
echo "Before the return<br>\n"; 
if(1) 
{ 
return 27; 
} 
echo "After the return<br>\n"; 
?>

假设在main.php文件中包含下面的语句:
<?php 
$retval=include('test.inc'); 
echo "File returned:'$retval'<br>\n"; 
?>

php3.0解释器会在第二行报告错误,而不能得到include()语句的返回值。但在php4.0中会得到下面的结果:
Before the return
File returned: '27'
下边假设main.php改为:
<?php 
include('test.inc'); 
echo "Back in main.html<br>\n"; 
?>

在php4.0中的输出结果是:
Before the return
Back in main.html

在php5.0中的输出结果也是:
Before the return
Back in main.html

在php3.0中的输出结果是:
Before the return
27Back in main.html

Parse error:parse error in /apache/htdocs/phptest/main.html on line 5

出现上面的错误是因为return语句位于{}内部而且不是一个函数内部。如果把{}去掉,使它位于test.inc的最外层,输出结果是:
Before the return
27Back in main.html
之所以出现27,是因为在php3.0中不支持include()返回。

3.require_once()和include_once()语句
require_once()和include_once()语句分别对应于require()和include()语句。require_once()和include_once()语句主要用于需要包含多个文件时,可以有效地避免把同一段代码包含进去而出现函数或变量重复定义的错误。例如:如果创建两个文件util.inc和fool.inc,程序代码分别为:
util.inc:

<?php 
define(PHPVERSION,floor(phpversion())); 
echo "GLOBALS ARE NICE<br>\n"; 
function goodTea() 
{ 
return "Olong tea tasts good!"; 
} 
?>

和fool.inc:
<?php 
require ("util.inc"); 
function showVar($var) 
{ 
if(PHPVERSION==4) 
{ 
print_r($var); 
} 
else 
{ 
var_dump($var); 
} 
} 
?>

然后在error_require.php中包含这两个文件:
<?php 
require("fool.inc"); 
require("util.inc");//此句会产生一个错误 
$foo=array("1",array("complex","quaternion")); 
echo "this is requiring util.inc again which is also<br>\n"; 
echo "required in fool.inc\n"; 
echo "Running goodTea:".goodTea()."<br>\n"; 
echo "Printing foo:<br>\n"; 
showVar($foo); 
?>

当运行error_require.php时,输出结果如下:
GLOBALS ARE NICE
GLOBALS ARE NICE

Fatal error:Cannot redeclare goodTea() in util.inc on line 4

如果使用require_once()语句来代替 require()语句,就不会出现上面的错误。我们把error_require.php和fool.inc中的require()语句改为require_once()语句并重命名为error_require_once.php,这是显示结果如下:
GLOBALS ARE NICE
this is requiring util.inc again which is also
required in fool.inc Running goodTea:Olong tea tastes good!
Printing foo:
Array([0] => 1 [1] => Array ([0] => complex [1] = quaternion))

include_once()语句的语法和include()语句类似,主要区别也是避免多次包含一个文件而引起函数或变量的重复定义。

require_once语句有一个引用链,它可以保证文件加入你的程序仅仅只有一次,而且会避开变量值和函数名之间的冲突。

和require_once语句一样,include_once语句把include的功能扩展了。在程序执行期间,将指定的文件包含进来,如果从文件引用进来的程序先前已经包含过的时候,include_once()就不会把它再包含进来。也就是仅仅可以引用同一个文件一次!

include_once() 语句在脚本执行期间包含并运行指定文件。此行为和 include() 语句类似,唯一区别是如果该文件中的代码已经被包含了,则不会再次包含。如同此语句名字暗示的那样,只会包含一次。

include_once() 应该用于在脚本执行期间同一个文件有可能被包含超过一次的情况下,想确保它只被包含一次以避免函数重定义,变量重新赋值等问题。

使用 require_once() 和 include_once() 的更多例子见最新的 PHP 源程序发行包中的 PEAR 代码。

返回值和 include() 相同。如果文件已被包含,本函数返回 TRUE。

注: include_once() 是 PHP 4.0.1pl2 中新加入的。

注: 要注意 include_once() 和 require_once() 在大小写不敏感的操作系统中(例如 Windows)的行为

可能不是所期望的。
例子: include_once() 在 Windows 下不区分大小写

<?php 
include_once("a.php"); // this will include a.php 
include_once("A.php"); // this will include a.php again on Windows! (PHP 4 only) 
?>

此行为在 PHP 5 中改了,路径先被规格化,因此 C:\PROGRA~1\A.php 和 C:\Program Files\a.php 的实现一样,文件只会被包含一次。

如果要包含的文件不存在,include提示notice,然后继续执行下面的语句,require提示致命错误并且退出。

win32平台下它们都是先包含后执行,所以被包含文件里最好不要再有include或require语句,这样会造成目录混乱。或许Linux下情况不同,暂时还没测试。

如果一个文件不想被包含多次可以使用include_once或require_once## 读取,可以写入文档数据。

<?php 
function r($file_name) { 
 $filenum=@fopen($file_name,"r"); 
 @flock($filenum,LOCK_SH); 
 $file_data=@fread($filenum,filesize($file_name)); 
 @fclose($filenum); 
 return $file_data; 
} 
function w($file_name,$data,$method="w"){ 
 $filenum=@fopen($file_name,$method); 
 flock($filenum,LOCK_EX); 
 $file_data=fwrite($filenum,$data); 
 fclose($filenum); 
 return $file_data; 
}
PHP 相关文章推荐
3.从实例开始
Oct 09 PHP
提取HTML标签
Oct 09 PHP
允许phpmyadmin空密码登录的配置方法
May 29 PHP
Codeigniter实现处理用户登录验证后的URL跳转
Jun 12 PHP
PHP模板解析类实例
Jul 09 PHP
UPUPW 更新 64 位 Apache 系列 PHP 7.0 正式版
Dec 08 PHP
Smarty模板变量调节器用法分析
May 23 PHP
基于PHPexecl类生成复杂的报表表头示例
Oct 14 PHP
jquery+thinkphp实现跨域抓取数据的方法
Oct 15 PHP
thinkPHP5框架自定义验证器实现方法分析
Jun 11 PHP
php 中htmlentities导致中文无法查询问题
Sep 10 PHP
Yii框架安装简明教程
May 15 PHP
php图片验证码代码
Mar 27 #PHP
几个php应用技巧
Mar 27 #PHP
PHP详细彻底学习Smarty
Mar 27 #PHP
php中用文本文件做数据库的实现方法
Mar 27 #PHP
Discuz! Passport 通行证整合
Mar 27 #PHP
FCKeditor添加自定义按钮
Mar 27 #PHP
php,ajax实现分页
Mar 27 #PHP
You might like
简单了解PHP编程中数组的指针的使用
2015/11/30 PHP
php大小写转换函数(strtolower、strtoupper)用法介绍
2017/11/17 PHP
PHP实现函数内修改外部变量值的方法示例
2018/12/28 PHP
Laravel 实现Controller向blade前台模板赋值的四种方式小结
2019/10/22 PHP
Extjs在exlipse中设置自动提示的方法
2010/04/07 Javascript
高性能WEB开发 flush让页面分块,逐步呈现 flush让页面分块,逐步呈现
2010/06/19 Javascript
jquery不会自动回收xmlHttpRequest对象 导致了内存溢出
2012/06/18 Javascript
js优化针对IE6.0起作用(详细整理)
2012/12/25 Javascript
JS将表单导出成EXCEL的实例代码
2013/11/11 Javascript
Javascript 按位与运算符 (&amp;)使用介绍
2014/02/04 Javascript
JQuery实现动态表格点击按钮表格增加一行
2014/08/24 Javascript
利用vue-router实现二级菜单内容转换
2016/11/30 Javascript
jQuery实现二维码扫描功能
2017/01/09 Javascript
three.js实现围绕某物体旋转
2017/01/25 Javascript
JS实现身份证输入框的输入效果
2017/08/21 Javascript
vue组件与复用详解
2018/04/08 Javascript
Webpack打包字体font-awesome的方法示例
2018/04/26 Javascript
使用vuepress搭建静态博客的示例代码
2019/02/14 Javascript
vue+element UI实现树形表格带复选框的示例代码
2019/04/16 Javascript
js中的this的指向问题详解
2019/08/29 Javascript
浅谈python配置与使用OpenCV踩的一些坑
2018/04/02 Python
使用pytorch进行图像的顺序读取方法
2018/07/27 Python
python 对字典按照value进行排序的方法
2019/05/09 Python
Python爬虫入门有哪些基础知识点
2020/06/02 Python
pytorch快速搭建神经网络_Sequential操作
2020/06/17 Python
h5调用摄像头的实现方法
2016/06/01 HTML / CSS
复古斯堪的纳维亚儿童服装:Baby go Retro
2017/09/09 全球购物
儿科护士实习自我鉴定
2013/10/17 职场文书
八项规定整改措施
2014/02/12 职场文书
警示教育活动总结
2014/05/05 职场文书
元旦标语大全
2014/10/09 职场文书
四风问题查摆剖析材料
2014/10/11 职场文书
大学生自我评价范文
2015/03/03 职场文书
妈妈别哭观后感
2015/06/08 职场文书
2016年基层党组织创先争优承诺书
2016/03/25 职场文书
Django REST framework 限流功能的使用
2021/06/24 Python