File: url.xml

package info (click to toggle)
phpdoc 20020310-1
  • links: PTS
  • area: main
  • in suites: woody
  • size: 35,272 kB
  • ctags: 354
  • sloc: xml: 799,767; php: 1,395; cpp: 500; makefile: 200; sh: 140; awk: 51
file content (257 lines) | stat: -rw-r--r-- 9,044 bytes parent folder | download
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
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
<?xml version="1.0" encoding="iso-8859-2"?>
 <reference id="ref.url">
  <title>URL Functions</title>
  <titleabbrev>URLs</titleabbrev>

  <refentry id="function.base64-decode">
   <refnamediv>
    <refname>base64_decode</refname>
    <refpurpose>Dekdovat data kdovan pomoc MIME base64</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>base64_decode</methodname>
      <methodparam><type>string</type><parameter>encoded_data</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>base64_decode</function> dekduje
     <parameter>encoded_data</parameter> a vrt pvodn data. Vrcen
     data mohou bt binrn
    </para>
    <para>
     Viz tak: <function>base64_encode</function>, RFC 2045 sekce 6.8.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.base64-encode">
   <refnamediv>
    <refname>base64_encode</refname>
    <refpurpose>Zakdovat data pomoc MIME base64</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>base64_encode</methodname>
      <methodparam><type>string</type><parameter>data</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>base64_encode</function> vrt
     <parameter>data</parameter> zakdovan pomoc base64. Toto kdovn
     je navreno tak, aby umonilo binrnm datm pet transport penosovmi
     vrstvami, kter nejsou osmibitov, jako jsou napklad tla email.
    </para>
    <para>
    Data kdovan pomoc base64 zabraj o zhruba 33% prostoru vce ne pvodn
    data.
    </para>
    <para>
    Viz tak:
     <function>base64_decode</function>,
     <function>chunk_split</function>,
     RFC-2045 sekce 6.8.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.parse-url">
   <refnamediv>
    <refname>parse_url</refname>
    <refpurpose>Rozebrat URL a vrtit jej komponenty</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>array</type><methodname>parse_url</methodname>
      <methodparam><type>string</type><parameter>url</parameter></methodparam>
     </methodsynopsis>
    <para>
    Tato funkce vrt asociativn pole vech komponent URL ptomnych v
    <parameter>url</parameter>. Ty mohou bt: "scheme", "host", "port",
    "user", "pass", "path", "query" a "fragment".
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.rawurldecode">
   <refnamediv>
    <refname>rawurldecode</refname>
    <refpurpose>Dekdovat URL-kdovan etzec</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>rawurldecode</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
    Vrt etzec, ve kterm sekvence znaku procent (<literal>%</literal>)
    nsledovch dvma estnctkovmi slicemi byly nahrazeny prostmi znaky.
    Napklad etzec <screen>foo%20bar%40baz</screen> dekduje na
    <screen>foo bar@baz</screen>.
    </para>
    <simpara>
     Viz tak: <function>rawurlencode</function>,
     <function>urldecode</function>,
     <function>urlencode</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.rawurlencode">
   <refnamediv>
    <refname>rawurlencode</refname>
    <refpurpose>URL-kdovat podle RFC1738</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>rawurlencode</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
    Vrt etzec, ve kterm byly vechny nealfanumerick znaky krom
    <screen>-_.</screen> nahrazeny znakem procent (<literal>%</literal>)
    nsledovanm dvma estnctkovmi slicemi. To je kdovn popsan
    v RFC1738 na ochranu prostch znak ped interpretac jako zvltn
    oddlovae v URL a na ochranu URL ped komolenm penosovmi systmy
    se znakovmi konvencemi (jako jsou nkter emailov systmy). Napklad,
    pokud chcete k FTP URL pidat heslo:
     <example>
      <title>Pklad <function>rawurlencode</function> . 1</title>
      <programlisting role="php">
