68

I know what the definition is of a Final class, but I want to know how and when final is really needed.

<?php
final class Foo extends Bar
{
   public function()
   {
     echo 'John Doe';
   }
}

If I understand it correctly, 'final' enables it to extend 'Foo'.

Can anyone explain when and why 'final' should be used? In other words, is there any reason why a class should not be extended?

If for example class 'Bar' and class 'Foo' are missing some functionality, it would be nice to create a class which extends 'Bar'.

1

5 Answers 5

72

There is a nice article about "When to declare classes final". A few quotes from it:

TL;DR: Make your classes always final, if they implement an interface, and no other public methods are defined

Why do I have to use final?

  1. Preventing massive inheritance chain of doom
  2. Encouraging composition
  3. Force the developer to think about user public API
  4. Force the developer to shrink an object's public API
  5. A final class can always be made extensible
  6. extends breaks encapsulation
  7. You don't need that flexibility
  8. You are free to change the code

When to avoid final:

Final classes only work effectively under following assumptions:

  1. There is an abstraction (interface) that the final class implements
  2. All of the public API of the final class is part of that interface

If one of these two pre-conditions is missing, then you will likely reach a point in time when you will make the class extensible, as your code is not truly relying on abstractions.

P.S. Thanks to @ocramius for great reading!

1
  • 1
    Example: use final when you want to create a Utility class. Commented Dec 2, 2019 at 8:06
28

For general usage, I would recommend against making a class final. There might be some use cases where it makes sense: if you design a complex API / framework and want to make sure that users of your framework can override only the parts of the functionality that you want them to control it might make sense for you to restrict this possibility and make certain base classes final.

e.g. if you have an Integer class, it might make sense to make that final in order to keep users of your framework form overriding, say, the add(...) method in your class.

4
  • 6
    It has often surprised me in the past just how often I have needed to do ridiculous things which were blocked casually, like your Integer class example. Granted, each time it's happened it has been the product of weeks of careful research of the code, but it has happened already a few times.
    – Iiridayn
    Commented Oct 2, 2012 at 20:56
  • 9
    -1: This is pure opinion (so makes it generally a bad answer as this would be a reason to close-vote the question instead); but next to that, most likely not a thoughful one in the sense of programming. See programmers.stackexchange.com/q/89073/24482
    – hakre
    Commented May 18, 2014 at 16:15
  • 1
    @hakre I see it backwards, the question is the one that (as it is currently stated) encourages opinion based answers, there is a flag for this
    – Purefan
    Commented Jun 17, 2017 at 22:55
  • would it not making sense to put getter and setter methods final?
    – Wollhaar
    Commented Jan 15 at 14:12
16

The reason are:

  1. Declaring a class as final prevents it from being subclassed—period; it’s the end of the line.

  2. Declaring every method in a class as final allows the creation of subclasses, which have access to the parent class’s methods, but cannot override them. The subclasses can define additional methods of their own.

  3. The final keyword controls only the ability to override and should not be confused with the private visibility modifier. A private method cannot be accessed by any other class; a final one can.

—— quoted from page 68 of the book PHP Object-Oriented Solutions by David Powers.

For example:

final childClassname extends ParentsClassname {
    // class definition omitted
}

This covers the whole class, including all its methods and properties. Any attempt to create a child class from childClassname would now result in a fatal error. But,if you need to allow the class to be subclassed but prevent a particular method from being overridden, the final keyword goes in front of the method definition.

class childClassname extends parentClassname { 
    protected $numPages;

    public function __construct($autor, $pages) {
        $this->_autor = $autor;
        $this->numPages = $pages;
    }

    final public function PageCount() { 
        return $this->numPages; 
    }
}

In this example, none of them will be able to overridden the PageCount() method.

7

A final class is one which cannot be extended http://php.net/manual/en/language.oop5.final.php

You would use it where the class contained methods which you specifically do not want overridden. This may be because doing do would break your application in some way.

8
  • Sorry but that was not my question. Commented Nov 22, 2010 at 17:07
  • Sorry I got carried away with the submit button. Edited. Please let me know if you would like me to expand Commented Nov 22, 2010 at 17:09
  • 2
    Yes it was, "If I understand it correctly, 'final' enables it to extend 'Foo'."
    – Malfist
    Commented Nov 22, 2010 at 17:09
  • You would use it where the class contained methods which you specifically do not want overridden. This may be because doing do would break your application in some way. could you give an example? Instead of overriding, extending could also add functionality instead of overriding, or?? Commented Nov 22, 2010 at 17:10
  • 1
    @Gumbo, I just want to know if creating Final classes is a bad practice and the PHP manual ain't telling me that. Can you tell me where I can find that? Commented Nov 22, 2010 at 17:45
5

My 2 cents:

When To Use final:

  • NEVER!!

Why?

  • it breaks the ability to use test doubles when unit testing
  • could lead to increased code duplication because of gaps in functionality in downstream code
  • the reasons to use it are all training issues being addressed with a radical shortcut

Bad Reasons to Use It:

  • Preventing massive inheritance chain of doom (training issue)
  • Encouraging composition (training issue)
  • Force the developer to think about user public API (training issue)
  • Force the developer to shrink an object's public API (training issue? code reviews?)
  • A final class can always be made extensible (relevance?)
  • extends breaks encapsulation (what? poor encapsulation breaks encapsulation; not inheritance. inheritance is not inherently evil.)
  • You don't need that flexibility (typical thinking behind short-sighted development. be prepared to hit a feature wall + training issue)
  • You are free to change the code (relevance?)
20
  • 6
    With respect, I disagree vehemently with this. First off, it's not a "training issue" - sometimes the people using your class simply aren't your responsibility, such as if you're writing a library, but you still want to stop them shooting themselves in the foot with inheritance. The mock issue can be overcome by having the class implement an interface and mocking that. If some of the functionality needs to be reused it can be extracted to a subclass or trait, and if you need to duplicate a significant amount of code to reimplement functionality the class was probably too big anyway. Commented Apr 6, 2021 at 20:33
  • 1
    Sorry, the refactoring is called Extract class, not extract subclass. Commented Apr 6, 2021 at 21:40
  • 2
    "training issue" means it's really not a coding problem, it's a people problem. talk to the people. document better. have frequent design discussions.
    – John Brown
    Commented May 27, 2021 at 0:06
  • 2
    Completely agree with this answer. I'm tired of seeing the final keyword on every class in a php project. Seems some devs are even proud of saying that in their IDE they have the final keyword in their class template file. This is horrible. C++ also received the final keyword and you have videos already talking about how you should be extremely careful when using it.
    – AntonioCS
    Commented Nov 16, 2021 at 17:14
  • 3
    So, this is an old thread now. In addition to all other points made above, the Final keyword is just fundamentally too much hubris for me to adopt. I cannot assume that any 1 approach to a software problem is the only and best approach ever. This is a journey of perpetual learning. Therefore, whenever I write code, I want to make life easier, not harder for the next designer to do whatever they want/need to extend & test functionality for their project. I won't be using Final unless I'm on a client's project where I have direct orders to do so. I said what I said.
    – John Brown
    Commented Jul 12, 2022 at 13:06

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.