-
Notifications
You must be signed in to change notification settings - Fork 7
/
serialize.xml
166 lines (156 loc) · 4.72 KB
/
serialize.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
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: cucinato Status: ready -->
<refentry xml:id="function.serialize" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>serialize</refname>
<refpurpose>Genera una versione archiviabile del valore</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>serialize</methodname>
<methodparam><type>mixed</type><parameter>value</parameter></methodparam>
</methodsynopsis>
<para>
Genera una versione archiviabile di un valore
</para>
<para>
Questo è utile per archiviare o passare valori a PHP senza
perderne il tipo e la struttura.
</para>
<para>
Per ottenere il valore dalla stringa serializzata, utilizzare
la funzione <function>unserialize</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>value</parameter></term>
<listitem>
<para>
Il valore da serializzare. <function>serialize</function>
gestisce tutti i tipi di variabili tranne il tipo <type>resource</type>.
Possono essere elaborati da <function>serialize</function> array che
contengano riferimenti a se stessi. Saranno archiviati anche i riferimenti
circolari negli array/object. Ogni altro
riferimento verrà perso.
</para>
<para>
Quando si esegue la serializzazione di oggetti, PHP cerca di eseguire la funzione
<link linkend="language.oop5.magic">__sleep</link> prima di cominciare la serializzazione.
Questo permette all'oggetto di eseguire le ultime operazioni di chiusura prima
di essere serializzato. Analogamente, quando l'oggetto viene ripristinato usando
<function>unserialize</function> viene chiamata la funzione membro <link
linkend="language.oop5.magic">__wakeup</link>.
</para>
<note>
<para>
I membri privati dell'oggetto avranno il nome della classe preposto al nome del
membro; i membri protetti avranno un '*' preposto al nome del membro.
Questi valori preposti sono delimitati da byte null.
</para>
</note>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Restituisce una stringa contenente un flusso di bytes rappresentante
<parameter>value</parameter> che può essere archiviato ovunque.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Esempio di <function>serialize</function></title>
<programlisting role="php">
<![CDATA[
<?php
// L'array multi-dimensionale $session_data contiene le informazioni della sessione
// per l'utente. Si userà serialize() per memorizzare le informazioni
// all'interno di un database alla fine della richiesta..
$conn = odbc_connect("webdb", "php", "chicken");
$stmt = odbc_prepare($conn,
"UPDATE sessions SET data = ? WHERE id = ?");
$sqldata = array (serialize($session_data), $_SERVER['PHP_AUTH_USER']);
if (!odbc_execute($stmt, $sqldata)) {
$stmt = odbc_prepare($conn,
"INSERT INTO sessions (id, data) VALUES(?, ?)");
if (!odbc_execute($stmt, $sqldata)) {
/* Qualcosa non ha funzionato... */
}
}
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>4.0.7</entry>
<entry>
Il processo di serializzazione degli oggetti è stato corretto.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
It is not possible to serialize PHP built-in objects.
</para>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>unserialize</function></member>
<member><link linkend="language.oop5.serialization">Serializing Objects</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
-->