move_uploaded_file

Function • Params and return types changed in PHP 8.0

Moves an uploaded file to a new location.

PHP 5
PHP 7
PHP 8.0
Improved
PHP 8.1
PHP 8.2-8.3
PHP 8.4
PHP 8.5
PHP 8.6

move_uploaded_file Function synopsis

move_uploaded_file(string $from, string $to): bool

Parameters

$from

Typestring

The filename of the uploaded file.

$to

Typestring

The destination of the moved file.

Return value

Typebool

Returns true on success.

If $from is not a valid upload file, then no action will occur, and move_uploaded_file will return false.

If $from is a valid upload file, but cannot be moved for some reason, no action will occur, and move_uploaded_file will return false. Additionally, a warning will be issued.

Changes to the move_uploaded_file Function

PHP 8.0

  • Return type added: bool
  • Parameter name of parameter #1 changed: $path to $from
  • Parameter type added for parameter #1 ($from): string
  • Parameter name of parameter #2 changed: $new_path to $to
  • Parameter type added for parameter #2 ($to): string
- move_uploaded_file($path, $new_path)
+ move_uploaded_file(string $from, string $to): bool

move_uploaded_file Function Availability

PHP VersionAvailability
PHP 8.6Upcoming Release Yes
PHP 8.5Supported (Latest) Yes
PHP 8.4Supported Yes
PHP 8.3Security-Fixes Only Yes
PHP 8.2Security-Fixes Only Yes
PHP 8.1Unsupported Yes
PHP 8.0Unsupported Yes
PHP 7.4Unsupported Yes
PHP 7.3Unsupported Yes
PHP 7.2Unsupported Yes
PHP 7.1Unsupported Yes
PHP 7.0Unsupported Yes
PHP 5.6Unsupported Yes
PHP 5.5Unsupported Yes
PHP 5.4Unsupported Yes
PHP 5.3Unsupported Yes