php/archived-doc-pt-br
1
0
Fork 0
mirror of https://github.com/php/doc-pt_br.git synced 2026-03-23 22:52:12 +01:00
Code Issues Packages Projects Releases Wiki Activity

* Fix some editor warnings about tabs and emphasis

Browse Source 
* Sync with latest EN version

git-svn-id: https://svn.php.net/repository/phpdoc/pt_BR/trunk@321680 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Thiago Henrique Pojda
2012-01-02 14:15:49 +00:00
parent f67ba17a84
commit 4ce930e9cb
10 changed files with 148 additions and 715 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
extensions.ent
View File

@@ -1,4 +1,5 @@
<!-- EN-Revision: 91ffe95d8be92e217cc7400fd6d4673be9daf847 Maintainer: felipe Status: ready --><!-- CREDITS: narigone -->
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8a887a3be84772ab571d361e7cb03cec3e5e8725 Maintainer: thiago Status: ready -->
<!--
Entities for the categorized extension list, so it does not need
to be translated, and thus it is not going to be outdated.
@@ -8,9 +9,10 @@
apêndice categoriza mais de 150 extensões documentadas no manual do
PHP por vários critérios.</para>'>
<!ENTITY extcat.alphabetical '<title xmlns="http://docbook.org/ns/docbook">Em ordem alfabética</title>'>
<!-- ======================================================================= -->
<!ENTITY extcat.alphabetical '<title xmlns="http://docbook.org/ns/docbook">Em ordem alfabética</title>'>
<!ENTITY extcat.purpose '<title xmlns="http://docbook.org/ns/docbook">Propósito</title>'>
<!ENTITY extcat.purpose.basic '<title xmlns="http://docbook.org/ns/docbook">Extensões Básicas do PHP</title>'>
@@ -22,7 +24,7 @@ PHP por vários critérios.</para>'>
<!ENTITY extcat.purpose.database '<title xmlns="http://docbook.org/ns/docbook">Extensões de Bancos de Dados</title>'>
<!ENTITY extcat.purpose.database.abstract '<title xmlns="http://docbook.org/ns/docbook">Camadas de Abstração</title>'>
<!ENTITY extcat.purpose.database.vendors '<title xmlns="http://docbook.org/ns/docbook">Extensões de Bancos de Dados Específicas</title>'>
<!ENTITY extcat.purpose.database.vendors '<title xmlns="http://docbook.org/ns/docbook">ns</title>'>
<!ENTITY extcat.purpose.xml '<title xmlns="http://docbook.org/ns/docbook">Manipulação de XML</title>'>
@@ -45,14 +47,14 @@ PHP por vários critérios.</para>'>
<!ENTITY extcat.purpose.remote.auth '<title xmlns="http://docbook.org/ns/docbook">Serviços de Autenticação</title>'>
<!ENTITY extcat.purpose.remote.other '<title xmlns="http://docbook.org/ns/docbook">Outros Serviços</title>'>
<!ENTITY extcat.purpose.compression '<title xmlns="http://docbook.org/ns/docbook">Extensões de Compressão e Arquivo</title>'>
<!ENTITY extcat.purpose.compression '<title xmlns="http://docbook.org/ns/docbook">Extensões de Arquivo e Compressão</title>'>
<!ENTITY extcat.purpose.calendar '<title xmlns="http://docbook.org/ns/docbook">Extensões Relacionadas à Calendários e Eventos</title>'>
<!ENTITY extcat.purpose.calendar '<title xmlns="http://docbook.org/ns/docbook">Extensões Relacionadas à Data e Hora</title>'>
<!ENTITY extcat.purpose.utilspec '<title xmlns="http://docbook.org/ns/docbook">Extensões Específicas à Área de Utilização</title>'>
<!ENTITY extcat.purpose.utilspec.nontext '<title xmlns="http://docbook.org/ns/docbook">Saída de MIME Não-Texto</title>'>
<!ENTITY extcat.purpose.utilspec.image '<title xmlns="http://docbook.org/ns/docbook">Geração e Processamento de Imagens</title>'>
<!ENTITY extcat.purpose.utilspec.audio '<title xmlns="http://docbook.org/ns/docbook">Manipulação de Formatos de Áudio</title>'>
<!ENTITY extcat.purpose.utilspec.audio '<title xmlns="http://docbook.org/ns/docbook">Manipulação de Formatos de áudio</title>'>
<!ENTITY extcat.purpose.utilspec.cmdline '<title xmlns="http://docbook.org/ns/docbook">Extensões Específicas de Linha de Comando</title>'>
<!ENTITY extcat.purpose.utilspec.windows '<title xmlns="http://docbook.org/ns/docbook">Extensões Apenas do Windows</title>'>
<!ENTITY extcat.purpose.utilspec.server '<title xmlns="http://docbook.org/ns/docbook">Extensões Específicas do Servidor</title>'>
@@ -73,7 +75,7 @@ compilar essas extensões é preciso ter bibliotecas externas.</para>'>
<!ENTITY extcat.membership.pecl '<title xmlns="http://docbook.org/ns/docbook">Extensões PECL</title><para xmlns="http://docbook.org/ns/docbook">Essas
extensões são disponível na <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.pecl;" xmlns="http://docbook.org/ns/docbook">PECL</link>. Existem outras
extensões PECL, mas elas ainda não são documentadas no manual do PHP.</para>'>
extensões PECL, mas elas ainda não estão documentadas no manual do PHP.</para>'>
<!-- ======================================================================= -->
@@ -87,5 +89,4 @@ extensões tornaram-se normalmente obsoletas em favor de outras extensões.</par
<!ENTITY extcat.state.experimental '<title xmlns="http://docbook.org/ns/docbook">Extensões Experimentais</title><para xmlns="http://docbook.org/ns/docbook">O
comportamento dessas extensões - incluindo os nomes das suas funções e qualquer
outra coisa documentada sobre essas extensões - podem mudar sem aviso em versões futuras
do PHP. O uso dessas extensões é arriscado.</para>'>
do PHP. Use essas funções a seu próprio risco.</para>'>

4
features/cookies.xml
View File

@@ -21,13 +21,13 @@
incluido na auto-global <varname>$_COOKIE</varname>
se <link linkend="ini.variables-order">variables_order</link> contém "C".
Se você deseja assimilar vários valores em um único
cookie, simplesmente acrescente <emphasis>[]</emphasis> ao nome do cookie.
cookie, simplesmente acrescente <literal>[]</literal> ao nome do cookie.
</para>
<para>
Dependendo da <link linkend="ini.register-globals">register_globals</link>,
variáveis regulares do PHP podem ser criadas para cookies. Contudo, não é recomendado
confiar neste recurso que pode ser freqüentemente desabilitado por motivos de segurança.
confiar neste recurso que pode ser frequentemente desabilitado por motivos de segurança.
<varname>$HTTP_COOKIE_VARS</varname> é também definido nas versões anteriores do PHP,
também, quando a variável de configuração <link linkend="ini.track-vars">track_vars</link>
estiver ativa. (Esta diretiva é obrigatoriamente ligada a partir do PHP 4.0.3.)

