Subversion Repositories eFlore/Applications.cel

Rev

Rev 2486 | Rev 2657 | Go to most recent revision | Blame | Compare with Previous | Last modification | View Log | RSS feed

<?php
// declare(encoding='UTF-8');
/**
 * Service d'import de données d'observation du CEL au format XLS
 *
 * Sont define()'d commme n° de colonne tous les abbrevs retournés par
 * FormateurGroupeColonne::nomEnsembleVersListeColonnes() préfixés par C_  cf: detectionEntete()
 *
 * Exemple d'un test:
 * $ GET "/jrest/ExportXLS/22506?format=csv&range=*&limite=13" \
 *   | curl -F "upload=@-" -F utilisateur=22506 "/jrest/ImportXLS"
 * # 13 observations importées
 * + cf MySQL general_log = 1
 *
 * @internal   Mininum PHP version : 5.2
 * @category   CEL
 * @package    Services
 * @subpackage Observations
 * @version    0.1
 * @author     Mathias CHOUET <mathias@tela-botanica.org>
 * @author     Raphaël DROZ <raphael@tela-botanica.org>
 * @author     Jean-Pascal MILCENT <jpm@tela-botanica.org>
 * @author     Aurelien PERONNET <aurelien@tela-botanica.org>
 * @license    GPL v3 <http://www.gnu.org/licenses/gpl.txt>
 * @license    CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
 * @copyright  1999-2014 Tela Botanica <accueil@tela-botanica.org>
 */
set_include_path(get_include_path() . PATH_SEPARATOR . dirname(dirname(realpath(__FILE__))) . '/lib');
// TERM
error_reporting(-1);
ini_set('html_errors', 0);
ini_set('xdebug.cli_color', 2);
date_default_timezone_set('Europe/Paris');
require_once 'lib/PHPExcel/Classes/PHPExcel.php';

// nombre d'INSERT à cumuler par requête SQL
// (= nombre de lignes XLS à bufferiser)
//define('NB_LIRE_LIGNE_SIMUL', 30);
define('NB_LIRE_LIGNE_SIMUL', 5);

// en cas d'import d'un fichier CSV, utilise fgetcsv() plutôt
// que PHPExcel ce qui se traduit par un gain de performances très substanciel
define('QUICK_CSV_IMPORT', TRUE);

// Numbers of days between January 1, 1900 and 1970 (including 19 leap years)
// see traiterDateObs()
// define("MIN_DATES_DIFF", 25569);
class MyReadFilter implements PHPExcel_Reader_IReadFilter {
        // exclusion de colonnes
        public $exclues = array();

        // lecture par morceaux
        public $ligne_debut = 0;
        public $ligne_fin = 0;

        public static $gestion_mots_cles = null;

        public function __construct() {}

        public function def_interval($debut, $nb) {
                $this->ligne_debut = $debut;
                $this->ligne_fin = $debut + $nb;
        }

        public function readCell($colonne, $ligne, $worksheetName = '') {
                if(@$this->exclues[$colonne]) return false;
                // si des n° de morceaux ont été initialisés, on filtre...
                if($this->ligne_debut && ($ligne < $this->ligne_debut || $ligne >= $this->ligne_fin)) return false;
                return true;
        }
}

function __anonyme_1($v) {      return !$v['importable']; }
function __anonyme_2(&$v) {     $v = $v['nom']; }
function __anonyme_3($cell) { return !is_null($cell); };
function __anonyme_5($item) { return is_null($item) ? '?' : $item; }
function __anonyme_6() { return NULL; }

class ImportXLS extends Cel  {
        static function __anonyme_4(&$item, $key) { $item = self::quoteNonNull(trim($item)); }

        static $ordre_BDD = Array(
                'ce_utilisateur',
                'prenom_utilisateur',
                'nom_utilisateur',
                'courriel_utilisateur',
                'ordre',
                'nom_sel',
                'nom_sel_nn',
                'nom_ret',
                'nom_ret_nn',
                'nt',
                'famille',
                'nom_referentiel',
                'pays', 
                'zone_geo',
                'ce_zone_geo',
                'date_observation',
                'lieudit',
                'station',
                'milieu',
                'mots_cles_texte',
                'commentaire',
                'transmission',
                'date_creation',
                'date_modification',
                'date_transmission',
                'latitude',
                'longitude',
                'altitude',
                'abondance',
                'certitude',
                'phenologie',
                'code_insee_calcule'
        );

        // cf: initialiser_pdo_ordered_statements()
        // eg: "INSERT INTO cel_obs (ce_utilisateur, ..., phenologie, code_insee_calcule) VALUES"
        // colonnes statiques d'abord, les autres ensuite, dans l'ordre de $ordre_BDD
        static $insert_prefix_ordre;
        // eg: "(<id>, <prenom>, <nom>, <email>, now(), now(), ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)"
        // dont le nombre de placeholder dépend du nombre de colonnes non-statiques
        // colonnes statiques d'abord, les autres ensuite, dans l'ordre de $ordre_BDD
        static $insert_ligne_pattern_ordre;

        // seconde (meilleure) possibilité
        // cf: initialiser_pdo_statements()
        // eg: "INSERT INTO cel_obs (ce_utilisateur, ..., date_creation, ...phenologie, code_insee_calcule) VALUES"
        static $insert_prefix;
        // eg: "(<id>, <prenom>, <nom>, <email>, ?, ?, ?, now(), now(), ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)"
        // dont le nombre de placeholder dépend du nombre de colonnes non-statiques
        static $insert_ligne_pattern;

        /*
         Ces colonnes:
         - sont propres à l'ensemble des enregistrements uploadés
         - sont indépendantes du numéro de lignes
         - n'ont pas de valeur par défaut dans la structure de la table
         - nécessitent une initialisation dans le cadre de l'upload
         initialiser_colonnes_statiques() y merge les données d'identification utilisateur
        */
        public $colonnes_statiques = array(
                'ce_utilisateur' => NULL,
                'prenom_utilisateur' => NULL,
                'nom_utilisateur' => NULL,
                'courriel_utilisateur' => NULL,

                // fixes (fonction SQL)
                // XXX future: mais pourraient varier dans le futur si la mise-à-jour
                // d'observation est implémentée
                'date_creation' => 'NOW()',
                'date_modification' => 'NOW()',
        );

        public static $prefixe_colonnes_etendues = 'ext:';
        public static $indexes_colonnes_etendues = Array();
        public static $gestion_champs_etendus = null;

        public $id_utilisateur = NULL;

