Aller au contenu

ftp_raw()

Comprendre la fonction PHP ftp_raw()

La fonction ftp_raw() est une fonction intégrée à PHP qui envoie une commande arbitraire à un serveur FTP. Dans cet article, nous examinerons cette fonction en détail et vous fournirons un guide complet pour l'utiliser dans vos projets PHP.

Qu'est-ce que ftp_raw() ?

La fonction prend deux paramètres :

  1. ftp_stream : L'identifiant de connexion renvoyé par la fonction ftp_connect().
  2. command : La commande à envoyer au serveur FTP.

La fonction renvoie un tableau de chaînes de caractères, avec une chaîne par ligne de réponse, contenant la réponse du serveur à la commande en cas de succès. Sinon, elle renvoie false.

Remarque : Pour la plupart des cas d'utilisation, les fonctions FTP de plus haut niveau (telles que ftp_nlist() ou ftp_get()) sont plus sûres et plus faciles à utiliser que les commandes brutes.

Syntaxe de ftp_raw()

La syntaxe de la fonction ftp_raw() est la suivante :

Syntaxe de ftp_raw()

php
array ftp_raw ( resource $ftp_stream , string $command )

La fonction ftp_raw() prend deux paramètres obligatoires, ftp_stream et command. Le paramètre ftp_stream est l'identifiant de connexion renvoyé par la fonction ftp_connect(), et le paramètre command est la commande à envoyer au serveur FTP.

Utilisation de ftp_raw()

Pour utiliser la fonction ftp_raw(), vous devez d'abord établir une connexion au serveur FTP à l'aide de la fonction ftp_connect(). Voici un exemple :

Utilisation de ftp_raw()

php
<?php

// Set up an FTP connection
$conn = ftp_connect('ftp.example.com');
if (!$conn) {
    die("Could not connect to FTP server.\n");
}

// Login with your FTP credentials
if (!ftp_login($conn, 'username', 'password')) {
    die("Login failed.\n");
}

// Send a raw command to the FTP server
$response = ftp_raw($conn, 'SYST');

// Output the server's response to the command
echo "Server response: " . implode("\n", $response) . "\n";

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

Dans cet exemple, nous établissons une connexion au serveur FTP à l'aide de la fonction ftp_connect() et vérifions qu'elle a réussi. Ensuite, nous nous connectons avec nos identifiants FTP à l'aide de la fonction ftp_login() et vérifions le succès. Nous envoyons une commande brute au serveur FTP à l'aide de la fonction ftp_raw() et affichons la réponse du serveur dans la console. Enfin, nous fermons la connexion FTP à l'aide de la fonction ftp_close().

Gestion des erreurs dans ftp_raw()

Il est important de gérer correctement les erreurs lors de l'utilisation de la fonction ftp_raw(). Si la fonction renvoie false, cela signifie que l'opération a échoué. Voici un exemple de gestion des erreurs :

Gestion des erreurs dans ftp_raw()

php
<?php

$response = ftp_raw($conn, 'SYST');

if (!$response) {
    echo "Failed to send raw command to FTP server.\n";
}

ftp_close($conn);

En gérant correctement les erreurs et en vérifiant la valeur de retour de la fonction, vous pouvez garantir le succès de vos opérations FTP à l'aide de la fonction ftp_raw().

Conclusion

En conclusion, la fonction ftp_raw() est un outil utile pour envoyer des commandes arbitraires à un serveur FTP. Avec une utilisation appropriée et une gestion des erreurs, cette fonction peut s'avérer précieuse dans vos projets PHP.

Pratique

Que fait la fonction FTP_RAW() en PHP ?

Trouvez-vous cela utile?

Aperçu dual-run — comparez avec les routes Symfony en production.