<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.5 $ -->
<!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
<refentry id="function.move-uploaded-file">
 <refnamediv>
  <refname>move_uploaded_file</refname>
  <refpurpose>Moves an uploaded file to a new location</refpurpose>
 </refnamediv>
 <refsect1>
  <title>Description</title>
  <methodsynopsis>
   <type>bool</type><methodname>move_uploaded_file</methodname>
   <methodparam><type>string</type><parameter>filename</parameter></methodparam>
   <methodparam><type>string</type><parameter>destination</parameter></methodparam>
  </methodsynopsis>
  <para>
   This function checks to ensure that the file designated by
   <parameter>filename</parameter> is a valid upload file (meaning
   that it was uploaded via PHP's HTTP POST upload mechanism). If
   the file is valid, it will be moved to the filename given by
   <parameter>destination</parameter>.
  </para>
  <para>
   If <parameter>filename</parameter> is not a valid upload file,
   then no action will occur, and
   <function>move_uploaded_file</function> will return
   &false;.
  </para>
  <para>
   If <parameter>filename</parameter> is a valid upload file, but
   cannot be moved for some reason, no action will occur, and
   <function>move_uploaded_file</function> will return
   &false;. Additionally, a warning will be issued.
  </para>
  <para>
   This sort of check is especially important if there is any chance
   that anything done with uploaded files could reveal their
   contents to the user, or even to other users on the same
   system.
  </para>
  <note>
   <para>
    <function>move_uploaded_file</function> is both &safemode;
    and <link linkend="ini.open-basedir">open_basedir</link>
    aware. However, restrictions are placed only on the
    <parameter>destination</parameter> path as to allow the moving
    of uploaded files in which <parameter>filename</parameter> may conflict
    with such restrictions. <function>move_uploaded_file</function> ensures
    the safety of this operation by allowing only those files uploaded
    through PHP to be moved.
   </para>
  </note>
  <warning>
   <para>
    If the destination file already exists, it will be overwritten.
   </para>
  </warning>
  <para>
   See also <function>is_uploaded_file</function>, and the section
   <link linkend="features.file-upload">Handling file uploads</link>
   for a simple usage example.
  </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:"../../../../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
-->