andre_ae Wed May 1 22:32:38 2002 EDT
Added files:
/phpdoc/pt_BR/appendices commandline.xml
Log:
initial translation
Index: phpdoc/pt_BR/appendices/commandline.xml
+++ phpdoc/pt_BR/appendices/commandline.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.10 Maintainer: andre_ae Status: ready -->
<!--
TODO:
The command line options not in the
list, but in the -h output below:
-e, -z
It would be best to document these, and
collect more info about -c and -d!
-->
<appendix id="commandline">
<title>Usando o PHP na linha de comando</title>
<para>
As op��es de linha de comando para o execut�vel do PHP s�o �teis
se voc� deseja debugar ou testar a instala��o do PHP, mas
pode ser mais que isso, se voc� precisa utilizar o PHP para um
prop�sito diferente do script para Web.
</para>
<para>
Note que voc� sempre pode direcionar a sa�da do execut�vel do PHP
para um arquivo externo com o caracter >,
ent�o <literal>php -q test.php > test.html</literal>
enviar� todo a sa�da de <filename>test.php</filename>
sem os headers HTTP para o arquivo <filename>test.html</filename>
no mesmo diret�rio.
</para>
<para>
Voc� s� pode utilizar essas op��es de linha de comando se voc� tiver
o PHP execut�vel. Se voc� compilou a vers�o m�dulo
e n�o possui a vers�o CGI dispon�vel em sua
m�quina, ent�o voc� n�o poder� usar essas op��es.
Para os usu�rios Windows, tanto a vers�o execut�vel e m�dulo do PHP
ent�o na distribui��o bin�ria, onde o execut�vel �
chamado <filename>php.exe</filename>.
</para>
<para>
A seguinte lista das op��es de linha de comando est� atualizada para o PHP 4.0.6.
Voc� pode obter a lista atualizada e algumas descri��es com o opcional
<literal>-h</literal>. A sa�da de
<literal>php -h</literal> dever� ser algo como isso:
<screen>
<![CDATA[
Usage: php [-q] [-h] [-s [-v] [-i] [-f <file>] | {<file> [args...]}
-q Quiet-mode. Suppress HTTP Header output.
-s Display colour syntax highlighted source.
-f <file> Parse <file>. Implies `-q'
-v Version number
-C Do not chdir to the script's directory
-c <path> Look for php.ini file in this directory
-d foo[=bar] Define INI entry foo with value 'bar'
-e Generate extended information for debugger/profiler
-z <file> Load Zend extension <file>.
-l Syntax check only (lint)
-m Show compiled in modules
-i PHP information
-h This help
]]>
</screen>
</para>
<para>
Esta � a lista das mais importantes op��es de linha de comando
com explica��es detalhadas.
</para>
<para>
<table>
<title>Op��es de linha de comando</title>
<tgroup cols="2">
<thead>
<row>
<entry>Op��o</entry>
<entry>Descri��o</entry>
</row>
</thead>
<tbody>
<row>
<entry>-q</entry>
<entry>
Suprime os headers HTTP na sa�da. Normalmente o PHP imprime
headers HTTP para o programa chamador (normalmente o servidor web)
para encaminhar para o browser. Escrevendo aplica��es
para a linha de comando esses headers s�o desnecess�rios.
</entry>
</row>
<row>
<entry>-s</entry>
<entry>
Exibe o c�digo fonte com destaque de cores para o arquivo
interpretado com essa op��o. Tem o mesmo efeito de voc�
exibir c�digo fonte utilizando a fun��o
<function>highlight_file</function> num
script PHP.
</entry>
</row>
<row>
<entry>-f</entry>
<entry>
Interpreta o arquivo informado, e procura por erros de sintaxe ou
fatais. Essa op��o implica em -q. Utilize para
debugar.
</entry>
</row>
<row>
<entry>-v</entry>
<entry>
Chamando o PHP com essa op��o, ele exibe
o n�mero da sua vers�o, por exemplo, 4.0.6.
</entry>
</row>
<row>
<entry>-C</entry>
<entry>
Normalmente o PHP altera o diret�rio de trabalho para
o diret�rio de execu��o do script. Esta op��o torna poss�vel,
por exemplo, abrir arquivos no mesmo diret�rio,
apenas especificando o nome do arquivo. Se voc�
deseja desativar essa modifica��o de diret�rio, basta
usar a op��o.
</entry>
</row>
<row>
<entry>-c</entry>
<entry>
Utilizando essa op��o, voc� pode especificar um caminho alternativo
para o &php.ini;, ent�o o PHP
procurar� por seu arquivo de configura��es neste caminho
em vez de seu default.
</entry>
</row>
<row>
<entry>-d</entry>
<entry>
Com essa op��o, voc� pode configurar diretivas individuais do
&php.ini; para
execu��o de um script.
</entry>
</row>
<row>
<entry>-l</entry>
<entry>
Verifica o arquivo informado apenas para erros de sintaxe. Esta
op��o implica em -q. Utilize para debugar.
Esta op��o n�o verifica erros fatais (como fun��es
n�o definidas). Utilize -f para testar
erros fatais tamb�m.
</entry>
</row>
<row>
<entry>-m</entry>
<entry>
Utilizando esta op��o, o PHP imprime a lista dos m�dulos PHP e Zend
compilados (e carregados), as vers�es do PHP e
Zend e uma pequena informa��o de copyright
da Zend.
</entry>
</row>
<row>
<entry>-i</entry>
<entry>
Esta op��o chama a fun��o
<function>phpinfo</function> e imprime
seus resultados. Se o PHP n�o estiver funcionando bem,
� interessante que voc� fa�a um <literal>php -i</literal>
e voc� ver� qualquer mensagem de erro exibida
antes da tabela de informa��es.
</entry>
</row>
<row>
<entry>-h</entry>
<entry>
Com essa op��o voc� pode obter informa��es sobre
a atual lista de op��es de linha de comando e
pequenas descri��es dessas op��es.
</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<para>
O PHP execut�vel pode ser utilizando para rodar scripts PHP absolutamente
independente de um servidor web. Se voc� est� num sistema Unix,
voc� pode acrescentar uma linha especial ao in�cio de seu script e
torn�-lo execut�vel, ent�o o sistema operacional saber� que programa
dever� rodar o script. Na plataforma Windows, voc� pode associar
<literal>php.exe -q</literal> com o clique duplo em arquivos
<literal>.php</literal> ou fazer um arquivo batch
para rodar seus scripts atrav�s do PHP. A primeira linha acrescentada ao
script nos Unix n�o funcionam no Windows, por isso voc� n�o pode escrever
programas independentes de plataforma desse jeito. Um exemplo simples de como
escrever
um programa para a linha de comando segue abaixo:
</para>
<example>
<title>Um script para rodar na linha de comando (script.php)</title>
<programlisting role="php">
<![CDATA[
#!/usr/bin/php -q
<?php
if ($argc != 2 || in_array($argv[1], array('--help', '-help', '-h', '-?'))) {
?>
Este � um script de linha de comando com um par�metro.
Uso:
<?php echo $argv[0]; ?> <opcao>
<opcao> pode ser qualquer palavra que
voc� queira imprimir. Com as op��es --help, -help, -h
ou -?, voc� pode obter essa ajuda.
<?php
} else {
echo $argv[1];
}
?>
]]>
</programlisting>
</example>
<para>
No script acima, n�s utilizamos uma primeira linha especial para indicar
que este arquivo precisa rodar pelo PHP e que n�o deve imprimir headers
HTTP. H� duas vari�veis que voc� precisa conhecer para escrever aplica��es
em linha de comando com o PHP: <varname>$argc</varname> e
<varname>$argv</varname>. O primeiro � o n�mero de argumentos mais
um (o nome do script executando). O segundo � um array
contendo os argumentos, come�ando com o nome do script no �ndice
zero (<varname>$argv[0]</varname>).
</para>
<para>
No programa acima � verificado se h� apenas um argumento
fornecido. Se o argumento for <literal>--help</literal>,
<literal>-help</literal>, <literal>-h</literal> ou <literal>-?</literal>,
� impresso uma mensagem de ajuda, imprimindo o nome do script dinamicamente.
Qualquer outro argumento � exibido como informado.
</para>
<para>
Para rodar esse aplicativo nos Unix, basta torn�-lo
execut�vel e o chamar diretamente como
<literal>script.php exibaisso</literal> ou
<literal>script.php -h</literal>. No Windows, voc� pode fazer um
arquivo batch para esta tarefa:
</para>
<example>
<title>Arquivo batch para rodar um script em linha de comando (script.bat)</title>
<programlisting role="winbat">
@c:\php\php.exe -q script.php %1 %2 %3 %4
</programlisting>
</example>
<para>
Assumindo que voc� nomeou o programa acima como
<filename>script.php</filename>, e voc� tem um
<filename>php.exe</filename> em
<filename>c:\php\php.exe</filename> este arquivo batch
ir� rodar com os seguintes par�metros:
<literal>script.bat exibaisso</literal> ou
<literal>script.bat -h</literal>.
</para>
<para>
Veja tamb�m a documenta��o da extens�o <link linkend="ref.readline">Readline</link>
para mais fun��es que voc� pode usar
para incrementar suas aplica��es para linha de comando em PHP.
</para>
</appendix>
<!-- 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:"../../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
-->