628
install/windows/building.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: n/a Maintainer: thiago Status: ready -->
<!-- EN-Revision: ce59ffa1590f4734e1c4dcaa83233cfa2f87ff7e Maintainer: thiago Status: ready -->
<sect1 xml:id="install.windows.building" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Compilando a partir dos fontes</title>
<para>
@@ -7,628 +7,10 @@
as ferramentas da Microsoft. Para compilar o PHP com cygwin, veja o <xref
linkend="install.unix"/>.
</para>
<sect2 xml:id="install.windows.building.quick-guide">
<title>Quick Guide to Building On Windows</title>
<para>
Este rápido guia passo-a-passo foi escrito em Março de 2008, executado no
Windows XP Service Pack 2 com todos as últimas atualizações e compilando o
PHP versões 5.2.5 e 5.3. Sua experiência pode ser diferente se utilizar outras ferramentas
</para>
<orderedlist>
<listitem>
<para>
Baixar e instalar:
</para>
<itemizedlist>
<listitem>
<simpara>
<link xlink:href="&url.vc2k8ee;">Microsoft
Visual C++ 2008 Express Edition</link>
</simpara>
</listitem>
<listitem>
<simpara>
<link xlink:href="&url.win32.sdk;">
Windows SDK for Windows Server 2008 and .NET Framework 3.5</link>
</simpara>
</listitem>
</itemizedlist>
</listitem>
<listitem>
<simpara>
Copie <filename>C:\Arquivos de Programas\Microsoft SDKs\Windows\v6.1\Include\WinResrc.h</filename>
para <filename>C:\Arquivos de Programas\Microsoft SDKs\Windows\v6.1\Include\winres.h</filename>.
</simpara>
</listitem>
<listitem>
<simpara>
Crie o diretório <filename>C:\work</filename>.
</simpara>
</listitem>
<listitem>
<simpara>
Baixe <link xlink:href="&url.win32.buildtools;">as ferramentas de
compilação do Windows</link> e descompacte o conteúdo em <filename>C:\work</filename>.
</simpara>
</listitem>
<listitem>
<simpara>
Crie o diretório <filename>C:\usr\local\lib</filename>. Copie
<filename>C:\work\win32build\bin\bison.simple</filename> para o novo
diretório.
</simpara>
</listitem>
<listitem>
<simpara>
Baixe <link xlink:href="&url.win32.dnsresolver;">a biblioteca de
resolução de DNS do Windows</link> e descompacte o conteúdo em <filename>C:\work</filename>.
</simpara>
</listitem>
<listitem>
<simpara>
Abra o arquivo <filename>C:\work\bindlib_w32\bindlib.dsw</filename>. Se e
quando perguntao se deseja atualizar o projeto, escolha Sim (Yes).
Escolha a configuração Release ou Debug na barra superior, então escolha
Compilar (Build) =&gt; Compilar Solução (Build Solution).
</simpara>
</listitem>
<listitem>
<simpara>
Obtenha uma cópia dos fontes do PHP e extraia para o diretório
<filename>C:\work</filename>. A essa altura, o diretório deverá estar
parecido com isso:
</simpara>
<screen>
<![CDATA[
+-C:\work
| +-bindlib_w32
| | +-Debug
| | | +-resolv.lib
| | | +-...
| | +-...
| +-win32build
| | +-bin
| | +-include
| | +-lib
| +-php-5.2.5
| | +-build
| | +-win32
| | +-...]]></screen>
</listitem>
<listitem>
<simpara>
Abra um shell utilizando o atalho no menu iniciar para o Visual Studio
2008 Command Prompt.
</simpara>
</listitem>
<listitem>
<simpara>
Execute o comando:
</simpara>
<screen>
<![CDATA[
C:\Arquivos de Programas\Microsoft Visual Studio 9.0\VC> set "PATH=C:\work\win32build\bin;%PATH%"
C:\Arquivos de Programas\Microsoft Visual Studio 9.0\VC>]]></screen>
</listitem>
<listitem>
<simpara>
Entre no diretório <filename>C:\work\php-5.2.5</filename>.
</simpara>
</listitem>
<listitem>
<simpara>
Execute <command>cscript /nologo win32\build\buildconf.js</command>.
</simpara>
</listitem>
<listitem>
<simpara>
Execute <command>cscript /nologo configure.js --disable-all --enable-cli
--enable-cgi --enable-object-out-dir=.. --disable-ipv6</command>. Para
habilitar depuração (debug), adicione <command>--enable-debug</command> no
final do comando.
</simpara>
</listitem>
<listitem>
<simpara>
Execute <command>nmake</command>.
</simpara>
</listitem>
<listitem>
<simpara>
Se tudo ocorreu bem, deverá existir um executável CLI do PHP em
<filename>C:\work\Debug_TS\php.exe</filename>, ou
<filename>C:\work\Release_TS\php.exe</filename>.
</simpara>
</listitem>
</orderedlist>
</sect2>
<sect2 xml:id="install.windows.building.environment">
<title>Ambiente de compilação</title>
<para>
Para compilar e montar o PHP, você precisa de um Microsoft Development Environment.
Os seguintes ambientes são suportados:
</para>
<itemizedlist>
<listitem>
<simpara>
Microsoft Visual C++ 6.0 (official)
</simpara>
</listitem>
<listitem>
<simpara>
Microsoft Visual C++ .NET
</simpara>
</listitem>
<listitem>
<simpara>
Microsoft Visual C++ 2005, Windows Platform SDK e .NET Framework SDK (atual)
</simpara>
</listitem>
</itemizedlist>
<para>
Embora VC6 (Microsoft Visual C++ 6.0) seja usado para executar oficiais compilações
do Windows, ele não pode ser obtido do site da Microsoft. Novos usuários
procurando compilar o PHP precisa usar Microsoft Visual C++ 2005 Express
Edition e seus componentes auxiliares.
</para>
<sect3 xml:id="install.windows.building.environment.express2005">
<title>Configurando o Microsoft Visual C++ 2005 Express</title>
<note>
<simpara>
Combinado, estes componentes são muito extenso e requisitará um
gigabyte de espaço de disco.
</simpara>
</note>
<para>
Configurando o Microsoft Visual C++ 2005 Express é melhor contido,
e requer a instalação de três pacotes separados e várias mudanças de
compatibilidades. Mantenha uma lista de caminhos no qual
estes programas estão sendo instalados. Faça download e instale
os seguintes programas:
</para>
<itemizedlist>
<listitem>
<simpara>
<link xlink:href="&url.win32.msvc2005express;">Microsoft Visual C++ 2005 Express</link>
</simpara>
</listitem>
<listitem>
<simpara>
<link xlink:href="&url.win32.platform-sdk;">Microsoft Windows Server 2005 Platform SDK</link>
</simpara>
</listitem>
<listitem>
<simpara>
<link xlink:href="&url.win32.net2.0-sdk;">.NET Framework 2.0 Software Development Kit</link>
</simpara>
</listitem>
</itemizedlist>
<para>
Há vários passos pós-instalação:
</para>
<itemizedlist>
<listitem>
<simpara>
<link xlink:href="&url.win32.express-and-sdk;">MSVC 2005 Express precisa
ser configurado para usar Windows Platform SDK</link>. Ele não é necessário
para executar o segundo passo, como PHP não usa interface gráfica de usuário.
</simpara>
</listitem>
<listitem>
<simpara>
Windows Platform SDK contém um arquivo chamado <filename>WinResrc.h</filename>
normalmente na pasta <filename>Include</filename> dentro do diretório de
instalação do SDK. Este necessita ser copiado e renomeado para
<filename>winres.h</filename>, o nome que o PHP usa para o arquivo.
</simpara>
</listitem>
</itemizedlist>
<para>
Finalmente, quando usando MSVC 2005 Express na linha de comando, várias
variáveis de ambiente precisam ser definidas. <filename>vsvars32.bat</filename>
normalmente encontradas em <filename>C:\Program Files\Microsoft Visual Studio 8\Common7\Tools</filename>
(pesquise pelo arquivo caso contrário) contém estas declarações. As variáveis
de ambiente <varname>PATH</varname>, <varname>INCLUDE</varname> e <varname>LIB</varname>
precisam corresponder aos diretórios <filename>bin</filename>, <filename>include</filename> e
<filename>lib</filename> dos dois recentes instalados SDK adicionado para eles.
</para>
<note>
<simpara>
O caminho do .NET SDK pode já estar presente no arquivo <filename>vsvars32.bat</filename>,
como esta instalação do próprio SDK no mesmo diretório que o Microsoft Visual C++ 2005 Express.
</simpara>
</note>
</sect3>
</sect2>
<sect2 xml:id="install.windows.building.libraries">
<title>Bibliotecas</title>
<para>
Para extrair os arquivos baixados, você precisará de uma ferramenta que descompacte
arquivos ZIP. O Windows XP e os mais novos já incluem essa funcionalidade embutida.
</para>
<para>
Antes de você começar, você tem que baixar:
</para>
<itemizedlist>
<listitem>
<simpara>
win32 buildtools do site do PHP
em <link xlink:href="&url.win32.buildtools;">&url.win32.buildtools;</link>.
</simpara>
</listitem>
<listitem>
<simpara>
o código-fonte para o DNS name resolver usado pelo PHP em
<link xlink:href="&url.win32.dnsresolver;">&url.win32.dnsresolver;</link>.
Esse é um substituto para a biblioteca <filename>resolv.lib</filename>
inclusa no arquivo <filename> win32build.zip</filename>.
</simpara>
</listitem>
<listitem>
<simpara>
Se você planeja compilar o PHP como um módulo do Apache você também precisará dos
<link xlink:href="&url.apache.source;">fontes do Apache</link>.
</simpara>
</listitem>
</itemizedlist>
<simpara>
Finalmente, você precisará dos fontes do PHP. Você pode pegar a
verão mais recente de desenvolvimento usando <link xlink:href="&url.php.anoncvs;">
login anônimo ao CVS</link>, um <link xlink:href="&url.php.snapshots;">
snapshot</link> ou o release mais novo dos <link xlink:href="&url.php.downloads;">
fontes</link>.
</simpara>
</sect2>
<sect2 xml:id="install.windows.building.install">
<title>Juntanto tudo</title>
<para>
Depois de baixar os pacotes necessários, você tem que extrair eles em
um lugar apropriado.
<itemizedlist>
<listitem>
<simpara>
Crie um diretório de trabalho onde todos os arquivos serão extraídos, ex.:
<filename class="directory">C:\work</filename>.
</simpara>
</listitem>
<listitem>
<simpara>
Crie o diretório <filename>win32build</filename> nesse
diretório de trabalho (<filename class="directory">C:\work</filename>) e descompate o arquivo <filename>
win32build.zip</filename> nele.
</simpara>
</listitem>
<listitem>
<simpara>
Crie o diretório <filename>bindlib_w32</filename> nesse
diretório de trabalho (<filename class="directory">C:\work</filename>) e descompate o arquivo <filename>
bindlib_w32.zip</filename> nele.
</simpara>
</listitem>
<listitem>
<simpara>
Extraia o código fonte do PHP no diretório de trabalho
(<filename class="directory">C:\work</filename>).
</simpara>
</listitem>
<listitem>
<simpara>
Compile as biblioteca que você precisará (ou baixe os binários se
estiverem disponíveis) e coloque os cabeçalhos e bibliotecas no diretório <filename
class="directory">C:\work\win32build\include</filename> e <filename
class="directory">C:\work\win32build\lib</filename>,
respectivamente.
</simpara>
</listitem>
<listitem>
<simpara>
Se você não tem o cygwin instalado com o bison e flex, você precisará também
fazer o diretório <filename class="directory">C:\work\win32build\bin</filename>
disponível no PATH, assim estas ferramentas podem ser encontradas
pelo script configure.
</simpara>
</listitem>
</itemizedlist>
Seguindo esses passos a sua estrutura de diretório parecerá com isso:
<screen>
<![CDATA[
+--C:\work
| |
| +--bindlib_w32
| | |
| | +--arpa
| | |
| | +--conf
| | |
| | +--...
| |
| +--php-5.x.x
| | |
| | +--build
| | |
| | +--...
| | |
| | +--win32
| | |
| | +--...
| |
| +--win32build
| | |
| | +--bin
| | |
| | +--include
| | |
| | +--lib
]]>
</screen>
</para>
<para>
Se você não estiver usando o <link xlink:href="&url.cygwin;">Cygwin</link>, você também deve
criar os diretórios <filename
class="directory">C:\usr\local\lib</filename> e então copie o arquivo
<filename>bison.simple</filename> de <filename
class="directory">C:\work\win32build\bin </filename> para <filename
class="directory">C:\usr\local\lib</filename>.
</para>
<note>
<simpara>
Se você quiser usar o PEAR e o conviniente instalador em linha de comando, o
CLI-SAPI é necessário. Para mais informação sobre PEAR e o instalador
leia a documentação no web site do <link
xlink:href="&url.php.pear.manual;">PEAR</link>.
</simpara>
</note>
</sect2>
<sect2 xml:id="install.windows.building.resolvlib">
<title>Compilando resolv.lib</title>
<para>
Você deve compilar a biblioteca <filename>resolv.lib</filename>. Decida se você
quer ter símbolos de depuração disponíveis (bindlib - Win32 Debug) ou não
(bindlib - Win32 Release), mas por favor, lembre-se da escolha que você fará, por
que a biblioteca com os símbolos só montará com o PHP se o mesmo for montado em modo
de depuração. Monte a configuração apropriada:
<itemizedlist>
<listitem>
<simpara>
Para usuários de GUI, execute VC++, clicando duas-vezes em
<filename>C:\work\bindlib_w32\bindlib.dsw</filename>. Então selecione
Build=&gt;Rebuild All.
</simpara>
</listitem>
<listitem>
<simpara>
Para usuários de linha de comando, assegure-se que as variáveis de ambiente
do C++ estão registradas, ou execute
<command>vcvars.bat</command>, e então execute um dos seguintes
comandos:
</simpara>
<itemizedlist>
<listitem>
<simpara>
<command>msdev bindlib.dsp /MAKE "bindlib - Win32 Debug"</command>
</simpara>
</listitem>
<listitem>
<simpara>
<command>msdev bindlib.dsp /MAKE "bindlib - Win32 Release"</command>
</simpara>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
Nesse ponto, você deve ter uma <filename>resolv.lib</filename> utilizável ou
nos sub-diretórios <filename
class="directory">C:\work\bindlib_w32\Debug</filename> ou
<filename>Release</filename>. Copie esse arquivo para o diretório
<filename class="directory">C:\work\win32build\lib</filename>,
sobrescrevendo o arquivo de mesmo nome nesse diretório.
</para>
</sect2>
<sect2 xml:id="install.windows.building.new">
<title>Montando o PHP usando no novo sistema de montagem [Apenas PHP &gt;=5]</title>
<para>
Esse capítulo explica como compilar o PHP &gt;=5 usando o novo sistema de montagem,
que é baseado em CLI e muito similar com o sistema de montagem principal do PHP no Unix.
</para>
<note>
<para>
Esse sistema de montagem não está disponível no PHP 4. Favor, ler <xref
linkend="install.windows.building.dsw"/> se for o seu caso.
</para>
</note>
<para>
Antes de começar, assegure-se de let <xref linkend="install.windows.building.install"/>
e que você compilou todas as bibliotecas
necessárias, como <link xlink:href="&url.libxml;">Libxml</link> ou <link
xlink:href="&url.icu;">ICU</link> (necessária para o PHP &gt;= 6).
</para>
<para>
Primeiro, você deve abrir um Prompt de Comando do Visual Strudio, que pode estar
disponível no Menu Iniciar (Start Menu). Um Prompt de Comando comum não
deve funcionar, uma vez que provavelmente as variáveis de ambiente necessárias
não estão configuradas. Então digite algo como <command>cd C:\work\php-5.x.x</command>
para entrar no diretório dos fontes do PHP. Agora se prepare para começar a configurar o PHP.
</para>
<para>
O segundo passo é executar o arquivo de lote <command>buildconf</command>
para criar o script configure, procurando o diretório por
arquivos <filename>config.w32</filename>. Via de regra, esse comando também
procurará nos seguintes diretórios: <filename class="directory">pecl;
..\pecl; pecl\rpc; ..\pecl\rpc</filename>. A partir do PHP 5.1.0, vodê pode alterar
esse comportamento usando o argumento <literal>--add-modules-dir</literal>
(ex.: <command>cscript /nologo win32/build/buildconf.js
--add-modules-dir=../php-gtk2 --add-modules-dir=../pecl</command>).
</para>
<para>
O terceiro passo é configurar. Para ver a lista de opções de configuração
disponíveis, digite <command>cscript /nologo configure.js
--help</command>. Depois de escolher as opções que você irá habilitar/desabilitar,
digite algo como <command>cscript /nologo configure.js --disable-foo
--enable-fun-ext</command>. Usar <literal>--enable-foo=shared</literal>
tentará construir a extensão 'foo' como um módulo compartilhado, carregado
dinâmicamente.
</para>
<para>
O último passo é compilar. Para isso, basta executar o comandocommand
<command>nmake</command>. Os arquivos gerados (e.g. .exe e .dll) serão
colocado ou nos diretórios <filename class="directory">Release_TS</filename> our
<filename class="directory">Debug_TS</filename> (se compilado com
Thread safety), ou no diretórios <filename class="directory">Release</filename> ou
<filename class="directory">Debug</filename> caso contrário.
</para>
<para>
É opcional, mas você também pode executar os aplicativos de teste do PHP, executando
<command>nmake test</command>. Se você quiser rodar apenas um teste específico, você
pode user a variável 'TESTS' (ex.: <command>nmake /D TESTS=ext/sqlite/tests
test</command> - só executará testes no sqlite). Para apagar esses arquivos que
foram criados durante a compilação, você pode usar o comando <command>nmake
clean</command>.
</para>
<para>
Uma opção de configuração muito útil para montar snapshots é
<literal>--enable-snapshot-build</literal>, que adiciona un novo modo de compilação
(<command>nmake build-snap</command>). Isso tenta montar cada extensão
disponível (como compartilhada, por padrão), mas ignorará erros de montagem em
extensões individuais ou SAPI.
</para>
</sect2>
<sect2 xml:id="install.windows.building.dsw">
<title>Building PHP using DSW files [PHP 4]</title>
<para>
Compilar o PHP usando os arquivos DSW não é suportado a partir do PHP5, já que um
<link linkend="install.windows.building.new">sistema mais flexível está
disponível</link>. De qualquer forma, você ainda pode usá-los, mas tenha em mente que
ele não são testados freqüentemente, então você pode ter problemas de compilação. Para
compilar o PHP 4 para Windows, no entanto, essa é a única opção disponível.
</para>
<sect3 xml:id="install.windows.building.dsw.configure">
<title>Configure MVC ++</title>
<para>
O próximo passo é configurar o MVC ++ para prepará-lo para compilar.
Rode o Microsoft Visual C++, e do menu selecione
Tools =&gt; Options. No diálogo que aparecerá, selecione o
tab de diretórios. Depois, mude o dropdown
para arquivos Executables, Includes, e Library. Suas configurações devem parecer
com isso:
<itemizedlist>
<listitem>
<simpara>
Arquivos executáveis: <filename
class="directory">C:\work\win32build\bin</filename>, Usuários do Cygwin:
<filename>C:\cygwin\bin</filename>
</simpara>
</listitem>
<listitem>
<simpara>
Arquivos inclusos: <filename
class="directory">C:\work\win32build\include</filename>
</simpara>
</listitem>
<listitem>
<simpara>
Arquivos de Bibliotecas: <filename
class="directory">C:\work\win32build\lib</filename>
</simpara>
</listitem>
</itemizedlist>
</para>
</sect3>
<sect3 xml:id="install.windows.building.dsw.compile">
<title>Compilando</title>
<simpara>
A melhor maneira de começar é compilando a versão CGI:
</simpara>
<itemizedlist>
<listitem>
<simpara>
Para usuários de GUI, execute VC++, e selecione File =&gt; Open Workspace
e selecione <filename>c:\work\php-4.x.x\win32\php4ts.dsw</filename>.
Depois vá em Build=&gt;Set Active Configuration e selecione a configuração
desejada, ou <literal>php4ts - Win32 Debug_TS</literal> ou
<literal>php4ts - Win32 Release_TS</literal>. Finalmente, selecione
Build=&gt;Rebuild All.
</simpara>
</listitem>
<listitem>
<simpara>
Para usuários de linha de comenado, assegure-se que você ou
registrou as variáveis de ambiente do C++, ou executou
<command>vcvars.bat</command>, e então execute um dos
seguintes comando no diretório
<filename class="directory">c:\work\php-4.x.x\win32</filename>:
</simpara>
<itemizedlist>
<listitem>
<simpara>
<command>msdev php4ts.dsp /MAKE "php4ts - Win32 Debug_TS"</command>
</simpara>
</listitem>
<listitem>
<simpara>
<command>msdev php4ts.dsp /MAKE "php4ts - Win32 Release_TS"</command>
</simpara>
</listitem>
<listitem>
<simpara>
Nesse ponto, você deve ter um arquivo <filename>php.exe</filename> usável
ou no subdiretório <filename
class="directory">c:\work\php-4.x.x.\Debug_TS</filename> ou em
<filename>Release_TS</filename>.
</simpara>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
<simpara>
É possível fazer algumas personalizações mínimas para o processo de compilação editando
o arquivo <filename>main/config.win32.h</filename>. Por exemplo, você pode
muda a localização padrão do arquivo &php.ini;, as extensões integradas, e a
localização padrão para suas extensões.
</simpara>
<simpara>
Depois, você pode querer montar a versão CLI que é feita para usar o
<link linkend="features.commandline">PHP da linha de comando</link>.
Os passos são o mesmos para compilar a versão CGI, exceto que você tem que
selecionar o arquivo de projeto <literal>php4ts_cli - Win32 Debug_TS</literal> ou
<literal>php4ts_cli - Win32 Release_TS</literal>. Depois de uma compilação
sucedida você encontrará o arquivo <filename>php.exe</filename>
ou no diretório <filename class="directory">Release_TS\cli\</filename> ou
<filename class="directory">Debug_TS\cli\</filename>.
</simpara>
<simpara>
Para montar o módulo SAPI (<filename>php4isapi.dll</filename>)
para integrar o PHP com o Microsoft IIS, modifique o seu arquivo de configuração
para <filename>php4isapi-whatever-config</filename> e construa a dll desejada.
</simpara>
</sect3>
</sect2>
<para>
Veja a documentação no Wiki em:
<link xlink:href="&url.wiki.windows.build.howto;">&url.wiki.windows.build.howto;</link>
</para>
</sect1>
<!-- Keep this comment at the end of the file

