PEAR Manual
Prev		Next

Net_FTP::mdtm()

Net_FTP::mdtm() -- returns the last modification date of a file.

Synopsis

require_once 'Net/FTP.php';

mixed Net_FTP::mdtm (string $file [, string $format = null])

Description

gives you the last modification-date of a file either as a unix timestamp or in a formated date.

Parameter

string $file - The file to check.
string $format - A date()-function styled format-string.

Return value

mixed - the last modification date on success, otherwise PEAR::Error.

Throws

Several errors may be returned by mdtm. The errornumber is unspecific (until now) and will not tell you anything about the errormessage. Possible errors are:

Table 47-1. Possible PEAR_Error values

Error message Description Solution

Filename '$file' seems to be a directory. The filename you gave the method does not reference a regular-file but a directory. Specify a correct filenamepath (eg. /my/file/path/foo.html, ../foo.html).

Could not get last-modification-date of '$file'.

The last-modification date could not be determined by PHP. Reasons for this may be that your FTP-server does not support the used command or that you gave the function a non existent file as reference.

check the given file for existence
contact the FTP server's admin

Date-format failed on timestamp '$res'. The given format-string was not well formated. Check the documentation of the PHP function date().

Note

This function can not be called statically.

Example

Example 47-1. Using mdtm()

<?php
     
    var_dump($test->mdtm('/foo/bar'));

    // returns the last modification time in german timeformat
    var_dump($test->mdtm('/foo/bar', 'd.m.Y, H:i'));
    
?>

Prev	Home	Next
Net_FTP::execute()	Up	Net_FTP::size()

PEAR Manual

Net_FTP::mdtm()

Synopsis

Description

Parameter

Return value

Throws

Note

Example

Newsletter

Hosted by

Search

Links