الباني في PHP: __construct وترقية الخصائص

الباني في PHP تابع اسمه __construct(). تستدعيه PHP تلقائيًا عندما تكتب new ClassName(...)، وتصبح الوسائط بين القوسين معاملاته، فيبدأ الكائن حياته وقيمه مضبوطة أصلًا.

<?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";

دون باني ستنشئ كائنًا فارغًا وتضبط كل خاصية بعده، ولن يمنعك شيء من نسيان إحداها. ومع الباني، تكون new User() دون وسائط خطأ ArgumentCountError.

ترقية خصائص الباني

تعريف خاصية، وذكرها معاملًا، وإسناد $this->name = $name يكرر كل اسم ثلاث مرات. ومنذ PHP 8.0، تفعل كلمة رؤية أمام معامل الباني الثلاثة معًا:

<?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";

يمكن أن يكون المعامل المرقّى أيضًا readonly (public readonly string $id)، وهي أقصر طريقة لكتابة كائن قيمة غير قابل للتغيير. ويمكنك المزج بين المعاملات المرقّاة والعادية، ويظل جسم الباني قادرًا على احتواء شيفرة تعمل بعد إسناد الخصائص المرقّاة.

القيم الافتراضية والوسائط المسماة

تأخذ معاملات الباني قيمًا افتراضية مثل أي دالة. وتأتي المعاملات ذات القيم الافتراضية بعد الإلزامية. ومع الوسائط المسماة (PHP 8.0) يستطيع المستدعي القفز إلى الخيار الذي يريده بدل تكرار كل قيمة افتراضية قبله:

<?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";

شغّله: تحتوي المخرجات HTML، لذا يعرض تبويب Page الأزرار الثلاثة، ويعرض تبويب Output الوسوم التي طبعتها PHP. لاحظ الأقواس في (new Button('Save'))->render(): منذ PHP 8.4 هي اختيارية، لكن PHP 8.3 تحتاج إليها.

التحقق من الوسائط في الباني

لا يستطيع الباني إعادة false أو رمز خطأ: يُتجاهل كل ما يعيده. لرفض المُدخلات الخاطئة، ارمِ استثناءً. عندها لا يُنشأ الكائن أبدًا، فيستطيع بقية البرنامج الوثوق بكل Temperature يتلقاها.

<?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 التقاط هذه الاستثناءات بمزيد من التفصيل.

عدة بوانٍ بتوابع مصنع ساكنة

ليس في PHP تحميل زائد للبواني: صنف واحد، __construct واحد. وعندما يمكن بناء الكائن من مُدخلات مختلفة (نص تاريخ، مصفوفة، طابع زمني)، أضف توابع ساكنة مسماة تجهّز الوسائط وتستدعي new static(...). وجعل الباني private يجبر الجميع على المرور عبر توابع المصنع.

<?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";

صار new Color(1, 2, 3) من خارج الصنف يرمي Error ("Call to private Color::__construct() from global scope"). وتشرح صفحة static لماذا تُستخدم new static هنا بدل new self.

استدعاء باني الأب بـ parent::__construct

عندما يعرّف صنف ابن بانيه الخاص، لا يعمل باني الأب من تلقاء نفسه. استدعه بـ parent::__construct(...)، عادة أولًا، حتى تُضبط خصائص الأب قبل أن يضيف الابن خصائصه:

<?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";

إذا لم يكن للابن باني أصلًا، تستخدم PHP باني الأب، فتمرر new Truck('Volvo') وسائطها مباشرة إلى Vehicle::__construct. مزيد عن هذا في الوراثة.

نسيان parent::__construct

لا ينتج هذا الخطأ أي رسالة في السطر الذي يحدث فيه. يعمل باني الابن، وتبقى خصائص الأب ذات الأنواع غير مهيأة، ويفشل البرنامج لاحقًا، حيثما تحدث أول قراءة:

<?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";
}

أضف parent::__construct(); سطرًا أول في Post::__construct وشغّله مرة أخرى: يطبع التاريخ. وهناك تابع ذو صلة، __destruct()، يعمل عندما يختفي آخر مرجع إلى كائن أو ينتهي السكربت. ونادرًا ما تحتاجه في الشيفرة اليومية، لأن PHP تغلق الملفات وتحرر الذاكرة بنفسها في نهاية كل طلب.