PHP Yapıcı Metot: __construct ve Özellik Yükseltme

PHP yapıcısı __construct() adlı bir metottur. new ClassName(...) yazdığınızda PHP onu otomatik olarak çağırır ve parantez içindeki argümanlar onun parametreleri olur, böylece nesne değerleri zaten ayarlanmış olarak hayata başlar.

<?php
class User
{
    public string $name;
    public int $age;

    public function __construct(string $name, int $age)
    {
        $this->name = $name;
        $this->age = $age;
    }
}

$ada = new User('Ada', 36);
echo "{$ada->name} is {$ada->age}\n";

Yapıcı olmadan boş bir nesne oluşturur ve her özelliği sonradan ayarlardınız; birini unutmanızı hiçbir şey engellemezdi. Bir yapıcıyla argümansız new User() bir ArgumentCountError olur.

Yapıcı özellik yükseltme

Bir özelliği tanımlamak, onu parametre olarak listelemek ve $this->name = $name atamasını yapmak her adı üç kez tekrarlar. PHP 8.0'dan beri bir yapıcı parametresinin önündeki bir görünürlük anahtar kelimesi üçünü birden yapar:

<?php
class User
{
    public function __construct(
        public string $name,
        public int $age,
        private string $email = '',
    ) {}

    public function contact(): string
    {
        return $this->email !== '' ? $this->email : 'no email';
    }
}

$u = new User('Grace', 45, 'grace@example.com');
echo $u->name, ', ', $u->age, ', ', $u->contact(), "\n";

$v = new User('Linus', 28);
echo $v->name, ', ', $v->contact(), "\n";

Yükseltilmiş bir parametre readonly da olabilir (public readonly string $id); bu, değiştirilemez bir değer nesnesi yazmanın en kısa yoludur. Yükseltilmiş ve normal parametreleri karıştırabilirsiniz ve yapıcı gövdesi, yükseltilmiş özellikler atandıktan sonra çalışan kod içermeye devam edebilir.

Varsayılan değerler ve adlandırılmış argümanlar

Yapıcı parametreleri her fonksiyon gibi varsayılan değer alır. Varsayılanlı parametreler zorunlu olanlardan sonra gelir. Adlandırılmış argümanlarla (PHP 8.0) çağıran, önündeki her varsayılanı tekrarlamak yerine istediği seçeneğe atlayabilir:

<?php
class Button
{
    public function __construct(
        public string $label,
        public string $color = 'blue',
        public string $size = 'medium',
        public bool $disabled = false,
    ) {}

    public function render(): string
    {
        $attr = $this->disabled ? ' disabled' : '';
        return "<button class=\"{$this->color} {$this->size}\"{$attr}>{$this->label}</button>";
    }
}

echo (new Button('Save'))->render(), "\n";
echo (new Button('Delete', 'red'))->render(), "\n";
echo (new Button('Wait', disabled: true))->render(), "\n";

Çalıştırın: çıktı HTML içerir, bu yüzden Page sekmesi oluşturulan üç düğmeyi, Output sekmesi ise PHP'nin yazdırdığı etiketleri gösterir. (new Button('Save'))->render() içindeki parantezlere dikkat edin: PHP 8.4'ten beri isteğe bağlıdırlar, ama PHP 8.3 onları ister.

Argümanları yapıcıda doğrulama

Bir yapıcı false veya bir hata kodu döndüremez: döndürdüğü her şey yok sayılır. Hatalı girdiyi reddetmek için bir istisna fırlatın. Nesne o zaman hiç oluşturulmaz, böylece programın geri kalanı aldığı her Temperature nesnesine güvenebilir.

<?php
class Temperature
{
    public function __construct(public readonly float $celsius)
    {
        if ($celsius < -273.15) {
            throw new InvalidArgumentException("Below absolute zero: $celsius");
        }
    }

    public function fahrenheit(): float
    {
        return $this->celsius * 9 / 5 + 32;
    }
}

echo (new Temperature(21.5))->fahrenheit(), "\n";

