touch

PHP 4, PHP 5, PHP 7, PHP 8
touch - Sets access and modification time of file
Manual
Code Examples

touch( string$filename, [int|null$mtime = null], [int|null$atime = null] ): bool

Attempts to set the access and modification times of the file named in the filename parameter to the value given in mtime. Note that the access time is always modified, regardless of the number of parameters.

If the file does not exist, it will be created.

Parameters

filename

The name of the file being touched.

mtime

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

atime

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 Values

Returns true on success or false on failure.

Notes

Note:

Note that time resolution may differ from one file system to another.

Changelog

Version Description
8.0.0 mtime and atime are now nullable.

Example of touch

Show all examples for touch

PHP Version:


Function touch:

Filesystem Functions

Most used PHP functions