13
install/windows/index.xml
View File

@@ -1,12 +1,11 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: thiago Status: ready -->
<!-- EN-Revision: 61426b8b2187711b721603805bcdef6a8923db31 Maintainer: thiago Status: ready -->
<chapter xml:id="install.windows" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Instalação em sistemas Windows</title>
<para>
Essa seção aplica-se ao Windows 98/Me e Windows NT/2000/XP/2003. O PHP
não funcionará em plataformas 16 bit como o Windows 3.1 e algumas vezes
nos referimos às plataformas Windows suportadas como Win32. Windows 95
não é mais suportado a partir do PHP 4.3.0.
nos referimos às plataformas Windows suportadas como Win32.
</para>
<note>
<para>
@@ -24,8 +23,8 @@
ou usando o <link linkend="install.windows.installer">instalador</link>.
</para>
<para>
Se você tiver o Microsoft Visual Studio, você pode também
<link linkend="install.windows.building">compilar</link>
Se você tiver um ambiente de desenvolvimento como o Microsoft Visual Studio,
você pode também <link linkend="install.windows.building">compilar</link>
o PHP a partir do código-fonte original.
</para>
<para>
@@ -37,7 +36,7 @@
<para>
Existem vários instaladores completos na Internet, mas nenhum deles
é apoioado pelo PHP.net, nós acreditamos que usando um dos pacotes
oficial para Windows de <link xlink:href="&url.php.downloads;">&url.php.downloads;</link>
oficial para Windows em <link xlink:href="&url.php.downloads;">&url.php.downloads;</link>
seja a melhor maneira de ter seu sistema seguro e otimizado.
</para>
</warning>
@@ -45,14 +44,12 @@
&install.windows.installer;
&install.windows.installermsi;
&install.windows.manual;
&install.windows.activescript;
&install.windows.iis;
&install.windows.iis6;
&install.windows.iis7;
&install.windows.apache1;
&install.windows.apache2;
&install.windows.sun;
&install.windows.omnihttpd;
&install.windows.sambar;
&install.windows.xitami;
&install.windows.building;

