La fonction get_spip_doc permet à SPIP de s’assurer d’avoir toujours le bon chemin vers un fichier, qu’il soit en absolu avec une URL complète, ou venant de SPIP (normalement du dossier IMG). Cette fonction est appelée presque à chaque fois que SPIP doit afficher un document, image ou autre.
Le pipeline get_spip_doc, quant à lui, permet d’effectuer des modifications sur le chemin avant qu’il soit retourné par la fonction éponyme. Cela permet d’effectuer des traitements sur le fichier en question, ou de le remplacer par un autre chemin, par exemple si on détecte que le fichier n’existe plus.
Il est appelé dans ecrire/inc/documents.php :
$fichier = pipeline('get_spip_doc', ['args' => ['fichier' => $fichier_demande], 'data' => $fichier]);