        // erreurs d'import
        public $bilan = Array();

        // cache (pour traiterLocalisation() pour l'instant)
        static $cache = Array('geo' => array());

        public function createElement($pairs) {
                if (!isset($pairs['utilisateur']) || trim($pairs['utilisateur']) == '') {
                        exit('0');
                }

                $id_utilisateur = intval($pairs['utilisateur']);
                $this->id_utilisateur = $id_utilisateur; // pour traiterImage();

                if (!isset($_SESSION)) {
                        session_start();
                }
                $this->controleUtilisateur($id_utilisateur);

                $this->utilisateur = $this->getInfosComplementairesUtilisateur($id_utilisateur);
                $this->initialiser_colonnes_statiques($id_utilisateur);
                list(self::$insert_prefix, self::$insert_ligne_pattern) = $this->initialiser_pdo_statements($this->colonnes_statiques);

                $infos_fichier = array_pop($_FILES);

                // renomme le fichier pour lui ajouter son extension initiale, ce qui
                // permet (une sorte) d'autodétection du format.
                $fichier = $infos_fichier['tmp_name'];
                $extension = pathinfo($infos_fichier['name'], PATHINFO_EXTENSION);
                if ( (strlen($extension) == 3 || strlen($extension) == 4) && (@rename($fichier, "$fichier.$extension"))) {
                        $fichier = "$fichier.$extension";
                }

                $objReader = PHPExcel_IOFactory::createReaderForFile($fichier);
                // TODO: check if compatible with toArray(<1>,<2>,TRUE,<4>)
                $objReader->setReadDataOnly(true);

                // TODO: is_a obsolete entre 5.0 et 5.3, retirer le @ à terme
                $IS_CSV = @is_a($objReader, 'PHPExcel_Reader_CSV') && QUICK_CSV_IMPORT;
                // en cas d'usage de fgetcsv, testons que nous pouvons compter les lignes
                if ($IS_CSV) {
                        $nb_lignes = intval(exec("wc -l $fichier"));
                }
                // et, le cas échéant, fallback sur PHPExcel à nouveau. La raison de ce test ici est
                // l'instabilité du serveur (safe_mode, safe_mode_exec_dir, symlink vers binaires pour exec(), ... multiples points-of-failure)
                if ($IS_CSV && !$nb_lignes) {
                        $IS_CSV = FALSE;
                }

                if ($IS_CSV) {
                        $objReader->setDelimiter(',')
                                ->setEnclosure('"')
                                ->setLineEnding("\n")
                                ->setSheetIndex(0);
                }

                // on ne conserve que l'en-tête
                $filtre = new MyReadFilter();
                $filtre->def_interval(1, 2);
                $objReader->setReadFilter($filtre);

                $objPHPExcel = $objReader->load($fichier);
                $obj_infos = $objReader->listWorksheetInfo($fichier);

                if ($IS_CSV) {
                        // $nb_lignes est déjà défini ci-dessus
                        $csvFileHandler = fopen($fichier, 'r');
                        // nous utilisons la valeur de retour dans un but informatif de l'utilisateur à la
                        // fin de l'import, *mais aussi* dans un array_diff_key() ci-dessous car bien que dans le
                        // fond le "parser" fgetcsv() n'ait pas d'intérêt à connaître les colonnes à ignorer,
                        // il se trouve que celles-ci peuvent interférer sur des fonctions comme traiterEspece()
                        // cf test "ref-nom-num.test.php" pour lequel l'élément C_NOM_SEL vaudrait 3 et $ligne serait array(3 => -42)
                        $filtre->exclues = self::detectionEntete(fgetcsv($csvFileHandler), TRUE);
                } else {
                        // XXX: indépendant du readFilter ?
                        $nb_lignes = $obj_infos[0]['totalRows'];
                        $donnees = $objPHPExcel->getActiveSheet()->toArray(NULL, FALSE, TRUE, TRUE);
                        $filtre->exclues = self::detectionEntete($donnees[1]);
                }

                $obs_ajouts = 0;
                $obs_maj = 0;
                $nb_images_ajoutees = 0;
                $nb_mots_cle_ajoutes = 0;
                $nb_champs_etendus_inseres = 0;

                $dernier_ordre = Cel::db()->requeter("SELECT MAX(ordre) AS ordre FROM cel_obs WHERE ce_utilisateur = $id_utilisateur");
                $dernier_ordre = intval($dernier_ordre[0]['ordre']) + 1;
                if (! $dernier_ordre) {
                        $dernier_ordre = 0;
                }

                // on catch to les trigger_error(E_USER_NOTICE);
                set_error_handler(array($this, 'erreurs_stock'), E_USER_NOTICE);
                $this->taxon_info_webservice = new RechercheInfosTaxonBeta($this->config, NULL);

                // lecture par morceaux (chunks), NB_LIRE_LIGNE_SIMUL lignes à fois
                // pour aboutir des requêtes SQL d'insert groupés.
                for ($ligne = 2; $ligne < $nb_lignes + NB_LIRE_LIGNE_SIMUL; $ligne += NB_LIRE_LIGNE_SIMUL) {
                        if (!$IS_CSV) {
                                $filtre->def_interval($ligne, NB_LIRE_LIGNE_SIMUL);
                                $objReader->setReadFilter($filtre);

                                $objPHPExcel = $objReader->load($fichier)->getActiveSheet();

                                // set col typing
                                if (C_CE_ZONE_GEO != 'C_CE_ZONE_GEO') {
                                        $objPHPExcel->getStyle(C_CE_ZONE_GEO . '2:' . C_CE_ZONE_GEO . $objPHPExcel->getHighestRow())->getNumberFormat()->setFormatCode('00000');
                                }
                                // TODO: set to string type
                                if (C_ZONE_GEO != 'C_ZONE_GEO') {
                                        $objPHPExcel->getStyle(C_ZONE_GEO . '2:' . C_ZONE_GEO . $objPHPExcel->getHighestRow())->getNumberFormat()->setFormatCode('00000');
                                }
                                $donnees = $objPHPExcel->toArray(NULL, FALSE, TRUE, TRUE);
                        } else {
                                $i = NB_LIRE_LIGNE_SIMUL;
                                $donnees = array();
                                while ($i--) {
                                        $tab = fgetcsv($csvFileHandler);
                                        if (!$tab) {
                                                continue;
                                        }
                                        $donnees[] = array_diff_key($tab, $filtre->exclues);
                                }
                        }

                        list($enregistrements, $images, $mots_cle, $champs_etendus) = self::chargerLignes($this, $donnees, $this->colonnes_statiques, $dernier_ordre);
                        if (! $enregistrements) {
                                break;
                        }

                        self::trierColonnes($enregistrements);
                        // normalement: NB_LIRE_LIGNE_SIMUL, sauf si une enregistrement ne semble pas valide
                        // ou bien lors du dernier chunk

                        $nb_rec = count($enregistrements);
                        $sql_pattern = self::$insert_prefix.
                                str_repeat(self::$insert_ligne_pattern.', ', $nb_rec - 1).
                                self::$insert_ligne_pattern;

                        Cel::db()->beginTransaction();
                        $stmt = Cel::db()->prepare($sql_pattern);
                        $donnees = array();
                        foreach ($enregistrements as $e) {
                                $donnees = array_merge($donnees, array_values($e));
                        }

                        $stmt->execute($donnees);

                        $dernier_autoinc = Cel::db()->lastInsertId();
                        Cel::db()->commit();

                        if (! $dernier_autoinc) {
                                trigger_error("l'insertion semble avoir échoué", E_USER_NOTICE);
                        }

                        $obs_ajouts += count($enregistrements);

                        $ordre_ids = self::chargerCorrespondancesIdOrdre($this, $enregistrements);

                        $nb_images_ajoutees += self::stockerImages($enregistrements, $images, $ordre_ids);
                        $nb_mots_cle_ajoutes += self::stockerMotsCle($enregistrements, $mots_cle, $dernier_autoinc);
                        $nb_champs_etendus_inseres += self::stockerChampsEtendus($champs_etendus, $ordre_ids, $this->config);
                }

                restore_error_handler();

                if ($this->bilan) {
                        echo implode("\n", $this->bilan) . "\n";
                }
                printf('%1$d observation%2$s ajoutée%2$s' . "\n" .
                        '%3$d image%4$s attachée%4$s' . "\n" .
                        (count($filtre->exclues) > 0 ? 'colonne%7$s non-traitée%7$s: %8$s' . "\n" : ''),

                        $obs_ajouts,
                        $obs_ajouts > 1 ? 's' : '',
                        $nb_images_ajoutees,
                        $nb_images_ajoutees > 1 ? 's' : '',
                        $nb_mots_cle_ajoutes,
                        $nb_mots_cle_ajoutes > 1 ? 's' : '',
                        count($filtre->exclues) > 1 ? 's' : '',
                        implode(', ', $filtre->exclues));
                die();
        }

