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 相关文章推荐
php实现mysql数据库备份类
Mar 20 PHP
joomla内置的表单验证功能使用方法
Jun 11 PHP
php fputcsv命令 写csv文件遇到的小问题(多维数组连接符)
May 24 PHP
laravel安装和配置教程
Oct 29 PHP
php查看网页源代码的方法
Mar 13 PHP
php+ajax实现的点击浏览量加1
Apr 16 PHP
php比较相似字符串的方法
Jun 05 PHP
PHP判断FORM表单或URL参数来的数据是否为整数的方法
Mar 25 PHP
php通过两层过滤获取留言内容的方法
Jul 11 PHP
php curl获取到json对象并转成数组array的方法
May 31 PHP
Laravel 添加多语言提示信息的方法
Sep 29 PHP
关于laravel后台模板laravel-admin select框的使用详解
Oct 03 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中AES加密解密的例子小结
2014/02/18 PHP
destoon实现商铺管理主页设置增加新菜单的方法
2014/06/26 PHP
使用php实现从身份证中提取生日
2016/05/09 PHP
php桥接模式应用案例分析
2019/10/23 PHP
自己的js工具 Cookie 封装
2009/08/21 Javascript
分别用marquee和div+js实现首尾相连循环滚动效果,仅3行代码
2011/09/21 Javascript
关于jquery css的使用介绍
2013/04/18 Javascript
如何使用Javascript获取距今n天前的日期
2013/07/08 Javascript
asp.net刷新本页面的六种方法总结
2014/01/07 Javascript
上传图片预览JS脚本 Input file图片预览的实现示例
2014/10/23 Javascript
谈谈我对JavaScript原型和闭包系列理解(随手笔记8)
2015/12/24 Javascript
JavaScript的this关键字的理解
2016/06/18 Javascript
jQuery窗口拖动功能的实现代码
2017/02/04 Javascript
AngularJS中$http的交互问题
2017/03/29 Javascript
Vue-Router进阶之滚动行为详解
2017/09/13 Javascript
基于react后端渲染模板引擎noox发布使用
2018/01/11 Javascript
vue使用rem实现 移动端屏幕适配
2018/09/26 Javascript
Element-ui 自带的两种远程搜索(模糊查询)用法讲解
2021/01/29 Javascript
python学习数据结构实例代码
2015/05/11 Python
浅谈插入排序算法在Python程序中的实现及简单改进
2016/05/04 Python
Python 自动化表单提交实例代码
2017/06/08 Python
python虚拟环境virtualenv的使用教程
2017/10/20 Python
pandas的唯一值、值计数以及成员资格的示例
2018/07/25 Python
pycharm修改界面主题颜色的方法
2019/01/17 Python
python 通过视频url获取视频的宽高方式
2019/12/10 Python
Python猴子补丁Monkey Patch用法实例解析
2020/03/23 Python
Python基于BeautifulSoup爬取京东商品信息
2020/06/01 Python
PyCharm MySQL可视化Database配置过程图解
2020/06/09 Python
美国优质宠物用品购买网站:Muttropolis
2020/02/17 全球购物
局部内部类是否可以访问非final变量?
2013/04/20 面试题
《小猫刮胡子》教学反思
2014/02/21 职场文书
校园演讲稿汇总
2014/05/21 职场文书
英语教师自荐信
2014/05/26 职场文书
初一军训感言
2015/08/01 职场文书
加薪申请书应该这样写!
2019/07/04 职场文书
如何用JavaScript实现一个数组惰性求值库
2021/05/05 Javascript