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:
| 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. |
|
| 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
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'));
?>