        /* detectionEntete() sert deux rôles:
         1) détecter le type de colonne attendu à partir des textes de la ligne d'en-tête afin de define()
         2) permet d'identifier les colonnes non-supportées/inutiles afin d'alléger le processus de parsing de PHPExcel
         grace au ReadFilter (C'est le rôle de la valeur de retour)

         La raison de la présence du paramètre $numeric_keys est que pour réussir à identifier les colonnes à exclure nous
         devons traiter un tableau représentant la ligne d'en-tête aussi bien:
          - sous forme associative pour PHPExcel (les clefs sont les lettres de l'alphabet)
          - sous forme de clefs numériques (fgetcsv())
          Le détecter après coup est difficile et pourtant cette distinction est importante car le comportement
          d'array_merge() (réordonnancement des clefs numérique) n'est pas souhaitable dans le second cas. */
        static function detectionEntete($entete, $numeric_keys = FALSE) {
                $colonnes_reconnues = Array();
                $cols = FormateurGroupeColonne::nomEnsembleVersListeColonnes('standard,avance');

                foreach ($entete as $k => $v) {
                        // traite les colonnes en faisant fi de la casse et des accents
                        $entete_simple = iconv('UTF-8', 'ASCII//TRANSLIT', strtolower(trim($v)));
                        foreach ($cols as $col) {
                                $entete_officiel_simple = iconv('UTF-8', 'ASCII//TRANSLIT', strtolower(trim($col['nom'])));
                                $entete_officiel_abbrev = $col['abbrev'];
                                if ($entete_simple == $entete_officiel_simple || $entete_simple == $entete_officiel_abbrev) {
                                        // debug echo "define C_" . strtoupper($entete_officiel_abbrev) . ", $k ($v)\n";
                                        define("C_" . strtoupper($entete_officiel_abbrev), $k);
                                        $colonnes_reconnues[$k] = 1;
                                        break;
                                }

                                if (strpos($v, self::$prefixe_colonnes_etendues) === 0) {
                                        $colonnes_reconnues[$k] = 1;
                                        self::$indexes_colonnes_etendues[$k] = $v;
                                        break;
                                }
                        }
                }

                // défini tous les index que nous utilisons à une valeur d'index de colonne Excel qui n'existe pas dans
                // le tableau renvoyé par PHPExcel
                // Attention cependant d'utiliser des indexes différenciés car traiterLonLat() et traiterEspece()
                // les utilisent
                foreach ($cols as $col) {
                        if (!defined('C_'.strtoupper($col['abbrev']))) {
                                define('C_'.strtoupper($col['abbrev']), 'C_'.strtoupper($col['abbrev']));
                        }
                }

                // prépare le filtre de PHPExcel qui évitera le traitement de toutes les colonnes superflues
                $colonnesID_non_reconnues = array_diff_key($entete, $colonnes_reconnues);

                // des colonnes de FormateurGroupeColonne::nomEnsembleVersListeColonnes()
                // ne retient que celles marquées "importables"
                $colonnes_automatiques = array_filter($cols, '__anonyme_1');

                // ne conserve que le nom long pour matcher avec la ligne XLS d'entête
                array_walk($colonnes_automatiques, '__anonyme_2');

                $colonnesID_a_exclure = array_intersect($entete, $colonnes_automatiques);

                if ($numeric_keys) {
                        return $colonnesID_non_reconnues + $colonnesID_a_exclure;
                }
                return array_merge($colonnesID_non_reconnues, $colonnesID_a_exclure);
        }

        static function chargerCorrespondancesIdOrdre($cel, $lignes) {
                $ordresObs = array();
                foreach ($lignes as &$ligne) {
                        $ordresObs[] = $ligne['ordre'];
                }
                $ordresObsConcat = implode(',', $ordresObs);
                $idUtilisateurP = Cel::db()->proteger($cel->id_utilisateur);
                $requete = 'SELECT id_observation, ordre '.
                        'FROM cel_obs '.
                        "WHERE ordre IN ($ordresObsConcat) ".
                        "AND ce_utilisateur = $idUtilisateurP ".
                        ' -- '.__FILE__.':'.__LINE__;
                $resultats = Cel::db()->requeter($requete);
                $ordresIds = array();
                foreach ($resultats as &$infos) {
                        $ordresIds[$infos['ordre']] = $infos['id_observation'];
                }
                return $ordresIds;
        }

