bundled.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2b6c321f6a2f2366c1e884fb6697ba1af7f0c0b4 Maintainer: gerardocdc Status: ready -->
<!-- Reviewed: no Maintainer: andresdzphp -->

<sect1 xml:id="install.macosx.bundled" xmlns="http://docbook.org/ns/docbook">
 <title>Usando el paquete PHP</title>
 <simpara>
  PHP está incluido en los Macs desde la versión OS X 10.0.0. Habilitar PHP
  con el servidor web por defecto requiere descomentar unas cuantas líneas 
  en el fichero de configuración de Apache <filename>httpd.conf</filename> donde 
  <acronym>CGI</acronym> y/o <acronym>CLI</acronym> están activados por defecto
  (son fácilmente accesibles a través del programa Terminal).
 </simpara>
 <simpara>
  Siguiendo las instrucciones que se ofrecen a continuación se podrá habilitar
  PHP de una forma rápida para un entorno de desarrollo local. Es 
  <emphasis>muy recomendable</emphasis> tener siempre actualizado PHP a la última
  versión. Como casi todo el software vivo, y PHP no es una excepción, se crean 
  nuevas versiones para resolver errores y añadir nuevas funcionalidades. Consulte
  la documentación de instalación de Mac OS X adecuada para más detalles. Las siguientes
  instrucciones para obtener una configuración están orientadas a los principiantes que
  deseen obtener una configuración totalmente operativa. Se anima a todos los usuarios
  a compilar o instalar una nueva versión ya empaquetada.
 </simpara>
 <simpara>
  La instalación típica es mediante mod_php. Para habilitar el paquete mod_php que viene
  en el Mac OS X para el servidor web Apache (el servidor web por defecto, al que se puede
  acceder mediante las Preferencias del Sistema) se requiere efectuar los siguientes pasos:
 </simpara>
 <para>
  <orderedlist>
   <listitem>
    <simpara>
     Localizar y abrir el archivo de configuración de Apache. Por defecto, la localización
     de dicho fichero es: <filename>/private/etc/apache2/httpd.conf</filename>
    </simpara>
    <simpara>
     Mediante el <literal>Finder</literal> o el <literal>Spotlight</literal> puede ser 
     algo complicado encontrar dicho fichero ya que por defecto es privado y pertenece al 
     usuario <literal>root</literal>.
    </simpara>
    <note>
     <simpara>
      Una forma de abrir el fichero es usando un editor de texto basado en UNIX en el 
      Terminal, como por ejemplo <literal>nano</literal>. Debido a que el fichero 
      pertenece al usuario <literal>root</literal> se debe emplear el comando <literal>sudo</literal>
      para abrirlo (como si fueramos el usuario <literal>root</literal>). Por ejemplo, teclée
      lo siguiente en el <literal>Terminal</literal> (tras lo cual le preguntará por la contraseña):
      <literal>sudo nano /private/etc/apache2/httpd.conf</literal>
     </simpara>
     <simpara>
      Comandos de nano a tener en cuenta: <literal>^w</literal> (buscar), 
      <literal>^o</literal> (guardar), and <literal>^x</literal> (salir) donde
      <literal>^</literal> representa la tecla Ctrl.
     </simpara>
    </note> 
    <note>
     <simpara>
      Las versiones de Mac OS X anteriores a 10.5 tienen incorporadas versiones 
      antiguas de PHP y Apache. Por ello, es posible que el fichero de configuracion 
      de Apache se encuentre en dichos equipos en <filename>/etc/httpd/httpd.conf</filename>.
     </simpara>
    </note>
   </listitem>
   <listitem>
    <para>
     En el editor de texto, descomente las líneas (eliminando el símbolo #) que sean
     similares a las que se muestran a continuación (a menudo estas líneas se encuentran 
     separadas, asi que tendrá que localizar ambas en el fichero):
     <screen>
<![CDATA[
# LoadModule php5_module libexec/httpd/libphp5.so

# AddModule mod_php5.c
]]>
     </screen>
     Fíjese en la localización/ruta de acceso. Cuando compile PHP en el futuro,
     las lineas arriba indicadas deberán ser reemplazadas o comentadas.
    </para>
   </listitem>
   <listitem>
    <para>
     Asegúrese que las extensiones que desee puedan ser interpretadas como PHP 
     (por ejemplo: .php .html y .inc)
    </para>
    <para>
     Como las siguientes sentencias ya existían en el <filename>httpd.conf</filename> 
     (desde el Max Panther), una vez se habilite PHP los ficheros <filename>.php</filename>
     automáticamente seran interpretados como 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>
      Con anterioridad a OS X 10.5 (Leopard) se empaquetaba PHP 4 en lugar de PHP 5,
      en cuyo caso las instrucciones anteriores pueden ser ligeramente diferentes 
      cambiando los 5 por los 4.
     </para>
    </note>
   </listitem>
   <listitem>
    <simpara>
     Asegúrese que DirectoryIndex carga el fichero por defecto index deseado
    </simpara>
    <simpara>
     Esto tambien se configura en <filename>httpd.conf</filename>. Normalmente se usan 
     <filename>index.php</filename> y <filename>index.html</filename>. Por defecto
     <filename>index.php</filename> está habilitado porque está incluido en la 
     comprobación de PHP mostrada arriba. Ajuste a conveniencia.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     Configure la localizacion de &php.ini; o use el valor por defecto.
    </simpara>
    <simpara>
     Por defecto se localiza en los Mac OS X en <filename>/usr/local/php/php.ini</filename> 
     y empleando <function>phpinfo</function> se puede obtener esta información.
     Si no se está usando &php.ini;, PHP usará los valores por defecto. Véase 
     también las preguntas frecuentes relacionadas en <link linkend="faq.installation.phpini">finding php.ini</link>.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     Localize o configure el <literal>DocumentRoot</literal>
    </simpara>
    <simpara>
     Éste es el directorio raíz de todos los ficheros web. Los ficheros en este directorio
     son obtenidos del servidor web a fin de que los ficheros PHP sean ejecutados como PHP
     antes de ser enviados al navegador. Una ruta de acceso típica es <filename>/Library/WebServer/Documents</filename>
     pero puede ser configurada en <filename>httpd.conf</filename>. Como alternativa, 
     el <filename>DocumentRoot</filename> por defecto para usuarios individuales es 
     <filename>/Users/yourusername/Sites</filename>
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     Cree un fichero <function>phpinfo</function>
    </simpara>
    <para>
     La función <function>phpinfo</function> muestra información sobre PHP. Considere 
     la creación de un fichero en el DocumentRoot que contenga el siguiente código PHP:
     <programlisting role="php">
<![CDATA[
<?php phpinfo(); ?>
]]>
     </programlisting>
    </para> 
   </listitem>
   <listitem>
    <simpara>
     Reinicie Apache, y cargue el fichero PHP creado arriba
    </simpara>
    <para>
     Para reiniciar, ejecute <literal>sudo apachectl graceful</literal> en el shell o 
     desactive/active la opción "Compartir Web" en las Preferencias del Sistema. Por defecto, 
     cargar ficheros locales en el navegador tiene una <acronym>URL</acronym> parecida a:
     <filename>http://localhost/info.php</filename>. Usar DocumentRoot en el directorio 
     del usuario es otra opción, y la URL sería parecida a:
     <filename>http://localhost/~yourusername/info.php</filename>
    </para>
   </listitem>
  </orderedlist>
 </para>
 <simpara>
  <acronym>CLI</acronym> (o <acronym>CGI</acronym> en versiones antiguas) también es 
  llamado de forma correcta <filename>php</filename> y posiblemente existe como 
  <filename>/usr/bin/php</filename>. Abra el Terminal, lea la <link linkend="features.commandline">sección de línea de comando</link>
  del manual de PHP, y ejecute <literal>php -v</literal> para comprobar la versión de PHP del 
  binario PHP. Una llamada a <function>phpinfo</function> también le mostrará 
  esta información.
 </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
-->