array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.ftp-set-option.php', 1 => 'ftp_set_option', 2 => 'Modifie les options de la connexion FTP', ), 'up' => array ( 0 => 'ref.ftp.php', 1 => 'Fonctions FTP', ), 'prev' => array ( 0 => 'function.ftp-rmdir.php', 1 => 'ftp_rmdir', ), 'next' => array ( 0 => 'function.ftp-site.php', 1 => 'ftp_site', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/ftp/functions/ftp-set-option.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

ftp_set_option

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

ftp_set_option — Modifie les options de la connexion FTP

Description

ftp_set_option(FTP\Connection $ftp, int $option, int|bool $value): true

ftp_set_option() contrôle diverses options pour une connexion FTP spécifiée.

Liste de paramètres

ftp

Une instance de FTP\Connection.

option

Actuellement, les options suivantes sont supportées :
Options FTP supportées
FTP_TIMEOUT_SEC Modifie le délai de connexion en secondes utilisé pour toutes les fonctions réseau. value doit être un entier plus grand que 0. Le délai de connexion par défaut est de 90 secondes.
FTP_AUTOSEEK Lorsqu'actif, les requêtes GET ou PUT avec un paramètre resumepos ou startpos se positionneront d'abord à la position désirée dans le fichier. Ceci est actif par défaut.
FTP_USEPASVADDRESS Lorsqu'il est désactivé, PHP ignore l'adresse IP retournée par le serveur FTP en réponse à la commande PASV et utilise plutôt l'adresse IP fournie dans le ftp_connect(). value doit être une valeur booléenne.

value

Ce paramètre dépend de l'option option que l'on veut modifier.

Valeurs de retour

Retourne toujours true.

Erreurs / Exceptions

Une ValueError est lancée si le paramètre option n'est pas supporté. Une TypeError est lancée si la value passée ne correspond pas au type attendu pour le paramètre option donné.

Historique

Version Description
8.5.0 Le type de retour est désormais true ; auparavant, c'était bool.
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_set_option()

<?php
// Définition du délai de connexion à 10 secondes
ftp_set_option($ftp, FTP_TIMEOUT_SEC, 10);
?>

Voir aussi