touch

Function • Params and return types changed in PHP 8.0

Sets access and modification time of file.

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

touch Function synopsis

touch(
    string $filename,
    ?int $mtime = null,
    ?int $atime = null
  ): bool

Parameters

$filename

Typestring

The name of the file being touched.

$mtime

OptionalType?intDefault valuenull

The touch time. If $mtime is null, the current system time is used.

$atime

OptionalType?intDefault valuenull

If not null, the access time of the given filename is set to the value of $atime. Otherwise, it is set to the value passed to the $mtime parameter. If both are null, the current system time is used.

Return value

Typebool

Returns true on success, false on failure

Changes to the touch Function

PHP 8.0

  • Return type added: bool
  • Parameter type added for parameter #1 ($filename): string
  • Parameter name of parameter #2 changed: $time to $mtime
  • Parameter type added for parameter #2 ($mtime): ?int
  • Parameter default value added for position #2 ($mtime): null
  • Parameter type added for parameter #3 ($atime): ?int
  • Parameter default value added for position #3 ($atime): null
  touch(
-     $filename,
+     string $filename,
-     $time,
+     ?int $mtime = null,
-     $atime
+     ?int $atime = null
-   )
+   ): bool

touch 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