include ve require arasındaki fark nedir?

Question

Accepted Answer

Hem `include` hem de `require` başka bir PHP dosyasının içeriğini geçerli dosyaya aktarır (ve çalıştırır). **Tek fark başarısızlık durumunda nasıl davranıldığıdır**: `require` dosya eksikse ölümcül bir hata meydana getirirken, `include` sadece bir uyarı yayar ve devam eder.

## Temel fark: başarısızlık davranışı

```php
<?php
include "config.php";    // if missing → WARNING, script CONTINUES
require "database.php";  // if missing → FATAL ERROR, script STOPS
```

```text
include → file missing → emits a Warning, execution continues (file's code skipped)
require → file missing → throws a Fatal Error, execution HALTS
```

Uygulamanın **çalışmadan vazgeçemeyeceği** dosyalar için **`require`** kullanın (temel sınıflar, kritik yapılandırma, veritabanı kurulumu) — eksik olduğunda sert şekilde durmasını istersiniz. **Opsiyonel dosyalar** (örneğin bir kenar çubuğu şablonu) için **`include`** kullanın, burada eksik dosya sayfayı çökertmemelidir.

## _once varyantları (çift dahil etmeyi önlemek)

```php
require_once "functions.php";   // include the file ONLY if not already included
include_once "helper.php";
```

`require_once`/`include_once` dosyayı sadece daha önce dahil edilmemişse aktarır — bir dosya birden fazla kez dahil edilebilirse (örneğin bir sınıf tanımı çeşitli dosyalar tarafından çekilirse) "function/class yeniden bildirilemez" hatalarından kaçınmak için **kritiktir**.

## Dahil etme aslında ne yapar

```php
// included files share the SAME scope and can define functions, classes, variables
// config.php:
$dbHost = "localhost";
// main.php:
require "config.php";
echo $dbHost;   // "localhost" — the variable is available
```

## Modern PHP: otomatik yükleme manuel dahil etmeleri değiştirir

```php
// ❌ old style — manually requiring every class file
require_once "User.php";
require_once "Order.php";

// ✅ modern — Composer AUTOLOADING loads classes on demand automatically
require "vendor/autoload.php";   // one line; classes load when used (PSR-4)
$user = new User();               // User.php loaded automatically
```

Modern PHP'de sınıflar için manual `require` nadiren kullanırsınız — **Composer'ın otomatik yükleyicisi** onları ihtiyaç halinde yükler. Yine de bunu başlatmak için bir kez `require "vendor/autoload.php"` kullanırsınız.

## Neden önemli

`include` ve `require` arasındaki farkı anlamak temel ancak önemli PHP bilgisidir — bunlar PHP dosyalarının kod paylaştığı yollar ve ayrım doğruluk için önemlidir.

Temel nokta başarısızlık davranışıdır: **kritik dosyalar için `require`** (böylece kritik bir dosya eksikse uygulama hızlı ve açık şekilde başarısız olur) ve **opsiyonel dosyalar için `include`** (böylece eksik bir kritik olmayan dosya sayfayı çökertmez).

**`_once` varyantlarını** bilmek bir sınıf veya fonksiyon tanımını yanlışlıkla iki kez dahil etmekten kaynaklanan yaygın "yeniden bildirilemez" hatalarını önlemek için pratik açıdan gereklidir.

Eşit derecede önemli olan modern bağlamı anlamaktır: bu yapılar temeldir ancak **modern PHP Composer otomatik yüklemesine dayanır** (sınıfları ihtiyaç halinde yükler) her dosyayı manuel olarak require etmek yerine, bu yüzden güncel kodda çoğunlukla sadece bir kez `require "vendor/autoload.php"` yaparsınız ve otomatik yükleyicinin geri kalanını işlemesini sağlarsınız.

include/require mekaniklerini (ve her başarısızlık modunun ne zaman uygun olduğunu) ve modern otomatik yüklemesinin manuel dahil etmeleri nasıl geçersiz kıldığını bilmek eski ve yeni PHP kod tabanlarıyla çalışmak için gündelik bilgidir.