# ftp_fput

(PHP 4, PHP 5, PHP 7, PHP 8)

ftp_fput — Téléverse un fichier sur un serveur FTP

### Description

ftp_fput(
FTP\Connection `$ftp`,
string `$remote_filename`,
resource `$stream`,
int `$mode` = `FTP_BINARY`,
int `$offset` = 0
): bool

ftp_fput() charge les données issues du fichier identifié par `stream` jusqu'à la fin du fichier.

### Liste de paramètres

`ftp`

  Une instance de FTP\Connection.

`remote_filename`

  Le chemin vers le fichier distant.

`stream`

  Un pointeur de fichier ouvert sur le fichier local. La lecture s'arrête à la fin du fichier.

`mode`

  Le mode de transfert. Doit être soit `FTP_ASCII`, soit `FTP_BINARY`.

`offset`

  La position dans le fichier distant à partir de laquelle le téléchargement commencera.

### Valeurs de retour

Cette fonction retourne `true` en cas de succès ou `false` si une erreur survient.

### Historique

Version | Description
--- | ---
8.1.0 | La paramètre `ftp` attend désormais une instance de FTP\Connection ; auparavant, une resource était attendu.
7.3.0 | Le paramètre `mode` est maintenant optionnel. Précédemment il était obligatoire.

### Exemples

Exemple #1 Exemple avec ftp_fput()

`<?php
// Ouverture de quelques fichiers pour lecture
$file = 'somefile.txt';
$fp = fopen($file, 'r');
// Mise en place d'une connexion basique
$ftp = ftp_connect($ftp_server);
// Identification avec un nom d'utilisateur et un mot de passe
$login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);
// Tente de charger le fichier $file
if (ftp_fput($ftp, $file, $fp, FTP_ASCII)) {
echo "Chargement avec succès du fichier $file\n";
} else {
echo "Il y a eu un problème lors du chargement du fichier $file\n";
}
// Fermeture de la connexion et du pointeur de fichier
ftp_close($ftp);
fclose($fp);
?>`

### Voir aussi

- ftp_put() - Charge un fichier sur un serveur FTP
- ftp_nb_fput() - Écrit un fichier sur un serveur FTP, et le lit depuis un fichier (non bloquant)
- ftp_nb_put() - Envoie un fichier sur un serveur FTP (non-bloquant)