PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Navigateur Internet
  • Erreur de sécurité dans une connexion sécurisée
  • Limite
  • Permissions requises
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Connecte le poste en cours à un serveur FTP (File Transfer Protocol).
Versions 18 et supérieures
WINDEVWEBDEV - Code ServeurWindows Les modes de connexion sécurisés disponibles sont les suivants :
  • FTPS : FTP sécurisé selon le protocole SSL avec chiffrement implicite.
  • FTPES : FTP sécurisé selon le protocole SSL avec chiffrement explicite.
  • SFTP : FTP sécurisé par un tunnel SSH.
Nouveauté 18
WINDEVWEBDEV - Code ServeurWindows Les modes de connexion sécurisés disponibles sont les suivants :
  • FTPS : FTP sécurisé selon le protocole SSL avec chiffrement implicite.
  • FTPES : FTP sécurisé selon le protocole SSL avec chiffrement explicite.
  • SFTP : FTP sécurisé par un tunnel SSH.
WINDEVWEBDEV - Code ServeurWindows Les modes de connexion sécurisés disponibles sont les suivants :
  • FTPS : FTP sécurisé selon le protocole SSL avec chiffrement implicite.
  • FTPES : FTP sécurisé selon le protocole SSL avec chiffrement explicite.
  • SFTP : FTP sécurisé par un tunnel SSH.
WINDEVWEBDEV - Code ServeurWindowsAndroidWidget Android Les modes de connexion sécurisés disponibles sont les suivants :
  • FTPS : FTP sécurisé selon le protocole SSL avec chiffrement implicite.
  • FTPES : FTP sécurisé selon le protocole SSL avec chiffrement explicite.
  • SFTP : FTP sécurisé par un tunnel SSH.
