archived-doc-pt-br/install/macos/bundled.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 04d9aded7bbd447523cf038ddf88e6d7f7e43c53 Maintainer: leonardolara Status: ready --><!-- CREDITS: royopa, diegopires, leonardolara -->
<sect1 xml:id="install.macosx.bundled" xmlns="http://docbook.org/ns/docbook">
 <title>Usando o pacote do PHP no macOS para versões anteriores ao macOS Monterey</title>
 <simpara>
  O PHP vem incluído com o macOS desde a versão macOS X (10.0.0) até a versão macOS Monterey (12.0.0).
  Habilitar o PHP no servidor web padrão requer apenas descomentar algumas linhas no
  arquivo de configuração do Apache (<filename>httpd.conf</filename>) enquanto que
  a versão <acronym>CGI</acronym> e/ou <acronym>CLI</acronym> estão disponíveis
  automaticamente (facilmente acessíveis pelo Terminal).
 </simpara>
 <simpara>
  Habilitar o PHP usando as instruções abaixo tem como objetivo configurar rapidamente
  um ambiente de desenvolvimento local. É <emphasis>altamente recomendado</emphasis>
  sempre atualizar o PHP para a versão mais nova. Como qualquer software ativo,
  novas versões são criadas para corrigir problemas e adicionar funcionalidades e o PHP
  não é diferente. As seguintes instruções são direcionadas para iniciantes,
  os detalhes fornecidos permitem que uma configuração padrão funcione. Todos os
  usuários são encorajados a compilar ou a instalar uma versão nova do pacote.
  <!---->
 </simpara>
 <simpara>
  O tipo de instalação padrão é usando mod_php, e habilitar o pacote
  mod_php no macOS para o servidor Apache (o servidor web padrão,
  que é acessível via Preferências de Sistema) envolve os seguintes passos:
 </simpara>
 <para>
  <orderedlist>
   <listitem>
    <simpara>
     Localize e abra o arquivo de configuração do Apache. Normalmente, ele está
     em: <filename>/private/etc/apache2/httpd.conf</filename>
    </simpara>
    <simpara>
     Usar <literal>Finder</literal> ou <literal>Spotlight</literal> para encontrar
     esse arquivo pode ser complicado, já que ele normalmente é privado e o dono
     é o usuário <literal>root</literal>.
    </simpara>
    <note>
     <simpara>
      Uma maneira de modificar o arquivo é usando um editor de texto baseado em Unix no
      Terminal, por exemplo <literal>nano</literal> e, como o proprietário do arquivo
      é o <literal>root</literal>, será usado o comando <literal>sudo</literal>.
      Para abri-lo (no usuário <literal>root</literal>), digite o seguinte comando no
      <literal>Terminal</literal> (será necessário digitar
      a senha):
      <literal>sudo nano /private/etc/apache2/httpd.conf</literal>
     </simpara>
     <simpara>
      Comandos importantes do nano: <literal>^w</literal> (buscar),
      <literal>^o</literal> (salvar), e <literal>^x</literal> (sair) onde
      <literal>^</literal> representa a tecla Ctrl.
     </simpara>
    </note>
    <note>
     <simpara>
      Versões do Mac OS X anteriores a 10.5 foram empacotadas com versões mais
      antigas do PHP e do Apache. Devido a isso, o arquivo de configuração do
      Apache pode estar em <filename>/etc/httpd/httpd.conf</filename>.
     </simpara>
    </note>
   </listitem>
   <listitem>
    <para>
     Com um editor de texto, descomente as linhas (removendo os #) que parecem
     com as linhas abaixo (essas duas linhas normalmente não estão juntas,
     localize ambas no arquivo):
     <screen>
<![CDATA[
# LoadModule php5_module libexec/httpd/libphp5.so

# AddModule mod_php5.c
]]>
     </screen>
      Observe a localização/caminho. Quando compilar o PHP no futuro, os
      arquivos acima devem ser substituídos ou comentados.
    </para>
   </listitem>
   <listitem>
    <para>
     Certifique-se que as extensões desejadas serão avaliadas como códigos PHP (exemplos:
     <filename class="extension">.php</filename>, <filename class="extension">.html</filename>
     e <filename class="extension">.inc</filename>).
    </para>
    <para>
     Como a seguinte instrução já existe no
     <filename>httpd.conf</filename> (a partir do Mac Panther), uma vez que o PHP
     for habilitado, os arquivos <filename class="extension">.php</filename> serão automaticamente
     interpretados como código PHP.
     <screen>
<![CDATA[
<IfModule mod_php5.c>
    # If php is turned on, we respect .php and .phps files.
    AddType application/x-httpd-php .php
    AddType application/x-httpd-php-source .phps

    # Since most users will want index.php to work we
    # also automatically enable index.php
    <IfModule mod_dir.c>
        DirectoryIndex index.html index.php
    </IfModule>
</IfModule>
]]>
     </screen>
    </para>
    <note>
     <para>
      Antes do OS X 10.5 (Leopard), o PHP 4 vinha empacotado no lugar
      do PHP 5, neste caso as instruções acima serão um pouco diferentes,
      mudando de 5 para 4.
     </para>
    </note>
   </listitem>
   <listitem>
    <simpara>
     Assegure-se de que a diretiva DirectoryIndex carrega o arquivo de índice desejado.
    </simpara>
    <simpara>
     Isso também é configurável no arquivo <filename>httpd.conf</filename>. Tipicamente
     <filename>index.php</filename> e <filename>index.html</filename> são
     usados. Por padrão, <filename>index.php</filename> é habilitado porque
     também está na verificação mostrada abaixo. Modifique como desejar.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     Configure a localização do arquivo &php.ini; ou use a padrão.
    </simpara>
    <simpara>
     Uma localização típica no macOS é
     <filename>/usr/local/php/php.ini</filename> e uma chamada à
     <function>phpinfo</function> revelará essa informação.
     Se não for usado um arquivo &php.ini;, o PHP usará todos os valores padrão.
     Veja também o FAQ relacionado em
     <link linkend="faq.installation.phpini">encontrando o php.ini</link>.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     Localize ou configure <literal>DocumentRoot</literal>.
    </simpara>
    <simpara>
     Esse é o diretório raiz para todos os arquivos do servidor. Os arquivos nesse diretório
     serão servidos pelo servidor web, então os arquivos PHP serão interpretados como PHP antes de
     terem seu resultado enviado para o servidor. Um caminho padrão para isso é
     <filename>/Library/WebServer/Documents</filename> mas isso pode ser modificado para
     qualquer outro no arquivo <filename>httpd.conf</filename>. Alternativamente, o
     <filename>DocumentRoot</filename> para usuários individuais é
     <filename>/Users/yourusername/Sites</filename>
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     Crie um arquivo <function>phpinfo</function>.
    </simpara>
    <para>
     A função <function>phpinfo</function> mostrará informações sobre o PHP.
     Considere criar um arquivo no DocumentRoot com o seguinte código PHP:
     <programlisting role="php">
<![CDATA[
<?php phpinfo(); ?>
]]>
     </programlisting>
    </para>
   </listitem>
   <listitem>
    <simpara>
     Reinicie o Apache e carregue o arquivo PHP criado acima.
    </simpara>
    <para>
     Para reiniciar, execute <literal>sudo apachectl graceful</literal> no
     shell ou stop/start na opção "Personal Web Server" nas Preferências do Sistema no
     macOS. Geralmente, carregar arquivos locais no navegador
     pode ser feito usando uma <acronym>URL</acronym> assim:
     <filename>http://localhost/info.php</filename> ou se estiver usando o
     diretório DocumentRoot dentro de um diretório de usuário, seria assim:
     <filename>http://localhost/~yourusername/info.php</filename>
    </para>
   </listitem>
  </orderedlist>
 </para>
 <simpara>
  A versão <acronym>CLI</acronym> (ou <acronym>CGI</acronym> em versões mais antigas) tem o
  nome <filename>php</filename> e provavelmente está em
  <filename>/usr/bin/php</filename>. Abra um terminal, leia a
  <link linkend="features.commandline">seção sobre linha de comando</link> do manual
  PHP e execute <literal>php -v</literal> para verificar a versão do PHP usada.
  Uma chamada ao <function>phpinfo</function> também revelará
  essa informação.
 </simpara>
</sect1>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->