PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version : 19.0

WinDevWebDev - Code ServeurWebDev - Code NavigateurWinDev MobileEtats et RequêtesWindowsLinuxWindows MobileWindows PhoneWindows Store appsAndroidWidget AndroidiPhone/iPadJavaPHPAjaxCode Utilisateur (MCU)Langage ExterneHFSQLHFSQL Client/ServeurProcédures stockéesHyper File 5.5OLE DBODBCAccès Natifs
UploadCopieFichier (Fonction)
En anglais : UploadCopyFile

Enregistre sur le serveur un fichier "uploadé" par l'internaute. Cet upload a pu être effectuée :
  • via un champ de saisie de type "Upload".
  • Versions 15 et supérieures
    via un champ Upload mono ou multi-fichiers.
    Nouveauté 15
    via un champ Upload mono ou multi-fichiers.
    via un champ Upload mono ou multi-fichiers.
Lors de cet enregistrement, il est possible de renommer le fichier copié sur le serveur.

Versions 15 et supérieures
PHP Cette fonction est désormais disponible pour les sites PHP.
Nouveauté 15
PHP Cette fonction est désormais disponible pour les sites PHP.
PHP Cette fonction est désormais disponible pour les sites PHP.
Versions 17 et supérieures
Ajax Cette fonction est disponible en Ajax uniquement pour les nouveaux champs Upload mono ou multi-fichiers.
Nouveauté 17
Ajax Cette fonction est disponible en Ajax uniquement pour les nouveaux champs Upload mono ou multi-fichiers.
Ajax Cette fonction est disponible en Ajax uniquement pour les nouveaux champs Upload mono ou multi-fichiers.
// Récupération du fichier envoyé par le client
refFic est une chaîne
refFic = UploadCopieFichier(SAI_File, "C:\Documents", "REF_3304")
// Si le fichier source est : "/User/Truc.jpg"
// refFic = "REF_3304.jpg" et le fichier a été copié dans "C:\documents\REF_3304.jpg"

// Upload réalisé à partir d'un champ Upload multi-fichiers
// Pour chaque fichier envoyé
POUR i = 1 _A_ UPL_Upload..Occurrence
        // Copie le fichier dans le répertoire des données
        UploadCopieFichier(UPL_Upload, fRepDonnées(), "",  i)        
FIN

Syntaxe
<Résultat> = UploadCopieFichier(<Nom du champ> , <Chemin sur le serveur> , <Nom du fichier> [, <Indice du fichier>])
<Résultat> : Chaîne de caractères
  • Nom (nom + extension) du fichier uploadé sur le serveur (ne contient pas le chemin du fichier)
  • Chaîne vide ("") en cas d'erreur.
<Nom du champ> : Chaîne de caractères (avec ou sans guillemets)
Nom du champ manipulé. Ce champ peut correspondre :
  • à champ de saisie de type "Upload". Ce champ contient le nom et le chemin du fichier à envoyer sur le serveur.
    Remarque : il est possible d'utiliser l'attribut d'une zone répétée (propriété Valeur pour l'attribut).
  • à un champ Upload mono-fichier ou multi-fichiers.
<Chemin sur le serveur> : Chaîne de caractères (avec guillemets)
Chemin du répertoire du serveur où le fichier doit être copié. Ce chemin peut par exemple correspondre au chemin renvoyé par la fonction fRepDonnées. Ce chemin peut également correspondre à fRepEnCours, mais les hébergeurs donnent rarement les droits pour écrire dans ce répertoire.

Linux Ce paramètre n'est pas pris en compte. Le fichier est uploadé dans le répertoire "/tmp" du serveur Linux. Ce répertoire est non modifiable.
<Nom du fichier> : Chaîne de caractères (avec guillemets)
Nom du fichier (nom et extension) uploadé sur le serveur. Si le fichier existe déjà, il est automatiquement écrasé.

Si ce paramètre correspond à :

  • une chaîne vide ("") : le nom du fichier sur le serveur sera identique au nom du fichier sur le poste de l'internaute.
  • uniquement le nom du fichier (sans l'extension), l'extension du fichier sur le serveur sera identique à l'extension du fichier sur le poste de l'internaute.
  • le nom du fichier et l'extension du fichier, ce nom et cette extension seront utilisés pour la copie du fichier sur le serveur.
<Indice du fichier> : Entier optionnel
Versions 15 et supérieures
Indice du fichier à enregistrer sur le serveur. Ce paramètre est utilisé uniquement dans le cas d'un upload réalisé avec le champ Upload multi-fichiers. Par défaut, cet indice correspond à 1.
Nouveauté 15
Indice du fichier à enregistrer sur le serveur. Ce paramètre est utilisé uniquement dans le cas d'un upload réalisé avec le champ Upload multi-fichiers. Par défaut, cet indice correspond à 1.
Indice du fichier à enregistrer sur le serveur. Ce paramètre est utilisé uniquement dans le cas d'un upload réalisé avec le champ Upload multi-fichiers. Par défaut, cet indice correspond à 1.

Remarques

Taille maximale des fichiers à uploader

Par défaut, la taille des fichiers à uploader est illimitée dans le moteur WebDev. Cette taille peut être limitée :
  • par le serveur Web utilisé. Pour plus de détails, consultez la documentation du serveur Web utilisé.
  • par le serveur d'application WebDev.
Si le fichier à uploader dépasse la taille limite, le fichier n'est pas uploadé.

Pour modifier la taille maximale des fichiers à uploader dans le serveur d'application WebDev, il est nécessaire de modifier la base de registres sur le serveur :

  1. Pour modifier la taille des fichiers uploadés pour toutes les applications WebDev 19, sélectionnez la clé : HKEY_LOCAL_MACHINE\SOFTWARE\PC SOFT\WEBDEV\19.0
  2. Ajoutez la chaîne MAX_UPLOAD. Cette chaîne aura pour valeur la taille maximale des fichiers à uploader (en Ko).

PHP Limites en PHP :
  • La taille des fichiers uploadés est limitée par la directive "upload_max_filesize" dans le fichier de configuration de PHP (fichier php.ini).
  • L'upload de fichiers doit être autorisé par le serveur PHP. Pour cela, la directive "file_uploads" doit être à "on" dans le fichier de configuration de PHP (fichier php.ini).
  • La directive upload_tmp_dir du fichier de configuration doit être renseignée vers un répertoire qui possède les droits en lecture/écriture.

Nom du fichier uploadé

La fonction UploadNomFichier permet de connaître le nom d'un fichier "uploadé".

Composantes
WebDev - Code Serveur wd190page.dll
Linux wd190page.so
Version minimum requise
  • Version 9
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire