ftp_mkdir()

Cos'è ftp_mkdir()?

La funzione ftp_mkdir() è una funzione built-in di PHP che crea una nuova directory sul server FTP. La funzione accetta due parametri:

1. ftp_stream: L'identificatore di connessione restituito dalla funzione ftp_connect().
2. directory: Il nome della directory da creare.

La funzione restituisce true se la directory è stata creata con successo. Altrimenti, restituisce false. Si noti che ftp_mkdir() non può creare directory annidate; i percorsi intermedi devono essere creati manualmente.

Sintassi di ftp_mkdir()

La sintassi della funzione ftp_mkdir() è la seguente:

Sintassi di ftp_mkdir()

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

Nota: La firma tipizzata mostrata sopra richiede PHP 8.0+. La funzione è disponibile a partire da PHP 4.3.0.

Utilizzo di ftp_mkdir()

Per utilizzare la funzione ftp_mkdir(), è necessario prima stabilire una connessione al server FTP usando la funzione ftp_connect() e autenticarsi con ftp_login(). Ecco un esempio:

Utilizzo di 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);

In questo esempio, stabiliamo una connessione al server FTP usando la funzione ftp_connect(). Poi effettuiamo l'accesso con le nostre credenziali FTP tramite la funzione ftp_login(). Infine, creiamo una nuova directory usando la funzione ftp_mkdir() e chiudiamo la connessione FTP.

Gestione degli errori in ftp_mkdir()

È importante gestire correttamente gli errori quando si utilizza la funzione ftp_mkdir(). Se la funzione restituisce false, significa che la creazione della directory non è riuscita. Le cause più comuni includono permessi insufficienti, un percorso non valido o la directory di destinazione già esistente. Si noti che ftp_mkdir() fallirà se la directory specificata esiste già.

Ecco un esempio di come gestire gli errori e configurare impostazioni FTP affidabili:

Gestione degli errori in 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.
}
?>

Per operazioni FTP affidabili, si consiglia di impostare un timeout e abilitare la modalità passiva prima di creare le directory:

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

Conclusione

La funzione ftp_mkdir() offre un modo semplice per creare directory su un server FTP. Ricordare di validare la connessione, gestire gli errori in modo appropriato, impostare timeout adeguati e creare manualmente le directory intermedie quando necessario. L'applicazione di queste pratiche aiuterà a integrare in modo affidabile la gestione delle directory FTP nelle proprie applicazioni PHP.

Funzioni correlate

Queste funzioni sono comunemente utilizzate insieme a ftp_mkdir() nella gestione delle directory tramite FTP:

• ftp_rmdir() — rimuove una directory dal server FTP.
• ftp_chdir() — cambia la directory di lavoro corrente sul server.
• ftp_pwd() — restituisce il percorso della directory corrente.
• ftp_set_option() — configura opzioni come il timeout della connessione.
• ftp_pasv() — attiva/disattiva la modalità passiva, spesso necessaria dietro i firewall.
• ftp_close() — chiude la connessione FTP al termine delle operazioni.

Pratica