The Basicsclass
Basic class definitions begin with the
keyword class, followed by a class name,
followed by a pair of curly braces which enclose the definitions
of the properties and methods belonging to the class.
The class name can be any valid label, provided it is not a
PHP reserved word. A valid class
name starts with a letter or underscore, followed by any number of
letters, numbers, or underscores. As a regular expression, it
would be expressed thus:
^[a-zA-Z_\x80-\xff][a-zA-Z0-9_\x80-\xff]*$.
A class may contain its
own constants, variables
(called "properties"), and functions (called "methods").
Simple Class definition
var;
}
}
?>
]]>
The pseudo-variable $this is available when a
method is called from within an object
context. $this is a reference to the calling
object (usually the object to which the method belongs, but
possibly another object, if the method is called
statically from the context
of a secondary object).
As of PHP 7.0.0 calling a non-static method statically from an incompatible
context results in $this being undefined inside the method. Calling a
non-static method statically from an incompatible context has been
deprecated as of PHP 5.6.0. As of PHP 7.0.0 calling a non-static method
statically has been generally deprecated (even if called from a compatible
context). Before PHP 5.6.0 such calls already triggered a strict notice.
Some examples of the $this pseudo-variable
We're assuming that error_reporting is disabled for this example;
otherwise the following code would trigger deprecated and strict notices,
respectively, depending on the PHP version.
foo();
A::foo();
$b = new B();
$b->bar();
B::bar();
?>
]]>
&example.outputs.5;
&example.outputs.7;
new
To create an instance of a class, the new keyword must
be used. An object will always be created unless the object has a
constructor defined that throws an
exception on error. Classes
should be defined before instantiation (and in some cases this is a
requirement).
If a string containing the name of a class is used with
new, a new instance of that class will be created. If
the class is in a namespace, its fully qualified name must be used when
doing this.
If there are no arguments to be passed to the class's constructor,
parentheses after the class name may be omitted.
Creating an instance
]]>
In the class context, it is possible to create a new object by
new self and new parent.
When assigning an already created instance of a class to a new variable, the new variable
will access the same instance as the object that was assigned. This
behaviour is the same when passing instances to a function. A copy
of an already created object can be made by
cloning it.
Object Assignment
var = '$assigned will have this value';
$instance = null; // $instance and $reference become null
var_dump($instance);
var_dump($reference);
var_dump($assigned);
?>
]]>
&example.outputs;
string(30) "$assigned will have this value"
}
]]>
PHP 5.3.0 introduced a couple of new ways to create instances of an
object:
Creating new objects
]]>
&example.outputs;
PHP 5.4.0 introduced the possibility to access a member of a newly created
object in a single expression:
Access member of newly created object
format('Y');
?>
]]>
&example.outputs.similar;
Prior to PHP 7.1, the arguments are not evaluated if there is no constructor
function defined.
Properties and methods
Class properties and methods live in separate "namespaces", so it is
possible to have a property and a method with the same name. Referring to
both a property and a method has the same notation, and whether a property
will be accessed or a method will be called, solely depends on the context,
i.e. whether the usage is a variable access or a function call.
Property access vs. method call
bar, PHP_EOL, $obj->bar(), PHP_EOL;
]]>
&example.outputs;
That means that calling an anonymous
function which has been assigned to a property is not directly
possible. Instead the property has to be assigned to a variable first, for
instance. As of PHP 7.0.0 it is possible to call such a property directly
by enclosing it in parentheses.
Calling an anonymous function stored in a property
bar = function() {
return 42;
};
}
}
$obj = new Foo();
// as of PHP 5.3.0:
$func = $obj->bar;
echo $func(), PHP_EOL;
// alternatively, as of PHP 7.0.0:
echo ($obj->bar)(), PHP_EOL;
]]>
&example.outputs;
extends
A class can inherit the methods and properties of another class by
using the keyword extends in the class
declaration. It is not possible to extend multiple classes; a
class can only inherit from one base class.
The inherited methods and properties can be overridden by
redeclaring them with the same name defined in the parent
class. However, if the parent class has defined a method
as final, that method
may not be overridden. It is possible to access the overridden
methods or static properties by referencing them
with parent::.
When overriding methods, the parameter signature should remain the same or
PHP will generate an E_STRICT level error. This does
not apply to the constructor, which allows overriding with different
parameters.
Simple Class Inheritance
displayVar();
?>
]]>
&example.outputs;
::class
The class keyword is also used for class
name resolution. You can get a string containing the fully qualified name
of the ClassName class by using
ClassName::class. This is particularly useful with
namespaced classes.
Class name resolution
]]>
&example.outputs;
The class name resolution using ::class is a
compile time transformation. That means at the time the class name string
is created no autoloading has happened yet. As a consequence, class names
are expanded even if the class does not exist. No error is issued in
that case.
Missing class name resolution
]]>
&example.outputs;
As of PHP 8.0.0, the ::class constant may also be used on
objects. This resolution happens at runtime, not compile time. Its effect is
the same as calling get_class on the object.
Object name resolution
]]>
&example.outputs;
Nullsafe methods and properties
As of PHP 8.0.0, properties and methods may also be accessed with the
"nullsafe" operator instead: ?->. The nullsafe operator
works the same as property or method access as above, except that if the
object being dereferenced is &null; then &null;
will be returned rather than an exception thrown. If the dereference is part of a
chain, the rest of the chain is skipped.
The effect is similar to wrapping each access in an is_null
check first, but more compact.
Nullsafe Operator
getUser(5)?->name;
// Is equivalent to the following code block:
if (is_null($repository)) {
$result = null;
} else {
$user = $repository->getUser(5);
if (is_null($user)) {
$result = null;
} else {
$result = $user->name;
}
}
?>
]]>
The nullsafe operator is best used when null is considered a valid and expected
possible value for a property or method return. For indicating an error,
a thrown exception is preferable.