29
language-defs.ent
View File

@@ -1,4 +1,5 @@
<!-- EN-Revision: 40884bbb4001a9b4add321fd34adc59dcad4e4a2 Maintainer: felipe Status: ready --><!-- CREDITS: ae -->
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: d07d738896974299a078d3295c7d9d950d07e10a Maintainer: thiago Status: ready -->
<!ENTITY PHPManual "Manual do PHP">
<!ENTITY Seealso "Veja também">
@@ -14,7 +15,7 @@
<!ENTITY TextProcessing "Processamento de Texto">
<!ENTITY AffectingPHPsBehaviour "Afetando o comportamento do PHP">
<!ENTITY SessionExtensions "Extensões de Sessão">
<!ENTITY OtherBasicExtensions "Outras Básicas Extensões">
<!ENTITY OtherBasicExtensions "Outras Extensões Básicas">
<!ENTITY DatabaseExtensions "Extensões de Banco de Dados">
<!ENTITY AbstractionLayers "Camadas de Abstração">
<!ENTITY VendorSpecificDatabaseExtensions "Vendor Specific Database Extensions">
@@ -29,10 +30,10 @@
<!ENTITY MailRelatedExtensions "Extensões Relacionadas a Mail">
<!ENTITY AuthenticationServices "Serviços de Autenticação">
<!ENTITY OtherServices "Outros Serviços">
<!ENTITY CompressionExtensions "Extensões de Compressão e Arquivo">
<!ENTITY CalendarandEventRelatedExtensions "Extensões Relacionadas a Calendário e Evento">
<!ENTITY CompressionExtensions "Extensões de Arquivo e Compressão">
<!ENTITY CalendarandEventRelatedExtensions "Extensões Relacionadas a Data e Hora">
<!ENTITY NonTextMIMEOutput "Saída de MIME Não-Texto">
<!ENTITY ImageProcessingandGeneration "Processamento de Imagem e Geração">
<!ENTITY ImageProcessingandGeneration "Processamento e Geração de Imagem">
<!ENTITY AudioFormatsManipulation "Manipulação de Formatos de Audio">
<!ENTITY CommandLineSpecificExtensions "Extensões Específica para Linha de Comando">
<!ENTITY WindowsOnlyExtensions "Extensões Somente para Windows">
@@ -41,11 +42,16 @@
<!ENTITY MiscExtensions "Extensões Miscelâneas">
<!ENTITY Appendices "Apêndices">
<!ENTITY PEAR "PEAR: Repositório de Programas e Extensões do PHP">
<!ENTITY FAQ "FAQ: Perguntas Mais Freqüentes">
<!ENTITY FAQ "FAQ: Perguntas Mais Frequentes">
<!ENTITY FAQabbrev "FAQ">
<!ENTITY Internals "PHP e Zend Engine Internamente">
<!ENTITY Internals2 "PHP no Núcleo: Um guia do Hacker para a Zend Engine">
<!ENTITY ZendAPI "Zend API: Hackeando o Núcleo do PHP">
<!ENTITY FunctionIndex "Índice de funções">
<!ENTITY IndexListing "Lista de índices">
<!ENTITY FunctionListing "Lista de Funções e Métodos">
<!ENTITY FunctionListingDescription "Lista de todas as funções e métodos no manual">
<!ENTITY ExampleListing "Lista de exemplos">
<!ENTITY ExampleListingDescription "Lista de todos os exemplos no manual">
<!ENTITY CHMEdition "HTML Help Edition">
<!ENTITY ReservedConstants "Constantes Pré-definidas">
<!ENTITY MissingStuff "(Identificadores não encontrados na compilação do manual)">
@@ -61,6 +67,12 @@
<!ENTITY Alias "Sinônimo de">
<!ENTITY Type "Tipo">
<!ENTITY Changelog "Histórico">
<!ENTITY Methods "Métodos">
<!ENTITY InheritedMethods "Métodos herdados">
<!ENTITY InheritedProperties "Propriedades herdadas">
<!ENTITY Properties "Propriedades">
<!ENTITY Constants "Constantes">
<!ENTITY NotAvailable "Não Disponível">
<!-- These are used in reference/$extname/reference.xml and other
supplemental files to mark section titles -->
@@ -70,7 +82,7 @@ supplemental files to mark section titles -->
<!ENTITY reftitle.constants '<title xmlns="http://docbook.org/ns/docbook">Constantes pré-definidas</title>'>
<!ENTITY reftitle.constructor '<title xmlns="http://docbook.org/ns/docbook">Construtor</title>'>
<!ENTITY reftitle.description '<title xmlns="http://docbook.org/ns/docbook">Descrição</title>'>
<!ENTITY reftitle.encoding '<title xmlns="http://docbook.org/ns/docbook">Codificação</title>'>
<!ENTITY reftitle.encoding '<title xmlns="http://docbook.org/ns/docbook">Codificação</title>'>
<!ENTITY reftitle.examples '<title xmlns="http://docbook.org/ns/docbook">Exemplos</title>'>
<!ENTITY reftitle.exceptions '<title xmlns="http://docbook.org/ns/docbook">Exceções</title>'>
<!ENTITY reftitle.errors '<title xmlns="http://docbook.org/ns/docbook">Erros</title>'>
@@ -80,6 +92,7 @@ supplemental files to mark section titles -->
<!ENTITY reftitle.indices '<title xmlns="http://docbook.org/ns/docbook">Índices</title>'>
<!ENTITY reftitle.interfacesynopsis '<title xmlns="http://docbook.org/ns/docbook">Resumo da Interface</title>'>
<!ENTITY reftitle.methods '<title xmlns="http://docbook.org/ns/docbook">Métodos</title>'>
<!ENTITY reftitle.mysqlnd '<title xmlns="http://docbook.org/ns/docbook">Somente Driver Nativo MySQL</title>'>
<!ENTITY reftitle.notes '<title xmlns="http://docbook.org/ns/docbook">Notas</title>'>
<!ENTITY reftitle.parameters '<title xmlns="http://docbook.org/ns/docbook">Parâmetros</title>'>
<!ENTITY reftitle.options '<title xmlns="http://docbook.org/ns/docbook">Opções</title>'>

