archived-doc-es/install/windows/commandline.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 14af302c9c0e561fa6f9cdd956268758ba9a89c5 Maintainer: jorgeolaya Status: ready --> 
<!-- Reviewed: no -->
<sect1 xml:id="install.windows.commandline" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title>Linea de Comandos PHP en Microsoft Windows </title>
 <para>
  Esta sección contiene notas y sugerencias específicas para conseguir ejecutar PHP 
  en la línea de comandos para Windows. 
 </para>
 <note>
  <para>
   Usted debe leer primero el <link linkend="install.windows.manual">manual
   de instalación</link>
  </para>  
 </note>
 <para>
  Cómo ejecutar PHP desde la línea de comandos sin hacer 
  ningún cambio a Windows.
  <screen>
<![CDATA[
C:\PHP5\php.exe -f "C:\PHP Scripts\script.php" -- -arg1 -arg2 -arg3
]]>     
  </screen>
 </para>
 
 <para>
  Pero hay algunos pasos sencillos que puede seguir para hacer esto simple. 
  Algunas de estas medidas ya se deberían haber tomado, pero se repiten aquí 
  para ser capaz de proporcionar una completa secuencia paso a paso.
  
  
  <itemizedlist>
   
   <note>
    <para>
     Tanto <envar>PATH</envar> como <envar>PATHEXT</envar> son variables de sistema preexistentes importantes en Windows, por lo que se ha de asegurarse de no sobrescribir dichas variables, solamente agregarle algo.
    </para>
   </note>
   
   <listitem>
    <para>
     Añada la ubicación del ejecutable de PHP (<filename>php.exe</filename>, 
     <filename>php-win.exe</filename> o <filename>php-cli.exe</filename>
     dependiendo de su versión de PHP y las preferencias de presentación) a la 
     variable de entorno <envar>PATH</envar>. Lea más acerca de cómo 
     añadir el directorio de PHP <envar>PATH</envar> en la <link
     linkend="faq.installation.addtopath">entrada correspondiente de preguntas frecuentes</link>.
    </para> 
   </listitem>
   
   <listitem>
    <para>
     Añada la extensión <literal>.PHP</literal> de la 
     variable de entorno <envar>PATHEXT</envar>. Esto se puede hacer 
     al mismo tiempo, con la modificación de la variable de entorno <varname>PATH</varname>.
     Siga los mismos pasos como se describe en las <link
     linkend="faq.installation.addtopath">Preguntas frecuentes</link> pero habría que modificar la 
     variable de entorno <varname>PATHEXT</varname>en lugar de la 
     variable de entorno <envar>PATH</envar>. 
     <note>
      <para>
       La posición en que se coloca el <literal>.PHP</literal>  
       determina qué secuencia de comandos o programa se ejecuta cuando hay nombre de archivos coincidentes. 
       Por ejemplo, colocar <literal>.PHP</literal> antes de 
       <literal>.BAT</literal> hará que el script se ejecute, en lugar de 
       el archivo por lotes, si hay un fichero por lotes con el mismo nombre. 
      </para>
     </note>
    </para>
   </listitem>
   
   <listitem>
    <para>
     Asociar la extensión <literal>.PHP</literal> con un tipo de fichero. Esta 
     se hace ejecutando el siguiente comando: 
     <screen>
<![CDATA[
assoc .php=phpfile
]]>     
     </screen>
    </para>
   </listitem>
   <listitem>
    <para>
     Asociar el tipo de fichero <literal>phpfile</literal> con el adecuado 
     ejecutable PHP. Esto se hace ejecutando el siguiente comando: 
     <screen>     
<![CDATA[
ftype phpfile="C:\PHP5\php.exe" -f "%1" -- %~2
]]>     
     </screen>
    </para>
   </listitem>
   
  </itemizedlist>
 </para>
 
 <para>
  Si sigue estos pasos permitirá ejecutar scripts PHP desde cualquier directorio 
  sin necesidad de escribir el ejecutable PHP o la extensión <literal>.PHP</literal>
  y todos los parámetros, será enviada a el script para el procesamiento. 
 </para>
 
 <para>
  En el ejemplo a continuación se detallan algunos de los cambios de registro que se puede hacer manualmente. 
  <example>
   <title>Registro de cambios</title>
   <screen>
<![CDATA[
Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\.php]
@="phpfile"
"Content Type"="application/php"

[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\phpfile]
@="PHP Script"
"EditFlags"=dword:00000000
"BrowserFlags"=dword:00000008
"AlwaysShowExt"=""

[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\phpfile\DefaultIcon]
@="C:\\PHP5\\php-win.exe,0"

[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\phpfile\shell]
@="Open"

[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\phpfile\shell\Open]
@="&Open"

[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\phpfile\shell\Open\command]
@="\"C:\\PHP5\\php.exe\" -f \"%1\" -- %~2"
]]>
   </screen>
  </example>
 </para>
 
 <para>
  Con estos cambios el mismo comando se puede escribir como: 
  <screen>
<![CDATA[
"C:\PHP Scripts\script" -arg1 -arg2 -arg3
]]>
  </screen>
  O, si la ruta de acceso <literal>"C:\PHP Scripts"</literal> está en el 
  variable de entorno <envar>PATH</envar>:
  <screen>
<![CDATA[
script -arg1 -arg2 -arg3
]]>
     </screen>
 </para>
 
 <note>
  <para>
   Hay un pequeño problema si tiene intención de utilizar esta técnica y usar 
   scripts PHP como filtro de línea de comandos, como el ejemplo a continuación: 
   <screen>
<![CDATA[
dir | "C:\PHP Scripts\script" -arg1 -arg2 -arg3
]]>
   </screen>
   o
   <screen>
<![CDATA[
dir | script -arg1 -arg2 -arg3
]]>
      </screen>
      Es posible que el script simplemente se cuelga y no salga nada. 
      Para hacer esto operacional, es necesario hacer otro cambio en el registro. 
      <screen>
<![CDATA[
Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\policies\Explorer]
"InheritConsoleHandles"=dword:00000001
]]>
      </screen>
      Información adicional sobre este tema se pueden encontrar en el 
      <link xlink:href="http://support.microsoft.com/default.aspx?scid=kb;en-us;321788">artículo de Microsoft: 321788</link>
     </para>
 </note>
</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
-->