        /*
         * charge un groupe de lignes
         */
        static function chargerLignes($cel, $lignes, $colonnes_statiques, &$dernier_ordre) {
                $enregistrement = NULL;
                $enregistrements = array();
                $toutes_images = array();
                $tous_mots_cle = array();
                $tous_champs_etendus = array();

                foreach ($lignes as $ligne) {
                        // dans le cas de fgetcsv, on peut avoir des false additionnel (cf do/while l. 279)
                        if ($ligne === false) {
                                continue;
                        }

                        // on a besoin des NULL pour éviter des notice d'index indéfini
                        if (! array_filter($ligne, '__anonyme_3')) {
                                continue;
                        }

                        if ($enregistrement = self::chargerLigne($ligne, $dernier_ordre, $cel)) {
                                // $enregistrements[] = array_merge($colonnes_statiques, $enregistrement);
                                $enregistrements[] = $enregistrement;
                                $pos = count($enregistrements) - 1;
                                $last = &$enregistrements[$pos];

                                if (isset($enregistrement['_images'])) {
                                        // ne dépend pas de cel_obs, et seront insérées *après* les enregistrements
                                        // mais nous ne voulons pas nous priver de faire des INSERT multiples pour autant
                                        $toutes_images[] = array(
                                                'images' => $last['_images'],
                                                'obs_pos' => $pos);
                                        // ce champ n'a pas à faire partie de l'insertion dans cel_obs,
                                        // mais est utile pour la liaison avec les images
                                        unset($last['_images']);
                                }

                                if (isset($enregistrement['_mots_cle'])) {
                                        // ne dépend pas de cel_obs, et seront insérés *après* les enregistrements
                                        // mais nous ne voulons pas nous priver de faire des INSERT multiples pour autant
                                        $tous_mots_cle[] = array(
                                                'mots_cle' => $last['_mots_cle'],
                                                'obs_pos' => $pos);
                                        unset($last['_mots_cle']);
                                }

                                if (isset($enregistrement['_champs_etendus'])) {
                                        $tous_champs_etendus[] = array(
                                                'champs_etendus' => $last['_champs_etendus'],
                                                'ordre' => $dernier_ordre);
                                        unset($last['_champs_etendus']);
                                }
                                $dernier_ordre++;
                        }
                }
                return array($enregistrements, $toutes_images, $tous_mots_cle, $tous_champs_etendus);
        }

        static function trierColonnes(&$enregistrements) {
                foreach ($enregistrements as &$enregistrement) {
                        $enregistrement = self::sortArrayByArray($enregistrement, self::$ordre_BDD);
                }
        }

        static function stockerMotsCle($enregistrements, $tous_mots_cle, $lastid) {
                $c = 0;
                // debug: var_dump($tous_mots_cle);die;
                foreach ($tous_mots_cle as $v) {
                        $c += count($v['mots_cle']['to_insert']);
                }
                return $c;
        }

        static function stockerImages($enregistrements, $toutes_images, $ordre_ids) {
                $valuesSql = array();
                foreach ($toutes_images as $images_pour_obs) {
                        $obs = $enregistrements[$images_pour_obs['obs_pos']];
                        $id_obs = $ordre_ids[$obs['ordre']]; // id réel de l'observation correspondant à l'ordre
                        $transmission = $obs['transmission'];
                        $date_transmission = $obs['date_transmission'];
                        foreach ($images_pour_obs['images'] as $image) {
                                $id_img = $image['id_image'];
                                $valuesSql[] = "($id_img, $id_obs, NOW(), $transmission, $date_transmission)";
                        }
                }

                if ($valuesSql) {
                        $clauseValues = implode(', ', $valuesSql);
                        // Utilisation de INSERT pour faire des UPDATE multiples en une seule requête
                        $requete = 'INSERT INTO cel_images '.
                                '(id_image, ce_observation, date_liaison, transmission, date_transmission) '.
                                "VALUES $clauseValues ".
                                'ON DUPLICATE KEY UPDATE '.
                                'ce_observation = VALUES(ce_observation), '.
                                'date_liaison = NOW(), '.
                                'transmission = VALUES(transmission), '.
                                'date_transmission = VALUES(date_transmission) '.
                                ' -- '.__FILE__.':'.__LINE__;
                        Cel::db()->executer($requete);
                }
                return count($valuesSql);
        }

