andre_ae Mon Nov 12 20:46:32 2001 EDT
Modified files:
/phpdoc/pt_BR/chapters intro.xml
Log:
sync for the EN version
Index: phpdoc/pt_BR/chapters/intro.xml
diff -u phpdoc/pt_BR/chapters/intro.xml:1.3 phpdoc/pt_BR/chapters/intro.xml:1.4
--- phpdoc/pt_BR/chapters/intro.xml:1.3 Fri Feb 23 20:59:49 2001
+++ phpdoc/pt_BR/chapters/intro.xml Mon Nov 12 20:46:31 2001
@@ -1,65 +1,146 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+
<chapter id="introduction">
<title>Introdu��o</title>
<sect1 id="intro-whatis">
<title>O que � PHP?</title>
- <simpara>
- PHP (oficialmente "PHP: Hypertext Preprocessor") � uma linguagem de script
- server-side HTML-embedded.
- </simpara>
<para>
- Resposta simples, mas o que isso significa ? Um exemplo:
+ PHP (um acr�nimo recursivo para "PHP: Hypertext Preprocessor")
+ � uma linguagem de script open-source do lado do servidor embut�vel em HTML.
+ </para>
+ <para>
+ Uma resposta simples, mas o que isso significa? Um exemplo:
</para>
<para>
<example>
<title>Um exemplo introdut�rio</title>
<programlisting role="php">
-<html>
- <head>
- <title>Example</title>
- </head>
- <body>
-
- <?php
- echo "Hi, I'm a PHP script!";
- ?>
-
- </body>
-</html>
+<![CDATA[
+<html>
+ <head>
+ <title>Exemplo</title>
+ </head>
+ <body>
+
+ <?php
+ echo "Ol�, Eu sou um script PHP!";
+ ?>
+
+ </body>
+</html>
+]]>
</programlisting>
</example>
</para>
<para>
Note como isso � diferente de scripts CGI escritos em outras
linguagens como Perl ou C --- ao inv�s de escrever um programa com um monte
- de comandos para imprimir HTML, voc� escreve um script HTML com algum
- c�digo inserido para fazer alguma coisa (nesse caso, imprimir algum
+ de comandos para imprimir HTML, voc� escreve um arquivo HTML com algum
+ c�digo inserido para fazer alguma coisa (nesse caso, imprimir um pouco de
texto). O c�digo PHP � delimitado por <link
linkend="language.basic-syntax.phpmode">tags iniciais e finais</link>
- que lhe permitem pular pra dentro e pra fora do modo PHP.
+ que lhe permitem pular pra dentro e pra fora do "modo PHP".
</para>
<para>
- O que distingui o PHP de algo como Javascript client-side
+ O que distingui o PHP de algo como Javascript no lado do cliente
� que o c�digo � executado no servidor. Se voc� tivesse um
script similar ao acima em seu servidor, o cliente receberia
os resultados da execu��o desse script, sem nenhum modo de determinar
qual � o c�digo fonte. Voc� pode inclusive configurar seu servidor
para processar todos os seus arquivos HTML como PHP, e ent�o n�o haver�
- nenhum modo dos usu�rios descobrirem que voc� usa c�digo.
+ nenhum modo dos usu�rios descobrirem que voc� usa essa linguagem.
</para>
</sect1>
<sect1 id="intro-whatcando">
<title>O que o PHP pode fazer?</title>
<para>
- No n�vel mais b�sico, o PHP pode fazer qualquer coisa que qualquer outro programa
- CGI pode fazer, como coletar dados de formul�rio, gerar conte�do
- de p�gina din�mico, ou enviar e receber cookies.
+ Qualquer coisa. O PHP � focado para ser uma linguagem de script do lado do
+servidor,
+ portanto, voc� pode fazer qualquer coisa que outro programa CGI pode fazer, como:
+ coletar dados de formul�rios, gerar conte�do din�mico de p�ginas ou
+ enviar e receber cookies. Mas o PHP pode fazer muito mais.
+ </para>
+ <para>
+ Esses s�o os maiores campos onde os scripts PHP podem se utilizados:
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ Script no lado do servidor (server-side). Este � o mais tradicional
+ e principal campo de atua��o do PHP. Voc� precisa de tr�s coisas
+ para seu trabalho. O interpretador do PHP (como CGI ou m�dulo),
+ um servidor web e um browser. Basta rodar o servidor web
+ conectado a um PHP instalado.
+ Voc� pode acessar os resultados de seu programa PHP com um browser,
+ visualizando a p�gina PHP atrav�s do servidor web. Veja as
+ <link linkend="installation">instru��es de instala��o</link>
+ para maiores informa��es.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ Script de linha de comando. Voc� pode fazer um script PHP
+ funcionar sem um servidor web ou browser.
+ A �nica coisa necess�ria � o interpretador.
+ Esse tipo de uso � ideal para script executados
+ usando o <literal>cron</literal> (ou o Agendador de Tarefas no Windows),
+ ou rotinas de processamento de texto. Veja a se��o
+ <link linkend="commandline">Utilizando o PHP em
+ linha de comando</link> para maiores informa��es.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ Escrevendo aplica��es GUI no lado do cliente (client-side). O PHP n�o �
+(provavelmente)
+ a melhor linguagem para produ��o de aplica��es com interfaces em janelas,
+ mas o PHP faz isso muito bem, e se
+ voc� deseja usar alguns recursos avan�ados do PHP em
+ aplica��es no lado do cliente poder� utilizar o
+ PHP-GTK para escrever esses programas. E programas
+ escritos desta forma ainda ser�o independentes de plataforma.
+ O PHP-GTK � uma extens�o do PHP, n�o dispon�vel na
+ distribui��o oficial. Se voc� est� interessado no
+ PHP-GTK, visite <ulink url="&url.php.gtk;">seu
+ website</ulink>
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ O PHP pode ser utilizado na maioria dos sistemas operacionais, incluindo
+ Linux, v�rias variantes Unix (incluindo HP-UX, Solaris e OpenBSD),
+ Microsoft Windows, Mac OS X, RISC OS, e provavelmente outros.
+ O PHP tamb�m � suportado pela maioria dos servidores web atuais, incluindo
+ Apache, Microsoft Internet Information Server,
+ Personal Web Server, Netscape and iPlanet Servers, Oreilly
+ Website Pro Server, Caudium, Xitami, OmniHTTPd, e muitos
+ outros. O PHP pode ser configurado como um m�dulo para a maioria dos servidores,
+ e para os outros como um CGI padr�o.<!--(repetitivo) PHP can work
+ as a CGI processor.-->
+ </para>
+ <para>
+ Com o PHP, portanto, voc� tem livre arb�trio para escolher o sistema
+ operacional e o servidor web. Do mesmo modo, voc� pode escolher entre
+ utilizar programa��o estrutural ou programa��o orientada a objeto,
+ ou uma mistura deles. Mesmo n�o
+ desenvolvendo nenhum recurso padr�o de OOP (Object Oriented Programming,
+Programa��o Orientada a Objetos) na vers�o atual
+ do PHP, muitas bibliotecas de c�digo e grandes aplica��es (incluindo a
+ <link linkend="pear">biblioteca PEAR</link>) foram escritos somente
+ utilizando OOP.
+ </para>
+ <para>
+ Com PHP voc� n�o est� limitado a gerar somente HTML. As habilidades
+ do PHP incluem gera��o de imagens, arquivos PDF e anima��es Flash
+ (utilizando libswf ou Ming) criados dinamicamente, on the fly. Voc� pode
+ facilmente criar qualquer padr�o texto, como XHTML e outros arquivos XML.
+ O PHP pode gerar esses padr�es e os salvar no sistema de arquivos,
+ em vez de imprimi-los, formando um cache din�mico de suas informa��es
+ no lado do servidor.
</para>
<para>
- Talvez a mais forte e mais significante caracter�stica do PHP � seu
+ Talvez a mais forte e mais significativa caracter�stica do PHP � seu
suporte a uma ampla variedade de banco de dados. Escrever uma p�gina que consulte
- um banco de dados � incivelmente simples. Os seguintes bancos de dados s�o
atualmente
+ um banco de dados � incrivelmente simples. Os seguintes bancos de dados s�o
+atualmente
suportados:
<blockquote>
<simplelist columns="3">
@@ -86,71 +167,99 @@
<member>Unix dbm</member>
</simplelist>
</blockquote>
+ Tamb�m foi providenciado uma abstra��o de banco de dados DBX permitindo a voc�
+ utilizar qualquer banco de dados transparentemente com sua extens�o.
+ Adicionalmente, o PHP suporta ODBC (Open Database Connection, ou Padr�o Aberto de
+Conex�o com Bancos de Dados),
+ permitindo que voc� utilize qualquer outro banco de dados que suporte
+ esse padr�o mundial.
+ </para>
+ <para>
+ O PHP tamb�m tem suporte para comunica��o com outros servi�os utilizando
+protocolos
+ como LDAP, IMAP, SNMP, NNTP, POP3, HTTP, COM (em Windows) e
+ incont�veis outros. Voc� pode abrir sockets de rede e
+ interagir diretamente com qualquer protocolo. O PHP tamb�m suporta o
+ interc�mbio de dados complexos WDDX, utilizado em virtualmente todas as linguagens
+ de programa��o para web. Falando de comunica��o, o PHP implementa a
+ instancia��o de objetos Java e os utiliza transparentemente como
+ objetos PHP. Voc� ainda pode usar sua extens�o CORBA para
+ acessar objetos remotos.
+ </para>
+ <para>
+ O PHP � extremamente �til em recursos de processamento de texto, do
+ POSIX Estendido ou express�es regulares Perl at� como interpretador para
+ documentos XML. Para acessar e processar documentos XML, s�o
+ suportados os padr�es SAX e DOM. Voc� ainda pode usar nossa extens�o
+ XSLT para transformar documentos XML.
+ </para>
+ <para>
+ Utilizando o PHP no campo comercial, voc� poder� as
+ fun��es espec�ficas para Cybescash, CyberMUT, Verysign Payflow
+ Pro e CCVS, pr�ticos sistemas de pagamento
+ online.
</para>
<para>
- O PHP tamb�m tem suporte para conversar com outros servi�os usando protocolos
- como IMAP, SNMP, NNTP, POP3, HTTP e incint�veis outros. Voc� tamb�m pode
- abrir cockets raw de rede e interagir usando outros protocolos.
- </para>
-<!--
- <figure>
- <title>Estrutura Interna</title>
- <graphic fileref="../images/php3_internal_structure.gif"/>
- </figure>
- <figure>
- <title>Esquema de Requisi��o</title>
- <graphic fileref="../images/php3_request_scheme.gif"/>
- </figure>
--->
+ Por �ltimo mas longe de terminar, temos tamb�m outras extens�es
+ interessantes: fun��es para o search engine mnoGoSearch,
+ fun��es para Gateway IRC, v�rios utilit�rios de compress�o
+ (gzip, bz2), calend�rio e convers�es de datas, tradu��o...
+ </para>
+ <para>
+ Como voc� pode ver, esta p�gina n�o � suficiente para descrever todos
+ os recursos e benef�cios que o PHP pode oferecer. Leia nas
+ se��es sobre a <link linkend="installation">Instala��o do
+ PHP</link>, e veja a <link linkend="funcref">lista de
+ fun��es</link> para detalhes das extens�es
+ mencionadas aqui.
+ </para>
</sect1>
<sect1 id="intro-history">
<title>Uma breve hist�ria do PHP</title>
<simpara>
- O PHP foi concebido em alguma �poca de 1994 por &link.rasmus;.
- Vers�es iniciais n�o lan�adas foram usadas em sua home page para manter
- uma trilha de quem estava olhando o seu curr�culo virtual. A primeira vers�o
- usada por outros estava dispon�vel em alguma �poca de 1995 e era conhecida como
- o Personal Home Page Tools. Consistia de um interpretador
- muito simplista que apenas entendia algumas macros especiais
- e um n�mero de utilidades que eram de uso comum em home pages
- daquela �poca. Um guestbook, um contador, e algumas outras coisas. O
- interpretador foi reescrito em meados de 1995 e batizado PHP/FI Version 2. O
- FI veio de outro pacote que Rasmus tinha escrito que interpretava
- dados de formul�rios html. Ele combinou os scripts do Personal Home Page Tools
- com o Form Interpreter e adicionou suporte mSQL e o PHP/FI
- nasceu. PHP/FI cresceu a um passo fant�stico e pessoas come�aram
- a contribuir para o c�digo.
+ O PHP foi concebido em por volta de 1994 por &link.rasmus;.
+ Vers�es iniciais n�o lan�adas foram usadas em sua home page para
+ rastrear quem estava olhando o seu curr�culo virtual. A primeira vers�o
+ utilizada por terceiros ficou dispon�vel em 1995 e era conhecida como
+ Personal Home Page Tools. Consistia de um interpretador
+ muito simples que apenas entendia algumas macros especiais
+ e um conjunto de utilit�rios comuns em home pages
+ daquela �poca. Um guestbook (livro de visitantes), um contador, e algumas outras
+coisas. O
+ interpretador foi rescrito em meados de 1995 e batizado PHP/FI vers�o 2. O
+ FI era de outro pacote que Rasmus tinha escrito e interpretava
+ dados de formul�rios HTML. Ele combinou os scripts do Personal Home Page Tools
+ com o Form Interpreter e adicionou suporte ao mSQL e assim nasceu o
+ PHP/FI. O PHP/FI cresceu a um ritmo fant�stico e pessoas come�aram
+ a contribuir para seu c�digo.
</simpara>
<simpara>
- � dif�cil dar qualquer estat�stica, mas � estimado
- que ao tardar de 1996 o PHP/FI estava em uso em pelo menos 15,000 web sites
+ � dif�cil precisar qualquer estat�stica, mas estima-se
+ que ao final de 1996 o PHP/FI estava em uso em pelo menos 15,000 web sites
ao redor do mundo. Em meados de 1997 este n�mero tinha crescido para mais de
- 50,000. Em 1997 tamb� houve uma mudan�a no desenvolvimento do PHP. Deixou
- de ser o projeto pessoal de Ramus para o qual muitas pessoas tinham
- contribu�do, para se tornar em um esfor�o de um time mais
- organizado. O interpretador foi reescrito do zero por Zeev Suraski e
- Andi Gutmans e este novo interpretador formou a base do PHP Version
- 3. Muito do c�digo de utilit�rios do PHP/FI foi portado para o PHP 3
- e muito dele foi completamente reescrito.
+ 50,000. Na metade de 1997 houve uma mudan�a no desenvolvimento do PHP. Ele deixou
+ de ser o projeto pessoal de Rasmus ao qual muitas pessoas tinham
+ contribu�do, para se tornar o foco de um time mais
+ organizado. O interpretador foi rescrito do zero por Zeev Suraski e
+ Andi Gutmans e este novo interpretador formou a base do PHP vers�o
+ 3. Muito do c�digo dos utilit�rios do PHP/FI foi portado para o PHP 3
+ e muito mais dele foi completamente rescrito.
</simpara>
<simpara>
- A �ltima vers�o (PHP 4) usa a ferramenta <ulink
- url="&url.zend;">Zend</ulink> scripting para possibilitar alta
- performance, suporta ainda uma ampla variedade de bibliotecas externas
- e extens�es, e roda como um m�dulo nativo com todos os
+ A �ltima vers�o (PHP 4) usa engine de scripting da <ulink
+ url="&url.zend;">Zend</ulink> para possibilitar alta
+ performance, suportar uma ampla variedade de bibliotecas externas
+ e extens�es, e ainda rodar como um m�dulo nativo com todos os
servidores web populares.
</simpara>
<simpara>
- Hoje (1/2001) PHP 3 ou PHP 4 agora det�m um n�mero de
- produtos comerciais como o servidor web da Red Hat, Stronghold.
+ Hoje (1/2001), o PHP 3 ou 4 pode ser encontrado em numerosos
+ produtos comerciais como o servidor web Stronghold da Red Hat.
Uma estimativa conservadora baseada na extrapola��o de
n�meros fornecidos pela <ulink url="&url.netcraft;">Netcraft</ulink>
(veja tamb�m <ulink url="&url.netcraft-survey;">Netcraft Web Server
- Survey</ulink>) seriam que o PHP est� em uso em mais de 5,100,000
+ Survey</ulink>) diria que o PHP est� em uso em mais de 5.100.000
sites ao redor do mundo. Para colocar isso em perspectiva, este n�mero �
- sens�velmente maior do que o n�mero de sites que rodam o servidor IIS da
Microsoft na Internet
- (5.03 milh�es).
+ sensivelmente maior do que o n�mero de sites que rodam o servidor IIS da
+Microsoft na Internet
+ (5,03 milh�es).
</simpara>
<!--
<figure>