ecrire/action/editer_objet.php ➔ objet_lire()

Complexity

Conditions	20
Paths	7440

Size

Total Lines

96

Duplication

Lines	0
Ratio	0 %

Importance

Changes

0

<?php
function objet_lire($objet, $valeur_id, $options = array()) {

	// Initialisation du tableau des descriptions et des id d'objet (au sens id_xxx).
	// Les tableaux sont toujours indexés par l'objet et l'id objet.
	static $descriptions = array();
	static $ids = array();

	// On détermine le nom du champ id de la table.
	include_spip('base/objets');
	$table_id = id_table_objet($objet);

	// On détermine l'id à utiliser.
	$champ_id = !empty($options['champ_id']) ? $options['champ_id'] : $table_id;

	// On détermine si on a passé l'id objet ou un autre identifiant unique de la table :
	if ($champ_id != $table_id) {
		// on a passé un identifiant différent que l'id de l'objet, on cherche si cet objet a déjà été rencontré
		// car dans ce cas on a déjà stocké son id objet.
		$index = isset($ids[$objet][$valeur_id]) ? $ids[$objet][$valeur_id] : 0;
	} else {
		$index = $valeur_id;
	}

	// On vérifie si l'objet demandé n'est pas déjà stocké : si oui, la description sera utilisée sauf si on a forcé
	// la lecture en base.
	if (isset($descriptions[$objet][$index])) {
		$description = $descriptions[$objet][$index];
	} else {
		$description = array();
	}

	// Si l'objet n'a pas encore été stocké, il faut récupérer sa description complète.
	if (!$description) {
		// Il est possible pour un type d'objet de fournir une fonction de lecture de tous les champs d'un objet.
		if (
			include_spip('action/editer_' . $objet)
			and function_exists($lire = "${objet}_lire_champs")
		) {
			$description = $lire($objet, $valeur_id, $champ_id);
		} else {
			// On récupère la table SQL à partir du type d'objet.
			$table = table_objet_sql($objet);

			// La condition est appliquée sur le champ désigné par l'utilisateur. Si ce champ n'est pas l'id objet
			// on considère qu'il est de type chaine.
			$where = ($champ_id != $table_id)
				? array("${champ_id}=" . sql_quote($valeur_id))
				: array("${champ_id}=" . intval($valeur_id));

			// Acquisition de tous les champs de l'objet : si l'accès SQL retourne une erreur on renvoie un tableau vide.
			if (!$description = sql_fetsel('*', $table, $where)) {
				$description = array();
			}
		}

		// On stocke systématiquement la description à l'index correspondant à l'objet et l'id objet.
		if (!$index) {
			// Première sauvegarde de l'objet qui est forcément lu via un champ qui n'est pas l'id objet.
			// Il faut donc stocker l'index pour un futur appel si la description est non vide.
			if ($description) {
				$index = $description[$table_id];
				$ids[$objet][$valeur_id] = $index;
			}
		}

		// Si l'index a bien été déterminé, on stocke la description à cet index.
		if ($index) {
			$descriptions[$objet][$index] = $description;
		}
	}

	// On ne retourne maintenant que les champs demandés.
	// - on détermine les informations à renvoyer.
	$informations = !empty($options['informations']) ? $options['informations'] : '';
	if ($description and $informations) {
		// Extraction des seules informations demandées.
		// -- si on demande une information unique on renvoie la valeur simple, sinon on renvoie un tableau.
		// -- si une information n'est pas un champ valide elle n'est pas renvoyée sans renvoyer d'erreur.
		if (is_array($informations)) {
			if (count($informations) == 1) {
				// Tableau d'une seule information : on revient à une chaine unique.
				$informations = array_shift($informations);
			} else {
				// Tableau des informations valides
				$description = array_intersect_key($description, array_flip($informations));
			}
		}

		if (is_string($informations)) {
			// Valeur unique demandée.
			$description = isset($description[$informations]) ? $description[$informations] : '';
		}
	}

	return $description;
}