ftp_mkdir()

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

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

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

Функция возвращает true, если каталог успешно создан. В противном случае она возвращает false. Обратите внимание, что ftp_mkdir() не может создавать вложенные каталоги; промежуточные пути необходимо создавать вручную.

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

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

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

bool ftp_mkdir ( FTP\Connection $ftp_stream , string $directory )

Примечание: типизированная сигнатура выше требует PHP 8.0+. Функция доступна начиная с PHP 4.3.0.

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

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

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

<?php

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

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

// Create a new directory
if (ftp_mkdir($conn, '/path/to/new/directory')) {
    echo "Directory created successfully.\n";
} else {
    echo "Failed to create directory.\n";
}

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

В этом примере мы устанавливаем соединение с FTP-сервером с помощью функции ftp_connect(). Затем выполняем вход с использованием FTP-учётных данных через функцию ftp_login(). Наконец, создаём новый каталог с помощью функции ftp_mkdir() и закрываем FTP-соединение.

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

При использовании функции ftp_mkdir() важно правильно обрабатывать ошибки. Если функция возвращает false, это означает, что создание каталога завершилось неудачей. Распространённые причины включают недостаточные права доступа, неверный путь или то, что указанный каталог уже существует. Обратите внимание, что ftp_mkdir() завершится ошибкой, если указанный каталог уже существует.

Пример обработки ошибок и настройки надёжных параметров FTP:

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

<?php
if (ftp_mkdir($conn, '/path/to/new/directory')) {
    echo "Directory created successfully.\n";
} else {
    echo "Failed to create directory.\n";
    // Note: PHP's FTP extension does not expose the last server response directly.
    // Verify connection status, permissions, and path validity.
}
?>

Для надёжной работы с FTP рекомендуется установить таймаут и включить пассивный режим перед созданием каталогов:

ftp_set_option($conn, FTP_TIMEOUT_SEC, 30);
ftp_set_option($conn, FTP_USEPASVADDRESS, true);

Заключение

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

Связанные функции

Следующие функции часто используются вместе с ftp_mkdir() при управлении каталогами по FTP:

• ftp_rmdir() — удаляет каталог с FTP-сервера.
• ftp_chdir() — изменяет текущий рабочий каталог на сервере.
• ftp_pwd() — возвращает путь к текущему каталогу.
• ftp_set_option() — настраивает параметры, такие как таймаут соединения.
• ftp_pasv() — переключает пассивный режим, который часто требуется при работе за межсетевыми экранами.
• ftp_close() — закрывает FTP-соединение по завершении работы.

Практика