Include Berkas PHP

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

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

File include 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 file PHP lainnya (sebelum eksekusi di server).

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

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

Jadi, jika Anda ingin melanjutkan eksekusi dan menampilkan hasil kepada pengguna, bahkan jika berkas include hilang, gunakan include. Jika tidak, di dalam kerangka, CMS, atau pengembangan aplikasi PHP yang kompleks, selalu gunakan require untuk merujuk berkas penting ke aliran eksekusi. Ini membantu meningkatkan keamanan dan keseluruhan aplikasi, khususnya saat berkas penting hilang dengan tak terduga.

Pemilihan berkas yang disertakan membuang banyak kerja. Ini berarti Anda dapat membuat standar header, footer, atau berkas menu untuk semua halaman. Lalu, saat header perlu diperbarui, Anda hanya perlu memperbarui berkas include header ini.

Sintaks

include 'filename';

atau

require 'filename';

Contoh include PHP

Contoh 1

Dengan asumsi kita memiliki sebuah berkas standar kaki halaman bernama "footer.php", seperti ini:

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

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

<html>
<body>
<h1>Selamat datang di halaman beranda kami!</h1>
<p>Teks satu bagian.</p>
<p>Teks satu bagian.</p>
<?php include 'footer.php';?>
</body>
</html>

Contoh Penggunaan

Contoh 2

Dengan asumsi kita memiliki sebuah berkas standar menu bernama "menu.php":

<?php
echo '<a href="/index.asp">Beranda</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 berkas menu ini. Cara lakuannya adalah (kami menggunakan elemen <div> sehingga nanti kami dapat dengan mudah menata gaya melalui CSS):

<html>
<body>
<div class="menu">
<?php include 'menu.php';?>
</div>
<h1>Selamat datang ke halaman rumah saya!</h1>
<p>Bahasa lainnya.</p>
<p>Bahasa lainnya.</p>
</body>
</html>

Contoh Penggunaan

Contoh 3

Dengan asumsi kita memiliki sebuah berkas bernama "vars.php" yang mendefinisikan beberapa variabel:

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

Lalu, jika kita merujuk berkas "vars.php" ini, kita dapat menggunakan variabel ini di berkas yang dipanggil:

<html>
<body>
<h1>Selamat datang ke halaman rumah saya!</h1>
<?php
include 'vars.php';
echo "Saya punya" . $color . $car . ".";
?>
</body>
</html>

Contoh Penggunaan

PHP include vs. require

Kalimat require juga digunakan untuk merujuk berkas ke kode PHP.

Namun, ada perbedaan besar antara include dan require: jika kita menggunakan kalimat include untuk merujuk berkas dan PHP tidak dapat menemukannya, skrip akan terus berjalan:

Contoh

<html>
<body>
<h1> Selamat datang di halaman rumah saya!</h1>
<?php
include 'noFileExists.php';
echo "Saya punya $color $car.";
?>
</body>
</html>

Contoh Penggunaan

Jika kita menggunakan kalimat require untuk menyelesaikan kasus yang sama, kalimat echo tidak akan terus berlanjut, karena skrip akan berhenti setelah kalimat require mengembalikan kesalahan yang serius:

Contoh

<html>
<body>
<h1> Selamat datang di halaman rumah saya!</h1>
<?php
require 'noFileExists.php';
echo "Saya punya $color $car.";
?>
</body>
</html>

Contoh Penggunaan

Komentar:

Gunakan require disaat ini: ketika berkas di minta oleh aplikasi.

Gunakan include disaat ini: ketika berkas bukan penting, dan aplikasi harus terus berjalan saat berkas tidak ditemukan.