PHP Include Files

Ang server-side include (SSI) ay ginagamit upang lumikha ng mga function, header, footer o elemento na pwedeng gamitin sa maraming pahina.

Ang include (o require) na salitang ito ay kumukuha ng lahat ng teksto/kodigo/pinakamarka na nasa tinukoy na file at kopyahin ito sa file na ginamit ang include na salitang ito.

Ang paglalaman ng file ay napaka-kagamit, kapag kailangan mong gamitin ang parehong PHP, HTML o teksto sa ilang pahina ng iyong website.

PHP include at require na salitang ito

Sa pamamagitan ng include o require na salitang ito, maaring idagdag ang nilalaman ng PHP na file sa ibang PHP na file (bago ito ipatnubay sa server).

Include ato require ang mga salitang ito ay katulad, maliban sa panglilingkod na error:

  • Ang require ay gumagawa ng critical error (E_COMPILE_ERROR) at titigil ang script
  • Ang include ay gumagawa lamang ng babala (E_WARNING), at magpapatuloy ang script

Kaya't kung nais mong magpatuloy sa pagpapatupad at ipakita sa user ang resulta, kahit nawawala ang file na nakakabit, gamit ang include. Sa ibang paraan, sa framework, CMS o kumplikadong pagpapatupad ng PHP application, palaging gamitin ang require para sa pagpapatugon ng kritikal na file. Ito ay tumutulong upang madagdagan ang seguridad at integridad ng application, kapag nawawala ang kritikal na file sa isang kahi-hanghihing sitwasyon.

Ang pagkakabit ng file ay naglalayong mabawasan ang maraming gawain. Ito ay nangangahulugan na maaaring gumawa ng standard na header, footer o menu file para sa lahat ng pahina. Pagkatapos, kapag kailangan na upang i-update ang header, ibutang lamang ang file na binabago ang header na nakakabit.

Grammar

include 'filename';

o

require 'filename';

PHP include example

Mga halimbawa 1

Imaginang mayroon kaming isang standard na file na footer na katulad nito:

<?php
echo "<p>Copyright © 2006-" . date("Y") . " codew3c.com</p>";
?>

Kung nais mong i-quote ang file na page footer sa isang pahina, gamit ang statement na include:

<html>
<body>
<h1>Welcome to Our Homepage!</h1>
<p>Isang teksto.</p>
<p>Isang teksto.</p>
<?php include 'footer.php';?>
</body>
</html>

运行实例

Mga halimbawa 2

Imaginang mayroon kaming isang standard na file na menu na may pangalang "menu.php":

<?php
echo '<a href="/index.asp">Home</a> -
<a href="/html/index.asp">HTML Tutorial</a> -
<a href="/css/index.asp">CSS Tutorial</a> -
<a href="/js/index.asp">JavaScript Tutorial</a> -
<a href="/php/index.asp">PHP Tutorial</a>';
?>

Ang lahat ng pahina sa websayt ay gumagamit ng file na menu na ito. Ang detalye ay (ginamit namin ang isang <div> element, upang mas madaling i-set ang estilo sa pamamagitan ng CSS sa hinaharap):

<html>
<body>
<div class="menu">
<?php include 'menu.php';?>
</div>
<h1>欢迎访问我的首页！</h1>
<p>Ilang teksto.</p>
<p>Ilang dagdag na teksto.</p>
</body>
</html>

运行实例

Mga halimbawa 3

Imaginang mayroon kaming isang file na may pangalang "vars.php", na naglalarawan ng ilang variable:

<?php
$color='银色的';
$car='奔驰轿车';
?>

然后，如果我们引用这个 "vars.php" 文件，就可以在调用文件中使用这些变量：

<html>
<body>
<h1>欢迎访问我的首页！</h1>
<?php
include 'vars.php';
echo "我有一辆" . $color . $car "。";
?>
</body>
</html>

运行实例

PHP include vs. require

require 语句同样用于向 PHP 代码中引用文件。

不过，include 与 require 有一个巨大的差异：如果用 include 语句引用某个文件并且 PHP 无法找到它，脚本会继续执行：

实例

<html>
<body>
<h1>Welcome to my home page!</h1>
<?php
include 'noFileExists.php';
echo "I have a $color $car.";
?>
</body>
</html>

运行实例

如果我们使用 require 语句完成相同的案例，echo 语句不会继续执行，因为在 require 语句返回严重错误之后脚本就会终止执行：

实例

<html>
<body>
<h1>Welcome to my home page!</h1>
<?php
require 'noFileExists.php';
echo "I have a $color $car.";
?>
</body>
</html>

运行实例

注释：

请在此时使用 require：当文件被应用程序请求时。

请在此时使用 include：当文件不是必需的，且应用程序在文件未找到时应该继续运行时。