rename

FunctionParams and return types changed in PHP 8.0

Renames a file or directory.

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

rename Function synopsis

rename(
    string $from,
    string $to,
    $context = null
  ): bool

Parameters

$from

Typestring

The old name.

$to

Typestring

The new name.

$context

OptionalDefault valuenull

Return value

Typebool

Returns true on success, false on failure

Changes to the rename Function

PHP 8.0

  • Return type added: bool
  • Parameter name of parameter #1 changed: $old_name to $from
  • Parameter type added for parameter #1 ($from): string
  • Parameter name of parameter #2 changed: $new_name to $to
  • Parameter type added for parameter #2 ($to): string
  • Parameter default value added for position #3 ($context): null
  rename(
-     $old_name,
+     string $from,
-     $new_name,
+     string $to,
-     $context
+     $context = null
-   )
+   ): bool

rename 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