File disertakan berdasarkan jalur file yang diberikan atau, jika tidak ada yang diberikan, ditentukan. Jika file tidak ditemukan di , Perhatikan bahwa Jika jalur ditentukan — apakah absolut (dimulai dengan huruf drive atau Untuk informasi lebih lanjut tentang cara PHP menangani termasuk file dan jalur penyertaan, lihat dokumentasi untuk Saat file disertakan, kode yang dikandungnya mewarisi cakupan variabel dari baris tempat penyertaan terjadi. Setiap variabel yang tersedia pada baris tersebut di file pemanggil akan tersedia di dalam file yang dipanggil, sejak saat itu. Namun, semua fungsi dan kelas yang ditentukan dalam file yang disertakan memiliki cakupan global Contoh #1 Contoh Dasar
Jika penyertaan terjadi di dalam suatu fungsi di dalam file pemanggil, maka semua kode yang terkandung dalam file yang dipanggil akan berlaku seolah-olah telah ditentukan di dalam fungsi tersebut. Jadi, itu akan mengikuti ruang lingkup variabel dari fungsi itu. Pengecualian untuk aturan ini adalah konstanta ajaib yang dievaluasi oleh parser sebelum penyertaan terjadi Contoh #2 Termasuk di dalam fungsi
Saat file disertakan, penguraian keluar dari mode PHP dan ke mode HTML di awal file target, dan dilanjutkan lagi di akhir. Untuk alasan ini, setiap kode di dalam file target yang harus dijalankan sebagai kode PHP harus disertakan dalam tag awal dan akhir PHP yang valid Jika "" diaktifkan di PHP, Anda dapat menentukan file yang akan disertakan menggunakan URL (melalui HTTP atau pembungkus lain yang didukung - lihat Protokol dan Pembungkus yang Didukung untuk daftar protokol) alih-alih nama jalur lokal. Jika server target menginterpretasikan file target sebagai kode PHP, variabel dapat diteruskan ke file yang disertakan menggunakan string permintaan URL seperti yang digunakan dengan HTTP GET. Ini tidak sepenuhnya berbicara hal yang sama dengan menyertakan file dan membuatnya mewarisi cakupan variabel file induk; Contoh #3
Peringatan File jarak jauh dapat diproses di server jarak jauh (tergantung pada ekstensi file dan fakta apakah server jarak jauh menjalankan PHP atau tidak) tetapi tetap harus menghasilkan skrip PHP yang valid karena akan diproses di server lokal. Jika file dari server jarak jauh harus diproses di sana dan hanya dikeluarkan, readfile() adalah fungsi yang jauh lebih baik untuk digunakan. Jika tidak, perhatian khusus harus diberikan untuk mengamankan skrip jarak jauh agar menghasilkan kode yang valid dan diinginkan Lihat juga File jarak jauh, fopen() dan file() untuk informasi terkait Menangani Pengembalian. Karena Contoh #4 Membandingkan nilai kembalian dari penyertaan
Contoh #5
Jika ada fungsi yang ditentukan dalam file yang disertakan, fungsi tersebut dapat digunakan di file utama secara independen jika sebelum kembali atau sesudahnya. Jika file dimasukkan dua kali, PHP akan memunculkan kesalahan fatal karena fungsinya sudah dideklarasikan. Direkomendasikan untuk menggunakan include_once alih-alih memeriksa apakah file sudah disertakan dan secara kondisional kembali ke dalam file yang disertakan Cara lain untuk "memasukkan" file PHP ke dalam variabel adalah dengan menangkap keluaran menggunakan Fungsi Kontrol Keluaran dengan Contoh #6 Menggunakan output buffering untuk memasukkan file PHP ke dalam string
Untuk memasukkan file secara otomatis ke dalam skrip, lihat juga opsi dan konfigurasi di php. ini
|