        /*
         Aucune des valeurs présentes dans $enregistrement n'est quotée
         cad aucune des valeurs retournée par traiter{Espece|Localisation}()
         car ce tableau est passé à un PDO::preparedStatement() qui applique
          proprement les règle d'échappement.
        */
        static function chargerLigne($ligne, $dernier_ordre, $cel) {
                // évite des notices d'index lors des trigger_error()
                $ref_ligne = !empty($ligne[C_NOM_SEL]) ? trim($ligne[C_NOM_SEL]) : '';

                // en premier car le résultat est utile pour
                // * traiter espèce (traiterEspece())
                // * traiter longitude et latitude (traiterLonLat())
                $referentiel = self::identReferentiel(trim(strtolower(@$ligne[C_NOM_REFERENTIEL])), $ligne, $ref_ligne);

                // $espece est rempli de plusieurs informations
                $espece = array(
                        C_NOM_SEL => NULL,
                        C_NOM_SEL_NN => NULL,
                        C_NOM_RET => NULL,
                        C_NOM_RET_NN => NULL,
                        C_NT => NULL,
                        C_FAMILLE => NULL);
                self::traiterEspece($ligne, $espece, $referentiel, $cel->taxon_info_webservice);

                if (!$espece[C_NOM_SEL]) {
                        $referentiel = Cel::$fallback_referentiel;
                }
                if ($espece[C_NOM_SEL] && !$espece[C_NOM_SEL_NN]) {
                        $referentiel = Cel::$fallback_referentiel;
                }

                // $localisation est rempli à partir de plusieurs champs: C_ZONE_GEO et C_CE_ZONE_GEO
                $localisation = Array(C_ZONE_GEO => NULL, C_CE_ZONE_GEO => NULL);
                self::traiterLocalisation($ligne, $localisation);
                //TODO: le jour où c'est efficace, traiter le pays à l'import

                // $transmission est utilisé pour date_transmission
                // XXX: @ contre "Undefined index"
                @$transmission = in_array(strtolower(trim($ligne[C_TRANSMISSION])), array(1, 'oui')) ? 1 : 0;


                // Dans ce tableau, seules devraient apparaître les données variable pour chaque ligne.
                // Dans ce tableau, l'ordre des clefs n'importe pas (cf: self::sortArrayByArray())
                $enregistrement = array(
                        "ordre" => $dernier_ordre,

                        "nom_sel" => $espece[C_NOM_SEL],
                        "nom_sel_nn" => $espece[C_NOM_SEL_NN],
                        "nom_ret" => $espece[C_NOM_RET],
                        "nom_ret_nn" => $espece[C_NOM_RET_NN],
                        "nt" => $espece[C_NT],
                        "famille" => $espece[C_FAMILLE],

                        "nom_referentiel" => $referentiel,

                        "pays" => $ligne[C_PAYS],
                        "zone_geo" => $localisation[C_ZONE_GEO],
                        "ce_zone_geo" => $localisation[C_CE_ZONE_GEO],

                        // $ligne: uniquement pour les infos en cas de gestion d'erreurs (date incompréhensible)
                        "date_observation" => isset($ligne[C_DATE_OBSERVATION]) ? self::traiterDateObs($ligne[C_DATE_OBSERVATION], $ref_ligne) : null,

                        "lieudit" => isset($ligne[C_LIEUDIT]) ? trim($ligne[C_LIEUDIT]) : null,
                        "station" => isset($ligne[C_STATION]) ? trim($ligne[C_STATION]) : null,
                        "milieu" => isset($ligne[C_MILIEU]) ? trim($ligne[C_MILIEU]) : null,

                        "mots_cles_texte" => NULL, // TODO: foreign-key
                        // XXX: @ contre "Undefined index"
                        "commentaire" => isset($ligne[C_COMMENTAIRE]) ? trim($ligne[C_COMMENTAIRE]) : null,

                        "transmission" => $transmission,
                        "date_transmission" => $transmission ? date('Y-m-d H:i:s') : null, // pas de fonction SQL dans un PDO statement, <=> now()

                        // $ligne: uniquement pour les infos en cas de gestion d'erreurs (lon/lat incompréhensible)
                        "latitude" => isset($ligne[C_LATITUDE]) ? self::traiterLonLat(null, $ligne[C_LATITUDE], $referentiel, $ref_ligne) : null,
                        "longitude" => isset($ligne[C_LONGITUDE]) ? self::traiterLonLat($ligne[C_LONGITUDE], null, $referentiel, $ref_ligne) : null,
                        "altitude" => isset($ligne[C_ALTITUDE]) ? intval($ligne[C_ALTITUDE]) : null, // TODO: guess alt from lon/lat

                        // @ car potentiellement optionnelles ou toutes vides => pas d'index dans PHPExcel (tableau optimisé)
                        "abondance" => @$ligne[C_ABONDANCE],
                        "certitude" => @$ligne[C_CERTITUDE],
                        "phenologie" => @$ligne[C_PHENOLOGIE],

                        "code_insee_calcule" => substr($localisation[C_CE_ZONE_GEO], -5) // varchar(5)
                );

                // passage de $enregistrement par référence, ainsi ['_images'] n'est défini
                // que si des résultats sont trouvés
                // "@" car PHPExcel supprime les colonnes null sur toute la feuille (ou tout le chunk)
                if (@$ligne[C_IMAGES]) {
                        self::traiterImage($ligne[C_IMAGES], $cel->id_utilisateur, $enregistrement);
                }

                if (@$ligne[C_MOTS_CLES_TEXTE]) {
                        self::traiterMotsCle($ligne[C_MOTS_CLES_TEXTE], $cel->id_utilisateur, $enregistrement);
                }

                $champs_etendus = self::traiterChampsEtendus($ligne, self::$indexes_colonnes_etendues);
                if (!empty($champs_etendus)) {
                        $enregistrement['_champs_etendus'] = $champs_etendus;
                }

                return $enregistrement;
        }

        static function traiterChampsEtendus(&$ligne, &$indexes_colonnes_etendues) {
                $champs_etendus_indexes = array();
                foreach($indexes_colonnes_etendues as $index_num => $label) {
                        if (isset($ligne[$index_num])) {
                                $champs_etendus_indexes[str_replace(self::$prefixe_colonnes_etendues, '', $label)] = $ligne[$index_num];
                        }
                }
                return $champs_etendus_indexes;
        }

        static function traiterImage($str, $id_utilisateur, &$enregistrement) {
                $liste_images = array_filter(explode('/', $str));
                array_walk($liste_images, array(__CLASS__, '__anonyme_4'));

                $nomsOrignalConcat = implode(',', $liste_images);
                $requete = 'SELECT id_image, nom_original '.
                        'FROM cel_images '.
                        "WHERE ce_utilisateur = $id_utilisateur AND nom_original IN ($nomsOrignalConcat) ".
                        ' -- '.__FILE__.':'.__LINE__;
                $resultat = Cel::db()->requeter($requete);

                if ($resultat) {
                        $enregistrement['_images'] = $resultat;
                }
        }

        static function traiterMotsCle($str, $id_utilisateur, &$enregistrement) {
                $liste_mots_cle = $liste_mots_cle_recherche = array_map('trim', array_unique(array_filter(explode(',', $str))));
                array_walk($liste_mots_cle_recherche, array(__CLASS__, '__anonyme_4'));

                if (self::$gestion_mots_cles == null) {
                        $gestion_mots_cles = new GestionMotsCles($this->config, 'obs');
                }
                $mots_cles_ids = $gestion_mots_cles->obtenirIdsMotClesPourMotsCles($liste_mots_cle, $id_utilisateur);
                foreach ($mots_cles_ids as $mot_cle) {
                        $resultat[$mot_cle['id_mot_cle']] = $mot_cle['mot_cle'];
                }

                $enregistrement['mots_cles_texte'] = implode(',', $liste_mots_cle);
                $enregistrement['_mots_cle'] = array(
                        'existing' => $resultat,
                        'to_insert' => array_diff($liste_mots_cle, $resultat));
        }


