DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Communication / Fonctions FTP
  • Fonction FTPProxy et protocole SOCKS5
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
Autres
Procédures stockées
Spécifie si les fonctions de communication utilisant le protocole FTP doivent ou non passer par un proxy pour exécuter leurs requêtes.
Cette fonction est prise en compte uniquement au prochain appel d'une fonction utilisant le protocole FTP.
Attention :
  • Cette fonction s'applique uniquement au protocole FTP (et non FTPIS/FTPES/SFTP).
  • En Linux, Android et iOS, cette fonction est disponible uniquement pour l'utilisation du protocole SOCKS5 (constante ftpProxySOCKS5).
Exemple
// Définit le proxy FTP
FTPProxy(ftpProxyUtilisateurRegroupé, "test", 2121, "test", "test")

// Ouvre la connexion
IDConnexion est un entier
IDConnexion = FTPConnecte("montest.doc.com", "test", "test", 21, Vrai, 20)
SI IDConnexion = -1 ALORS
	Erreur(ErreurInfo(errComplet))
SINON
	...
FIN
Syntaxe
FTPProxy(<Type du proxy> [, <Adresse du proxy> [, <Port du proxy> [, <Login> [, <Mot de passe>]]]])
<Type du proxy> : Constante de type Entier
Type du proxy FTP à utiliser :
ftpProxyAucunPermet d'annuler l'utilisation du proxy FTP.
ftpProxyOpenProxy FTP nécessitant la commande "OPEN".
Les instructions envoyées sont les suivantes :
  • USER avec le login Proxy
  • PASS avec le mot de passe Proxy
  • OPEN de la forme @<Adresse du serveur FTP>:<Port du serveur FTP>
  • USER avec le login FTP
  • PASS avec le mot de passe FTP
LinuxAndroidWidget AndroidiPhone/iPad Cette constante n'est pas disponible.
ftpProxySiteProxy FTP nécessitant la commande "SITE".
Les instructions envoyées sont les suivantes :
  • USER avec le login Proxy
  • PASS avec le mot de passe Proxy
  • SITE de la forme @<Adresse du serveur FTP>:<Port du serveur FTP>
  • USER avec le login FTP
  • PASS avec le mot de passe FTP
LinuxAndroidWidget AndroidiPhone/iPad Cette constante n'est pas disponible.
ftpProxySOCKS5Proxy FTP utilisant le protocole SOCKS5.
ftpProxyUtilisateurRegroupéProxy FTP nécessitant la commande "USER" avec l'utilisateur et le mot de passe.
Les instructions envoyées sont les suivantes :
  • USER de la forme <Login proxy>:<Login FTP>@<Adresse du serveur FTP>:<Port du serveur FTP>
  • PASS de la forme <Mot de passe proxy>:<Mot de passe FTP>
LinuxAndroidWidget AndroidiPhone/iPad Cette constante n'est pas disponible.
ftpProxyUtilisateurSéparéProxy FTP nécessitant la commande "USER" et la commande "PASS" séparée.
Les instructions envoyées sont les suivantes :
  • USER avec le login Proxy
  • PASS avec le mot de passe Proxy
  • USER de la forme <Login FTP>@<Adresse du serveur FTP>:<Port du serveur FTP>
  • PASS avec le mot de passe FTP
LinuxAndroidWidget AndroidiPhone/iPad Cette constante n'est pas disponible.
<Adresse du proxy> : Chaîne de caractères optionnelle
Adresse du proxy FTP, donnée sous la forme :
  • adresse IP au format XXX.XXX.XXX.XXX (par exemple 125.5.110.100).
  • URL contenant le nom du serveur (par exemple www.pcsoft.fr). Cette syntaxe est conseillée.
  • adresse IP obtenue par la fonction NetAdresseIP.
<Port du proxy> : Entier optionnel
Numéro de port du proxy FTP. Si ce paramètre n'est pas précisé, le paramètre vaut 21.
<Login> : Chaîne de caractères optionnelle
Authentification auprès du proxy FTP. Si ce paramètre correspond à une chaîne vide ("", valeur par défaut), aucune authentification n'est effectuée.
<Mot de passe> : Chaîne de caractères optionnelle ou Chaîne secrète
Mot de passe pour authentification auprès du proxy. Si le <Login> correspond à une chaîne vide (""), ce paramètre est ignoré.
Nouveauté 2025
Utilisation de chaînes secrètes : Si vous utilisez le coffre-fort de chaînes secrètes, le type de la chaîne secrète utilisable pour ce paramètre doit être "Chaîne Ansi ou Unicode".
Pour plus de détails sur les chaînes secrètes et l'utilisation du coffre-fort, consultez Coffre-fort de chaînes secrètes.
AndroidWidget Android Les chaînes secrètes ne sont pas disponibles pour ce paramètre en Android/Android Widget.
Remarques

Fonction FTPProxy et protocole SOCKS5

Pour utiliser le protocole SOCKS5 avec la fonction FTPProxy, il est nécessaire d'utiliser la constante ftpProxySOCKS5 pour préciser le type du proxy à utiliser.
ATTENTION :
  • Un proxy SOCKS5 ne peut pas être utilisé si le protocole FTP est configuré pour utiliser Wininet (mode de gestion utilisant Internet Explorer). Ce mode de gestion est paramétré grâce à la constante httpParamètreMode de la fonction FTPParamètre. L'utilisation de la fonction FTPProxy provoquera alors une erreur fatale.
  • Un proxy SOCKS5 peut être utilisé uniquement avec les protocoles FTP et SFTP. Si un proxy SOCKS5 est configuré, l'utilisation de la fonction FTPConnecte sur un serveur via FTPES ou FTPIS provoquera une erreur fatale.
Exemple :
// On ne doit pas utiliser wininet pour avoir accès au proxy SOCKS5
FTPParamètre(ftpParamètreMode, 1)
// Les fonctions FTP utiliseront le proxy SOCKS5 
// à l'adresse 172.12.2.79:1080 avec les identifiants USER:PWD 
FTPProxy(ftpProxySOCKS5, "172.12.2.79",1080, "USER", "PWD")
// On se connecte au serveur FTP de test de rebex
nIDFTP est entier = FTPConnecte("ftp://test.rebex.net/", "demo", "password", 21)
SI nIDFTP = -1 ALORS
	Erreur(ErreurInfo(errComplet))
SINON
	Info("OK")
FIN
FTPDéconnecte(nIDFTP)
// On enlève le proxy
FTPProxy(ftpProxyAucun)
Classification Métier / UI : Code métier
Composante : wd300com.dll
Version minimum requise
  • Version 16
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 13/11/2024

Signaler une erreur ou faire une suggestion | Aide en ligne locale