105
language/constants.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: n/a Maintainer: felipe Status: ready --><!-- CREDITS: ae -->
<!-- EN-Revision: 48573a3b164e53168cbc2acff2c714811ec6387c Maintainer: felipe Status: ready --><!-- CREDITS: ae, thiago -->
<chapter xml:id="language.constants" xmlns="http://docbook.org/ns/docbook">
<title>Constantes</title>
@@ -8,7 +8,7 @@
sugere, esse valor não pode mudar durante a execução do
script (exceção às <link linkend="language.constants.predefined">
constantes mágicas</link>, que não são constantes de verdade).
As constantes são sensíveis ao caso por padrão. Por convenção,
As constantes são "Case Sensitive" (Sensível ao tamanho de letras) por padrão. Por convenção,
o nomes de constantes são sempre em maiúsculas.
</simpara>
<para>
@@ -46,35 +46,37 @@ define("__FOO__", "alguma coisa");
</para>
<note>
<simpara>
Para nossos exemplos, as letras a-z, A-Z e os caracteres ASCII
Para nossos exemplos, uma letra é a-z, A-Z e os caracteres ASCII
do 127 ao 255 (0x7f-0xff).
</simpara>
</note>
<simpara>
Como as &link.superglobals;, o escopo de uma constante é global. Você
pode acessar constantes de qualquer lugar em seu script sem se preocupar com o escopo.
Para mais informações sobre o escopo no PHP, leia a seção do manual
<link linkend="language.variables.scope">escopo de variáveis</link>.
pode acessar constantes de qualquer lugar em seu script sem se preocupar
com o escopo. Para mais informações sobre o escopo no PHP, leia a seção
do manual <link linkend="language.variables.scope">escopo de variáveis</link>.
</simpara>
<sect1 xml:id="language.constants.syntax">
<title>Sintaxe</title>
<simpara>
Você pode definir uma constante utilizando-se da função
<function>define</function>. Quando uma constante é definida,
ela não pode ser mais modificada ou anulada.
<function>define</function>, ou utilizando a palavra-chave <literal>const</literal>
fora da definição de uma classe a partir dor PHP 5.3.0. Quando uma constante
é definida, ela nunca mais poderá ser modificada ou anulada.
</simpara>
<simpara>
Somente dados escalares (<type>boolean</type>, <type>integer</type>,
<type>float</type> e <type>string</type>) pode ser colocados
em constantes.
Não defina constantes do tipo <type>resource</type> (recurso).
<type>float</type> e <type>string</type>) podem ser colocados
em constantes. É possível ter consntantes com um <type>resource</type>
(recurso), mas deve ser evitado já que pode causar resultados não
esperados.
</simpara>
<simpara>
Você pode obter o valor de uma constante simplesmente especificando seu nome.
Diferentemente de variáveis, você <emphasis>não</emphasis> pode prefixar
uma constante com um sinal de <literal>$</literal>.
Diferentemente de variáveis, você <emphasis>não</emphasis> prefixa uma
constante com um sinal de <literal>$</literal>.
Você também pode utilizar a função <function>constant</function> para
ler o valor de uma constante, se você precisar obter seu valor
dinamicamente.
@@ -96,8 +98,9 @@ define("__FOO__", "alguma coisa");
quando isso acontecer. Veja também a referência do manual sobre como
<link linkend="language.types.array.foo-bar">$foo[bar]</link> é
errado (a não ser que você primeiro <function>define</function>
<literal>bar</literal> como uma constante). Se você simplesmente quer checar se uma
constante foi definida, utilize a função <function>defined</function>.
<literal>bar</literal> como uma constante). Se você simplesmente quer
checar se uma constante foi definida, utilize a função
<function>defined</function>.
</simpara>
<para>
Estas são as diferenças entre constantes e variáveis:
@@ -128,7 +131,7 @@ define("__FOO__", "alguma coisa");
</listitem>
<listitem>
<simpara>
Constantes só podem conter valores escalares.
Constantes só devem conter valores escalares.
</simpara>
</listitem>
</itemizedlist>
@@ -147,9 +150,34 @@ echo Constant; // imprime "Constant" e gera um alerta notice.
]]>
</programlisting>
</example>
</para>
<para>
<example>
<title>Definindo Constantes usando a palavra-chave <literal>const</literal></title>
<programlisting role="php">
<![CDATA[
<?php
// Funciona a partir do PHP 5.3.0
const CONSTANT = 'Hello World';
echo CONSTANT;
?>
]]>
</programlisting>
</example>
</para>
<note>
<para>
Ao contrário das funções definidas através de <function>define</function>,
as constantes definidas usando a palavra-chave <literal>const</literal>
devem ser declarados no escopo de topo (principal) pois são definidas no
tempo de compilação. Isso significa que elas não podem ser definidas
dentro de funções, laços ou <literal>if</literal>s.
</para>
</note>
<simpara>
Veja também <link linkend="language.oop5.constants">Constantes de Classe</link>.
</simpara>
@@ -160,11 +188,11 @@ echo Constant; // imprime "Constant" e gera um alerta notice.
<simpara>
O PHP fornece um grande número de <link
linkend="reserved.constants">predefined constants</link> para qualquer script
que ele execute. A maioria dessas constantes, entretanto, são criadas por
várias extensões, e somente estarão presentes quando essas extensões
estiverem disponíveis, por carregamento dinâmico ou por compilação
direta.
linkend="reserved.constants">consntantes predefinidas</link> para qualquer
script que ele execute. A maioria dessas constantes, entretanto, são
criadas por várias extensões, e somente estarão presentes quando essas
extensões estiverem disponíveis, tanto por carregamento dinâmico quanto por
compilação direta.
</simpara>
<para>
@@ -172,7 +200,7 @@ echo Constant; // imprime "Constant" e gera um alerta notice.
onde elas são utilizadas. Por exemplo, o valor de
<constant>__LINE__</constant> depende do número da linha em que é
utilizada em seu script. Essas constantes especiais são
insensíveis ao caso:
insensíveis a maiúsculas e minúsculas (case insensitive):
</para>
<para>
<table>
@@ -214,31 +242,44 @@ echo Constant; // imprime "Constant" e gera um alerta notice.
<row>
<entry><constant>__FUNCTION__</constant></entry>
<entry>
O nome da função (Acrescentado no PHP 4.3.0). A partir do PHP 5 esta constante
retorna o nome da função como ela foi declarada (sensível a maiúsculas e minúsculas). No
PHP 4 sempre retorna o nome em minúsculas.
O nome da função (Acrescentado no PHP 4.3.0). A partir do PHP 5 esta
constante retorna o nome da função como ela foi declarada (sensível a
maiúsculas e minúsculas). No PHP 4 sempre retorna o nome em minúsculas.
</entry>
</row>
<row>
<entry><constant>__CLASS__</constant></entry>
<entry>
O nome da classe (Acrescentado no PHP 4.3.0). A partir do PHP 5 esta constante
retorna o nome da função como ela foi declarada (sensível a maiúsculas e minúsculas). No
PHP 4 sempre retorna o nome em minúsculas.
O nome da classe (Adicionado no PHP 4.3.0). A partir do PHP 5 esta
constante retorna o nome da função como ela foi declarada (sensível a
maiúsculas e minúsculas). No PHP 4 sempre retorna o nome em minúsculas.
O nome da classe inclui o namespace em que foi declarado (ex:
<literal>Foo\Bar</literal>). Note que a partir do PHP 5.4, __CLASS__
funciona também em traits. Quando utilizada em um método trait, __CLASS__ é
o nome da classe do trait em que foi utilizada.
</entry>
</row>
<row>
<entry><constant>__TRAIT__</constant></entry>
<entry>
O nome do trait. (Adicionado no PHP 5.4.0) A partir do PHP 5.4 essa
constante retorna o trait em que fo delcarado (sensível a maiúsculas e
minúsculas). O nome do trait incluir o namespace em que foi declarado
(ex: <literal>Foo\Bar</literal>).
</entry>
</row>
<row>
<entry><constant>__METHOD__</constant></entry>
<entry>
O nome do método de classe. (Acrescentado no PHP 5.0.0). O nome do método é
O nome do método de classe. (Adicionado no PHP 5.0.0). O nome do método é
retornado como foi declarado (sensível a maiúsculas e minúsculas).
</entry>
</row>
<row>
<entry><constant>__NAMESPACE__</constant></entry>
<entry>
O nome do atual namespace (sensível a maiúsculas e minúsculas). Esta constante
é definida em tempo de compilação (Adicionada no PHP 5.3.0).
O nome do namespace atual (sensível a maiúsculas e minúsculas). Esta
constante é definida em tempo de compilação (Adicionada no PHP 5.3.0).
</entry>
</row>
</tbody>

