PHP 8.1 introduced the feature of readonly property & PHP 8.2 introduced the new feature of readonly classes

The concept of readonly property in PHP is as simple as when a class property is declared using the readonly modifier, you cannot modify the property after initialization.

class User 
   public readonly string $name;
   public function __construct(string $name) {
       // Legal initialization.
       $this->name = $name;
$john = new User("John");
// Legal read.
var_dump($john->name); // string(4) "John"
// Illegal reassignment. It does not matter that the assigned value is the same.
$john->name = "John";
// Error: Cannot modify readonly property User::$name

There are some important notes to remember about readonly properties in PHP.

  • You can only apply¬†readonly¬†modifier on¬†typed properties¬†. A readonly property without type constraints can be created using the¬†Mixed¬†type.
  • You can not assign¬†readonly¬†modifier on static properties.
  • You can initialize the¬†readonly¬†property once, and only from the scope where it has been declared. Any other assignment or modification of the property will result in an Error exception.
  • You can not assign default value on¬†readonly¬†properties, because a¬†readonly¬†property with a default value is essentially the same as a PHP - class constant, and thus not particularly useful.
    • You can not unset()¬†readonly¬†properties once they are initialized. However, it is possible to unset a¬†readonly¬†property prior to initialization, from the scope where the property has been declared.
  • Not only plain assignments, any type of modification of¬†readonly¬†property will also result in an Error exception
  • However, objects (or resources) stored in¬†readonly¬†properties may still be modified internally

readonly classes

Now as we got the concept of readonly property it will be very easier for us to understand readonly classes in PHP.

If we define a class as readonly all the declared property of that class will automatically become readonly property.

readonly class User
    public string $name;
    public string $gender;

So, User::$name and User::$gender are now readonly properties. To achieve this previously in PHP 8.1 we had to do something like:

class User
    public readonly string $name;
    public readonly string $gender;

From this observation, we can say that readonly classes are syntactic sugar that will make all the declared properties of that class readonly properties.

So, we have to remember that, all those important notes that we described about readonly properties are still applicable here. Such as:

  1. A readonly class can not contain untyped or static properties.
  2. A readonly class’s property cannot have a default value. etc.
  3. Another important note to remember about readonly classes is that A readonly class can only be extended if, the child class is also a readonly class.