ftp_mdtm

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

ftp_mdtmRetorna o horário da última modificação do arquivo informado

Descrição

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

ftp_mdtm() retorna o horário da última modificação de um arquivo remoto.

Nota:

Nem todos os servidores suportam este recurso!

Nota:

ftp_mdtm() não funciona com diretórios.

Parâmetros

ftp

Uma instância de FTP\Connection.

filename

O arquivo do qual será extraído o horário da última modificação.

Valor Retornado

Retorna o horário da última modificação como um timestamp Unix local em caso de sucesso, ou -1 em caso de erro.

Registro de Alterações

Versão Descrição
8.1.0 O parâmetro ftp agora espera uma instância de FTP\Connection; anteriormente, um resource era esperado.

Exemplos

Exemplo #1 Exemplo de ftp_mdtm()

<?php

$file
= 'algumArquivo.txt';

// define uma conexão básica
$ftp = ftp_connect($ftp_server);

// login com usuário e senha
$login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);

// obtém o horário da última modificação
$buff = ftp_mdtm($ftp, $file);

if (
$buff != -1) {
// algumArquivo.txt foi modificado em: March 26 2003 14:16:41.
echo "$file foi modificado em : " . date("F d Y H:i:s.", $buff);
} else {
echo
"Não foi possível obter mdtime";
}

// fecha a conexão
ftp_close($ftp);

?>

add a note add a note

User Contributed Notes 3 notes

up
3
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
-3
Jaytop
19 years ago
Seems to work with directories as well on my Win32 box.
up
-9
wseibert at hxcorp dot com
20 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