-
Notifications
You must be signed in to change notification settings - Fork 8
/
gzencode.xml
143 lines (136 loc) · 4.31 KB
/
gzencode.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 3e15d2894fb35432d2a111db36fe8ba8ebc62024 Maintainer: pastore Status: ready -->
<!-- CREDITS: cucinato -->
<refentry xml:id="function.gzencode" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>gzencode</refname>
<refpurpose>Crea una stringa compressa con gzip</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>gzencode</methodname>
<methodparam><type>string</type><parameter>data</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>level</parameter><initializer>-1</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>encoding_mode</parameter><initializer>FORCE_GZIP</initializer></methodparam>
</methodsynopsis>
<para>
Questa funzione restituisce una versione compressa di
<parameter>data</parameter> compatibile con l'output del
programma <command>gzip</command>.
</para>
<para>
Per ulteriori informazioni sul formato dei file GZIP, consultare il documento:
<link xlink:href="&url.rfc;1952">Specifica del formato di file GZIP
versione 4.3</link> (RFC 1952).
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>data</parameter></term>
<listitem>
<para>
I dati da codificare.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>level</parameter></term>
<listitem>
<para>
Il livello di compressione. Può essere dato come 0 per nessuna compressione fino a 9
per la massima compressione. Se non viene fornito, il livello di compressione predefinito
adottato sarà quello di default della libreria zlib.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>encoding_mode</parameter></term>
<listitem>
<para>
La modalità di codifica. Può essere <constant>FORCE_GZIP</constant> (il default)
o <constant>FORCE_DEFLATE</constant>.
</para>
<para>
Prima di PHP 5.4.0, se si utilizza <constant>FORCE_DEFLATE</constant>, si ottiene
una stringa compressa col DEFLATE standard di zlib (comprendente gli header zlib) dopo un header
del file gzip ma senza il checksum crc32 finale.
</para>
<para>
In PHP 5.4.0 e versioni successive, <constant>FORCE_DEFLATE</constant> genera
un output conforme a RFC 1950, costituito da un header zlib, i dati
compressi col DEFLATE e un checksum Adler.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
La stringa codificata o &false; se si è verificato un errore.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
I dati risultanti contengono gli header e la struttura
dati appropriati per creare un file .gz standard, ad esempio:
<example>
<title>Creare un file gzip</title>
<programlisting role="php">
<![CDATA[
<?php
$data = implode("", file("bigfile.txt"));
$gzdata = gzencode($data, 9);
$fp = fopen("bigfile.txt.gz", "w");
fwrite($fp, $gzdata);
fclose($fp);
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>gzdecode</function></member>
<member><function>gzdeflate</function></member>
<member><function>gzinflate</function></member>
<member><function>gzuncompress</function></member>
<member><function>gzcompress</function></member>
<member>
<link xlink:href="&url.rfc;1950">
Specifica del Formato dei Dati Compressi ZLIB (RFC 1950)
</link>
</member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- 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
-->