Versions 15 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
Nouveauté 15
Android Cette fonction est désormais disponible pour les applications Android.
Android Cette fonction est désormais disponible pour les applications Android.
Versions 18 et supérieures
Widget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WEBDEV - Code ServeurLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 18
Widget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WEBDEV - Code ServeurLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WEBDEV - Code ServeurLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 22 et supérieures
AndroidWidget Android Les modes de connexion sécurisés FTPS, FTPES et SFTP sont désormais disponibles pour les applications Android et pour les Widgets Android.
Nouveauté 22
AndroidWidget Android Les modes de connexion sécurisés FTPS, FTPES et SFTP sont désormais disponibles pour les applications Android et pour les Widgets Android.
AndroidWidget Android Les modes de connexion sécurisés FTPS, FTPES et SFTP sont désormais disponibles pour les applications Android et pour les Widgets Android.
// Connexion du poste en cours au serveur FTP
ResConnecte = FTPConnecte("192.54.12.8")
Syntaxe
<Résultat> = FTPConnecte(<Serveur> [, <Nom de l'utilisateur> [, <Mot de passe> [, <Numéro de port> [, <Type de connexion> [, <Délai de connexion> [, <Clé privée> [, <Mot de passe de la clé>]]]]]]])
<Résultat> : Entier
  • Identifiant de la connexion,
  • 0 lors de la première connexion.
  • -1 en cas d'erreur. Le compte-rendu détaillé de l'erreur est connu grâce à la fonction ErreurInfo utilisée avec la constante errCode ou errMessage.
    En cas d'erreur d'identification, la fonction ErreurInfo utilisée avec la constante errCode renvoie la constante ftpErreurIdentification.
PHP Ce paramètre est de type Variant et correspond à l'identifiant de la connexion ou -1 en cas d'erreur.
<Serveur> : Chaîne de caractères (avec guillemets)
Nom du serveur FTP (par exemple "ftp.cdrom.com") ou adresse IP du serveur FTP (par exemple "192.54.12.8").
Versions 18 et supérieures
WINDEVWEBDEV - Code ServeurWindows Ce paramètre permet de définir le protocole utilisé :
  • si le nom du serveur commence par "ftp://", la connexion est en mode non sécurisé.
  • si le nom du serveur commence par "ftps://", la connexion est en mode sécurisé selon le protocole FTPS (FTP sécurisé par SSL avec chiffrement implicite).
  • si le nom du serveur commence par "ftpes://", la connexion est en mode sécurisé selon le protocole FTPES (FTP sécurisé par SSL avec chiffrement explicite).
  • si le nom du serveur commence par "sftp://", la connexion est en mode sécurisé par un tunnel SSH selon le protocole SFTP.
Nouveauté 18
WINDEVWEBDEV - Code ServeurWindows Ce paramètre permet de définir le protocole utilisé :
  • si le nom du serveur commence par "ftp://", la connexion est en mode non sécurisé.
  • si le nom du serveur commence par "ftps://", la connexion est en mode sécurisé selon le protocole FTPS (FTP sécurisé par SSL avec chiffrement implicite).
  • si le nom du serveur commence par "ftpes://", la connexion est en mode sécurisé selon le protocole FTPES (FTP sécurisé par SSL avec chiffrement explicite).
  • si le nom du serveur commence par "sftp://", la connexion est en mode sécurisé par un tunnel SSH selon le protocole SFTP.
WINDEVWEBDEV - Code ServeurWindows Ce paramètre permet de définir le protocole utilisé :
  • si le nom du serveur commence par "ftp://", la connexion est en mode non sécurisé.
  • si le nom du serveur commence par "ftps://", la connexion est en mode sécurisé selon le protocole FTPS (FTP sécurisé par SSL avec chiffrement implicite).
  • si le nom du serveur commence par "ftpes://", la connexion est en mode sécurisé selon le protocole FTPES (FTP sécurisé par SSL avec chiffrement explicite).
  • si le nom du serveur commence par "sftp://", la connexion est en mode sécurisé par un tunnel SSH selon le protocole SFTP.
Versions 18 et supérieures
WINDEVWEBDEV - Code ServeurWindowsAndroidWidget Android Ce paramètre permet de définir le protocole utilisé :
  • si le nom du serveur commence par "ftp://", la connexion est en mode non sécurisé.
  • si le nom du serveur commence par "ftps://", la connexion est en mode sécurisé selon le protocole FTPS (FTP sécurisé par SSL avec chiffrement implicite).
  • si le nom du serveur commence par "ftpes://", la connexion est en mode sécurisé selon le protocole FTPES (FTP sécurisé par SSL avec chiffrement explicite).
  • si le nom du serveur commence par "sftp://", la connexion est en mode sécurisé par un tunnel SSH selon le protocole SFTP.
Nouveauté 18
WINDEVWEBDEV - Code ServeurWindowsAndroidWidget Android Ce paramètre permet de définir le protocole utilisé :
  • si le nom du serveur commence par "ftp://", la connexion est en mode non sécurisé.
  • si le nom du serveur commence par "ftps://", la connexion est en mode sécurisé selon le protocole FTPS (FTP sécurisé par SSL avec chiffrement implicite).
  • si le nom du serveur commence par "ftpes://", la connexion est en mode sécurisé selon le protocole FTPES (FTP sécurisé par SSL avec chiffrement explicite).
  • si le nom du serveur commence par "sftp://", la connexion est en mode sécurisé par un tunnel SSH selon le protocole SFTP.
WINDEVWEBDEV - Code ServeurWindowsAndroidWidget Android Ce paramètre permet de définir le protocole utilisé :
  • si le nom du serveur commence par "ftp://", la connexion est en mode non sécurisé.
  • si le nom du serveur commence par "ftps://", la connexion est en mode sécurisé selon le protocole FTPS (FTP sécurisé par SSL avec chiffrement implicite).
  • si le nom du serveur commence par "ftpes://", la connexion est en mode sécurisé selon le protocole FTPES (FTP sécurisé par SSL avec chiffrement explicite).
  • si le nom du serveur commence par "sftp://", la connexion est en mode sécurisé par un tunnel SSH selon le protocole SFTP.
<Nom de l'utilisateur> : Chaîne de caractères optionnelle (avec guillemets)
  • Nom de l'utilisateur qui tente d'effectuer une connexion nominative (identification de l'utilisateur sur le serveur FTP). Ce paramètre est donné par le responsable du site FTP.
  • Chaîne vide ("") pour effectuer une connexion anonyme.
<Mot de passe> : Chaîne de caractères optionnelle (avec guillemets)
Mot de passe de l'utilisateur : permet d'identifier l'utilisateur sur le serveur FTP. Ce paramètre est donné par le responsable du site FTP.
Ce mot de passe correspond :
  • au <Mot de passe> spécifié si ce paramètre est différent d'une chaîne vide (""),
  • à l'adresse email de l'utilisateur si le paramètre <Nom de l'utilisateur> n'est pas spécifié ou est égal à une chaîne vide (""),
  • à une chaîne vide ("") si ce paramètre n'est pas spécifié et si le paramètre <Nom de l'utilisateur> est différent d'une chaîne vide ("").
<Numéro de port> : Entier optionnel
Numéro de port sur lequel le serveur doit être lancé. Ce paramètre est donné par le responsable du site FTP.
Par défaut :
  • pour une connexion non sécurisée, ce port est le port 21.
Versions 18 et supérieures
  • WINDEVWEBDEV - Code ServeurWindows pour une connexion sécurisée en mode FTPS, ce port est le port 990.
  • WINDEVWEBDEV - Code ServeurWindows pour une connexion sécurisée en mode FTPES, ce port est le port 21.
  • WINDEVWEBDEV - Code ServeurWindows pour une connexion sécurisée en mode SFTP, ce port est le port 22.
Nouveauté 18
  • WINDEVWEBDEV - Code ServeurWindows pour une connexion sécurisée en mode FTPS, ce port est le port 990.
  • WINDEVWEBDEV - Code ServeurWindows pour une connexion sécurisée en mode FTPES, ce port est le port 21.
  • WINDEVWEBDEV - Code ServeurWindows pour une connexion sécurisée en mode SFTP, ce port est le port 22.
  • WINDEVWEBDEV - Code ServeurWindows pour une connexion sécurisée en mode FTPS, ce port est le port 990.
  • WINDEVWEBDEV - Code ServeurWindows pour une connexion sécurisée en mode FTPES, ce port est le port 21.
  • WINDEVWEBDEV - Code ServeurWindows pour une connexion sécurisée en mode SFTP, ce port est le port 22.
  • WINDEVWEBDEV - Code ServeurWindowsAndroidWidget Android pour une connexion sécurisée en mode FTPS, ce port est le port 990.
  • WINDEVWEBDEV - Code ServeurWindowsAndroidWidget Android pour une connexion sécurisée en mode FTPES, ce port est le port 21.
  • WINDEVWEBDEV - Code ServeurWindowsAndroidWidget Android pour une connexion sécurisée en mode SFTP, ce port est le port 22.
<Type de connexion> : Constante optionnelle de type Entier
Type de connexion à effectuer :
  • Vrai (par défaut) pour une connexion passive au serveur FTP. Lors d'un transfert de fichiers, c'est le serveur qui prend l'initiative du transfert. Ce type de connexion permet de franchir certains "firewalls".
  • Faux pour une connexion active au serveur FTP. Lors d'un transfert de fichiers, c'est le client qui prend l'initiative du transfert. Ce type de connexion peut être refusé par certains serveurs FTP protégés.
Type de connexion à effectuer :
Versions 21 et supérieures
ftpModeActif
Nouveauté 21
ftpModeActif
ftpModeActif (ou Faux par compatibilité)
Connexion active au serveur FTP.
Lors d'un transfert de fichiers, c'est le client qui prend l'initiative du transfert. Ce type de connexion peut être refusé par certains serveurs FTP protégés.
Versions 21 et supérieures
ftpModePassif
Nouveauté 21
ftpModePassif
ftpModePassif (ou Vrai par compatibilité)
(Valeur par défaut)
Connexion passive au serveur FTP (mode PASV).
Lors d'un transfert de fichiers, c'est le serveur qui prend l'initiative du transfert. Ce type de connexion permet de franchir certains "firewalls".
Remarque : Si la connexion au serveur est en IPV6, alors la connexion se fera en mode passif étendu (car le mode passif ne supporte pas IPV6).
Versions 21 et supérieures
ftpModePassifEtendu
Nouveauté 21
ftpModePassifEtendu
ftpModePassifEtendu
Connexion passive étendue au serveur FTP (mode EPSV).
Lors d'un transfert de fichiers, c'est le serveur qui prend l'initiative du transfert. Ce type de connexion permet de franchir certains "firewalls".
Si le serveur ne supporte pas le mode passif étendu (la commande FEAT est envoyée au serveur pour connaître la capacité), la connexion est dégradée en mode passif simple.
Limitations :
  • Ce mode n’est pas supporté lors de l'utilisation du module "wininet" de Windows (voir fonction FTPParamètre) : la connexion est réalisée en mode ftpModePassif.
  • AndroidWidget AndroidJava Constante non disponible.
  • Windows MobilePHP Cette constante est identique à la constante ftpModePassif.
<Délai de connexion> : Entier optionnel ou Durée optionnelle
Nombre de secondes au bout desquelles la requête de connexion au serveur FTP est abandonnée (par défaut 20). Ce délai s'applique à toutes les opérations FTP réalisées sur cette connexion. Si aucune réponse du serveur n'est obtenue dans le <Délai de connexion> spécifié, la fonction FTPConnecte retourne -1.
Remarque : Ce paramètre peut correspondre à :
  • un entier correspondant au nombre de secondes,
  • une variable de type Durée,
  • Versions 23 et supérieures
    l'indication directe de la durée (par exemple 1 s).
    Nouveauté 23
    l'indication directe de la durée (par exemple 1 s).
    l'indication directe de la durée (par exemple 1 s).
PHP Ce paramètre correspond à un entier.
<Clé privée> : Chaîne de caractères optionnelle (avec guillemets)
Versions 18 et supérieures
WINDEVWEBDEV - Code ServeurWindows Nom et chemin du fichier correspondant à la clé privée utilisée lors d'une connexion en mode SFTP. Ce fichier doit avoir été généré au format OpenSSH.
Si ce paramètre n'est pas spécifié, la connexion sécurisée utilise une authentification par <Nom de l'utilisateur> / <Mot de passe>.
Nouveauté 18
WINDEVWEBDEV - Code ServeurWindows Nom et chemin du fichier correspondant à la clé privée utilisée lors d'une connexion en mode SFTP. Ce fichier doit avoir été généré au format OpenSSH.
Si ce paramètre n'est pas spécifié, la connexion sécurisée utilise une authentification par <Nom de l'utilisateur> / <Mot de passe>.
WINDEVWEBDEV - Code ServeurWindows Nom et chemin du fichier correspondant à la clé privée utilisée lors d'une connexion en mode SFTP. Ce fichier doit avoir été généré au format OpenSSH.
Si ce paramètre n'est pas spécifié, la connexion sécurisée utilise une authentification par <Nom de l'utilisateur> / <Mot de passe>.
WINDEVWEBDEV - Code ServeurWindowsAndroidWidget Android Nom et chemin du fichier correspondant à la clé privée utilisée lors d'une connexion en mode SFTP. Ce fichier doit avoir été généré au format OpenSSH.
Si ce paramètre n'est pas spécifié, la connexion sécurisée utilise une authentification par <Nom de l'utilisateur> / <Mot de passe>.
<Mot de passe de la clé> : Chaîne de caractères ANSI optionnelle (avec guillemets)
Versions 18 et supérieures
WINDEVWEBDEV - Code ServeurWindows Mot de passe du fichier contenant la clé privé utilisée lors d'une connexion en mode SFTP. Si ce paramètre n'est pas spécifié, la connexion sécurisée utilise une authentification par <Nom de l'utilisateur> / <Mot de passe>.
Nouveauté 18
WINDEVWEBDEV - Code ServeurWindows Mot de passe du fichier contenant la clé privé utilisée lors d'une connexion en mode SFTP. Si ce paramètre n'est pas spécifié, la connexion sécurisée utilise une authentification par <Nom de l'utilisateur> / <Mot de passe>.
WINDEVWEBDEV - Code ServeurWindows Mot de passe du fichier contenant la clé privé utilisée lors d'une connexion en mode SFTP. Si ce paramètre n'est pas spécifié, la connexion sécurisée utilise une authentification par <Nom de l'utilisateur> / <Mot de passe>.
WINDEVWEBDEV - Code ServeurWindowsAndroidWidget Android Mot de passe du fichier contenant la clé privé utilisée lors d'une connexion en mode SFTP. Si ce paramètre n'est pas spécifié, la connexion sécurisée utilise une authentification par <Nom de l'utilisateur> / <Mot de passe>.
Remarques
WINDEVWEBDEV - Code ServeurWINDEV MobileEtats et RequêtesWindowsWindows MobileAjaxCode Utilisateur (MCU)

Navigateur Internet

La fonction FTPConnecte nécessite l'installation d'Internet Explorer version 3 ou supérieure.
Les modifications du paramètre <Délai de connexion> n'ont pas d'effet pour certaines versions d'Internet Explorer. Il s'agit d'un problème des composants Microsoft connu et corrigé dans les versions les plus récentes d'Internet Explorer (version 5.1 et supérieure).
Versions 18 et supérieures
WINDEVWEBDEV - Code ServeurWindowsLinux

Erreur de sécurité dans une connexion sécurisée

Lors d'une connexion sécurisée, certaines erreurs de sécurité peuvent faire échouer la fonction :
  • certificat invalide ou ne provenant pas d'une société connue.
  • nom du site figurant dans le certificat ne correspondant pas à un serveur.
  • date du certificat non-valide ou expiré.
Il est possible de se connecter en ignorant ces erreurs. Pour cela, il suffit d'utiliser la variable FTP.IgnoreErreur :
Valeur de FTP.IgnoreErreur
(ces valeurs peuvent être combinées)
Description
ftpIgnoreCertificatInvalideLe certificat est ignoré.
ftpIgnoreCertificatExpiréLa date du certificat est ignorée.
ftpIgnoreNomCertificatInvalideLe nom du site figurant dans le certificat est ignoré.
ftpIgnoreRévocationLa révocation du certificat est ignorée.
// Exemple de gestion des erreurs

xnum est un entier
FTP.IgnoreErreur = ftpIgnoreCertificatExpiré + ftpIgnoreCertificatInvalide + ...
ftpIgnoreNomCertificatInvalide + ftpIgnoreRévocation
xnum = FTPConnecte("ftpes://Mon_Ip_Server", "Mon_User", "Mon_Password", 21, Vrai)
SI xnum =-1  ALORS
      Info(ErreurInfo(errMessage))
SINON
      Info("OK")
FIN
Nouveauté 18
WINDEVWEBDEV - Code ServeurWindowsLinux

Erreur de sécurité dans une connexion sécurisée

Lors d'une connexion sécurisée, certaines erreurs de sécurité peuvent faire échouer la fonction :
  • certificat invalide ou ne provenant pas d'une société connue.
  • nom du site figurant dans le certificat ne correspondant pas à un serveur.
  • date du certificat non-valide ou expiré.
Il est possible de se connecter en ignorant ces erreurs. Pour cela, il suffit d'utiliser la variable FTP.IgnoreErreur :
Valeur de FTP.IgnoreErreur
(ces valeurs peuvent être combinées)
Description
ftpIgnoreCertificatInvalideLe certificat est ignoré.
ftpIgnoreCertificatExpiréLa date du certificat est ignorée.
ftpIgnoreNomCertificatInvalideLe nom du site figurant dans le certificat est ignoré.
ftpIgnoreRévocationLa révocation du certificat est ignorée.
// Exemple de gestion des erreurs

xnum est un entier
FTP.IgnoreErreur = ftpIgnoreCertificatExpiré + ftpIgnoreCertificatInvalide + ...
ftpIgnoreNomCertificatInvalide + ftpIgnoreRévocation
xnum = FTPConnecte("ftpes://Mon_Ip_Server", "Mon_User", "Mon_Password", 21, Vrai)
SI xnum =-1  ALORS
      Info(ErreurInfo(errMessage))
SINON
      Info("OK")
FIN
WINDEVWEBDEV - Code ServeurWindowsLinux

Erreur de sécurité dans une connexion sécurisée

Lors d'une connexion sécurisée, certaines erreurs de sécurité peuvent faire échouer la fonction :
  • certificat invalide ou ne provenant pas d'une société connue.
  • nom du site figurant dans le certificat ne correspondant pas à un serveur.
  • date du certificat non-valide ou expiré.
Il est possible de se connecter en ignorant ces erreurs. Pour cela, il suffit d'utiliser la variable FTP.IgnoreErreur :
Valeur de FTP.IgnoreErreur
(ces valeurs peuvent être combinées)
Description
ftpIgnoreCertificatInvalideLe certificat est ignoré.
ftpIgnoreCertificatExpiréLa date du certificat est ignorée.
ftpIgnoreNomCertificatInvalideLe nom du site figurant dans le certificat est ignoré.
ftpIgnoreRévocationLa révocation du certificat est ignorée.
// Exemple de gestion des erreurs

xnum est un entier
FTP.IgnoreErreur = ftpIgnoreCertificatExpiré + ftpIgnoreCertificatInvalide + ...
ftpIgnoreNomCertificatInvalide + ftpIgnoreRévocation
xnum = FTPConnecte("ftpes://Mon_Ip_Server", "Mon_User", "Mon_Password", 21, Vrai)
SI xnum =-1  ALORS
      Info(ErreurInfo(errMessage))
SINON
      Info("OK")
FIN
AndroidWidget Android

Limite

L'utilisation des protocoles sécurisés (sFTP, FTPS, ...) est disponible uniquement sur des appareils avec des processeurs ARM. Si cette fonction est utilisée sur des appareils avec des processeurs non ARM (x86, mips, ...), une erreur fatale sera déclenchée.
AndroidWidget Android

Permissions requises

L’utilisation de cette fonction entraîne la modification des permissions requises par l’application.
Permission requise : INTERNET
Cette permission autorise l’application à ouvrir des sockets réseau.
Liste des exemples associés :
Les fonctions FTP Exemples unitaires (WEBDEV) : Les fonctions FTP
[ + ] Utilisation des principales fonctions FTP de WEBDEV pour :
- Se connecter à un serveur FTP
- Lister les fichiers et les répertoires présents sur le serveur FTP
- Récupérer des fichiers présents sur le serveur FTP
- Se déconnecter d'un serveur FTP
WD Transfert de fichiers par FTP Exemples complets (WINDEV) : WD Transfert de fichiers par FTP
[ + ] WD Transfert de fichiers par FTP

Cet exemple est un client FTP complet vous permettant de mémoriser plusieurs serveurs FTP. Vous pouvez alors effectuer des transferts multi-fichiers du poste local vers le serveur ou du serveur FTP vers le poste local. On utilise pour cela les fonctions standards du WLangage (FTPConnecte, etc...)
Composantes
WINDEVWEBDEV - Code ServeurEtats et Requêtes wd230com.dll
Windows Mobile wp230com.dll
Java wd230java.jar
Linux wd230com.so
Android wd230android.jar
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire