PHP Include Dosyası

Sunucu tarafı içermek (SSI), birden fazla sayfada tekrar kullanılabilir fonksiyonlar, başlık, alt başlık veya unsurlar oluşturmak için kullanılır.

include (veya require) cümlesi, belirtilen dosyada mevcut tüm metin/kod/etiketleri alır ve include cümlesi kullanan dosyaya kopyalar.

Aynı PHP, HTML veya metni web sitesinin birçok sayfasında kullanmak gerektiğinde, dosya içermek oldukça kullanışlıdır.

PHP include ve require cümleleri

include veya require cümleleri ile, PHP dosyasının içeriği bir başka PHP dosyasına eklenebilir (sunucu çalışmadan önce).

include ve require cümleleri hataların işleme açısından aynıdır:

  • require ciddi bir hata (E_COMPILE_ERROR) oluşturur ve betiki durdurur
  • include yalnızca uyarı (E_WARNING) oluşturur ve betik devam eder

Bu yüzden, içermek dosyasını kaybettiğinizde de devam etmek ve kullanıcıya sonuçları çıkarmak istiyorsanız, include kullanın. Aksi takdirde, çerçeve, CMS veya karmaşık PHP uygulama programlama yapılarında, kritik dosyaların kaybolması durumunda güvenlik ve bütünlüğü artırmak için her zaman require kullanın.

Dosya içermek, çok çalışmayı azaltır. Bu, tüm sayfalar için standart başlık, ayak izi veya menü dosyaları oluşturmanızı anlamına gelir. Sonra, başlık gerektiğinde güncellemek için sadece bu başlık içermek dosyasını güncellemeniz yeterlidir.

Sözdizimi

include 'filename';

veya

require 'filename';

PHP include Örneği

Örnek 1

Örneğin, "footer.php" adında bir standart ayak izi dosyası var, böyle:

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

Bu sayfa ayak izi dosyasını bir sayfada kullanmak istiyorsanız, include ifadesini kullanın:

<html>
<body>
<h1>Web Sitemize Hoş Geldiniz!</h1>
<p>Bir metin parçası.</p>
<p>Bir metin parçası.</p>
<?php include 'footer.php';?>
</body>
</html>

Çalıştırma Örneği

Örnek 2

Örneğin, "menu.php" adında bir standart menü dosyası var:

<?php
echo '<a href="/index.asp">Ana Sayfa</a> -
<a href="/html/index.asp">HTML Eğitimi</a> -
<a href="/css/index.asp">CSS Eğitimi</a> -
<a href="/js/index.asp">JavaScript Eğitimi</a> -
<a href="/php/index.asp">PHP Eğitimi</a>';
?>

Web sayfalarının tümü bu menü dosyasını kullanır. Bu, bir <div> elementi kullanarak yapılır, böylece gelecekte CSS ile kolayca stillendirilebilir:

<html>
<body>
<div class="menu">
<?php include 'menu.php';?>
</div>
<h1>Welcome to my home page!</h1>
<p>Some text.</p>
<p>Some more text.</p>
</body>
</html>

Çalıştırma Örneği

Örnek 3

Örneğin, "vars.php" adında bir dosya var ve bazı değişkenler tanımlıyor:

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

Sonra, bu "vars.php" dosyasını çağırdığımızda, bu değişkenleri çağırma dosyasında kullanabiliriz:

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

Çalıştırma Örneği

PHP include vs. require

require ifadesi de PHP koduna dosya çağırma için kullanılır.

Ancak, include ve require arasında büyük bir fark vardır: Bir dosyayı include ifadesi ile çağırdığınızda ve PHP dosyayı bulamazsa, script devam eder:

Örnek

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

Çalıştırma Örneği

Eğer require ifadesi ile aynı örneği tamamlarsak, echo ifadesi devam etmez çünkü script, require ifadesi sonunda ciddi bir hata döndüğünde sonlandırılır:

Örnek

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

Çalıştırma Örneği

Yorum:

Bu anda require kullanın: Dosya uygulama tarafından talep edildiğinde.

Bu anda include kullanın: Dosya gerekli değilse ve uygulama dosya bulunmadığında devam etmeliyse.