Saltar al contenido

ftp_mdtm()

¿Qué es ftp_mdtm()?

La función ftp_mdtm() es una función integrada de PHP que recupera la última fecha de modificación de un archivo especificado en un servidor FTP. Toma dos parámetros:

  1. ftp_stream: El identificador de conexión devuelto por ftp_connect().
  2. remote_file: La ruta al archivo en el servidor.

La función devuelve la última fecha de modificación como una marca de tiempo Unix. Si el archivo no existe o la conexión no es válida, devuelve -1.

Sintaxis de ftp_mdtm()

La sintaxis de la función ftp_mdtm() es la siguiente:

Sintaxis de ftp_mdtm()

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

Nota: El tipo resource está obsoleto en PHP 8. En PHP 8.1+, el primer parámetro espera un objeto FTP\Connection en su lugar.

Esta función requiere una conexión FTP activa. No maneja automáticamente el modo pasivo; si tu servidor lo requiere, llama a ftp_pasv($ftp_stream, true) antes de invocar esta función.

Uso de ftp_mdtm()

Para usar la función ftp_mdtm(), primero establece una conexión con el servidor FTP usando ftp_connect(). Aquí tienes un ejemplo:

Uso 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);

En este ejemplo, establecemos una conexión, iniciamos sesión, recuperamos la hora de modificación del archivo y cerramos la conexión.

Manejo de errores en ftp_mdtm()

Es importante manejar los errores correctamente al usar ftp_mdtm(). Dado que la función devuelve -1 en caso de error, debes comprobar ese valor. Aquí tienes un ejemplo:

Manejo de errores en 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";
}

Este ejemplo verifica el valor devuelto. Si es igual a -1, se muestra un mensaje de error; de lo contrario, se muestra la marca de tiempo.

Conclusión

La función ftp_mdtm() es una función integrada de PHP muy útil que te permite recuperar la última fecha de modificación de un archivo especificado en un servidor FTP. Siguiendo las pautas y mejores prácticas descritas en este artículo, puedes usar ftp_mdtm() en tus proyectos PHP con confianza. Esperamos que este artículo te haya sido de ayuda.

Práctica

¿Cuál es el propósito de la función 'ftp_mdtm' en PHP?

¿Te resulta útil?

Vista previa dual-run — compárala con las rutas Symfony en producción.