<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.2 $ -->
<!-- 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.sm.uidcheck;
     <note>
     <para>
      <function>move_uploaded_file</function> is not affected by the normal
      safe-mode UID-restrictions. This is not unsafe because
      <function>move_uploaded_file</function> only operates on files uploaded
      via PHP.
     </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
-->