phpQuery - v1.0.0

 

Introduction

phpQuery est une class permettant de simplifier le développement de site web. Il regroupe une trentaine de fonctions pour gérer une ou plusieurs base de données ou des fichiers.

phpQuery nécessite la version 7.0 minimum de PHP pour fonctionner et est distribuée sous licence MIT.

phpQuery - v1.0.0IntroductionExemple d'applicationInstancier la classopen() close()query()assoc()select() insert()update()delete()pagination()chmod()getContent()getTypeMime() getFileInfo() load() library() scandir() secure() is_md5() data2Csv() string2url() random() get() post() sort() download() redirect() session() dateInterval() imageResize() console()

Exemple d'application

Instancier la class

En prenant comme référence une variable que l'on va nommer $root

Pour créer une liaison entre la class et votre BDD :

Pour créer une liaison entre la class et votre serveur FTP :

Si vous souhaitez travailler avec plusieurs BDD :

A noter qu'il est possible de définir les accès directement dans la class (ligne 31 et 39)

 

open()

Ouvrir une connexion SQL (si elle existe déjà elle sera récupéré) :

Ici $link est facultatif mais peut-être utilisé pour des opérations de requêtes en dehors de la class

 

close()

Fermer une connexion SQL :

Libère la variable $link

 

query()

Pour exécuter une requête select sur la base de données :

Dans le cas d'un seul résultat la fonction retourne un tableau associatif

Dans le cas de plusieurs résultats la fonction retourne un tableau associatif à 2 dimensions

L'ouverture et la fermeture de la connexion SQL est gérée par la fonction mais ne prend en charge que les requêtes select, insert, update et delete

Dans le cas d'une requête insert le numéro d'enregistrement est retourné

 

assoc()

Récupèrer un tableau associatif à partir de 2 champs d'une même table :

L'ouverture et la fermeture de la connexion SQL sont prises en charge par la fonction

 

select()

Exécuter une requête select à partir d'un tableau associatif et retourne le résultat de la requête dans un deuxième tableau associatif

L'ouverture et la fermeture de la connexion SQL sont prises en charge par la fonction

Pour des opérations de sélection plus complexe utilisez la fonction query()

 

insert()

Exécuter une requête insert à partir d'un tableau associatif

L'ouverture et la fermeture de la connexion SQL sont prises en charge par la fonction

Pour des opérations d'enregistrement plus complexe utilisez la fonction query()

 

update()

Exécuter une requête update à partir d'un tableau associatif

L'ouverture et la fermeture de la connexion SQL sont prises en charge par la fonction

Pour des opérations de mise à jour plus complexe utilisez la fonction query()

 

delete()

Exécuter une requête delete à partir d'un tableau associatif

L'ouverture et la fermeture de la connexion SQL sont prises en charge par la fonction

Pour des opérations de suppression plus complexe utilisez la fonction query()

 

pagination()

Génère un système de pagination à partir d'une requête select et retourne le résultat dans un tableau associatif. Le système de pagination est affiché sous la forme d'une liste à puce.

Exemple d'application adapatable suivant vos besoins :

Exemple de rendu de la structure html

Exemple de rendu css pour la mise en forme de la pagination

 

chmod()

Modifier les permissions d'un fichier ou d'un dossier à partir d'une connexion FTP

Les permissions par défaut sont paramétrable depuis la class (ligne 50 et 51)

 

getContent()

Récupérer le contenu d'un fichier local ou d'une url distante dans une variable de type string

 

getTypeMime()

Récupèrer le type mime d'un fichier local dans une variable de type string

 

getFileInfo()

Récupèrer les propriétés d'un fichier local dans un tableau associatif

La taille du fichier (size) est exprimé en octet

 

load()

Charger un ensemble de fichiers

Charger un ensemble de fichiers avec un tableau associatif passé en paramètre

Dans l'exemple ci-dessus les informations du tableau associatif sont convertis en variable et accessible uniquement dans le fichier form.php

Si unset = true dans load() le tableau associatif sera supprimé

 

library()

Charger en mémoire un ou plusieurs fichiers php

Si un fichier a déjà été chargé PHP ne l'inclura pas une deuxième fois

 

scandir()

Récupèrer une liste de fichier

Récupèrer une liste de fichier mais filtrer avec l'extension "php"

Récupèrer les infos détaillées de chaque fichier mais filtrer avec l'extension "html"

Pour filtrer sur plusieurs extensions : 'php,html,gif'

 

secure()

Sécuriser des données à partir d'une variable de type chaine ou tableau multidimensionnel. A utiliser dans le cas ou vous souhaitez transmettre les données dans une requête SQL.

Si la variable est une chaine la fonction retournera une chaine, si c'est un tableau la fonction retournera un tableau en respectant l'ordre des clés

 

is_md5()

Vérifier si une chaine de caractère correspond au format MD5

 

data2Csv()

Formater les données d'un tableau associatif à 2 dimensions en chaine CSV

 

string2url()

Transformer une chaine de caracères à destination d'une URL référençable

 

random()

Génèrer une clé aléatoire

 

get()

Filtrer la variable $_GET en omettant certains arguments. Peut être combiné avec la fonction secure()

 

post()

Filtrer la variable $_POST en omettant certains champs. Peut être combiné avec la fonction secure().

 

sort()

Trier un tableau associatif par clé. Peut être combiné avec la fonction select().

 

download()

Télécharger un fichier local ou à partir d'une variable

Le type mime et le format d'encodage du fichier de sortie peuvent être définit depuis la fonction

Si le nom du fichier n'est pas définit la date du jour au format "YYYMMDD" est utilisé

 

redirect()

Redirection vers un fichier, un dossier ou une url distante

 

session()

Gestion de session par cookie avec clé d'identification. Peut-être combiné avec la fonction is_md5()

La fonction gère les même propriétés que setcookies() et retourne la clé crypté en MD5

La fonction peut-être utilisé en complément d'une table "session" pour stocker la clé MD5 et permettre l'identification de l'utilisateur connecté

 

dateInterval()

Récupèrer une plage de dâte à partir d'une date de début et de fin

Détermine si "2019-03-02" existe entre le "2019-02-28" et le "2019-03-05"

Formater une plage de dâte à partir d'une date de début et de fin

La fonction gère par défaut les dates au format "Y-m-d"

 

imageResize()

Redimensionner une image en proportion.

Exemple d'application adapatable suivant vos besoins :

La fonction gère les formats d'image GIF, JPG, PNG et créer une image en fonction de l'extension définit dans le fichier de destination.

 

console()

Console de débogage.

Affiche des informations à propos d'une variable, de manière à ce qu'elle soit clairement lisible.

La console peut-être appelé aussi depuis fonction query()