Manipulação de objetos em classes em OOP em PHP

Classes podem aceitar objetos de outras classes como parâmetros de métodos e manipular esses objetos. Vamos ver um exemplo. Suponha que temos a seguinte classe:

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

Suponha que decidimos criar uma classe que irá manipular um conjunto de objetos de usuários:

php<?php
  class UsersCollection {
    
  }
?>

Vamos armazenar os objetos de usuários como um array em uma propriedade privada:

php<?php
  class UsersCollection {
    private $users;
    
    public function __construct() {
      $this->users = [];
    }
  }
?>

Vamos criar um método para adicionar um novo usuário ao array:

php<?php
  class UsersCollection {
    private $users;
    
    public function __construct() {
      $this->users = [];
    }
    
    public function add($user) {
      $this->users[] = $user;
    }
  }
?>

E agora vamos criar um método que exibirá os nomes de todos os usuários:

php<?php
  class UsersCollection {
    private $users;
    
    public function __construct() {
      $this->users = [];
    }
    
    public function add($user) {
      $this->users[] = $user;
    }
    
    public function show() {
      foreach ($this->users as $user) {
        echo $user->getName() . '<br>';
      }
    }
  }
?>

Vamos ver como nossa classe funciona. Primeiro, vamos criar seu objeto:

php<?php
  $uc = new UsersCollection();
?>

Agora vamos adicionar à nossa coleção alguns usuários:

php<?php
  $uc->add(new User('john'));
  $uc->add(new User('eric'));
  $uc->add(new User('kyle'));
?>

E agora vamos chamar o método que exibirá os nomes de todos os usuários:

php<?php
  $uc->show();
?>