A Palavra-chave use

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

Escrever o caminho completo do namespace toda vez que você usa uma classe pode se tornar cansativo. A palavra-chave use permite importar uma classe no topo do seu arquivo, para que você possa referenciá-la pelo seu nome curto.

Em vez de escrever \Blog\User repetidamente, você pode importá-lo uma vez:

<?php
use Blog\User;

$user = new User("Alice");
echo $user->name;

Quando você precisa de classes de diferentes namespaces com o mesmo nome, você pode criar um apelido usando a palavra-chave as:

<?php
use Blog\User as BlogUser;
use Shop\User as ShopUser;

$blogger = new BlogUser("Alice");
$customer = new ShopUser("alice@example.com");

echo $blogger->name . "\n";
echo $customer->email . "\n";

Saída:

Alice
alice@example.com

Você também pode importar várias classes do mesmo namespace usando importações agrupadas:

<?php
use Blog\{User, Post, Comment};

$user = new User("Alice");
$post = new Post("Hello World");

Ponto Chave: A instrução use deve aparecer após a declaração namespace (se houver) e antes de qualquer outro código. Isso torna seu código mais limpo e fácil de ler ao eliminar caminhos de namespace repetitivos.

Desafio

Fácil

Vamos organizar um aplicativo de mensagens usando a palavra-chave use para importar classes de forma limpa e evitar escrever caminhos de namespace completos em todos os lugares.

Você criará três arquivos que trabalham juntos:

Messaging/Email.php — Defina uma classe Email no namespace Messaging. Ela deve ter uma propriedade public $address, um construtor que aceita e define o endereço, e um método send() que retorna "Sending email to [address]".
Messaging/SMS.php — Defina uma classe SMS no namespace Messaging. Ela deve ter uma propriedade public $phone, um construtor que aceita e define o número de telefone, e um método send() que retorna "Sending SMS to [phone]".
main.php — Inclua ambos os arquivos de classe e, em seguida, use a palavra-chave use para importar ambas as classes. Crie um objeto Email com o endereço "alice@example.com" e um objeto SMS com o telefone "555-1234". Imprima o resultado da chamada de send() em cada objeto (cada um em sua própria linha).

No main.php, em vez de escrever new \Messaging\Email(...), você importará as classes no topo com instruções use para que possa simplesmente escrever new Email(...) e new SMS(...).

Folha de consulta

A palavra-chave use importa uma classe no topo do seu arquivo, permitindo que você a referencie pelo seu nome curto em vez do caminho completo do namespace:

<?php
use Blog\User;

$user = new User("Alice");

Quando classes de namespaces diferentes compartilham o mesmo nome, crie um apelido usando a palavra-chave as:

<?php
use Blog\User as BlogUser;
use Shop\User as ShopUser;

$blogger = new BlogUser("Alice");
$customer = new ShopUser("alice@example.com");

Importe múltiplas classes do mesmo namespace usando importações agrupadas:

<?php
use Blog\{User, Post, Comment};

$user = new User("Alice");
$post = new Post("Hello World");

A instrução use deve aparecer após a declaração namespace (se houver) e antes de qualquer outro código.

Experimente você mesmo

<?php
// Inclua os arquivos de classe
require_once 'Messaging/Email.php';
require_once 'Messaging/SMS.php';

// TODO: Use a palavra-chave 'use' para importar ambas as classes do namespace Messaging
// Isso permite que você escreva 'new Email(...)' em vez de 'new \Messaging\Email(...)'


// TODO: Crie um objeto Email com o endereço "alice@example.com"


// TODO: Crie um objeto SMS com o telefone "555-1234"


// TODO: Imprima o resultado da chamada de send() em cada objeto (cada um em sua própria linha)

?>