echo '&lt;A HREF="ftp://user:', rawurlencode ('foo @+%/'),
     '@ftp.my.com/x.txt">';
      </programlisting>
     </example>
     Nebo, pokud pedvte informace v komponent URL obsahujc info o cest:
     <example>
      <title>Pklad <function>rawurlencode</function> . 2</title>
      <programlisting role="php">
echo '&lt;A HREF="http://x.com/department_list_script/',
    rawurlencode ('sales and marketing/Miami'), '">';
      </programlisting>
     </example>
    </para>
    <simpara>
     Viz tak: <function>rawurldecode</function>,
     <function>urldecode</function>,
     <function>urlencode</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.urldecode">
   <refnamediv>
    <refname>urldecode</refname>
    <refpurpose>Dekdovat URL-kdovan etzec</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>urldecode</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Dekduje vechny <literal>%<replaceable>##</replaceable></literal>
     kdy v danm etzci. Vrt dekdovan etzec.
     <example>
      <title>Pklad <function>urldecode</function></title>
      <programlisting role="php">
$a = split ('&amp;', $querystring);
$i = 0;
while ($i &lt; count ($a)) {
    $b = split ('=', $a [$i]);
    echo 'Hodnota argumentu ', htmlspecialchars (urldecode ($b [0])),
         ' je ', htmlspecialchars (urldecode ($b [1])), "&lt;BR>";
    $i++;
}
      </programlisting>
     </example>
    </para>
    <para>
     Viz tak <function>urlencode</function>,
     <function>rawurlencode</function>,
     <function>rawurldecode</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.urlencode">
   <refnamediv>
    <refname>urlencode</refname>
    <refpurpose>URL-kdovat etzec</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>urlencode</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
    Vrt etzec, ve kterm byly vechny nealfanumerick znaky krom
     <literal>-_.</literal> nahrazeny znakem procent (<literal>%</literal>)
     nsledovanm dvma estncktovmi slicemi a mezery kdovny jako
     znaky plus (<literal>+</literal>). Kdovn je stejn jako u dat
     postovanch z WWW formule, tj. stejn jako u
     <literal>application/x-www-form-urlencoded</literal> typu.
     To se li od RFC1738 kdovn (viz
     <function>rawurlencode</function>) v tom, e z historickch dvod
     se mezery kduj jako znaky plus (<literal>+</literal>). Tato funkce
     je vhodn pi kdovn etzce, kter se m pout jako query st URL
     jako phodn zpsob pedn promnnch na dal strnku:
     <example>
      <title>Pklad <function>urlencode</function></title>
      <programlisting role="php">
echo '&lt;A HREF="mycgi?foo=', urlencode ($userinput), '"&gt;';
      </programlisting>
     </example>
    </para>
	<para> Poznmka: pozor pi pedvn promnnch, kter by mohly
	odpovdat HTML entitm. Vci jako &amp;amp, &amp;copy a &amp;pound
	browser analyzuje a msto poadovanho jmna promnn pouije
	odpovdajc entitu. To je zejm problm, na kter W3C upozoruje u
	lta. Pruka je tady: <ulink url="&url.argsep;">&url.argsep;</ulink>
	PHP podporuje zmnu oddlovae argument na stednk doporuovan W3C
	skrze .ini direktivu arg_separator. Bohuel, vtina uivatelskch program
	neposl data z formul v tomto formtu. Penositelnj formou je
	pout jako oddlova &amp;amp; msto &amp;. Na to nemuste mnit
	arg_separator. Nechte ho na &amp;, ale kdujte URL pomoc
	<function>htmlentities</function> (urlencode($data)).
     <example>
      <title>Pklad na <function>urlencode/htmlentities</function></title>
      <programlisting role="php">
echo '&lt;A HREF="mycgi?foo=', htmlentities (urlencode ($userinput) ), '"&gt;';
      </programlisting>
     </example>
	</para>
    <para>
     Viz tak <function>urldecode</function>,
     <function>htmlentities</function>,
     <function>rawurldecode</function>,
     <function>rawurlencode</function>.
    </para>
   </refsect1>
  </refentry>

 </reference>

<!-- 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:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->