-
Notifications
You must be signed in to change notification settings - Fork 73
/
http.xml
184 lines (172 loc) · 6.72 KB
/
http.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
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8bc832a464e33122e8129f5a623bd845b69fa7e0 Maintainer: mch Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="wrappers.http" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="verify_info:false" role="stream_wrapper">
<refnamediv>
<refname>http://</refname>
<refname>https://</refname>
<refpurpose>Доступ к URL-адресам по протоколу HTTP(s)</refpurpose>
</refnamediv>
<refsect1 role="description"><!-- {{{ -->
&reftitle.description;
<para>
Предоставляет доступ только для чтения файлов или ресурсов через протокол HTTP.
По умолчанию используется HTTP 1.0 GET. Для поддержки виртуальных хостов на основе имён
вместе с запросом посылается заголовок <literal>Host:</literal>.
Если через файл &php.ini; или контекст потока сконфигурировали строку
<link linkend="ini.user-agent">user_agent</link>, то она также включится
в запрос.
</para>
<simpara>
Этот поток также разрешает получить доступ к <emphasis>содержимому</emphasis>
ресурса; заголовки сохраняются в переменной
<varname>$http_response_header</varname>.
</simpara>
<simpara>
Если важно знать URL-адрес, с которого получили документ
(после всех переадресаций, которые были выполнены),
то необходимо обработать серию заголовков ответов,
которые возвращает поток.
</simpara>
<simpara>
INI-директива <link linkend="ini.from">from</link> будет использоваться для заголовка
<literal>From:</literal>, если установлена и не переопределена в контексте
<xref linkend="context"/>.
</simpara>
</refsect1><!-- }}} -->
<refsect1 role="usage"> <!-- {{{ -->
&reftitle.usage;
<itemizedlist>
<listitem><simpara><filename>http://example.com</filename></simpara></listitem>
<listitem><simpara><filename>http://example.com/file.php?var1=val1&var2=val2</filename></simpara></listitem>
<listitem><simpara><filename>http://user:password@example.com</filename></simpara></listitem>
<listitem><simpara><filename>https://example.com</filename></simpara></listitem>
<listitem><simpara><filename>https://example.com/file.php?var1=val1&var2=val2</filename></simpara></listitem>
<listitem><simpara><filename>https://user:password@example.com</filename></simpara></listitem>
</itemizedlist>
</refsect1> <!-- }}} -->
<refsect1 role="options"><!-- {{{ -->
&reftitle.options;
<para>
<table>
<title>Основная информация</title>
<tgroup cols="2">
<thead>
<row>
<entry>Атрибут</entry>
<entry>Поддержка</entry>
</row>
</thead>
<tbody>
<row>
<entry>Ограничение по <link linkend="ini.allow-url-fopen">allow_url_fopen</link></entry>
<entry>Да</entry>
</row>
<row>
<entry>Чтение</entry>
<entry>Да</entry>
</row>
<row>
<entry>Запись</entry>
<entry>Нет</entry>
</row>
<row>
<entry>Добавление</entry>
<entry>Нет</entry>
</row>
<row>
<entry>Одновременное чтение и запись</entry>
<entry>Недоступно</entry>
</row>
<row>
<entry>Поддержка <function>stat</function></entry>
<entry>Нет</entry>
</row>
<row>
<entry>Поддержка <function>unlink</function></entry>
<entry>Нет</entry>
</row>
<row>
<entry>Поддержка <function>rename</function></entry>
<entry>Нет</entry>
</row>
<row>
<entry>Поддержка <function>mkdir</function></entry>
<entry>Нет</entry>
</row>
<row>
<entry>Поддержка <function>rmdir</function></entry>
<entry>Нет</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</refsect1> <!-- }}} -->
<refsect1 role="examples"><!-- {{{ -->
&reftitle.examples;
<example xml:id="wrappers.http.example.basic"><!-- {{{ -->
<title>Определение URL-адреса, с которого забрали документ после переадресаций</title>
<programlisting role="php">
<![CDATA[
<?php
$url = 'http://www.example.com/redirecting_page.php';
$fp = fopen($url, 'r');
$meta_data = stream_get_meta_data($fp);
foreach ($meta_data['wrapper_data'] as $response) {
/* Выполнялась ли переадресация? */
if (strtolower(substr($response, 0, 10)) == 'location: ') {
/* Сохранить в переменной $url адрес переадресации */
$url = substr($response, 10);
}
}
?>
]]>
</programlisting>
</example><!-- }}} -->
</refsect1><!-- }}} -->
<refsect1 role="notes"><!-- {{{ -->
&reftitle.notes;
<note>
<simpara>
Протокол HTTPS поддерживается, только когда включили модуль <link linkend="book.openssl">openssl</link>.
</simpara>
</note>
<simpara>
HTTP-соединения предназначены только для чтения; запись данных или копирование файлов
в HTTP-ресурс не поддерживается.
</simpara>
<simpara>
Отправку, например, <emphasis>POST</emphasis>- и <emphasis>PUT</emphasis>-запросов
можно выполнить через <link linkend="context.http">HTTP-контекст</link>.
</simpara>
</refsect1><!-- }}} -->
<refsect1 role="seealso"><!-- {{{ -->
&reftitle.seealso;
<simplelist>
<member><xref linkend="context.http"/></member>
<member><varname>$http_response_header</varname></member>
<member><function>stream_get_meta_data</function></member>
</simplelist>
</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
-->