Le fichier stand.php est une bibliothèque PHP complète pour faciliter la gestion des bases de données et des sessions. Voici une documentation détaillée des fonctionnalités disponibles dans ce fichier.
Important
Télécharger d'abord le fichier et incluez le dans votre projet.
require_once 'stand.php';La fonction ConnDB() permet d'établir une connexion à la base de données en supportant à la fois MySQLi et PDO.
$variable = ConnDB('host', 'username', 'password', 'database', 'connType');host: Adresse de l'hôte de la base de donnéesusername: Nom d'utilisateurpassword: Mot de passedatabase: Nom de la base de donnéesconnType: Type de connexion ('mysqli' ou 'PDO', par défaut 'PDO')
$conn = ConnDB('localhost', 'root', '', 'contacts', 'mysqli');La fonction Query() exécute une requête SQL personnalisée avec des paramètres.
syntaxe:
$variable = Query("requete", [parametres], $conn);requete: Requete SQLparametres: Parametres d'une requete$conn: Variable de connexion à la base de données
exemple:
$results = Query("SELECT * FROM contacts WHERE id = ?", [1], $connexion);exemple avec plus d'un paramètre:
$results = Query("SELECT * FROM contacts WHERE id = ? and nom = ?", [1,'uwizeyimana'], $connexion);
if ($results) {
foreach ($results as $row) {
echo "ID: " . $row['id'] . " - Name: " . $row['nom'] . "<br>";
}
} else {
echo "Aucun résultat trouvé.";
}La fonction Insert()permet d'inserer des données dans la bse de données.
syntaxe:
$variable = Insert('table', [data], $conn);table: Nom de la tabledata: Tableau associatif des données à insérer (clé => valeur).$conn: Variable de connexion à la base de données
exemple:
$userId = Insert('users', [
'username' => 'emmadiblo',
'email' => 'emmadiblo@gmail.com',
'password' => HashPassword('secure_password')
], $conn);exemple:
// Sélectionner plusieurs lignes
$users = Select('users', $conn, ['status' => 'active'], 'id, username, email', 'username ASC', 10, 0);
// Sélectionner une seule ligne
$user = SelectOne('users', $conn, ['id' => 123]);exemple:
// Mettre à jour avec condition
$affected = Update('users',
['status' => 'inactive'],
['id' => 123],
$conn
);
// Mettre à jour toutes les lignes
$affected = UpdateAll('users', ['status' => 'pending'], $conn);exemple:
// Supprimer avec condition
$affected = Delete('users', ['id' => 123], $conn);
// Supprimer toutes les lignes (avec confirmation obligatoire)
$affected = DeleteAll('users', $conn, true);exemple:
BeginTransaction($conn);
try {
// Opérations sur la base de données...
CommitTransaction($conn);
} catch (Exception $e) {
RollbackTransaction($conn);
// Gestion de l'erreur...
}exemple:
$result = Paginate('articles', $conn, 2, 10, ['status' => 'published']);
// $result contient 'data' (les articles) et 'pagination' (informations sur la pagination)
$articles = $result['data'];
$pagination = $result['pagination'];exemple:
if (Exists('users', ['email' => 'john@example.com'], $conn)) {
// L'utilisateur existe déjà
}exemple:
$count = Count('users', $conn, ['status' => 'active']);exemple:
$results = SearchLike('users',
['username' => 'john', 'email' => 'example'],
$conn,
'id, username, email',
'OR'
);exemple:
$id = Upsert('users',
['email' => 'john@example.com', 'username' => 'john_doe', 'last_login' => date('Y-m-d H:i:s')],
['email'],
$conn
);exemple:
$result = InsertOrUpdate('users',
['email' => 'john@example.com', 'username' => 'john_doe', 'status' => 'active'],
null,
$conn
);exemple:
// Initialiser une session sécurisée
InitSession([
'cookie_lifetime' => 86400, // 24 heures
'cookie_secure' => true
]);
// Régénérer l'ID de session
RegenerateSessionId();
// Détruire la session
DestroySession();exemple:
// Définir une valeur
SetSession('user_id', 123);
// Récupérer une valeur
$userId = GetSession('user_id');
// Vérifier si une clé existe
if (HasSession('user_id')) {
// La clé existe
}
// Supprimer une valeur
RemoveSession('user_id');
// Vider la session
ClearSession();exemple:
// Définir un message flash
SetFlash('success', 'Votre profil a été mis à jour avec succès.');
// Vérifier s'il y a des messages flash
if (HasFlash()) {
// Il y a des messages flash
}
// Récupérer et supprimer les messages flash
$flashMessages = GetFlash();
foreach ($flashMessages as $flash) {
echo '<div class="alert alert-' . $flash['type'] . '">' . $flash['message'] . '</div>';
}exemple:
$cleanData = Sanitize($_POST);exemple:
// Dans le formulaire
$token = GenerateCsrfToken('user_form');
echo '<input type="hidden" name="csrf_token" value="' . $token . '">';
// Lors de la soumission du formulaire
if (ValidateCsrfToken($_POST['csrf_token'], 'user_form')) {
// Token valide, traiter le formulaire
} else {
// Token invalide
}
// Nettoyer les jetons expirés
CleanExpiredCsrfTokens();exemple:
// Hacher un mot de passe
$hashedPassword = HashPassword('secure_password');
// Vérifier un mot de passe
if (VerifyPassword('password_to_check', $hashedPassword)) {
// Mot de passe correct
}
// Vérifier si un rehachage est nécessaire
if (PasswordNeedsRehash($hashedPassword)) {
$newHash = HashPassword('secure_password');
// Mettre à jour le hash dans la base de données
}exemple:
// Générer un UUID
$uuid = GenerateUUID();
// Générer un jeton d'accès
$accessToken = GenerateAccessToken(64);Cette bibliothèque offre un ensemble complet de fonctions pour simplifier le développement d'applications PHP en fournissant des abstractions pour les opérations courantes de base de données et de gestion des sessions, tout en intégrant les bonnes pratiques de sécurité.