Перейти к содержимому

ftp_mdtm()

Что такое ftp_mdtm()?

Функция ftp_mdtm() — это встроенная функция PHP, которая возвращает время последнего изменения указанного файла на FTP-сервере. Она принимает два параметра:

  1. ftp_stream: Идентификатор соединения, возвращаемый функцией ftp_connect().
  2. remote_file: Путь к файлу на сервере.

Функция возвращает время последнего изменения в виде Unix-метки времени. Если файл не существует или соединение недействительно, она возвращает -1.

Синтаксис ftp_mdtm()

Синтаксис функции ftp_mdtm() выглядит следующим образом:

Синтаксис ftp_mdtm()

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

Примечание: Тип resource устарел в PHP 8. В PHP 8.1+ первый параметр ожидает объект FTP\Connection.

Для работы этой функции требуется активное FTP-соединение. Она автоматически не обрабатывает пассивный режим; если ваш сервер требует его использования, вызовите ftp_pasv($ftp_stream, true) перед вызовом этой функции.

Использование ftp_mdtm()

Чтобы использовать функцию ftp_mdtm(), сначала установите соединение с FTP-сервером с помощью ftp_connect(). Вот пример:

Использование 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);

В этом примере мы устанавливаем соединение, выполняем вход, получаем время изменения файла и закрываем соединение.

Обработка ошибок в ftp_mdtm()

При использовании ftp_mdtm() важно правильно обрабатывать ошибки. Поскольку функция возвращает -1 при ошибке, следует проверять это значение. Вот пример:

Обработка ошибок в 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";
}

В этом примере проверяется возвращаемое значение. Если оно равно -1, выводится сообщение об ошибке; в противном случае отображается метка времени.

Заключение

Функция ftp_mdtm() — это полезная встроенная функция PHP, которая позволяет получить время последнего изменения указанного файла на FTP-сервере. Следуя рекомендациям и лучшим практикам, описанным в этой статье, вы сможете уверенно использовать ftp_mdtm() в своих PHP-проектах. Надеемся, что эта статья оказалась для вас полезной.

Практика

Какова цель функции 'ftp_mdtm' в PHP?

Считаете ли это полезным?

Предпросмотр dual-run — сравните с маршрутами Symfony на продакшене.