touch(3) [php man page]

TOUCH(3)								 1								  TOUCH(3)

touch - Sets access and modification time of file

SYNOPSIS

       bool touch (string  $filename, [int  $time = time()], [int  $atime])

DESCRIPTION

	Attempts  to set the access and modification times of the file named in the $filename parameter to the value given in $time. 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

	      o $filename
		- The name of the file being touched.

	      o $time
		- The touch time. If $time is not supplied, the current system time is used.

	      o $atime
		- If present, the access time of the given filename is set to the value of $atime. Otherwise, it is set to the value passed to the
		$time parameter. If neither are present, the current system time is used.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

CHANGELOG

       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 5.3.0	|						    |
       |	|						    |
       |	|  It  became  possible  to change the modification |
       |	| time of a directory under Windows.		    |
       |	|						    |
       +--------+---------------------------------------------------+
EXAMPLES

       Example #1

	      touch(3) example

	      <?php
	      if (touch($filename)) {
		  echo $filename . ' modification time has been changed to present time';
	      } else {
		  echo 'Sorry, could not change modification time of ' . $filename;
	      }
	      ?>

       Example #2

	      touch(3) using the $time parameter

	      <?php
	      // This is the touch time, we'll set it to one hour in the past.
	      $time = time() - 3600;

	      // Touch the file
	      if (!touch('some_file.txt', $time)) {
		  echo 'Whoops, something went wrong...';
	      } else {
		  echo 'Touched file with success';
	      }
	      ?>

NOTES

       Note

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

       Warning

	       Prior to PHP 5.3.0 it was not possible to change the modification time of a directory with this function under Windows.

PHP Documentation Group 														  TOUCH(3)

Touch(3pm)						User Contributed Perl Documentation						Touch(3pm)

NAME

       File::Touch - update access and modification timestamps, creating nonexistent files where necessary.

SYNOPSIS

	use File::Touch;
	@file_list = ('one.txt','../two.doc');
	$count = touch(@file_list);

	use File::Touch;
	$reference_file = '/etc/passwd';
	$touch_obj = File::Touch->new(
				      reference => $reference_file,
				      no_create => 1
				      );
	@file_list = ('one.txt','../two.doc');
	$count = $touch_obj->touch(@file_list);

DESCRIPTION

       Here's a list of arguments that can be used with the object-oriented contruction:

       atime_only => [0|1]
	   If nonzero, change only the access time of files. Default is zero.

       mtime_only => [0|1]
	   If nonzero, change only the modification time of files. Default is zero.

       no_create => [0|1]
	   If nonzero, do not create new files. Default is zero.

       reference => $reference_file
	   If defined, use timestamps from this file instead of current time. Default is undefined.

       atime => $time
	   If defined, use this time (in epoch seconds) instead of current time for access time.

       mtime => $time
	   If defined, use this time (in epoch seconds) instead of current time for modification time.

Examples
   Update access and modification times, creating nonexistent files
	use File::Touch;
	my @files = ('one','two','three');
	my $count = touch(@files);
	print "$count files updated
";

   Set access time forward, leave modification time unchanged
	use File::Touch;
	my @files = ('one','two','three');
	my $day = 24*60*60;
	my $time = time() + 30 * $day;
	my $ref = File::Touch->new( atime_only => 1, time => $time );
	my $count = $ref->touch(@files);
	print "$count files updated
";

   Set modification time back, update access time, do not create nonexistent files
	use File::Touch;
	my @files = ('one','two','three');
	my $day = 24*60*60;
	my $time = time() - 30 * $day;
	my $ref = File::Touch->new( mtime => $time, no_create => 1 );
	my $count = $ref->touch(@files);
	print "$count files updated
";

AUTHOR

       Nigel Wetters Gourlay (nwetters@cpan.org)

COPYRIGHT

       Copyright (c) 2001,2007,2009 Nigel Wetters Gourlay. All Rights Reserved.  This module is free software. It may be used, redistributed
       and/or modified under the same terms as Perl itself.

perl v5.10.0							    2009-07-25								Touch(3pm)