        /* FONCTIONS de TRANSFORMATION de VALEUR DE CELLULE */
        // TODO: PHP 5.3, utiliser date_parse_from_format()
        // TODO: parser les heures (cf product-owner)
        // TODO: passer par le timestamp pour s'assurer de la validité
        static function traiterDateObs($date, $ref_ligne) {
                // TODO: see https://github.com/PHPOffice/PHPExcel/issues/208
                // TODO: PHPExcel_Shared_Date::ExcelToPHP()
                if (is_double($date)) {
                        if ($date > 0) {
                                return PHPExcel_Style_NumberFormat::toFormattedString($date, PHPExcel_Style_NumberFormat::FORMAT_DATE_YYYYMMDD2) . " 00:00:00";
                        }

                        $msg = "ligne «{$ref_ligne}»: Attention: date antérieure à 1970 et format de cellule «DATE» utilisés ensemble";
                        trigger_error($msg, E_USER_NOTICE);
                } else {
                        // attend l'un des formats de
                        // http://www.php.net/manual/fr/datetime.formats.date.php
                        // le plus simple: YYYY/MM/DD (utilisé à l'export), mais DD-MM-YYYY est aussi supporté
                        $matches = NULL;
                        // et on essaie d'être sympa et supporter aussi DD/MM/YYYY
                        if (preg_match(';^([0-3]?\d)/([01]\d)/([12]\d\d\d)$;', $date, $matches)) {
                                $date = $matches[3] . '/' . $matches[2] . '/' . $matches[1];
                        }
                        $timestamp = strtotime($date);
                        if (! $timestamp || $timestamp > time() + 3600 * 24 * 1) { // une journée d'avance maxi autorisée (décallage horaire ?)
                                if ($date) {
                                        $msg = "ligne «{$ref_ligne}»: Attention: date erronée ($date)";
                                        trigger_error($msg, E_USER_NOTICE);
                                }
                                return NULL;
                        }
                        return strftime('%Y-%m-%d 00:00:00', $timestamp);
                }
        }

        static function identReferentiel($referentiel, $ligne, $ref_ligne) {
                // SELECT DISTINCT nom_referentiel, COUNT(id_observation) AS count FROM cel_obs GROUP BY nom_referentiel ORDER BY count DESC;
                if (strpos($referentiel, 'bdtfx') !== FALSE) {
                        return 'bdtfx'; //:v1.01';
                }
                if (strpos($referentiel, 'bdtxa') !== FALSE) {
                        return 'bdtxa'; //:v1.00';
                }
                if (strpos($referentiel, 'bdnff') !== FALSE) {
                        return 'bdtfx';
                }
                if (strpos($referentiel, 'isfan') !== FALSE) {
                        return 'isfan'; //:v1.00';
                }
                if (strpos($referentiel, 'apd') !== FALSE) {
                        return 'apd'; //:v1.00';
                }
                if (strpos($referentiel, 'autre') !== FALSE) {
                        return 'autre';
                }

                if ($referentiel && isset($ligne[C_NOM_SEL]) && $ligne[C_NOM_SEL]) {
                        $msg = "ligne «{$ref_ligne}»: Attention: référentiel «{$referentiel}» inconnu";
                        trigger_error($msg, E_USER_NOTICE);
                        return 'autre';
                }
                return NULL;
        }

        static function traiterLonLat($lon = NULL, $lat = NULL, $referentiel = 'bdtfx', $ref_ligne) {
                // en CSV ces valeurs sont des string, avec séparateur en français (","; cf défauts dans ExportXLS)
                if ($lon && is_string($lon)) {
                        $lon = str_replace(',', '.', $lon);
                }
                if ($lat && is_string($lat)) {
                        $lat = str_replace(',', '.', $lat);
                }

                // sprintf applique une précision à 5 décimale (comme le ferait MySQL)
                // tout en uniformisant le format de séparateur des décimales (le ".")
                if ($lon && is_numeric($lon) && $lon >= -180 && $lon <= 180) {
                        return sprintf('%.5F', $lon);
                }
                if ($lat && is_numeric($lat) && $lat >= -90 && $lat <= 90) {
                        return sprintf('%.5F', $lat);
                }

                if ($lon || $lat) {
                        trigger_error("ligne \"{$ref_ligne}\": " .
                                  "Attention: longitude ou latitude erronée",
                                  E_USER_NOTICE);
                }
                return NULL;
        }

        /*
          TODO: s'affranchir du webservice pour la détermination du nom scientifique en s'appuyant sur cel_references,
          pour des questions de performances
        */
        static function traiterEspece($ligne, Array &$espece, &$referentiel, $taxon_info_webservice) {
                if (empty($ligne[C_NOM_SEL])) {
                        return;
                }

                // nom_sel reste toujours celui de l'utilisateur
                $espece[C_NOM_SEL] = trim($ligne[C_NOM_SEL]);

                // XXX/attention, nous ne devrions pas accepter un référentiel absent !
                if (!$referentiel) {
                        $referentiel = 'bdtfx';
                }
                $taxon_info_webservice->setReferentiel($referentiel);
                $ascii = iconv('UTF-8', 'ASCII//TRANSLIT', $ligne[C_NOM_SEL]);

                $determ = $taxon_info_webservice->rechercherInfosSurTexteCodeOuNumTax(trim($ligne[C_NOM_SEL]));

                // note: rechercherInfosSurTexteCodeOuNumTax peut ne retourner qu'une seule clef "nom_sel"
                if (! $determ) {
                        // on supprime les noms retenus et renvoi tel quel
                        // on réutilise les define pour les noms d'indexes, tant qu'à faire
                        // XXX; tout à NULL sauf C_NOM_SEL ci-dessus ?
                        $espece[C_NOM_SEL_NN] = @$ligne[C_NOM_SEL_NN];
                        $espece[C_NOM_RET] = @$ligne[C_NOM_RET];
                        $espece[C_NOM_RET_NN] = @$ligne[C_NOM_RET_NN];
                        $espece[C_NT] = @$ligne[C_NT];
                        $espece[C_FAMILLE] = @$ligne[C_FAMILLE];

                        return;
                }

                // succès de la détection, mais résultat partiel
                if (!isset($determ->id)) {
                        $determ = $taxon_info_webservice->effectuerRequeteInfosComplementairesSurNumNom($determ->{"nom_retenu.id"});
                }

                // ne devrait jamais arriver !
                if (!$determ) {
                        die("erreur critique: " . __FILE__ . ':' . __LINE__);
                }

                // un schéma <ref>:(nt|nn):<num> (ie: bdtfx:nt:8503) a été passé
                // dans ce cas on met à jour le référentiel avec celui passé dans le champ espèce
                if (isset($determ->ref)) {
                        $referentiel = $determ->ref;
                }

                // succès de la détection
                // nom_sel est remplacé, mais seulement si un motif spécial à été utilisé (bdtfx:nn:4567)
                if ($taxon_info_webservice->is_notation_spe) {
                        $espece[C_NOM_SEL] = $determ->nom_sci;
                }

                // écrasement des numéros (nomenclatural, taxonomique) saisis...
                $espece[C_NOM_SEL_NN] = $determ->id;
                $espece[C_NOM_RET] = RechercheInfosTaxonBeta::supprimerBiblio($determ->nom_retenu_complet);
                $espece[C_NOM_RET_NN] = $determ->{"nom_retenu.id"};
                $espece[C_NT] = $determ->num_taxonomique;
                $espece[C_FAMILLE] = $determ->famille;
                return;
        }

