-
Notifications
You must be signed in to change notification settings - Fork 70
/
move-uploaded-file.xml
148 lines (142 loc) · 5.65 KB
/
move-uploaded-file.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
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.move-uploaded-file" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>move_uploaded_file</refname>
<refpurpose>Перемещает загруженный файл в новое место</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>move_uploaded_file</methodname>
<methodparam><type>string</type><parameter>from</parameter></methodparam>
<methodparam><type>string</type><parameter>to</parameter></methodparam>
</methodsynopsis>
<para>
Эта функция проверяет, является ли файл <parameter>from</parameter>
загруженным на сервер (переданным по протоколу HTTP POST). Если файл
действительно загружен на сервер, он будет перемещён в место, указанное
в аргументе <parameter>to</parameter>.
</para>
<para>
Такая проверка особенно важна в том случае, если существует шанс того,
что какие-либо действия, производимые над загруженным файлом, могут
открыть его содержимое пользователю или даже другим пользователям системы.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>from</parameter></term>
<listitem>
<para>
Путь к загруженному файлу.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>to</parameter></term>
<listitem>
<para>
Путь, по которому необходимо переместить файл.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
В случае успешного выполнения возвращает &true;.
</para>
<para>
Если <parameter>from</parameter> не является загруженным файлом,
никаких действий не предпринимается и
<function>move_uploaded_file</function> возвращает &false;.
</para>
<para>
Если <parameter>from</parameter> является загруженным файлом, но
не может быть перемещён по каким-либо причинам, никаких действий не
предпринимается и <function>move_uploaded_file</function> возвращает &false;.
Кроме того, отображается предупреждение.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Загрузка нескольких файлов</title>
<programlisting role="php">
<![CDATA[
<?php
$uploads_dir = '/uploads';
foreach ($_FILES["pictures"]["error"] as $key => $error) {
if ($error == UPLOAD_ERR_OK) {
$tmp_name = $_FILES["pictures"]["tmp_name"][$key];
// basename() может предотвратить атаку на файловую систему;
// может быть целесообразным дополнительно проверить имя файла
$name = basename($_FILES["pictures"]["name"][$key]);
move_uploaded_file($tmp_name, "$uploads_dir/$name");
}
}
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
Функция <function>move_uploaded_file</function> принимает во внимание
<link linkend="ini.open-basedir">open_basedir</link>.
Тем не менее, ограничения накладываются лишь на параметр
<parameter>to</parameter>, чтобы разрешить перемещение загруженных
файлов, так как параметр <parameter>from</parameter> может
конфликтовать с этими ограничениями. <function>move_uploaded_file</function> гарантирует
безопасность этой операции, работая лишь с теми файлами, которые были
загружены через PHP.
</para>
</note>
<warning>
<para>
Если результирующий файл уже существует, он будет перезаписан.
</para>
</warning>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>is_uploaded_file</function></member>
<member><function>rename</function></member>
<member>Простой пример использования этой функции можно найти в разделе "<link linkend="features.file-upload">Загрузка файлов на сервер</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
-->