الأصناف والكائنات في PHP: الخصائص والتوابع و$this

يُعرَّف الصنف في PHP بـ class Name { ... } ويحمل خصائص (متغيرات) وتوابع (دوال). تنشئ new Name() كائنًا منه، ويقرأ -> خاصية أو يستدعي تابعًا: $user->name و$user->greet().

<?php
class User
{
    public string $name = 'Guest';

    public function greet(): string
    {
        return "Hello, {$this->name}";
    }
}

$user = new User();
echo $user->greet(), "\n";

$user->name = 'Ada';
echo $user->greet(), "\n";

الصنف هو المخطط، والكائن شيء واحد مبني منه. يمكنك إنشاء ما تحتاجه من كائنات من صنف واحد، ولكل منها قيم خصائصه الخاصة.

الخصائص والتوابع

تُعرَّف الخاصية بكلمة رؤية، ونوع اختياري، وقيمة افتراضية اختيارية. والتابع دالة داخل الصنف. داخل التابع، $this هو الكائن الذي استُدعي عليه التابع، فتقرأ $this->balance رصيد ذلك الكائن.

<?php
class Account
{
    public string $owner = '';
    public float $balance = 0;

    public function deposit(float $amount): void
    {
        $this->balance += $amount;
    }

    public function summary(): string
    {
        return sprintf('%s has %.2f', $this->owner, $this->balance);
    }
}

$a = new Account();
$a->owner = 'Ada';
$a->deposit(50);
$a->deposit(25.5);

$b = new Account();
$b->owner = 'Linus';
$b->deposit(10);

echo $a->summary(), "\n";
echo $b->summary(), "\n";

يحتفظ كل كائن بـ $balance الخاص به: الإيداع في $a لا يمس $b. وضبط الخصائص واحدة واحدة بعد new ممل؛ أما الباني فيأخذ القيم الابتدائية وسائط بدلًا من ذلك.

public وprivate وprotected

تتحكم الرؤية فيمن يستطيع لمس خاصية أو استدعاء تابع:

جعل الخاصية private وكشف التوابع هو طريقة الصنف لحماية قواعده. هنا لا يتغير الرصيد إلا عبر deposit() وwithdraw()، اللتين ترفضان المبالغ الخاطئة:

<?php
class Wallet
{
    private int $cents = 0;

    public function deposit(int $cents): void
    {
        if ($cents <= 0) {
            throw new InvalidArgumentException('Deposit must be positive');
        }
        $this->cents += $cents;
    }

    public function withdraw(int $cents): bool
    {
        if ($cents > $this->cents) {
            return false;
        }
        $this->cents -= $cents;
        return true;
    }

    public function balance(): int
    {
        return $this->cents;
    }
}

$w = new Wallet();
$w->deposit(500);
var_dump($w->withdraw(800));
var_dump($w->withdraw(200));
echo $w->balance(), "\n";

قراءة الخاصية الخاصة من خارج الصنف ليست تحذيرًا، بل Error:

<?php
// This throws an Error on purpose: $cents is private
class Wallet
{
    private int $cents = 500;
}

$w = new Wallet();
echo $w->cents;

الخصائص ذات الأنواع والقيم غير المهيأة

تبدأ الخاصية ذات النوع دون قيمة افتراضية غير مهيأة، وهذا يختلف عن null. وقراءتها قبل إسناد أي شيء إليها ترمي Error. إما أن تعطيها قيمة افتراضية، أو تسندها في الباني، أو تجعلها قابلة لـ null بـ ?Type و= null.

<?php
class Product
{
    public string $name;           // no default: uninitialized
    public ?string $sku = null;    // nullable with a default
    public int $stock = 0;
}

$p = new Product();
var_dump($p->sku, $p->stock);

try {
    echo $p->name;
} catch (Error $e) {
    echo $e->getMessage(), "\n";
}

$p->name = 'Keyboard';
echo $p->name, "\n";

تُفرض الأنواع عند الإسناد. في الوضع الافتراضي (غير الصارم)، تحوّل $p->stock = '7' النص الرقمي إلى 7، بينما ترمي $p->stock = 'many' الخطأ TypeError.

الخصائص readonly

تُكتب الخاصية readonly (PHP 8.1) مرة واحدة، من داخل الصنف، ثم لا تُكتب أبدًا. وهي الطريقة المعتادة لبناء كائنات القيم مثل المبالغ المالية أو المعرّفات. وأضافت PHP 8.2 الصيغة readonly class، التي تجعل كل خاصية readonly.

<?php
class Order
{
    public readonly string $id;

    public function __construct(string $id)
    {
        $this->id = $id;
    }
}

$order = new Order('A-1001');
echo $order->id, "\n";

try {
    $order->id = 'B-2002';
} catch (Error $e) {
    echo $e->getMessage(), "\n";
}

يجب أن يكون للخاصية readonly نوع، ولا يمكن أن تكون لها قيمة افتراضية. إذا احتجت إلى نسخة معدّلة، فأنشئ كائنًا جديدًا (new Order('B-2002')) بدل تعديل القديم.

طباعة كائن بـ __toString

لا تعمل echo $object إلا عندما يعرّف الصنف __toString(). يعيد التابع النص الذي يجب أن تستخدمه PHP كلما عومل الكائن على أنه نص: في echo، وفي ضم النصوص، وفي "{$object}".

<?php
class Money
{
    public function __construct(
        private int $cents,
        private string $currency = 'EUR',
    ) {}

    public function __toString(): string
    {
        return number_format($this->cents / 100, 2) . ' ' . $this->currency;
    }
}

$price = new Money(129900);
echo $price, "\n";
echo 'Total: ' . $price . "\n";
echo "Shipping: " . new Money(450, 'USD') . "\n";

// For debugging, print_r and var_dump show the properties
print_r(new Money(5));

دون __toString، ترمي echo $object الخطأ Error ("Object of class Money could not be converted to string"). ولتصحيح الأخطاء، تعمل print_r() وvar_dump() على أي كائن وتعرضان الخصائص الخاصة أيضًا؛ راجع var_dump وprint_r.

إسناد كائن لا ينسخه

هذا هو الخطأ الذي يوقع معظم القادمين من المصفوفات. إسناد مصفوفة ينسخها. أما إسناد كائن فلا ينسخ إلا المقبض: يشير المتغيران بعدها إلى الكائن نفسه.

<?php
class Point
{
    public int $x = 0;
    public int $y = 0;
}

$a = new Point();
$b = $a;          // same object
$b->x = 10;
echo "a->x = {$a->x}\n";

$c = clone $a;    // independent copy
$c->x = 99;
echo "a->x = {$a->x}, c->x = {$c->x}\n";

var_dump($a === $b, $a === $c, $a == $c);
var_dump($a instanceof Point);
echo get_class($c), "\n";

تصنع clone نسخة سطحية: إذا كانت خاصية تحمل كائنًا آخر، فإن النسختين ما زالتا تتشاركان ذلك الكائن الداخلي. تكون === صحيحة فقط للكائن نفسه، بينما تقارن == قيم خصائص كائنين من الصنف نفسه. وتمرير كائن إلى دالة يعمل بطريقة الإسناد نفسها، لذا تستطيع الدالة تغيير الكائن الذي تتلقاه.