Aller au contenu

ftp_mdtm()

Qu'est-ce que ftp_mdtm() ?

La fonction ftp_mdtm() est une fonction intégrée de PHP qui récupère la date de dernière modification d'un fichier spécifié sur un serveur FTP. Elle prend deux paramètres :

  1. ftp_stream : L'identifiant de connexion renvoyé par ftp_connect().
  2. remote_file : Le chemin d'accès au fichier sur le serveur.

La fonction renvoie la date de dernière modification sous forme de timestamp Unix. Si le fichier n'existe pas ou si la connexion est invalide, elle renvoie -1.

Syntaxe de ftp_mdtm()

La syntaxe de la fonction ftp_mdtm() est la suivante :

Syntaxe de ftp_mdtm()

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

Remarque : Le type resource est déprécié dans PHP 8. À partir de PHP 8.1+, le premier paramètre attend un objet FTP\Connection.

Cette fonction nécessite une connexion FTP active. Elle ne gère pas automatiquement le mode passif ; si votre serveur l'exige, appelez ftp_pasv($ftp_stream, true) avant d'invoquer cette fonction.

Utilisation de ftp_mdtm()

Pour utiliser la fonction ftp_mdtm(), établissez d'abord une connexion au serveur FTP à l'aide de ftp_connect(). Voici un exemple :

Utilisation de 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);

Dans cet exemple, nous établissons une connexion, nous connectons, récupérons l'heure de modification du fichier, puis fermons la connexion.

Gestion des erreurs dans ftp_mdtm()

Il est important de gérer correctement les erreurs lors de l'utilisation de ftp_mdtm(). Comme la fonction renvoie -1 en cas d'échec, vous devez vérifier cette valeur. Voici un exemple :

Gestion des erreurs dans 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";
}

Cet exemple vérifie la valeur de retour. Si elle est égale à -1, un message d'erreur s'affiche ; sinon, le timestamp est affiché.

Conclusion

La fonction ftp_mdtm() est une fonction intégrée PHP utile qui vous permet de récupérer la date de dernière modification d'un fichier spécifié sur un serveur FTP. En suivant les directives et les bonnes pratiques présentées dans cet article, vous pouvez utiliser ftp_mdtm() dans vos projets PHP en toute confiance. Nous espérons que cet article vous a été utile.

Pratique

Quel est l'objectif de la fonction 'ftp_mdtm' en PHP ?

Trouvez-vous cela utile?

Aperçu dual-run — comparez avec les routes Symfony en production.