Include Berkas PHP

Server-side Include (SSI) digunakan untuk membuat fungsi, judul halaman, kaki halaman, atau elemen yang dapat digunakan kembali di berbagai halaman.

Perintah include (atau require) akan mengambil semua teks/kode/tanda yang ada di file yang ditentukan dan menyalin ke file yang menggunakan perintah include.

File yang disertakan sangat berguna, jika anda perlu mengutip PHP, HTML, atau teks yang sama di berbagai halaman situs.

Perintah include dan require PHP

Dengan perintah include atau require, anda dapat memasukkan konten file PHP ke dalam file PHP lain (sebelum server menjalankannya).

Perintah include dan require adalah sama, kecuali dalam hal penanganan kesalahan:

  • require akan menghasilkan kesalahan yang parah (E_COMPILE_ERROR) dan menghentikan skrip
  • include hanya menghasilkan peringatan (E_WARNING), dan skrip akan terus berlanjut

Jadi, jika Anda ingin terus melanjutkan dan menampilkan hasil kepada pengguna, bahkan jika file pembiayaan hilang, gunakan include. Jika tidak, di dalam kerangka, CMS, atau pemrograman aplikasi PHP yang kompleks, selalu gunakan require untuk merujuk file penting ke aliran eksekusi. Ini membantu meningkatkan keamanan dan keselamatan aplikasi, dalam kasus file penting hilang dengan sebab yang tak terduga.

Pembiayaan file membuang banyak kerja. Ini berarti Anda dapat membuat header, footer, atau file menu standar untuk semua halaman. Lalu, saat header perlu diperbarui, Anda hanya perlu memperbarui file pembiayaan header ini.

Syarat

include 'filename';

atau

require 'filename';

Contoh PHP include

例子 1

假设我们有一个名为 "footer.php" 的标准的页脚文件，就像这样：

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

Jika Anda ingin mengambil file kaki laman ini di halaman yang sama, gunakan pernyataan include:

<html>
<body>
<h1>Selamat datang ke halaman utama kami!</h1>
<p>Sebuah kalimat teks.</p>
<p>Sebuah kalimat teks.</p>
<?php include 'footer.php';?>
</body>
</html>

Contoh Berjalan

例子 2

假设我们有一个名为 "menu.php" 的标准菜单文件：

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

Semua halaman di situs ini menggunakan file menu ini. Cara khususnya adalah (kami menggunakan elemen <div> sehingga nanti kami dapat dengan mudah mengatur gaya melalui CSS):

<html>
<body>
<div class="menu">
<?php include 'menu.php';?>
</div>
<h1>Selamat Datang ke Laman Rujukan saya!</h1>
<p>Berikut adalah teks.</p>
<p>Berikut adalah teks yang lebih banyak.</p>
</body>
</html>

Contoh Berjalan

例子 3

假设我们有一个名为 "vars.php" 的文件，其中定义了一些变量：

<?php
$color='Perak';
$car='Kereta Mercedes';
?>

Lalu, jika kami merujuk fail 'vars.php' ini, kita boleh menggunakan pemboleh ubah ini di dalam fail panggilan:

<html>
<body>
<h1>Selamat Datang ke Laman Rujukan saya!</h1>
<?php
include 'vars.php';
echo "Saya ada $color $car.";
?>
</body>
</html>

Contoh Berjalan

PHP include vs. require

Kalimat require juga digunakan untuk merujuk fail ke dalam kod PHP.

Walau bagaimanapun, ada perbezaan besar antara include dan require: Jika kalimat include digunakan untuk merujuk fail dan PHP tidak dapat menemui fail itu, skrip akan terus berjalan:

Contoh

<html>
<body>
<h1>Selamat Datang ke Laman Rujukan saya!</h1>
<?php
include 'noFileExists.php';
echo "Saya ada $color $car.";
?>
</body>
</html>

Contoh Berjalan

Jika kami menggunakan kalimat require untuk menyelesaikan kasus yang sama, kalimat echo tidak akan terus berjalan, kerana skrip akan berhenti di sebelah belakang kesalahan yang serius setelah kalimat require kembali:

Contoh

<html>
<body>
<h1>Selamat Datang ke Laman Rujukan saya!</h1>
<?php
require 'noFileExists.php';
echo "Saya ada $color $car.";
?>
</body>
</html>

Contoh Berjalan

Komen:

Sila gunakan require di masa ini: Apabila fail dikehendaki oleh aplikasi.

Sila gunakan include di masa ini: Apabila fail bukan penting dan aplikasi akan terus berjalan apabila fail tidak ditemui.