ftp_mdtm

(PHP 4, PHP 5, PHP 7, PHP 8)

ftp_mdtmReturns the last modified time of the given file

Description

ftp_mdtm(FTP\Connection $ftp, string $filename): int

ftp_mdtm() gets the last modified time for a remote file.

Note:

Not all servers support this feature!

Note:

ftp_mdtm() does not work with directories.

Parameters

ftp

An FTP\Connection instance.

filename

The file from which to extract the last modification time.

Return Values

Returns the last modified time as a local Unix timestamp on success, or -1 on error.

Changelog

Version Description
8.1.0 The ftp parameter expects an FTP\Connection instance now; previously, a resource was expected.

Examples

Example #1 ftp_mdtm() example

<?php

$file
= 'somefile.txt';

// set up basic connection
$ftp = ftp_connect($ftp_server);

// login with username and password
$login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);

// get the last modified time
$buff = ftp_mdtm($ftp, $file);

if (
$buff != -1) {
// somefile.txt was last modified on: March 26 2003 14:16:41.
echo "$file was last modified on : " . date("F d Y H:i:s.", $buff);
} else {
echo
"Couldn't get mdtime";
}

// close the connection
ftp_close($ftp);

?>

add a note add a note

User Contributed Notes 3 notes

up
3
mawkapelle at gmail dot com
5 years ago
Wrapped the above in a function, for easy use:

function getMtime($filename, $server, $login, $pwd){

    // set up connection
    $conn_id = ftp_connect($server) or die("ERROR:Could not connect to $server");

    // login
    $login_result = ftp_login($conn_id, $login, $pwd);

    //  get the last modified time for our file
    $buff = ftp_mdtm($conn_id, $filename);

    // close the connection
    ftp_close($conn_id);

    if ($buff != -1) {
        // somefile.txt was last modified on: March 26 2003 14:16:41.
        return "$filename was last modified on : " . date("F d Y H:i:s.", $buff);
    } else {
        return "ERROR: Could not retrieve mdtime";
    }
}

$filename='example.csv';
$server='ftp.example.nl';
$login='supersecureloginhere';
$pwd='supersecurepwd';

$mtime=getMtime($filename, $server, $login, $pwd);
echo $mtime;
up
-3
Jaytop
18 years ago
Seems to work with directories as well on my Win32 box.
up
-10
wseibert at hxcorp dot com
19 years ago
When trying to get the modified time of a file that has spaces in it, ftp_mdtm will fail on some FTP servers.  If this happens, surround the file name with quotes.

$file_name = "my index.html";

$file_modtime = ftp_mdtm($connection, '"'.$file_name.'"')
To Top