الكلمة المفتاحية final

جزء من قسم Object Oriented Programming في رحلة PHP على Coddy — الدرس 24 من 91.

بينما توفر الوراثة (inheritance) وتجاوز الدوال (method overriding) المرونة، ستحتاج أحياناً إلى منع تغيير فئات (classes) أو دوال (methods) معينة. تقوم الكلمة المفتاحية final بقفل الكود الخاص بك، مما يضمن عدم إمكانية تعديل تطبيقات محددة بواسطة الفئات التابعة (child classes).

عندما تقوم بتمييز طريقة (method) كـ final، لا يمكن لأي فئة فرعية (child class) تجاوزها:

<?php
class BankAccount {
    protected $balance;
    
    public function __construct($balance) {
        $this->balance = $balance;
    }
    
    final public function getAccountId() {
        return "ACC-" . spl_object_id($this);
    }
}

class SavingsAccount extends BankAccount {
    public function addInterest() {
        return $this->balance * 0.05;
    }
}

$account = new SavingsAccount(1000);
echo $account->getAccountId();

المخرجات:

ACC-1

لا يمكن تجاوز الطريقة getAccountId() في SavingsAccount أو أي فئة فرعية أخرى. يحمي هذا الوظائف الهامة التي يجب أن تظل متسقة عبر جميع أنواع الحسابات.

يمكنك أيضاً تمييز فئة كاملة كـ final لمنع أي وراثة:

<?php
final class SecurityManager {
    public function authenticate($user) {
        return "Authenticating $user";
    }
}

$security = new SecurityManager();
echo $security->authenticate("admin");

المخرجات:

Authenticating admin

لا يمكن لأي فئة أن ترث من SecurityManager. هذا مفيد للفئات الحساسة أمنياً أو عندما يكون تصميم الفئة مكتملاً ولا ينبغي تعديله.

نقطة رئيسية: استخدم final مع الدوال (methods) لمنع التجاوز (overriding) مع الاستمرار في السماح بالوراثة (inheritance)، أو مع الأصناف (classes) لمنع الوراثة تماماً. إنها أداة لحماية الكود الحرج الذي يجب أن يعمل تماماً كما تم تصميمه.

التحدي

سهل

لنقم ببناء نظام لإدارة المستندات يوضح كيف تحمي الكلمة المفتاحية final الوظائف الهامة من التعديل بواسطة الفئات الفرعية (child classes).

ستقوم بإنشاء ثلاثة ملفات تعمل معاً لإدارة أنواع مختلفة من المستندات مع ضمان بقاء ميزات أمان معينة مقفلة:

Document.php — قم بتعريف فئة Document التي تعمل كقاعدة لجميع المستندات. يجب أن تحتوي على خاصية عامة $title وخاصية محمية $author. يقبل المنشئ (constructor) كلاً من العنوان والمؤلف. قم بتضمين دالة final تسمى getSignature() تعيد "Signed by: [author]" — يجب ألا يتم تغيير ميزة الأمان هذه أبداً بواسطة الفئات الفرعية. أضف أيضاً دالة getContent() عادية تعيد "Document: [title]".
Report.php — قم بتعريف فئة Report التي ترث من Document. قم بتضمين ملف Document في الأعلى. تضيف هذه الفئة خاصية $department. يجب أن يقبل المنشئ العنوان، والمؤلف، والقسم — استخدم parent::__construct() لأول قيمتين، ثم قم بتعيين القسم. قم بإعادة كتابة (Override) دالة getContent() لتعيد "Report: [title] ([department])". ترث فئة Report دالة getSignature() النهائية دون القدرة على تغييرها.
main.php — قم بتضمين ملف Report. ستتلقى ثلاثة مدخلات: عنوان المستند، اسم المؤلف، والقسم. أنشئ كائن Report بهذه القيم. اطبع نتيجة getContent() في السطر الأول، ثم اطبع نتيجة getSignature() في السطر الثاني.

يوضح هذا التحدي كيف تحمي دوال final الوظائف الهامة — يظل إنشاء التوقيع ثابتاً عبر جميع أنواع المستندات، بينما يمكن تخصيص الدوال الأخرى مثل getContent() بواسطة كل فئة فرعية. يمكن لـ Report تغيير كيفية عرض المحتوى، ولكن تنسيق التوقيع مقفل في الفئة الأب.

ورقة مرجعية

تمنع الكلمة المفتاحية final الأصناف أو الدوال من التعديل عليها بواسطة الأصناف الفرعية.

الدوال النهائية (Final Methods): قم بتمييز الدالة كـ final لمنع الأصناف الفرعية من إعادة تعريفها (overriding):

<?php
class BankAccount {
    protected $balance;
    
    final public function getAccountId() {
        return "ACC-" . spl_object_id($this);
    }
}

class SavingsAccount extends BankAccount {
    // لا يمكن إعادة تعريف getAccountId()
}

الأصناف النهائية (Final Classes): قم بتمييز صنف بالكامل كـ final لمنع أي عملية وراثة:

<?php
final class SecurityManager {
    public function authenticate($user) {
        return "Authenticating $user";
    }
}

// لا يمكن لأي صنف أن يرث من SecurityManager

استخدم final مع الدوال لحماية وظائف محددة مع السماح بالوراثة، أو مع الأصناف لمنع الوراثة تماماً. هذا مفيد للأكواد الحساسة أمنياً أو عندما يجب أن تظل التنفيذات (implementations) ثابتة.

جرّب بنفسك

<?php
require_once 'Report.php';

// قراءة المدخلات
$title = trim(fgets(STDIN));
$author = trim(fgets(STDIN));
$department = trim(fgets(STDIN));

// TODO: إنشاء كائن Report باستخدام قيم المدخلات

// TODO: طباعة نتيجة getContent()

// TODO: طباعة نتيجة getSignature()
?>