DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer en PHP
  • Présentation
  • Manipuler des fichiers de données MySQL, Oracle ou PostgreSQL
  • Pour manipuler des fichiers de données MySQL, Oracle ou PostgreSQL en PHP avec les fonctions HFSQL :
  • Remarques
  • Les fonctions suivantes sont actuellement disponibles en PHP :
  • Manipuler des fichiers de données via ODBC
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Présentation
WEBDEV permet de créer un site PHP manipulant des fichiers de données :
  • au format MySQL. Ces données peuvent être manipulées avec les fonctions SQL du WLangage ou avec les fonctions HFSQL du WLangage. Une base de données MySQL est nécessaire.
  • via ODBC. Ces données peuvent être manipulées avec les fonctions SQL du WLangage. Il est possible par exemple de manipuler une source de données au format HFSQL Classic ou HFSQL Client/Serveur définie dans l'administrateur ODBC.
  • au format PostgreSQL. Ces données peuvent être manipulées avec les fonctions SQL du WLangage ou avec les fonctions HFSQL du WLangage. Une base de données PostgreSQL est nécessaire et l'extension php_pgsql doit être activée dans le fichier php.ini.
  • au format Oracle. Ces données peuvent être manipulées avec les fonctions SQL du WLangage ou avec les fonctions HFSQL du WLangage. Une base de données Oracle est nécessaire, l'extension php_oci8 doit être activée dans le fichier php.ini et la couche cliente Oracle doit être présente sur le serveur.
Remarque : Pré-requis :
  • Serveurs PHP 5 : Version minimale conseillée : version 5.6.
  • Serveurs PHP 7 : Version minimale conseillée : version 7.0.22.
  • Serveurs PHP 8 : Version minimale conseillée : version 8.0.10.
Manipuler des fichiers de données MySQL, Oracle ou PostgreSQL

Pour manipuler des fichiers de données MySQL, Oracle ou PostgreSQL en PHP avec les fonctions HFSQL :

Les fichiers de données décrits dans l'analyse du projet doivent être du type correspondant à la base ciblée. La connexion au serveur est décrite dans l'analyse.
Si cette condition est remplie, les fichiers de données peuvent être manipulés directement par les fonctions HFSQL disponibles en PHP.
Les champs Table fichier créés sous l'éditeur sont alors directement reliées aux fichiers de données décrits sous l'éditeur d'analyses.

Remarques

  • L'utilisation des fonctions HFSQL sur des requêtes avec l'accès PHP/MySQL nécessite un serveur MySQL en version 4.1 ou supérieure.
  • Lors des parcours sur requête (fonctions HLitPremier/HLitSuivant par exemple), il peut arriver que la requête soit ré-exécutée plusieurs fois.
  • Les noms des fichiers et des rubriques de la base de données ne doivent contenir ni caractères accentués, ni espaces.
  • Utilisation de requêtes paramétrées : Si le code SQL de la requête n'a pas été intégralement généré par l'éditeur de requêtes, le nom des paramètres de la requête doit être de la forme {paramX} où X est le numéro du paramètre dans l'ordre d'apparition dans la requête.
    Exemple : SELECT Nom, Prenom FROM Client WHERE Nom={Param1} AND Prenom={Param2}

Les fonctions suivantes sont actuellement disponibles en PHP :

EcranVersFichierInitialise automatiquement :
  • la valeur mémoire des rubriques d'un fichier de données avec la valeur des champs de la fenêtre.
  • la valeur des variables WLangage avec la valeur des champs de la fenêtre.
Cette fonction est également disponible pour les pages WEBDEV.
FichierVersEcranInitialise automatiquement les champs d'une fenêtre ou d'une page avec :
  • les valeurs des rubriques associées dans l'enregistrement en cours (chargé en mémoire) du fichier de données décrit sous l'éditeur d'analyses.
  • les valeurs des variables WLangage associées.
Cette opération est effectuée quel que soit l'état des champs (grisés, inactifs, ou invisibles).
FichierVersPageInitialise automatiquement les champs d'une page avec :
  • les valeurs des rubriques associées dans l'enregistrement en cours (chargé en mémoire) du fichier de données décrit sous l'éditeur d'analyses. Cette opération est effectuée quel que soit l'état des champs (grisés, inactifs, ou invisibles).
  • les valeurs des variables WLangage associées. Cette opération est effectuée quel que soit l'état des champs (grisés, inactifs, ou invisibles).
HActiveFiltreActive le filtre précédemment créé pour le fichier de données (la vue ou la requête) spécifié.
HAjouteAjoute :
  • l'enregistrement présent en mémoire dans le fichier de données (la requête ou la vue).
  • l'enregistrement présent dans une variable de type Enregistrement dans le fichier de données (la requête ou la vue).
HAnnuleDéclarationPermet de :
HAnnuleRechercheAnnule le critère de recherche en cours.
HAttacheMémoPermet d'associer un fichier à une rubrique de type mémo binaire ou d'annuler l'attachement existant entre un fichier et une rubrique binaire.
HAvanceAvance de plusieurs enregistrements dans le fichier de données, à partir de la position en cours, selon une rubrique spécifiée.
HChangeConnexionChange dynamiquement la connexion associée à un fichier de données.
HConstruitValCléConstruit la valeur d'une clé composée pour réaliser un filtre (fonction HFiltre) ou effectuer une recherche (fonctions HLitRecherchePremier, HLitRechercheDernier, ...).
HCréationCrée à vide un fichier de données (fichier d'extension ".FIC") avec le fichier d'index et le fichier mémo si nécessaires.
HCréationSiInexistantEffectue les opérations suivantes :
  • Si le fichier n'existe pas, crée à vide un fichier de données (fichier d'extension ".FIC") avec le fichier d'index et le fichier mémo si nécessaire.La fonction est équivalente à HCréation.
  • Si le fichier existe, ouvre le fichier.
