sql_fetch

La fonction sql_fetch() retourne une ligne, sous forme d’un tableau associatif, d’un résultat d’une sélection. Elle retourne false s’il n’y a plus de ligne à afficher.

Elle admet 3 paramètres, seul le premier est indispensable :

  1. $res est la ressource obtenue avec sql_select(),
  2. $serveur,
  3. $option.

Elle s’utilise en partenariat étroit avec sql_select(), souvent employé dans cette association :

if ($res = sql_select('colonne', 'table')) {
	while ($r = sql_fetch($res)) {
		// utilisation des resultats avec $r['colonne']
	}
}

Exemple

Lister les articles proposés à publication :

$result = sql_select("id_article, id_rubrique, titre, statut", "spip_articles", "statut = 'prop'", "", "date DESC");
while ($row = sql_fetch($result)) {
	$id_article=$row['id_article'];
	if (autoriser('voir', 'article', $id_article)) {
		// actions
	}
}

Le plugin « Contact avancé » peut enregistrer des messages dans la table spip_messages. Au moment de la suppression d’un de ces messages, il supprime les éventuels documents qui lui sont liés comme ceci :

function action_supprimer_message() {
	$securiser_action = charger_fonction('securiser_action', 'inc');
	$id_message = $securiser_action();
	// Verifions si nous avons un document 
	if ($docs = sql_select('id_document', 'spip_documents_liens', 'id_objet=' . intval($id_message) . ' AND objet="message"')) {
		include_spip('action/documenter');
		while ($id_doc = sql_fetch($docs)) {
			supprimer_lien_document($id_doc['id_document'], "message", $id_message);
		}
	}
	sql_delete("spip_messages", "id_message=" . sql_quote($id_message));
	sql_delete("spip_auteurs_messages", "id_message=" . sql_quote($id_message));
}

La fonction calculer_rubriques_publiees() dans ecrire/inc/rubriques.php permet de recalculer les statuts et dates de rubriques pour savoir lesquelles ont le statut « publié ». Dedans, une partie sélectionne les rubriques qui ont des documents publiés (la rubrique l’est alors aussi) et attribue à une colonne temporaire le nouveau statut et la nouvelle date. Une fois toutes les mises à jour faites, la colonne temporaire est enregistrée dans la véritable colonne :

// Mettre les compteurs a zero
sql_updateq('spip_rubriques', array(
	'date_tmp' => '0000-00-00 00:00:00', 
	'statut_tmp' => 'prive'));
// [...]
// Publier et dater les rubriques qui ont un *document* publie
$r = sql_select(
	array(
		"rub.id_rubrique AS id", 
		"max(fille.date) AS date_h"), 
	array(
		"spip_rubriques AS rub", 
		"spip_documents AS fille", 
		"spip_documents_liens AS lien"), 
	array(
		"rub.id_rubrique = lien.id_objet",
		"lien.objet='rubrique'",
		"lien.id_document=fille.id_document",
		"rub.date_tmp <= fille.date",
		"fille.mode='document'", "rub.id_rubrique"));
while ($row = sql_fetch($r)) {
	  sql_updateq('spip_rubriques', 
		array(
			'statut_tmp'=>'publie',
			'date_tmp'=>$row['date_h']),
		"id_rubrique=" . $row['id']);
}
// [...]
// Enregistrement des modifs
sql_update('spip_rubriques', array(
	'date'=>'date_tmp', 
	'statut'=>'statut_tmp'));

Auteur Matthieu Marcillaud Publié le : Mis à jour : 10/05/10

Traductions : English, français