<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/language.namespaces.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'pt_BR',
  ),
  'this' => 
  array (
    0 => 'language.namespaces.rationale.php',
    1 => 'Vis&atilde;o Geral',
    2 => 'Vis&atilde;o geral de Namespaces',
  ),
  'up' => 
  array (
    0 => 'language.namespaces.php',
    1 => 'Namespaces',
  ),
  'prev' => 
  array (
    0 => 'language.namespaces.php',
    1 => 'Namespaces',
  ),
  'next' => 
  array (
    0 => 'language.namespaces.definition.php',
    1 => 'Namespaces',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'pt_BR',
    'path' => 'language/namespaces.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="language.namespaces.rationale" class="sect1">
  <h2 class="title">Visão geral de Namespaces</h2>
  
  <p class="verinfo">(PHP 5 &gt;= 5.3.0, PHP 7, PHP 8)</p>
  <p class="simpara">
   O que são namespaces? Na definição mais ampla, os namespaces (na tradução literal, &quot;espaços de nomes&quot;) são uma forma de encapsular
   itens. Isso é visto como um conceito abstrato em muitos lugares. Por exemplo, em qualquer
   sistema operacional, os diretórios servem para agrupar arquivos relacionados, e agem como um namespace para
   os arquivos dentro deles. Como um exemplo concreto, o arquivo <code class="literal">foo.txt</code> pode
   existir em ambos os diretórios <code class="literal">/home/greg</code> e <code class="literal">/home/other</code>,
   mas duas cópias de <code class="literal">foo.txt</code> não podem coexistir em um mesmo diretório. Além
   disso, para acessar o arquivo <code class="literal">foo.txt</code> fora do
   diretório <code class="literal">/home/greg</code>, o nome do diretório deve ser prefixado ao nome
   do arquivo usando o separador de diretórios para obter <code class="literal">/home/greg/foo.txt</code>. Esse
   mesmo princípio se estende a namespaces no mundo da programação.
  </p>

  <p class="simpara">
   No mundo PHP, os namespaces são projetados para resolver dois problemas que os autores
   de bibliotecas e aplicações encontram ao criar elementos de código reutilizáveis,
   como classes ou funções:
  </p>
  <p class="para">
   <ol type="1">
    <li class="listitem">
     <span class="simpara">
      Colisões de nomes entre o código criado e
      classes/funções/constantes internas do PHP ou classes/funções/constantes de terceiros.
     </span>
    </li>
    <li class="listitem">
     <span class="simpara">
      Capacidade de criar apelidos (ou encurtar) Nomes_Extralongos projetados para aliviar o primeiro problema,
      melhorando a legibilidade do código-fonte.
     </span>
    </li>
   </ol>
  </p>
  <p class="simpara">
   Os Namespaces do PHP fornecem uma maneira de agrupar classes, interfaces,
   funções e constantes relacionadas. Aqui está um exemplo da sintaxe de namespace em PHP:
  </p>
  <div class="example" id="example-1">
   <p><strong>Exemplo #1 Exemplo da sintaxe de namespace</strong></p>
   <div class="example-contents">
   <div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">namespace </span><span style="color: #0000BB">meu\nome</span><span style="color: #007700">; </span><span style="color: #FF8000">// veja a seção "Definindo Namespaces"<br /><br /></span><span style="color: #007700">class </span><span style="color: #0000BB">MinhaClasse </span><span style="color: #007700">{}<br />function </span><span style="color: #0000BB">minhafuncao</span><span style="color: #007700">() {}<br />const </span><span style="color: #0000BB">MINHACONST </span><span style="color: #007700">= </span><span style="color: #0000BB">1</span><span style="color: #007700">;<br /><br /></span><span style="color: #0000BB">$a </span><span style="color: #007700">= new </span><span style="color: #0000BB">MinhaClasse</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$c </span><span style="color: #007700">= new </span><span style="color: #0000BB">\meu\nome\MinhaClasse</span><span style="color: #007700">; </span><span style="color: #FF8000">// veja a seção "Espaço Global"<br /><br /></span><span style="color: #0000BB">$a </span><span style="color: #007700">= </span><span style="color: #0000BB">strlen</span><span style="color: #007700">(</span><span style="color: #DD0000">'oi'</span><span style="color: #007700">); </span><span style="color: #FF8000">// veja a seção "Usando namespaces: recorrendo a<br />                   // funções/constantes globais"<br /><br /></span><span style="color: #0000BB">$d </span><span style="color: #007700">= </span><span style="color: #0000BB">namespace\MINHACONST</span><span style="color: #007700">; </span><span style="color: #FF8000">// veja a seção "operador de namespace<br />                           // e constante __NAMESPACE__"<br /></span><span style="color: #0000BB">$d </span><span style="color: #007700">= </span><span style="color: #0000BB">__NAMESPACE__ </span><span style="color: #007700">. </span><span style="color: #DD0000">'\MINHACONST'</span><span style="color: #007700">;<br />echo </span><span style="color: #0000BB">constant</span><span style="color: #007700">(</span><span style="color: #0000BB">$d</span><span style="color: #007700">); </span><span style="color: #FF8000">// veja a seção "Namespaces e recursos de linguagem dinâmica"<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
   <blockquote class="note"><p><strong class="note">Nota</strong>: 
    <span class="simpara">
     Nomes de namespace não diferenciam maiúsculas de minúsculas.
    </span>
   </p></blockquote>
  <blockquote class="note"><p><strong class="note">Nota</strong>: 
   <p class="para">
    O nome do namespace <code class="literal">PHP</code> e os nomes compostos que começam
    com esse nome (como <code class="literal">PHP\Classes</code>) são reservados para uso interno da linguagem
    e não devem ser usados no código criado pelo usuário.
   </p>
  </p></blockquote>
 </div><?php manual_footer($setup); ?>