julianobailao

<?php

class Customer
{
    /**
     * Customer name.
     *
     * @var string
     */
    protected $name;

julianobailao

<?php

class Address
{
    protected $street;
    protected $number;
    protected $city;
    protected $state;

    /**

julianobailao

<?php

// Como vimos, para que possamos instanciar uma classe de clientes precisamos passar o
// nome do cliente como parametro, então vamos lá:
$customer = new Customer('Jack Sparrow');

// Pronto! Agora temos uma instância da nossa classe de clientes agora,
// vamos adicionar endereços a este clientes:
$customer->address()->put('main_address', new Address('Street name', '12345', 'City name', 'My state'));

julianobailao

<?php

$main_address = $customer->address()->find('main_address')->getFullAddressText();
// Street name, 12345 - City name - My state

// Quando utilizamos o método find para buscar um ítem, ele retornará o objeto presente neste índice,
// ou null caso seja um indíce não existente. A collection possui também o método findOrFail, funciona de 
// forma semelhante ao find, porém caso tente buscar um índice não existente, retornará uma exceção do tipo
// CollectionItemNotFoundException

julianobailao

<?php

$customer->address()->put('secondary_address', new Address('Highway name', 'km 12345', 'City name', 'My state'));
$customer->address()->put('business_address', new Address('Business Street name', '54321', 'City name', 'My state'));

julianobailao

<?php

$customer->address()->remove('business_address');

julianobailao

<?php

$numItems = $customer->address()->count();
// 3

julianobailao

<?php

$addressess = $customer->address()->all();
/**
 * [
 *   'main_address' => Address::object...,
 *   'secondary_address' => Address::object...,
 *   'business_address' => Address::object...,
 * ]
 */

julianobailao

<?php

$customer->address()->remove('main_address');
// true

julianobailao

<?php

// Each
$customer->address()->each(function ($address, $key) {
  // do something
});

// Map
$customer->address()->map(function ($address) {
  // return  something