文件包含

在实际应用中，往往需要将一些公用的代码放到一个单独的文件中，其他的文件只需要包含这个文件就可以了。这样做，有助于提高代码的重用性，并为后期维护带来很大的便利。本节将要介绍如何在PHP中实现文件包含操作。

 使用require和require_once语句进行文件包含

require语句用于将指定的文件包含到代码本身，其语法格式如下。

require(string filename)

其中filename指代要包含的文件的文件名。需要注意的是虽然require语句是写在PHP代码中的，但是被包含的文件仍然要按照一个完整的PHP脚本文件来写。即用“<?php … ?>”来标记其中的PHP代码。

以下代码是一个使用require语句实现文件包含的例子。其中include.inc文件是被包含文件，test.php用于包含include.inc文件。

include.inc的代码如下。

<?php

if($score>60 or $score==60)

    echo "及格";

if(!($score>60 or $score==60))

    echo "不及格";

?>

test.php的代码如下所示。

<?php

$score = 60;

require("include.inc");                         //包含include.inc

?>

运行结果如下所示。

及格

可以看到，变量$score在包含的文件中同样有效。上面的代码与下面的代码完全相同。

<?php

$score = 60;

if($score>60 or $score==60)

    echo "及格";

if(!($score>60 or $score==60))

    echo "不及格";

?>

require语句还可以使用return语句来返回一个值，这个特性有些类似于将require看做函数了。以下代码使用这一特性改写了上面的例子，实现了同样的功能。

include.inc的代码如下所示。

<?php

if($score>60 or $score==60)

    $result = "及格";

if(!($score>60 or $score==60))

    $result = "不及格";

return $result;

?>

test.php的代码如下所示。

<?php

$score = 60;

echo require("include.inc");                        //输出require的返回结果

?>

 

 使用include与include_once语句进行文件包含

PHP还提供了一种文件包含语句，即include语句。include语句在使用方法和功能上与require语句几乎完全相同。主要的不同点有以下两点。

1．机制不同

require语句在进行文件包含时，不管这条require语句是否被运行，都会将被包含文件中的代码包含进来。而include语句在进行文件包含时，如果这条include语句没有被运行，则被包含文件中的代码将不会被包含进来，如以下代码所示。

<?php

$a = 1;

if($a == 2)                                     //如果$a等于2，则调用include.inc

    require("include.inc");

?>

在这个例子中，if语句的条件无法被满足，因此，程序将不会执行require语句。但是，由于require语句的运行机制，include.inc中的代码仍然会被包含进来，但是没有被调用。使用include语句改写上面的例子，代码如下。

<?php

$a = 1;

if($a == 2)                                 //如果$a等于2，则调用include.inc

    include("include.inc");

?>

在这个例子中，程序将不会把include.inc中的代码包含进来。

2．文件不存在时的错误处理方式不同

如果被包含文件无法找到，require语句与include语句的错误提示是不相同的。require语句会抛出一个致命错误并终止脚本的运行，而include只会抛出警告信息。以下代码中，incl.inc是一个不存在的文件。使用require语句的代码如下。

<?php

require("incl.inc");                                //调用incl.inc

echo "This is a test";

?>

运行结果如下所示。

Warning: require(incl.inc) [function.require]: failed to open stream: No such file or directory in C:\htdocs\TEST\test.php on line 2

 

Fatal error: require() [function.require]: Failed opening required 'incl.inc' (include_path='.;C:\php\pear\') in C:\htdocs\TEST\test.php on line 2

可以看到，错误类型为“Fatal error”，并且代码在require语句处终止了。将require改写成include的代码如下所示。

<?php

include("incl.inc");

echo "This is a test";

?>

运行结果如下所示。

Warning: include(incl.inc) [function.include]: failed to open stream: No such file or directory in C:\htdocs\TEST\test.php on line 2

 

Warning: include() [function.include]: Failed opening 'incl.inc' for inclusion (include_path='.;C:\php\pear\') in C:\htdocs\TEST\test.php on line 2

 

This is a test

可以看到，错误类型为“Warning”，并且代码并没有在include语句处终止，下面的代码仍然被运行了。

与require和require_once的关系类似，include也有一个相对应的require_once语句用来处理重定义错误的问题。其用法和功能与require_once完全相同

转载于:https://my.oschina.net/u/3304754/blog/853704