reverting incorrect commit

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@99119 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
André Luis Ferreira da Silva Bacci 2002-10-10 05:01:31 +00:00
parent 319d2d89b2
commit 9067941231
3 changed files with 70 additions and 70 deletions

View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.31 Maintainer: ernani Status: ready -->
<!-- $Revision: 1.4 $ -->
<section id="zlib.constants">
&reftitle.constants;
&extension.constants;
@ -7,7 +7,7 @@
<varlistentry>
<term>
<constant>FORCE_GZIP</constant>
(<link linkend="language.types.integer">inteiro</link>)
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
@ -18,7 +18,7 @@
<varlistentry>
<term>
<constant>FORCE_DEFLATE</constant>
(<link linkend="language.types.integer">inteiro</link>)
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>

View file

@ -1,21 +1,21 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.11 Maintainer: ernani Status: ready -->
<!-- $Revision: 1.3 $ -->
<section id="zlib.configuration">
&reftitle.runtime;
&extension.runtime;
<para>
A extensão zlib oferece a opção de comprimir transparentemente
suas páginas em tempo real, se o navegador requisitante suportar isto.
Então existem três opções no <link
linkend="configuration.file">arquivo de configuração</link> &php.ini;.
The zlib extension offers the option to transparently compress
your pages on-the-fly, if the requesting browser supports
this. Therefore there are three options in the <link
linkend="configuration.file">configuration file</link> &php.ini;.
<table>
<title>Opções de Configuração da Zlib</title>
<title>Zlib Configuration Options</title>
<tgroup cols="3">
<thead>
<row>
<entry>Nome</entry>
<entry>Padrão</entry>
<entry>Modificável</entry>
<entry>Name</entry>
<entry>Default</entry>
<entry>Changeable</entry>
</row>
</thead>
<tbody>
@ -37,43 +37,43 @@
</tbody>
</tgroup>
</table>
Para maiores detalhes e definições das constantes PHP_INI_* veja a função
For further details and definition of the PHP_INI_* constants see
<function>ini_set</function>.
</para>
<para>
Aqui está uma breve explicação das diretrizes de configuração.
Here is a short explanation of the configuration directives.
<variablelist>
<varlistentry id="ini.zlib.output-compression">
<term>
<parameter>zlib.output_compression</parameter>
<type>booleano</type>/<type>inteiro</type>
<type>boolean</type>/<type>integer</type>
</term>
<listitem>
<para>
Serve para comprimir páginas de modo transparente. Se esta opção for
mudada para "On" no &php.ini; ou na configuração do Apache, as páginas serão
comprimidas se o navegador enviar um cabeçalho "Accept-Encoding: gzip" ou
"deflate". "Content-Encoding: gzip" (respectivamente
"deflate") e cabeçalhos "Vary: Accept-Encoding" serão adicionados para
a saida.
Whether to transparently compress pages. If this option is set
to "On" in &php.ini; or the Apache configuration, pages are
compressed if the browser sends an "Accept-Encoding: gzip" or
"deflate" header. "Content-Encoding: gzip" (respectively
"deflate") and "Vary: Accept-Encoding" headers are added to
the output.
</para>
<para>
Você pode usar a função <function>ini_set</function> para desabilitar isto em
seu script se os cabeçalhos ainda não foram enviados. Se você enviar um cabeçalho à saída
"Content-Type: image/" a compressão será desabilitada,
também (para corrigir um defeito do Netscape). Você pode reabilitar
isto, se você adicionar a função "ini_set('zlib.output_compression', 'On')"
depois da chamada do cabeçalho que que foi adicionado o content-type da imagem.
You can use <function>ini_set</function> to disable this in
your script if the headers aren't already sent. If you output
a "Content-Type: image/" header the compression is disabled,
too (in order to circumvent a Netscape bug). You can reenable
it, if you add "ini_set('zlib.output_compression', 'On')"
after the header call which added the image content-type.
</para>
<para>
Esta opção também aceita valores inteiros em vez de valores booleanos
"On"/"Off", usando isto você pode configurar o tamanho do buffer de saída
(o padrão é 4KB).
This option also accepts integer values instead of boolean
"On"/"Off", using this you can set the output buffer size
(default is 4KB).
</para>
<note>
<para>
<link linkend="ini.output-handler">output_handler</link> deve estar
vazio se a diretriz estiver configurada em 'On'! Em vez disto você deve usar zlib.output_handler.
<link linkend="ini.output-handler">output_handler</link> must be
empty if this is set 'On' ! Instead you must use zlib.output_handler.
</para>
</note>
</listitem>
@ -82,11 +82,11 @@
<varlistentry id="ini.zlib.output-compression-level">
<term>
<parameter>zlib.output_compression_level</parameter>
<type>inteiro</type>
<type>integer</type>
</term>
<listitem>
<para>
Nível de compressão usado para as saídas.
Compression level used for transparent output compression.
</para>
</listitem>
</varlistentry>
@ -98,9 +98,9 @@
</term>
<listitem>
<para>
Você não pode especificar tratamentos adicionais de saída se zlib.output_compression
for ativado. Esta configuração faz o mesmo que a <link linkend="ini.output-handler">
output_handler</link> mas em uma ordem diferente.
You cannot specify additional output handlers if zlib.output_compression
is activated here. This setting does the same as <link linkend="ini.output-handler">
output_handler</link> but in a different order.
</para>
</listitem>
</varlistentry>

View file

@ -1,36 +1,36 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.11 Maintainer: ernani Status: ready -->
<!-- $Revision: 1.10 $ -->
<reference id="ref.zlib">
<title>Funções de Compressão Zlib</title>
<title>Zlib Compression Functions</title>
<titleabbrev>Zlib</titleabbrev>
<partintro>
<section id="zlib.intro">
&reftitle.intro;
<para>
Este módulo lhe possibilita ler e gerar transparentemente
arquivos comprimidos do tipo gzip (.gz), através de muitas das
funções <link linkend="ref.filesystem">filesystem</link>
nas quais funcionam com arquivos gzip comprimidos (e arquivos não comprimidos
também, mas não com sockets).
This module enables you to transparently read and write
gzip (.gz) compressed files, through versions of most of
the <link linkend="ref.filesystem">filesystem</link> functions
which work with gzip-compressed files (and uncompressed files,
too, but not with sockets).
</para>
<note>
<para>
A Versão 4.0.4 introduziu a função fopen-wrapper para arquivos .gz, então
você pode usar o prefixo 'zlib:' especial para acessar arquivos comprimidos
transparentemente usando as funções normais de acesso a arquivos f*() se
você concatenar o nome do arquivo e ou seu caminho com o prefixo 'zlib:' quando usar a função
Version 4.0.4 introduced a fopen-wrapper for .gz-files, so that
you can use a special 'zlib:' URL to access compressed files
transparently using the normal f*() file access functions if you
prepend the filename or path with a 'zlib:' prefix when calling
<function>fopen</function>.
</para>
<para>
Na versão 4.3.0, este prefixo especial foi mudado para 'zlib://'
para previnir ambiguidades com nome de arquivos contendo ':'.
In version 4.3.0, this special prefix has been changed to 'zlib://'
to prevent ambiguities with filenames containing ':'.
</para>
<para>
Esta facilidade requer uma biblioteca em tempo de execução que provê a função
<literal>fopencookie()</literal>. Em meu conhecimento atual
a GNU libc é a única bliblioteca que provê
esta facilidade.
This feature requires a C runtime library that provides the
<literal>fopencookie()</literal> function. To my current
knowledge the GNU libc is the only library that provides
this feature.
</para>
</note>
</section>
@ -38,9 +38,9 @@
<section id="zlib.requirements">
&reftitle.required;
<para>
Este módulo usa as funções da <ulink url="&url.zlib;">zlib</ulink>
por Jean-loup Gailly e Mark Adler. Você terá que usar uma versão zlib
&gt;= à 1.0.9 com este módulo.
This module uses the functions of <ulink url="&url.zlib;">zlib</ulink>
by Jean-loup Gailly and Mark Adler. You have to use a zlib
version &gt;= 1.0.9 with this module.
</para>
</section>
@ -56,42 +56,42 @@
<section id="zlib.examples">
&reftitle.examples;
<para>
Este exemplo abre um arquivo temporário e gera uma string teste
dentro dele, então ela mostra o conteúdo deste arquivo duas vezes.
This example opens a temporary file and writes a test string
to it, then it prints out the content of this file twice.
</para>
<example>
<title>Pequeno Exemplo das funções Zlib</title>
<title>Small Zlib Example</title>
<programlisting role="php">
<![CDATA[
<?php
$filename = tempnam ('/tmp', 'zlibteste').'.gz';
$filename = tempnam ('/tmp', 'zlibtest').'.gz';
print "<html>\n<head></head>\n<body>\n<pre>\n";
$s = "Somente um teste, teste, teste, teste, teste, teste, teste, teste!\n";
$s = "Only a test, test, test, test, test, test, test, test!\n";
// abre o arquivo para gerar ele com a compressão máxima
// open file for writing with maximum compression
$zp = gzopen($filename, "w9");
// escreve a string no arquivo
// write string to file
gzwrite($zp, $s);
// fecha o arquivo
// close file
gzclose($zp);
// abre o arquivo para leitura
// open file for reading
$zp = gzopen($filename, "r");
// lê 3 caracteres
// read 3 char
print gzread($zp, 3);
// mostra o conteúdo até o fim do arquivo e o fecha.
// output until end of the file and close it.
gzpassthru($zp);
print "\n";
// abre o arquivo e imprime o conteúdo dele (pela segunda vez).
// open file and print content (the 2nd time).
if (readgzfile($filename) != strlen($s)) {
echo "Erro com as funções zlib!";
echo "Error with zlib functions!";
}
unlink($filename);
print "</pre>\n</h1></body>\n</html>\n";