        static function detectFromNom($nom) {
                $r = Cel::db()->requeter(sprintf("SELECT num_nom, num_tax_sup FROM bdtfx_v1_01 WHERE (nom_sci LIKE '%s') ".
                        "ORDER BY nom_sci ASC LIMIT 0, 1",
                        Cel::db()->proteger($nom)));
                if ($r) {
                        return $r;
                }

                Cel::db()->requeter(sprintf("SELECT num_nom, num_tax_sup FROM bdtfx_v1_01 WHERE (nom_sci LIKE '%s' OR nom LIKE '%s') ".
                        "ORDER BY nom_sci ASC LIMIT 0, 1",
                        Cel::db()->proteger($nom),
                        Cel::db()->proteger(str_replace(' ', '% ', $nom))));
                return $r;
        }

        static function traiterLocalisation($ligne, Array &$localisation) {
                if (empty($ligne[C_ZONE_GEO])) {
                        $ligne[C_ZONE_GEO] = NULL;
                }
                if (empty($ligne[C_CE_ZONE_GEO])) {
                        $ligne[C_CE_ZONE_GEO] = NULL;
                }

                $identifiant_commune = trim($ligne[C_ZONE_GEO]);
                if (!$identifiant_commune) {
                        $departement = trim($ligne[C_CE_ZONE_GEO]);

                        if (strpos($departement, 'INSEE-C:', 0) === 0) {
                                $localisation[C_CE_ZONE_GEO] = trim($ligne[C_CE_ZONE_GEO]);
                                if (array_key_exists($localisation[C_CE_ZONE_GEO], self::$cache['geo'])) {
                                        $localisation[C_ZONE_GEO] = self::$cache['geo'][$localisation[C_CE_ZONE_GEO]];
                                } else {
                                        $nom = Cel::db()->requeter(sprintf("SELECT nom FROM cel_zones_geo WHERE code = %s LIMIT 1",
                                                self::quoteNonNull(substr($localisation[C_CE_ZONE_GEO], strlen("INSEE-C:")))));
                                        if ($nom) {
                                                $localisation[C_ZONE_GEO] = $nom[0]['nom'];
                                        }
                                        self::$cache['geo'][$localisation[C_CE_ZONE_GEO]] = @$nom[0]['nom'];
                                }
                                return;
                        }

                        if (!is_numeric($departement)) {
                                $localisation[C_CE_ZONE_GEO] = $ligne[C_CE_ZONE_GEO];
                                return;
                        }

                        $cache_attempted = FALSE;
                        if(array_key_exists($departement, self::$cache['geo'])) {
                                $cache_attempted = TRUE;
                                if (self::$cache['geo'][$departement][0] && self::$cache['geo'][$departement][1]) {
                                        $localisation[C_ZONE_GEO] = self::$cache['geo'][$departement][0];
                                        $localisation[C_CE_ZONE_GEO] = self::$cache['geo'][$departement][1];
                                        return;
                                }
                        }

                        $requete = "SELECT DISTINCT nom, CONCAT('INSEE-C:', code) AS code ".
                                'FROM cel_zones_geo '.
                                'WHERE code = %s '.
                                'LIMIT 1 '.
                                ' -- '.__FILE__.':'.__LINE__;
                        $resultat_commune = Cel::db()->requeter(sprintf($requete, self::quoteNonNull($departement)));
                        if (! $cache_attempted && $resultat_commune) {
                                $localisation[C_ZONE_GEO] = $resultat_commune[0]['nom'];
                                $localisation[C_CE_ZONE_GEO] = $resultat_commune[0]['code'];
                                self::$cache['geo'][$departement] = array($resultat_commune[0]['nom'], $resultat_commune[0]['code']);
                                return;
                        }
                        $localisation[C_CE_ZONE_GEO] = $ligne[C_CE_ZONE_GEO];
                        return;
                }

                $select = "SELECT DISTINCT nom, code FROM cel_zones_geo";

                if (preg_match('/(.+) \((\d{1,5})\)/', $identifiant_commune, $elements)) {
                        // commune + departement : montpellier (34)
                        $nom_commune=$elements[1];
                        $code_commune=$elements[2];
                        if (strlen($code_commune) <= 2) {
                                $requete = sprintf("%s WHERE nom = %s AND code LIKE %s",
                                        $select, self::quoteNonNull($nom_commune),
                                        self::quoteNonNull($code_commune.'%'));
                        } else {
                                $requete = sprintf("%s WHERE nom = %s AND code = %d",
                                        $select, self::quoteNonNull($nom_commune),
                                        $code_commune);
                        }
                } elseif (preg_match('/^(\d+|(2[ab]\d+))$/i', $identifiant_commune, $elements)) {
                        // Code insee seul
                        $code_insee_commune=$elements[1];
                        $requete = sprintf("%s WHERE code = %s", $select, self::quoteNonNull($code_insee_commune));
                } else {
                        // Commune seule (le departement sera recupere dans la colonne departement si elle est presente)
                        // on prend le risque ici de retourner une mauvaise Commune
                        $nom_commune = str_replace(" ", "%", iconv('UTF-8', 'ASCII//TRANSLIT', $identifiant_commune));
                        $requete = sprintf("%s WHERE nom LIKE %s", $select, self::quoteNonNull($nom_commune.'%'));
                }

                if (array_key_exists($identifiant_commune, self::$cache['geo'])) {
                        $resultat_commune = self::$cache['geo'][$identifiant_commune];
                } else {
                        $resultat_commune = Cel::db()->requeter($requete);
                        self::$cache['geo'][$identifiant_commune] = $resultat_commune;
                }

                // cas de la commune introuvable dans le référentiel
                // réinitialisation aux valeurs du fichier XLS
                if (! $resultat_commune) {
                        $localisation[C_ZONE_GEO] = trim($ligne[C_ZONE_GEO]);
                        $localisation[C_CE_ZONE_GEO] = trim($ligne[C_CE_ZONE_GEO]);
                } else {
                        $localisation[C_ZONE_GEO] = $resultat_commune[0]['nom'];
                        $localisation[C_CE_ZONE_GEO] = "INSEE-C:" . $resultat_commune[0]['code'];
                        return;
                }

                $departement =& $localisation[C_CE_ZONE_GEO];

                if (strpos($departement, "INSEE-C:", 0) === 0) {
                        $localisation[C_ZONE_GEO] = $localisation[C_ZONE_GEO];
                        $localisation[C_CE_ZONE_GEO] = $localisation[C_CE_ZONE_GEO];
                }

                if (!is_numeric($departement)) {
                        $localisation[C_ZONE_GEO] = $localisation[C_ZONE_GEO];
                        $localisation[C_CE_ZONE_GEO] = $localisation[C_CE_ZONE_GEO];
                }

                if (strlen($departement) == 4) {
                        $departement = "INSEE-C:0$departement";
                }
                if (strlen($departement) == 5) {
                        $departement = "INSEE-C:$departement";
                }
                $departement = trim($departement);

                $localisation[C_ZONE_GEO] = $localisation[C_ZONE_GEO];
                $localisation[C_CE_ZONE_GEO] = $localisation[C_CE_ZONE_GEO];
        }

