International PHP Conference Berlin 2025

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

User Contributed Notes 2 notes

up
4
mawkapelle at gmail dot com
6 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
-4
Jaytop
19 years ago
Seems to work with directories as well on my Win32 box.
To Top