ftp_nb_get
(PHP 4 >= 4.3.0, PHP 5, PHP 7)
ftp_nb_get — Lit un fichier sur un serveur FTP, et l'écrit dans un fichier (non bloquant)
Description
$ftp_stream
, string $local_file
, string $remote_file
[, int $mode = FTP_IMAGE
[, int $resumepos = 0
]] ) : int
ftp_nb_get() lit le fichier remote_file
présent sur le serveur FTP ftp_stream et le sauvegarde
dans un fichier local.
La différence entre cette fonction et ftp_fget() est que cette fonction peut lire le fichier de manière asynchrone, afin que votre programme fasse autre chose pendant que le fichier est téléchargé.
Liste de paramètres
-
ftp_stream -
L'identifiant du lien de connexion FTP.
-
local_file -
Le chemin vers le fichier local (sera écrasé si le fichier existe déjà).
-
remote_file -
Le chemin vers le fichier distant.
-
mode -
Le mode de transfert. Doit être soit
FTP_ASCIIouFTP_BINARY. -
resumepos -
La position dans le fichier distant à partir de laquelle le téléchargement doit commencer.
Historique
| Version | Description |
|---|---|
| 7.3.0 |
Le paramètre mode est maintenant optionel. Précédemment il
était obligatoire.
|
Exemples
Exemple #1 Exemple avec ftp_nb_get()
<?php
// Initialise le téléchargement
$ret = ftp_nb_get($my_connection, "test", "README", FTP_BINARY);
while ($ret == FTP_MOREDATA) {
// Faites ce que vous voulez...
echo ".";
// Continue le téléchargement...
$ret = ftp_nb_continue($my_connection);
}
if ($ret != FTP_FINISHED) {
echo "Il y a eu un problème lors du téléchargement...";
exit(1);
}
?>
Exemple #2 Reprise d'un téléchargement avec ftp_nb_get()
<?php
// Initialise
$ret = ftp_nb_get($my_connection, "test", "README", FTP_BINARY,
filesize("test"));
// Ou : $ret = ftp_nb_get($my_connection, "test", "README",
// FTP_BINARY, FTP_AUTORESUME);
while ($ret == FTP_MOREDATA) {
// Faites ce que vous voulez...
echo ".";
// Continue le téléchargement...
$ret = ftp_nb_continue($my_connection);
}
if ($ret != FTP_FINISHED) {
echo "Il y a eu un problème lors du téléchargement du fichier...";
exit(1);
}
?>
Exemple #3 Reprise d'un téléchargement à la position 100 dans un nouveau fichier avec ftp_nb_get()
<?php
// Désactive l'Autoseek
ftp_set_option($my_connection, FTP_AUTOSEEK, false);
// Initialisation
$ret = ftp_nb_get($my_connection, "newfile", "README", FTP_BINARY, 100);
while ($ret == FTP_MOREDATA) {
/* ... */
// Continue le téléchargement...
$ret = ftp_nb_continue($my_connection);
}
?>
Dans l'exemple ci-dessus, newfile est 100
octets plus petit que README sur le site FTP, car
nous avons commencé à lire à l'offset 100. Si nous n'avions pas
désactivé l'option FTP_AUTOSEEK, les premiers
100 octets du fichier newfile seraient complétés
avec '\0'.
Voir aussi
- ftp_nb_fget() - Lit un fichier sur un serveur FTP, et l'écrit dans un fichier (non bloquant)
- ftp_nb_continue() - Reprend le téléchargement d'un fichier (non bloquant)
- ftp_fget() - Télécharge un fichier via FTP dans un fichier local
- ftp_get() - Télécharge un fichier depuis un serveur FTP
Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-function.ftp-nb-get.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.
