<?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.basics.php',
    1 => 'Fundamentos',
    2 => 'Usando namespaces: Fundamentos',
  ),
  'up' => 
  array (
    0 => 'language.namespaces.php',
    1 => 'Namespaces',
  ),
  'prev' => 
  array (
    0 => 'language.namespaces.definitionmultiple.php',
    1 => 'Definindo v&aacute;rios namespaces no mesmo arquivo',
  ),
  'next' => 
  array (
    0 => 'language.namespaces.dynamic.php',
    1 => 'Namespaces e recursos de linguagem din&acirc;mica',
  ),
  '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.basics" class="sect1">
  <h2 class="title">Usando namespaces: Fundamentos</h2>
  
  <p class="verinfo">(PHP 5 &gt;= 5.3.0, PHP 7, PHP 8)</p>
  <p class="para">
   Antes de discutir o uso de namespaces, é importante entender como o PHP
   sabe qual elemento de namespace seu código está solicitando. Uma analogia simples pode ser feita
   entre os namespaces do PHP e um sistema de arquivos. Existem três maneiras de acessar um arquivo em um
   sistema de arquivos:
   <ol type="1">
    <li class="listitem">
     <span class="simpara">
      Nome de arquivo relativo como <code class="literal">foo.txt</code>. Será resolvido para
      <code class="literal">diretorioatual/foo.txt</code> onde <code class="literal">diretorioatual</code> é o
      diretório ocupado atualmente. Então, se o diretório atual for
      <code class="literal">/home/foo</code>, o nome será resolvido para <code class="literal">/home/foo/foo.txt</code>.
     </span>
    </li>
    <li class="listitem">
     <span class="simpara">
      Nome de caminho relativo como <code class="literal">subdiretorio/foo.txt</code>. Será resolvido
      para <code class="literal">diretorioatual/subdiretorio/foo.txt</code>.
     </span>
    </li>
    <li class="listitem">
     <span class="simpara">
      Nome de caminho absoluto como <code class="literal">/main/foo.txt</code>. Será resolvido
      para <code class="literal">/main/foo.txt</code>.
     </span>
    </li>
   </ol>
   O mesmo princípio pode ser aplicado a elementos com namespace no PHP. Por
   exemplo, um nome de classe pode ser referenciado de três maneiras:
   <ol type="1">
    <li class="listitem">
     <span class="simpara">
      Nome não qualificado ou nome de classe sem prefixo como
      <code class="literal">$a = new foo();</code> ou
      <code class="literal">foo::metodoestatico();</code>. Se o namespace atual for
      <code class="literal">namespaceatual</code>, ele será resolvido para
      <code class="literal">namespaceatual\foo</code>. Se
      o código for global, sem namespace, ele será resolvido para <code class="literal">foo</code>.
     </span>
     <span class="simpara">
      Uma ressalva: nomes não qualificados para funções e constantes
      serão resolvidos para funções e constantes globais se a função ou constante com namespace
      não for definida. Veja <a href="language.namespaces.fallback.php" class="link">Usando namespaces:
      recorrendo a funções/constantes globais</a> para obter detalhes.
     </span>
    </li>
    <li class="listitem">
     <span class="simpara">
      Nome qualificado ou um nome de classe prefixado como
      <code class="literal">$a = new subnamespace\foo();</code> ou
      <code class="literal">subnamespace\foo::metodoestatico();</code>. Se o namespace atual for
      <code class="literal">namespaceatual</code>, ele será resolvido para
      <code class="literal">namespaceatual\subnamespace\foo</code>. Se
      o código for global, sem namespace, ele será resolvido para <code class="literal">subnamespace\foo</code>.
     </span>
    </li>
    <li class="listitem">
     <span class="simpara">
      Nome totalmente qualificado ou um nome prefixado com um operador de prefixo global como
      <code class="literal">$a = new \namespaceatual\foo();</code> ou
      <code class="literal">\namespaceatual\foo::metodoestatico();</code>. Ele sempre será resolvido
      para o nome literal especificado no código, <code class="literal">namespaceatual\foo</code>.
     </span>
    </li>
   </ol>
  </p>
  <p class="para">
   Aqui está um exemplo dos três tipos de sintaxe em código real:
   <div class="informalexample">
    <p class="simpara">arquivo1.php</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">Foo\Bar\subnamespace</span><span style="color: #007700">;<br /><br />const </span><span style="color: #0000BB">FOO </span><span style="color: #007700">= </span><span style="color: #0000BB">1</span><span style="color: #007700">;<br />function </span><span style="color: #0000BB">foo</span><span style="color: #007700">() {}<br />class </span><span style="color: #0000BB">foo<br /></span><span style="color: #007700">{<br />    static function </span><span style="color: #0000BB">metodoestatico</span><span style="color: #007700">() {}<br />}<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

    <p class="simpara">arquivo2.php</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">Foo\Bar</span><span style="color: #007700">;<br />include </span><span style="color: #DD0000">'arquivo1.php'</span><span style="color: #007700">;<br /><br />const </span><span style="color: #0000BB">FOO </span><span style="color: #007700">= </span><span style="color: #0000BB">2</span><span style="color: #007700">;<br />function </span><span style="color: #0000BB">foo</span><span style="color: #007700">() {}<br />class </span><span style="color: #0000BB">foo<br /></span><span style="color: #007700">{<br />    static function </span><span style="color: #0000BB">metodoestatico</span><span style="color: #007700">() {}<br />}<br /><br /></span><span style="color: #FF8000">/* Nome não qualificado */<br /></span><span style="color: #0000BB">foo</span><span style="color: #007700">(); </span><span style="color: #FF8000">// será resolvido para a função Foo\Bar\foo<br /></span><span style="color: #0000BB">foo</span><span style="color: #007700">::</span><span style="color: #0000BB">metodoestatico</span><span style="color: #007700">(); </span><span style="color: #FF8000">// será resolvido para a classe Foo\Bar\foo, método metodoestatico<br /></span><span style="color: #007700">echo </span><span style="color: #0000BB">FOO</span><span style="color: #007700">; </span><span style="color: #FF8000">// será resolvido para a constante Foo\Bar\FOO<br /><br />/* Nome qualificado */<br /></span><span style="color: #0000BB">subnamespace\foo</span><span style="color: #007700">(); </span><span style="color: #FF8000">// será resolvido para a função Foo\Bar\subnamespace\foo<br /></span><span style="color: #0000BB">subnamespace\foo</span><span style="color: #007700">::</span><span style="color: #0000BB">metodoestatico</span><span style="color: #007700">(); </span><span style="color: #FF8000">// será resolvido para a classe Foo\Bar\subnamespace\foo,<br />                                    // método metodoestatico<br /></span><span style="color: #007700">echo </span><span style="color: #0000BB">subnamespace\FOO</span><span style="color: #007700">; </span><span style="color: #FF8000">// será resolvido para a constante constant Foo\Bar\subnamespace\FOO<br /><br />/* Nome totalmente qualificado */<br /></span><span style="color: #0000BB">\Foo\Bar\foo</span><span style="color: #007700">(); </span><span style="color: #FF8000">// será resolvido para a função Foo\Bar\foo<br /></span><span style="color: #0000BB">\Foo\Bar\foo</span><span style="color: #007700">::</span><span style="color: #0000BB">metodoestatico</span><span style="color: #007700">(); </span><span style="color: #FF8000">// será resolvido para a classe Foo\Bar\foo, método metodoestatico<br /></span><span style="color: #007700">echo </span><span style="color: #0000BB">\Foo\Bar\FOO</span><span style="color: #007700">; </span><span style="color: #FF8000">// será resolvido para a constante Foo\Bar\FOO<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
  </p>
  <p class="para">
   Note que para acessar qualquer classe,
   função ou constante global, um nome totalmente qualificado pode ser usado, como
   <span class="function"><a href="function.strlen.php" class="function">\strlen()</a></span> ou <span class="classname"><a href="class.exception.php" class="classname">\Exception</a></span> ou
   \<strong><code><a href="info.constants.php#constant.ini-all">INI_ALL</a></code></strong>.
   <div class="example" id="example-1">
    <p><strong>Exemplo #1 Acessando classes, funções e constantes globais em um 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">Foo</span><span style="color: #007700">;<br /><br />function </span><span style="color: #0000BB">strlen</span><span style="color: #007700">() {}<br />const </span><span style="color: #0000BB">INI_ALL </span><span style="color: #007700">= </span><span style="color: #0000BB">3</span><span style="color: #007700">;<br />class </span><span style="color: #0000BB">Exception </span><span style="color: #007700">{}<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">// chama a função global strlen<br /></span><span style="color: #0000BB">$b </span><span style="color: #007700">= </span><span style="color: #0000BB">\INI_ALL</span><span style="color: #007700">; </span><span style="color: #FF8000">// acessa a constante global INI_ALL<br /></span><span style="color: #0000BB">$c </span><span style="color: #007700">= new </span><span style="color: #0000BB">\Exception</span><span style="color: #007700">(</span><span style="color: #DD0000">'erro'</span><span style="color: #007700">); </span><span style="color: #FF8000">// instancia um objeto da classe global Exception<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
  </p>
 </div><?php manual_footer($setup); ?>