move_uploaded_file

(PHP 4 >= 4.0.3, PHP 5)

move_uploaded_file -- Presunie uploadnutý súbor na nové miesto

Popis

bool move_uploaded_file ( string názovsúboru, string cieľ)

Táto funkcia skontroluje, či súbor špecifikovaný v parametri názovsúboru je platný uploadnutý súbor (t. j. či bol súbor uploadnutý použitím mechanizmov HTTP POST PHP). Ak je súbor platný, bude presunutý na miesto špecifikované parametrom cieľ.

Ak názovsúboru nie je platný uploadnutý súbor nevykoná sa nič a funkcia move_uploaded_file() vráti FALSE.

Ak názovsúboru je platný uploadnutý súbor, ale presun nemôže byť z nejakého dôvodu uskutočnený, nevykoná sa nič a move_uploaded_file() vráti FALSE. Navyše bude vydané varovanie.

Tento spôsob kontroly je dôležitý najmä v prípadoch, keď manipulácia s uploadnutnými súbormi môže odhaliť ich obsah užívateľovi, či dokonca ostatným užívateľom systému.

Poznámka: Keď je safe mode povolený, PHP zisťuje, či súbory alebo adresáre, na ktorých idete pracovať, majú rovnaké UID (vlastník) ako skript, ktorý sa spracováva.

Poznámka: move_uploaded_file() nie je ovplyvnená režimom safe mode a jeho obmedzeniami cez UID. Toto však nie je nebezpečné pretože move_uploaded_file() pracuje výlučne na súboroch, ktoré boli uploadnuté cez PHP.

Varovanie

Ak cieľový súbor existuje, bude prepísaný.

Pozri tiež is_uploaded_file() a sekciu Práca s uploadnutými súbormi, ktorá obsahuje aj niekoľko jednoduchých príkladov.