try {
    $t = new Temperature(-300);
} catch (InvalidArgumentException $e) {
    echo 'Rejected: ', $e->getMessage(), "\n";
}

try catch sayfası bu istisnaları yakalamayı daha ayrıntılı anlatır.

Statik fabrika metotlarıyla birden çok yapıcı

PHP'de yapıcı aşırı yükleme yoktur: bir sınıf, bir __construct. Bir nesne farklı girdilerden (bir tarih dizgesi, bir dizi, bir zaman damgası) oluşturulabiliyorsa, argümanları hazırlayıp new static(...) çağıran adlandırılmış statik metotlar ekleyin. Yapıcıyı private yapmak herkesi fabrikalardan geçmeye zorlar.

<?php
class Color
{
    private function __construct(
        public readonly int $r,
        public readonly int $g,
        public readonly int $b,
    ) {}

    public static function fromRgb(int $r, int $g, int $b): static
    {
        return new static($r, $g, $b);
    }

    public static function fromHex(string $hex): static
    {
        [$r, $g, $b] = sscanf(ltrim($hex, '#'), '%02x%02x%02x');
        return new static($r, $g, $b);
    }

    public function css(): string
    {
        return "rgb({$this->r}, {$this->g}, {$this->b})";
    }
}

echo Color::fromRgb(255, 128, 0)->css(), "\n";
echo Color::fromHex('#1e90ff')->css(), "\n";

Sınıfın dışından new Color(1, 2, 3) artık bir Error fırlatır ("Call to private Color::__construct() from global scope"). static sayfası burada neden new self yerine new static kullanıldığını açıklar.

Üst sınıfın yapıcısını parent::__construct ile çağırma

Bir alt sınıf kendi yapıcısını tanımladığında üst sınıfın yapıcısı kendiliğinden çalışmaz. Onu parent::__construct(...) ile, genellikle ilk sırada çağırın, böylece alt sınıf kendi özelliklerini eklemeden önce üst sınıfın özellikleri ayarlanır:

<?php
class Vehicle
{
    public function __construct(
        protected string $brand,
        protected int $wheels = 4,
    ) {}

    public function describe(): string
    {
        return "{$this->brand} with {$this->wheels} wheels";
    }
}

class Truck extends Vehicle
{
    public function __construct(string $brand, private int $capacityKg)
    {
        parent::__construct($brand, 6);
    }

    public function describe(): string
    {
        return parent::describe() . ", carries {$this->capacityKg} kg";
    }
}

echo (new Vehicle('Fiat'))->describe(), "\n";
echo (new Truck('Volvo', 18000))->describe(), "\n";

Alt sınıfın hiç yapıcısı yoksa PHP üst sınıfınkini kullanır ve new Truck('Volvo') argümanlarını doğrudan Vehicle::__construct metoduna verirdi. Bununla ilgili daha fazlası kalıtım sayfasında.

parent::__construct çağrısını unutmak

Bu hata, gerçekleştiği satırda hiçbir hata üretmez. Alt sınıfın yapıcısı çalışır, üst sınıfın türlü özellikleri başlatılmamış kalır ve program daha sonra, ilk okumanın yapıldığı yerde başarısız olur:

<?php
class Model
{
    protected array $attributes;

    public function __construct()
    {
        $this->attributes = ['created' => '2026-03-14'];
    }

    public function get(string $key): mixed
    {
        return array_key_exists($key, $this->attributes) ? $this->attributes[$key] : null;
    }
}

class Post extends Model
{
    public function __construct(public string $title)
    {
        // parent::__construct() is missing
    }
}

$post = new Post('Hello');
try {
    echo $post->get('created'), "\n";
} catch (Error $e) {
    echo $e->getMessage(), "\n";
}

Post::__construct metodunun ilk satırı olarak parent::__construct(); ekleyin ve tekrar çalıştırın: tarihi yazdırır. İlgili bir metot olan __destruct(), bir nesneye yapılan son referans ortadan kalktığında ya da betik bittiğinde çalışır. Günlük kodda nadiren gerekir, çünkü PHP her isteğin sonunda dosyaları kendisi kapatır ve belleği serbest bırakır.