Zum Inhalt springen

ftp_mdtm()

Was ist ftp_mdtm()?

Die Funktion ftp_mdtm() ist eine integrierte PHP-Funktion, die die letzte Änderungszeit einer angegebenen Datei auf einem FTP-Server abruft. Sie erwartet zwei Parameter:

  1. ftp_stream: Die Verbindungs-ID, die von ftp_connect() zurückgegeben wird.
  2. remote_file: Der Pfad zur Datei auf dem Server.

Die Funktion gibt die letzte Änderungszeit als Unix-Timestamp zurück. Wenn die Datei nicht existiert oder die Verbindung ungültig ist, wird -1 zurückgegeben.

Syntax von ftp_mdtm()

Die Syntax der Funktion ftp_mdtm() lautet wie folgt:

Syntax von ftp_mdtm()

php
int ftp_mdtm ( resource $ftp_stream , string $remote_file )

Hinweis: Der Typ resource ist in PHP 8 veraltet. Ab PHP 8.1 erwartet der erste Parameter stattdessen ein FTP\Connection-Objekt.

Diese Funktion erfordert eine aktive FTP-Verbindung. Sie behandelt den passiven Modus nicht automatisch; wenn Ihr Server dies erfordert, rufen Sie ftp_pasv($ftp_stream, true) auf, bevor Sie diese Funktion aufrufen.

Verwendung von ftp_mdtm()

Um die Funktion ftp_mdtm() zu verwenden, stellen Sie zunächst eine Verbindung zum FTP-Server mit ftp_connect() her. Hier ist ein Beispiel:

Verwendung von ftp_mdtm()

php
<?php

// Set up an FTP connection
$conn = ftp_connect('ftp.example.com');

// Login with your FTP credentials
ftp_login($conn, 'username', 'password');

// Get the last modified time of the remote file
$last_modified = ftp_mdtm($conn, '/path/to/remote/file');

// Close the FTP connection
ftp_close($conn);

In diesem Beispiel stellen wir eine Verbindung her, melden uns an, rufen die Änderungszeit der Datei ab und schließen die Verbindung.

Fehlerbehandlung in ftp_mdtm()

Es ist wichtig, Fehler bei der Verwendung von ftp_mdtm() ordnungsgemäß zu behandeln. Da die Funktion im Fehlerfall -1 zurückgibt, sollten Sie auf diesen Wert prüfen. Hier ist ein Beispiel:

Fehlerbehandlung in ftp_mdtm()

php
<?php

$last_modified = ftp_mdtm($conn, '/path/to/remote/file');

if ($last_modified === -1) {
    echo "Failed to retrieve the last modified time.\n";
} else {
    echo "The last modified time is $last_modified.\n";
}

Dieses Beispiel prüft den Rückgabewert. Wenn er -1 entspricht, wird eine Fehlermeldung angezeigt; andernfalls wird der Timestamp ausgegeben.

Fazit

Die Funktion ftp_mdtm() ist eine nützliche integrierte PHP-Funktion, mit der Sie die letzte Änderungszeit einer angegebenen Datei auf einem FTP-Server abrufen können. Durch Befolgen der in diesem Artikel beschriebenen Richtlinien und Best Practices können Sie ftp_mdtm() mit Sicherheit in Ihren PHP-Projekten einsetzen. Wir hoffen, dass dieser Artikel für Sie hilfreich war.

Praxis

Was ist der Zweck der Funktion 'ftp_mdtm' in PHP?

Finden Sie das nützlich?

Dual-run-Vorschau — vergleichen Sie mit den Symfony-Routen live.