        public static function stockerChampsEtendus($champs_etendus, $ordre_ids, $config) {
                // singleton du pauvre mais l'export est suffisamment inefficace pour s'en priver
                self::$gestion_champs_etendus = self::$gestion_champs_etendus == null ?
                        new GestionChampsEtendus($config, 'obs') :
                        self::$gestion_champs_etendus;

                $champs_etendus_obs = array();
                foreach ($champs_etendus as $champ_etendu_a_obs) {
                        $id_obs = $ordre_ids[$champ_etendu_a_obs['ordre']]; // id réel de l'observation correspondant à l'ordre
                        foreach ($champ_etendu_a_obs['champs_etendus'] as $label => $champ) {
                                // XXX: insère t'on des valeurs vides ?
                                $valeur = $champ;
                                $cle = $label;

                                if (!empty($cle) && !empty($valeur)) {
                                        $champ_etendu_a_inserer = new ChampEtendu();
                                        $champ_etendu_a_inserer->id = $id_obs;
                                        $champ_etendu_a_inserer->cle = $cle;
                                        $champ_etendu_a_inserer->valeur = $valeur;

                                        $champs_etendus_obs[] = $champ_etendu_a_inserer;
                                }
                        }
                }

                self::$gestion_champs_etendus->ajouterParLots($champs_etendus_obs);
                //TODO: que faire si l'insertion des champs étendus échoue ?
                return count($champs_etendus_obs);
        }

        /* HELPERS */

        // http://stackoverflow.com/questions/348410/sort-an-array-based-on-another-array
        // XXX; utilisé aussi (temporairement ?) par FormateurGroupeColonne.
        static function sortArrayByArray($array, $orderArray) {
                $ordered = array();
                foreach($orderArray as $key) {
                        if (array_key_exists($key, $array)) {
                                $ordered[$key] = $array[$key];
                                unset($array[$key]);
                        }
                }
                return $ordered + $array;
        }

        // retourne une BBox [N,S,E,O) pour un référentiel donné
        static function getReferentielBBox($referentiel) {
                if ($referentiel == 'bdtfx') {
                        return Array(
                                'NORD' => 51.2, // Dunkerque
                                'SUD' => 41.3, // Bonifacio
                                'EST' => 9.7, // Corse
                                'OUEST' => -5.2); // Ouessan
                }
                return FALSE;
        }

        // ces valeurs ne sont pas inséré via les placeholders du PDO::preparedStatement
        // et doivent donc être échappées correctement.
        public function initialiser_colonnes_statiques() {
                $this->colonnes_statiques = array_merge($this->colonnes_statiques,
                        array(
                                'ce_utilisateur' => self::quoteNonNull($this->id_utilisateur), // peut-être un hash ou un id
                                'prenom_utilisateur' => self::quoteNonNull($this->utilisateur['prenom']),
                                'nom_utilisateur' => self::quoteNonNull($this->utilisateur['nom']),
                                'courriel_utilisateur' => self::quoteNonNull($this->utilisateur['courriel']),
                        ));
        }

        static function initialiser_pdo_ordered_statements($colonnes_statiques) {
                return Array(
                        // insert_ligne_pattern_ordre
                        sprintf('INSERT INTO cel_obs (%s, %s) VALUES',
                                implode(', ', array_keys($colonnes_statiques)),
                                implode(', ', array_diff(self::$ordre_BDD, array_keys($colonnes_statiques)))),

                        // insert_ligne_pattern_ordre
                        sprintf('(%s, %s ?)',
                                implode(', ', $colonnes_statiques),
                                str_repeat('?, ', count(self::$ordre_BDD) - count($colonnes_statiques) - 1))
                );
        }

        static function initialiser_pdo_statements($colonnes_statiques) {
                return Array(
                        // insert_prefix
                        sprintf('INSERT INTO cel_obs (%s) VALUES ',
                                implode(', ', self::$ordre_BDD)),


                        // insert_ligne_pattern, cf: self::$insert_ligne_pattern
                        '(' .
                        // 3) créé une chaîne de liste de champ à inséré en DB
                        implode(', ', array_values(
                        // 2) garde les valeurs fixes (de $colonnes_statiques),
                        // mais remplace les NULL par des "?"
                        array_map('__anonyme_5',
                                  // 1) créé un tableau genre (nom_sel_nn => NULL) depuis self::$ordre_BDD
                                  // et écrase certaines valeurs avec $colonnes_statiques (initilisé avec les données utilisateur)
                                  array_merge(array_map('__anonyme_6', array_flip(self::$ordre_BDD)), $colonnes_statiques
                                  )))) .
                        ')'
                );
        }

        // équivalent à Bdd->proteger() (qui wrap PDO::quote),
        // sans transformer NULL en ""
        static function quoteNonNull($chaine) {
                if (is_null($chaine)) {
                        return 'NULL';
                }
                if (!is_string($chaine) && !is_integer($chaine)) {
                        die('erreur: ' . __FILE__ . ':' . __LINE__);
                }
                return Cel::db()->quote($chaine);
        }

        public function erreurs_stock($errno, $errstr) {
                $this->bilan[] = $errstr;
        }
}