6
reference/ftp/functions/ftp-set-option.xml
View File

@@ -43,8 +43,8 @@
<entry><constant>FTP_TIMEOUT_SEC</constant></entry>
<entry>
Muda o limite de tempo em segundos usado para todas as operações
de rede relacionadas. <parameter>value</parameter> deve ser um inteiro que
seja maior do que 0. O limite de tempo padrão é 90 segundos.
de rede relacionadas. <parameter>value</parameter> deve ser um inteiro que
seja maior do que 0. O limite de tempo padrão é 90 segundos.
</entry>
</row>
<row>
@@ -53,7 +53,7 @@
Quando ativado, requisições GET ou PUT com um parâmetro
<parameter>resumepos</parameter> ou <parameter>startpos</parameter>
irá primeiro procurar a posição especificada no arquivo.
Isto esta ativado por padrâo.
Isto esta ativado por padrâo.
</entry>
</row>
</tbody>

12
reference/xml/functions/xml-parser-get-option.xml
View File

@@ -6,7 +6,7 @@
<refname>xml_parser_get_option</refname>
<refpurpose>Obtém as opções de um analisador (parser) XML</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
@@ -18,7 +18,7 @@
Obtém um valor de opção de um analisador XML.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
@@ -34,7 +34,7 @@
<varlistentry>
<term><parameter>option</parameter></term>
<listitem>
<simpara>
<simpara>
Qual opção buscar. <constant>XML_OPTION_CASE_FOLDING</constant>
e <constant>XML_OPTION_TARGET_ENCODING</constant> estão disponíveis.
Veja <function>xml_parser_set_option</function> para suas descrições.
@@ -44,17 +44,17 @@
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Esta função retorna &false; se o <parameter>parser</parameter> não se
referir a um analisador válido ou se a <parameter>opção</parameter> não
é válida (gera também um <constant>E_WARNING</constant>).
Senão o valor da opção é retornado.
Senão o valor da opção é retornado.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

