Propiedades

Las variables pertenecientes a una clase se llaman "propiedades". También se les puede llamar usando otros términos como "atributos" o "campos", pero para los propósitos de esta referencia se va a utilizar "propiedades". Éstas se definen usando una de las palabras reservadas public, protected, o private, seguido de una declaración normal de variable. Esta declaración puede incluir una inicialización, pero esta inicialización debe ser un valor constante, es decir, debe poder ser evaluada durante la compilación y no depender de información generada durante la ejecución.

Véase la Visibilidad para más información sobre el significado de public, protected, y private.

Nota:

Con el fin de mantener la compatibilidad con PHP 4, PHP 5 continuará aceptando el uso de la palabra reservada var en la declaración de propiedades en lugar de (o además de) public, protected, o private. Sin embargo, var ya no es necesaria. Entre las versiones 5.0 y 5.1.3 de PHP, el uso de var fue considerado obsoleto y emitía una advertencia de nivel E_STRICT; pero a partir de PHP 5.1.3 ya no está obsoleta y no se emite la advertencia.

Si se declara una propiedad utilizando var en lugar de public, protected, o private, PHP tratará dicha propiedad como si hubiera sido definida como public.

Dentro de los métodos de una clase, se puede acceder a las propiedades no estáticas utilizando -> (el operador de objeto): $this->propiedad (donde propiedad es el nombre de la propiedad). A las propiedades estáticas se puede acceder utilizando :: (doble dos puntos): self::$propiedad. Véase la palabra reservada 'static' para más información sobre la diferencia entre propiedades estáticas y no estáticas.

La pseudovariable $this está disponible dentro de cualquier método de clase cuando éste es invocado dentro del contexto de un objeto. $this es una referencia al objeto invocador (usualmente el objeto al cual pertenece el método, aunque puede que sea otro objeto si el método es llamado estáticamente desde el contexto de un objeto secundario).

Ejemplo #1 Declaración de propiedades

<?php
class ClaseSencilla
{
   
// Válido a partir de PHP 5.6.0:
   
public $var1 'hola ' 'mundo';
   
// Válido a partir de PHP 5.3.0:
   
public $var2 = <<<EOD
hola mundo
EOD;
   
// Válido a partir de PHP 5.6.0:
   
public $var3 1+2;
   
// Declaraciones de propiedades inválidas:
   
public $var4 self::miMétodoEstático();
   public 
$var5 $myVar;

   
// Declaraciones de propiedades válidas:
   
public $var6 miConstante;
   public 
$var7 = array(truefalse);

   
// Válido a partir de PHP 5.3.0:
   
public $var8 = <<<'EOD'
hola mundo
EOD;
}
?>

Nota:

Existen varias funciones interesantes para manipular clases y objetos. Puede ser interesante echarle un vistazo a las Funciones de clases/objetos.

A partir de PHP 5.3.0, se puede utilizar heredocs y nowdocs en cualquier contexto de datos estáticos, incluyendo la declaración de propiedades.

Ejemplo #2 Ejemplo del uso de nowdoc para inicializar una propiedad

<?php
class foo {
   
// A paritr de PHP 5.3.0
   
public $bar = <<<'EOT'
bar
EOT;
   public 
$baz = <<<EOT
baz
EOT;
}
?>

Nota:

Se añadio soporte para Nowdoc y Heredoc en PHP 5.3.0.