Propriedades de Instância vs Estáticas

Parte da seção Programação Orientada a Objetos do Journey de PHP da Coddy — lição 15 de 91.

Quando você cria uma propriedade em uma classe, você precisa decidir se ela pertence a cada objeto individual ou à própria classe. Essa distinção é a diferença entre propriedades de instância e propriedades estáticas.

Propriedades de instância são o padrão. Cada objeto recebe sua própria cópia da propriedade, e alterá-la em um objeto não afeta os outros:

<?php
class User {
    public $name;
    
    public function __construct($name) {
        $this->name = $name;
    }
}

$alice = new User("Alice");
$bob = new User("Bob");

echo $alice->name . "\n";
echo $bob->name . "\n";

Saída:

Alice
Bob

Propriedades estáticas pertencem à classe, não a nenhum objeto específico. Você as declara com a palavra-chave static e as acessa usando o nome da classe com :: em vez de um objeto com ->:

<?php
class User {
    public static $count = 0;
    public $name;
    
    public function __construct($name) {
        $this->name = $name;
        self::$count++;
    }
}

$alice = new User("Alice");
$bob = new User("Bob");

echo User::$count;

Saída:

Observe como $count é compartilhado entre todas as instâncias. Toda vez que criamos um novo User, a mesma variável $count incrementa. Dentro da classe, usamos self::$count para referenciar a propriedade estática.

Ponto Chave: Use propriedades de instância quando cada objeto precisar de seu próprio valor. Use propriedades estáticas quando precisar compartilhar dados entre todos os objetos de uma classe, como contar instâncias ou armazenar configurações.

Desafio

Fácil

Vamos construir um sistema de rastreamento de visitantes que demonstra a diferença entre propriedades de instância (exclusivas para cada visitante) e propriedades estáticas (compartilhadas entre todos os visitantes).

Você criará dois arquivos para organizar seu código:

Visitor.php — Defina uma classe Visitor que rastreia visitantes individuais e mantém uma contagem contínua do total de visitantes. Cada visitante deve ter sua própria propriedade $name (propriedade de instância), enquanto uma propriedade $totalVisitors deve ser compartilhada entre todas as instâncias (propriedade estática). O construtor aceita um nome, o define e incrementa a contagem total de visitantes. Adicione um método getInfo() que retorna "[name] is visitor #[totalVisitors]".
main.php — Inclua o arquivo da classe Visitor e, em seguida, crie três visitantes com os nomes "Alice", "Bob" e "Charlie" (nessa ordem). Após criar os três, imprima o resultado da chamada de getInfo() para cada visitante (cada um em sua própria linha) e, em seguida, imprima a contagem total de visitantes acessando a propriedade estática diretamente da classe usando Visitor::$totalVisitors.

Lembre-se de que, dentro da classe, você acessa propriedades estáticas usando self::$propertyName, enquanto fora da classe você usa ClassName::$propertyName. Propriedades de instância são acessadas com $this->propertyName como de costume.

Sua saída deve mostrar cada visitante com seu número atribuído, seguido pela contagem total final na última linha.

Folha de consulta

Propriedades de instância pertencem a cada objeto individual, enquanto propriedades estáticas pertencem à própria classe e são compartilhadas entre todas as instâncias.

Propriedades de Instância:

Cada objeto recebe sua própria cópia da propriedade:

<?php
class User {
    public $name;
    
    public function __construct($name) {
        $this->name = $name;
    }
}

$alice = new User("Alice");
$bob = new User("Bob");

echo $alice->name; // Alice
echo $bob->name;   // Bob

Propriedades Estáticas:

Declaradas com a palavra-chave static e compartilhadas entre todas as instâncias:

<?php
class User {
    public static $count = 0;
    public $name;
    
    public function __construct($name) {
        $this->name = $name;
        self::$count++;
    }
}

$alice = new User("Alice");
$bob = new User("Bob");

echo User::$count; // 2

Acessando Propriedades Estáticas:

Dentro da classe: self::$propertyName
Fora da classe: ClassName::$propertyName

Acessando Propriedades de Instância:

Dentro da classe: $this->propertyName
Fora da classe: $object->propertyName

Experimente você mesmo

<?php
// Inclui a classe Visitor
require_once 'Visitor.php';

// TODO: Crie três visitantes com os nomes "Alice", "Bob" e "Charlie" (nessa ordem)

// TODO: Imprima o resultado de getInfo() para cada visitante (cada um em sua própria linha)

// TODO: Imprima a contagem total de visitantes usando Visitor::$totalVisitors
?>