10
reference/xml/functions/xml-parser-set-option.xml
View File

@@ -15,10 +15,10 @@
<methodparam><type>mixed</type><parameter>value</parameter></methodparam>
</methodsynopsis>
<para>
Define uma opção em uma analisador (parser) XML.
Define uma opção em uma analisador (parser) XML.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
@@ -95,14 +95,14 @@
<term><parameter>value</parameter></term>
<listitem>
<para>
Novo valor da opção.
Novo valor da opção.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
@@ -111,7 +111,7 @@
Caso contrário, a opção esta definida e é retornado &true;.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

37
security/magicquotes.xml
View File

@@ -5,7 +5,7 @@
&warn.deprecated.feature-5-3-0.removed-6-0-0;
<para>
Magic Quotes é um processo de inserção automática de caracteres de escape (\)
em todos os dados indo para o script PHP. É preferível escrever código com
em todos os dados indo para o script <acronym>PHP</acronym>. É preferível escrever código com
essa opção desligada e adicionar esses caracteres manualmente quando necessário.
</para>
@@ -27,8 +27,8 @@
<link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link>
</simpara>
<simpara>
Afeta os dados de requisições HTTP GET, POST, e COOKIE). Não pode ser alterada
em tempo de execução e tem o valor padrão <emphasis>on</emphasis> no PHP.
Afeta os dados de requisições <acronym>HTTP</acronym> GET, POST, e COOKIE). Não pode ser alterada
em tempo de execução e tem o valor padrão <emphasis>on</emphasis> no <acronym>PHP</acronym>.
</simpara>
<simpara>
Veja também <function>get_magic_quotes_gpc</function>.
@@ -75,8 +75,8 @@
<listitem>
<simpara>
Não existe mais razão para usar magic quotes porque não
é mais uma parte suportada do PHP. Entretanto, existe e ajudou
alguns iniciante a contruir um código melhor(mais seguro).
é mais uma parte suportada do <acronym>PHP</acronym>. Entretanto, a função existe e ajuda
alguns iniciantes a contruir um código melhor(mais seguro).
Mas, ao lidar com código que utiliza este recurso
é melhor atualizar o código do que ativar magic quotes.
</simpara>
@@ -101,7 +101,6 @@
</simpara>
<simpara>
Presumir que ela está ligada, ou desligada, afeta portabilitade. Use
Assuming it to be on, or off, affects portability. Use
<function>get_magic_quotes_gpc</function> para verificar isso e codifique
de acordo com a situação.
</simpara>
@@ -188,24 +187,24 @@ php_flag magic_quotes_gpc Off
</para>
<para>
<example>
<title>Disabilitando magic quotes em tempo de execução</title>
<title>Desabilitando magic quotes em tempo de execução</title>
<programlisting role="php">
<![CDATA[
<?php
if (get_magic_quotes_gpc()) {
function stripslashes_deep($value)
{
$value = is_array($value) ?
array_map('stripslashes_deep', $value) :
stripslashes($value);
return $value;
$process = array(&$_GET, &$_POST, &$_COOKIE, &$_REQUEST);
while (list($key, $val) = each($process)) {
foreach ($val as $k => $v) {
unset($process[$key][$k]);
if (is_array($v)) {
$process[$key][stripslashes($k)] = $v;
$process[] = &$process[$key][stripslashes($k)];
} else {
$process[$key][stripslashes($k)] = stripslashes($v);
}
}
}
$_POST = array_map('stripslashes_deep', $_POST);
$_GET = array_map('stripslashes_deep', $_GET);
$_COOKIE = array_map('stripslashes_deep', $_COOKIE);
$_REQUEST = array_map('stripslashes_deep', $_REQUEST);
unset($process);
}
?>
]]>