Français
Français
Pdostatement :: ColumnCount () est une méthode dans l'objet Pdostatement qui renvoie des valeurs entières liées au nombre de colonnes dans l'ensemble de résultats. Le prototype est le suivant:
public PDOStatement::columnCount(): int
Après avoir exécuté une requête SQL (en particulier l'instruction SELECT ), vous pouvez appeler cette méthode pour obtenir le nombre de colonnes incluses dans le jeu de résultats.
Jetons un coup d'œil à l'exemple le plus simple:
<?php
$pdo = new PDO('mysql:host=localhost;dbname=test', 'user', 'password');
$stmt = $pdo->query('SELECT id, name, email FROM users');
$columnCount = $stmt->columnCount();
echo "Le nombre de colonnes est: " . $columnCount;
?>
Une fois le code ci-dessus exécuté, la sortie sera:
Le nombre de colonnes est: 3
Cela montre que les résultats de la requête contiennent trois champs: ID , nom et e-mail .
Un malentendu commun est d'essayer d'appeler ColumnCount () après que la requête n'a pas été exécutée ou effectué une requête de jeu non-resulte (tel que insérer , mettre à jour , supprimer ). Ceci est incorrect:
<?php
$stmt = $pdo->prepare('SELECT id, name FROM users WHERE id = :id');
// Non exécuté -> columnCount Possible de revenir 0 ou une valeur incorrecte
echo $stmt->columnCount(); // Généralement 0
?>
Pour vous assurer que la valeur de retour est exacte, vous devez toujours appeler après l'exécution de la requête et que l'ensemble de résultats est obtenu:
$stmt->execute([':id' => 1]);
echo $stmt->columnCount(); // Renvoie correctement le nombre de colonnes
Supposons que vous construisez un outil de navigateur de table de base de données commun, et que vous devez générer dynamiquement la ligne de titre de la table HTML en fonction des résultats de la requête. Vous pouvez utiliser ColumnCount () et getColumnMeta () pour le terminer:
<?php
$stmt = $pdo->query('SELECT * FROM users');
$colCount = $stmt->columnCount();
echo "<table border='1'><tr>";
for ($i = 0; $i < $colCount; $i++) {
$meta = $stmt->getColumnMeta($i);
echo "<th>" . htmlspecialchars($meta['name']) . "</th>";
}
echo "</tr>";
?>
Cela générera automatiquement un en-tête correspondant au résultat de la requête.
De nombreux débutants confondrent RowCount () et ColumnCount () . La différence entre les deux est la suivante:
ColumnCount () : Obtenez le nombre de colonnes dans le résultat de la requête.
RowCount () : obtient le nombre de lignes affectées, mais n'est pas toujours fiable dans certaines requêtes.
Pour obtenir le nombre de lignes renvoyées par une requête sélectionnée , vous devez utiliser fetchall () ou le nombre de résultats de résultats de traversée.
Le comportement de ColumnCount () est fondamentalement cohérent entre les bases de données, mais certains pilotes (tels que les anciennes versions de SQLite ou de certains pilotes ODBC) peuvent retourner 0 avant l'exécution. Par conséquent, pour obtenir des valeurs précises, les règles suivantes doivent être suivies:
Assurez-vous d'exécuter () ou quey () est exécuté;
Utiliser des pilotes compatibles avec des métadonnées;
N'appelez pas cette méthode dans une déclaration sans résultat.
Si vous développez une API REST et que vous souhaitez retourner les informations sur le champ de chaque enregistrement, vous pouvez utiliser ColumnCount () pour générer automatiquement une liste de champs, par exemple:
<?php
$stmt = $pdo->query('SELECT * FROM users');
$columns = [];
for ($i = 0; $i < $stmt->columnCount(); $i++) {
$meta = $stmt->getColumnMeta($i);
$columns[] = $meta['name'];
}
header('Content-Type: application/json');
echo json_encode([
'columns' => $columns,
'data' => $stmt->fetchAll(PDO::FETCH_ASSOC)
]);
?>
Cela est particulièrement pratique lors de la construction d'interfaces comme https://gitbox.net/api/v1/table/users .