HDécritConnexionDécrit une nouvelle connexion à une base de données externe.
HDésactiveFiltreDésactive temporairement un filtre sur un fichier de données (une vue ou une requête).
HEnDehorsPermet de savoir si l'enregistrement sur lequel on veut se positionner est en dehors du fichier de données, du filtre, de la vue ou de la requête.
HErreurRenvoie le numéro de la dernière erreur déclenchée par le moteur HFSQL.
HErreurDoublonPermet de vérifier si une erreur de doublons est survenue.
HErreurInfoRenvoie une information détaillée sur la dernière erreur déclenchée par le moteur HFSQL.
HExécuteRequêteDéclare une requête créée sous l'éditeur de requêtes au moteur HFSQL et exécute cette requête.
HExécuteRequêteSQLInitialise une requête écrite en langage SQL et déclare cette requête au moteur HFSQL.
HExtraitMémoExtrait le contenu d'une rubrique de type mémo binaire d'un fichier HFSQL, d'une requête ou d'une vue HFSQL dans un fichier physique (sur le disque).
HFermeFerme soit un fichier de données, soit tous les fichiers de données ouverts par l'utilisateur en cours : tous les fichiers de données physiques correspondant sont fermés pour l'utilisateur en cours.
HFermeConnexionFerme une connexion à une base de données.
HFiltreDéfinit et active un filtre sur un fichier de données, une vue ou une requête.
HFiltreCommenceParDéfinit et active un filtre de type "Commence par" sur un fichier, une vue ou une requête.
HFiltreIdentiqueDéfinit et active un filtre permettant de rechercher la valeur exacte d'une rubrique de type chaîne.
HLibèrePositionSupprime une position sauvegardée par la fonction HSauvePosition.
HListeBaseDeDonnéesListe les bases de données Client/Serveur associées à une connexion.
HListeConnexionRenvoie la liste des connexions actuellement décrites dans l'application.
HLitDernierPositionne sur le dernier enregistrement d'un fichier selon une rubrique de parcours.
HLitPrécédentPositionne sur l'enregistrement précédent d'un fichier en fonction d'une rubrique de parcours.
HLitPremierPositionne sur le premier enregistrement d'un fichier en fonction d'une rubrique de parcours.
HLitRecherchePositionne sur le premier enregistrement du fichier dont la valeur d'une rubrique spécifique est supérieure ou égale à une valeur recherchée (recherche générique).
HLitRechercheDernierPositionne sur le dernier enregistrement du fichier dont la valeur d'une rubrique spécifique est inférieure ou égale à une valeur recherchée (recherche à l'identique).
HLitRecherchePremierPositionne sur le premier enregistrement du fichier dont la valeur d'une rubrique spécifique est strictement égale à une valeur recherchée (recherche à l'identique).
HLitSuivantPositionne sur l'enregistrement suivant d'un fichier de données en fonction d'une rubrique de parcours.
HModifieModifie l'enregistrement spécifié ou l'enregistrement présent en mémoire dans le fichier de données (la requête ou la vue).
HNbEnrRenvoie le nombre d'enregistrements d'un fichier, d'une requête ou d'une vue HFSQL : enregistrements actifs, rayés, supprimés, etc.
HOuvreOuvre un fichier de données.
HOuvreConnexionOuvre une connexion à une base de données spécifique.
HPositionCouranteRenvoie la position approximative de l'enregistrement en cours dans le fichier de données.
HRAZInitialise :
  • une ou toutes les variables des rubriques d'un fichier de données avec leurs valeurs par défaut.
  • une ou toutes les rubriques d'une variable de type Enregistrement avec leurs valeurs par défaut.
HReculeRecule de plusieurs enregistrements dans le fichier de données, à partir de la position en cours, selon une rubrique spécifiée.
HRetourPositionRestaure le contexte précédemment sauvegardé d'un fichier (fonction HSauvePosition) : enregistrement en cours, filtre, pointeurs de lecture.
HSauvePositionMémorise le contexte en cours d'un fichier : enregistrement en cours, filtre, pointeurs de lecture.
HSupprimeSupprime un enregistrement d'un fichier de données (d'une requête ou d'une vue).
HTrouveVérifie si l'enregistrement en cours correspond au filtre ou à la recherche en cours.
Manipuler des fichiers de données via ODBC
Pour manipuler des fichiers de données via ODBC :
  1. Définissez une source de données ODBC.
    Pour créer par exemple une source de données sur des fichiers HFSQL Classic ou Client/Serveur, consultez Driver ODBC sur HFSQL Classic et Client/Serveur.
    Remarque : Pour utiliser les fonctions SQL en PHP, il est nécessaire de définir une source de données ODBC "système" et non "utilisateur".
  2. Utilisez la fonction SQLConnecte pour vous connecter à la base de données. Dans ce cas, le type de la base est "ODBC".
  3. Utilisez les fonctions SQL pour manipuler vos données.
Version minimum requise
  • Version 10
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

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