ftp_mkdir()

O que é ftp_mkdir()?

A função ftp_mkdir() é uma função interna do PHP que cria um novo diretório no servidor FTP. A função recebe dois parâmetros:

1. ftp_stream: O identificador de conexão retornado pela função ftp_connect().
2. directory: O nome do diretório a ser criado.

A função retorna true se o diretório foi criado com sucesso. Caso contrário, retorna false. Observe que ftp_mkdir() não consegue criar diretórios aninhados; os caminhos intermediários devem ser criados manualmente.

Sintaxe de ftp_mkdir()

A sintaxe da função ftp_mkdir() é a seguinte:

Sintaxe de ftp_mkdir()

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

Observação: A assinatura tipada acima requer PHP 8.0+. A função está disponível desde o PHP 4.3.0.

Uso de ftp_mkdir()

Para usar a função ftp_mkdir(), você primeiro precisa estabelecer uma conexão com o servidor FTP usando a função ftp_connect() e autenticar-se com ftp_login(). Veja um exemplo:

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

Neste exemplo, estabelecemos uma conexão com o servidor FTP usando a função ftp_connect(). Em seguida, fazemos login com nossas credenciais FTP usando a função ftp_login(). Por fim, criamos um novo diretório usando a função ftp_mkdir() e fechamos a conexão FTP.

Tratamento de erros em ftp_mkdir()

É importante tratar os erros adequadamente ao usar a função ftp_mkdir(). Se a função retornar false, significa que a criação do diretório não foi bem-sucedida. Os motivos comuns incluem permissões insuficientes, um caminho inválido ou o diretório de destino já existir. Observe que ftp_mkdir() falhará se o diretório especificado já existir.

Veja um exemplo de como tratar erros e configurar definições FTP confiáveis:

Tratamento de erros em 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.
}
?>

Para operações FTP confiáveis, considere definir um tempo limite e habilitar o modo passivo antes de criar diretórios:

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

Conclusão

A função ftp_mkdir() oferece uma maneira direta de criar diretórios em um servidor FTP. Lembre-se de validar sua conexão, tratar os erros com elegância, definir tempos limite adequados e criar diretórios intermediários manualmente quando necessário. Aplicar essas práticas ajudará você a integrar o gerenciamento de diretórios FTP em suas aplicações PHP de forma confiável.

Funções relacionadas

Estas funções são comumente usadas junto com ftp_mkdir() ao gerenciar diretórios via FTP:

• ftp_rmdir() — remove um diretório do servidor FTP.
• ftp_chdir() — altera o diretório de trabalho atual no servidor.
• ftp_pwd() — retorna o caminho do diretório atual.
• ftp_set_option() — configura opções como o tempo limite da conexão.
• ftp_pasv() — ativa o modo passivo, frequentemente necessário atrás de firewalls.
• ftp_close() — fecha a conexão FTP quando você terminar.

Prática