array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.ftp-alloc.php', 1 => 'ftp_alloc', 2 => 'Alloue de l\'espace pour un téléchargement de fichier', ), 'up' => array ( 0 => 'ref.ftp.php', 1 => 'Fonctions FTP', ), 'prev' => array ( 0 => 'ref.ftp.php', 1 => 'Fonctions FTP', ), 'next' => array ( 0 => 'function.ftp-append.php', 1 => 'ftp_append', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/ftp/functions/ftp-alloc.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

ftp_alloc

(PHP 5, PHP 7, PHP 8)

ftp_alloc — Alloue de l'espace pour un téléchargement de fichier

Description

ftp_alloc(FTP\Connection $ftp, int $size, string &$response = null): bool

ftp_alloc() envoie la commande FTP ALLO pour allouer un espace sur le serveur FTP de size octets.

Note:

De nombreux serveurs FTP ne supportent pas cette commande. Ces serveurs peuvent retourner un code d'erreur (false) qui indique que la commande n'est pas supportée, ou (true) pour dire que la préallocation n'est pas nécessaire : le client continue alors ses opérations de la même façon. À cause de cela, il est préférable de n'utiliser cette fonction qu'avec les serveurs qui requièrent spécifiquement cette fonction.

Liste de paramètres

ftp

Une instance de FTP\Connection.

size

Le nombre d'octets à allouer.

response

Une représentation textuelle de la réponse du serveur qui sera retournée par référence dans response si une variable est fournie.

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.

Exemples

Exemple #1 Exemple avec ftp_alloc()

<?php

$file = "/home/user/myfile";

// Connexion au serveur
$ftp = ftp_connect('ftp.example.com');
$login_result = ftp_login($ftp, 'anonymous', 'user@example.com');

if (ftp_alloc($ftp, filesize($file), $result)) {
echo "Espace alloué avec succès sur le serveur. Envoi de $file.\n";
ftp_put($ftp, '/incoming/myfile', $file, FTP_BINARY);
} else {
echo "Impossible d'allouer l'espace sur le serveur. Réponse du serveur : $result\n";
}

ftp_close($ftp);

?>

Voir aussi