PERBEDAAN FUNGSI INCLUDE(), INCLUDE_ONCE(), REQUIRE DAN REQUIRE_ONCE

PENGERTIAN FUNGSI INCLUDE(), INCLUDE_ONCE(), REQUIRE DAN REQUIRE_ONCE

PHP memiliki beberapa fungsi untuk menyertakan suatu file yaitu include(), require(), include_once() dan require_once(). 

1. INCLUDE()

 include(), digunakan untuk mengikutsertakan file lain kedalam halaman yang sedang kita buat.

2. INCLUDE_ONCE()

include_once(), secara prinsip sama seperti pada include(), dari segi penggunaannya dan terminologi lainnya. Akan tetapi dengan menggunakan include_once(), maka file yang sama tidak akan boleh dimasukkan lebih dari satu- jadi hanya satu file saja yang dapat dimasukkan ke halaman utama.

3. REQUIRE DAN REQUIRE_ONCE()

Sama seperti include() dan include_once, yaitu melakukan proses penggabungan dengan file-file lain kedalam file induk. Perbedaan yang mendasar adalah require() atau require_once() akan memberikan informasi fatal error jika file bersangkuran tidak ditemukan atau terjadi kesalahan pada file tersebut dan halaman web akan berhenti sehingga script lainnya ditak akan dieksekusi.

Perbedaan Fungsi include() dan require()

Terkait dengan fungsi include(), manual PHP menyatakan bahwa “The include statement includes and evaluates the specified file”. Artinya fungsi include() akan menyertakan dan mengevaluasi seluruh program yang ada di file yang disertakan. Jika terdapat error pada program yang disertakan, maka error akan ditampilkan di layar. Dan jika file yang disertakan ternyata tidak ditemukan (mungkin karena lokasi yang salah atau memang file tidak ada), maka program selanjutnya (setelah include) akan tetap dijalankan walaupun ditampilkan error.

Perhatikan contoh program koneksi.php sederhana berikut ini.

1. <?php
2. mysql_connect("localhost", "root", "")
3. mysql_select_db("demo");
4. ?>

Dan berikut ini program test.php yang akan menyertakan file koneksi.php di atas menggunakan fungsi include()

1. <?php
2. include "conn/koneksi.php";
3. echo "Program setelah koneksi";
4. ?>

Jika program test.php di atas dijalankan dan file koneksi.php berjalan dengan baik dan tidak ada error maka akan ditampilkan text “Program setelah koneksi” tanpa adanya error. Namun jika pada file koneksi.php ternyata tidak ditemukan, maka tulisan “Program setelah koneksi” tetap ditampilkan walaupun disertai error yang disebabkan karena file koneksi.php tidak ditemukan. Berikut ini contoh tampilannya.

Perintah require() pada dasarnya sama dengan perintah include(). Perbedaannya hanya terletak pada saat file yang disertakan tidak ditemukan, maka perintah-perintah selanjutnya tidak akan dijalankan. Perhatikan program test.php di atas. Jika perintah include pada baris ke-2 diganti dengan perintah “require” dan program koneksi.php tidak ditemukan, maka teks “Program setelah koneksi” tidak akan ditampilkan, melainkan hanya menampilkan error. Berikut ini contoh tampilannya.

Perbedaan Antara *_once dan Tanpa “once”

Lalu bagaimana perbedaan antara include() dengan include_once() serta require() dan require_once()? Penambahan akhiran _once baik pada include maupun require akan memastikan bahwa file yang disertakan hanya dieksekusi sekali saja, walaupun file disertakan beberapa kali. Sebaliknya tanpa akhiran _once penyertaan file yang sama beberapa kali mungkin akan menyebabkan error.

Untuk lebih jelasnya perhatikan kedua program berikut ini.

1. <?php
2. class Foo {
3. var $bar = 10;
4. function getBar() {
5. return $bar;
6. }
7. }
8. ?>

Contoh program test2.php yang menyertakan file foo.class.php  di atas sebanyak dua kali.

1. <?php
2. require "foo.class.php";
3. require "foo.class.php";
4. echo "Program setelah pemanggilan";
5. ?>

Pada saat program test2.php di atas dicoba, maka akan terjadi error akibat penyertaan file foo.class.php sebanyak dua kali, sehingga dianggap bahwa pendefinisian class Foo terjadi dua kali. Mendefinisikan suatu class dengan nama yang sama lebih dari satu kali akan mengakibatkan error. Berikut ini tampilan errornya.

untuk menghindari error di atas, kita dapat menambahkan akhiran once di fungsi include maupun require sehingga program hanya akan mengeksekusi penyertaan file sebanyak sekali. Silahkan ganti fungsi require pada baris 2 dan 3 program test2.php di atas dengan fungsi require_once dan cobalah kembali program test2.php. Tidak akan terjadi error.

Anda juga bisa mencoba program dibawah ini agar Anda paham perbedaannya.

Buatlah file php dengan nama panggil.php

Buat juga file php dengan nama coba.php

*Anda bisa mengubah 'require' tersebut menjadi include(), include_once ataupun require_once kemudian jalankan agar Anda dapat mengetahui perbedaannya.

sumber:

http://achmatim.net/2013/10/20/php-perbedaan-fungsi-include-require-include_once-dan-require_once/#codesyntax_1

http://garanteng.blogspot.co.id/2016/07/teknik-modulasi-include-includeonce.html

http://www.dhiezain.com/belajar-php/2015/02/8/perbedaan-fungsi-require-include-require-once-dan-include-once-pada-php.html