NxTIC/manager/lightdb.php

<?php

	namespace manager;


    class lightdb{

        // REPERTOIRE RACINE DE TOUTES LES BDD
        public static $root = __ROOT__.'/tmp/';

        // ATTRIBUTS
		private $dbname;
		private $dir;
		private $index;
        private $driver;
        private $line;

        /* CONSTRUCTEUR -> CREER LES FICHIERS S'ILS N'EXISTENT PAS SINON, RECUPERE LES DONNES
        *
        * @dbname<String>                                       Nom de la base de données
        *
        */
		public function __construct($dbname){
            /* [0] On récupère les attributs
            =========================================================*/
			$this->dbname = $dbname;
			$this->dir    = self::$root.$dbname.'/';

            /* [1] Création du répertoire s'il n'existe pas
            =========================================================*/
			if( !is_dir($this->dir) )
				mkdir($this->dir);

			/* [2] Création du fichier d'index ou récupération
			=========================================================*/
			/* (1) Si le fichier n'existe pas, on le crée */
			if( !file_exists($this->dir.'index') )
                file_put_contents($this->dir.'index', json_encode(array()) );


            /* (2) On récupère le contenu du fichier */
            $fIndex = new \SplFileObject($this->dir.'index');
            $fIndex->seek(0);

			$index = json_decode( $fIndex->current(), true );

            // Si erreur de parsage, on retourne une erreur
			if( is_null($index) ) return;
			$this->index = $index;

            /* [3] Initialisation du gestionnaire d'acces (SplFileObject)
            =========================================================*/
            /* (1) Si le fichier n'existe pas, on le crée */
            if( !file_exists($this->dir.'data') )
                file_put_contents($this->dir.'data', '' );

            /* (2) On place un 'driver' sur le fichier */
            $this->driver = new \SplFileObject($this->dir.'data', 'r+');

            /* (3) On récupère le nombre de lignes */
            $this->line = -1;
            while( !$this->driver->eof() ){
                $this->line++;
                $this->driver->fgetcsv();
            }
		}


        public function close(){ $this->driver = null; }



        /* RETOURNE LA LISTE DES INDEX
        *
        * @i<String>                                            Index pour lequel on veut la ligne et le hash
        *
        * @return Index<Array>                                  Tableau associatif contenant le hash et la ligne
        *
        */
		public function index($i=null){
			return is_numeric($i) ? $this->index : $this->index;
		}


        /* INSERTION D'UNE ENTREE DANS LA BASE DE DONNEES
        *
        * @key<String>                                          Clé qui permettra l'accès direct
        * @data<mixed*>                                         Objet qui sera enregistré dans la base
        *
        * @return status<Boolean>                               Retourne TRUE si tout s'est bien passé, sinon FALSE
        *
        */
		public function insert($key, $data){
            /* (1) On vérifie que la clé est unique */
            if( array_key_exists($key, $this->index) )
                return false;

            /* (2) On ajoute les données aux fichier */
            $json_data = json_encode($data);
            $this->driver->seek($this->line);
            $this->line++;
            $written = $this->driver->fwrite( $json_data.PHP_EOL );

            // Si erreur d'écriture, on retourne FALSE
            if( is_null($written) )
                return false;

            /* (3) On enregistre l'index */
            $this->index[$key] = array(
                'line' => $this->line - 1,
                'hash' => sha1($json_data)
            );

            /* (4) On enregistre le fichier index */
            $fIndex = new \SplFileObject($this->dir.'index', 'w');
            $fIndex->fwrite( json_encode($this->index) );
            $fIndex = null;

            return true;
        }


        /* MODIFICATION D'UNE ENTREE DE CLE DONNEE
        *
        * @key<String>                                          Clé associée à la valeur à modifier
        * @data<mixed*>                                         Nouvelle valeur, si tableau associatif, remplacera uniquement les valeurs données
        *
        * @return status<Boolean>                               Retourne TRUE si tout s'est bien passé, sinon FALSE
        *
        */
		public function update($key, $data){}


        /* RENVOIE LES DONNEES ASSOCIEES A UNE CLE DONNEE
        *
        * @key<String>                                          Clé associée à la valeur à récupérer
        *
        * @return data<mixed*>                                  Renvoie la valeur associée à la clé, FALSE si erreur
        *
        */
		public function fetch($key){
            /* (1) On vérifie que la clé existe bien */
            if( !array_key_exists($key, $this->index) )
                return false;

            /* (2) On récupère la ligne */
            $line = $this->index[$key]['line'];

            /* (3) On récupère le contenu */
            $this->driver->seek($line);
            $json = json_decode( $this->driver->current(), true );

            // Si erreur de parsage
            if( is_null($json) )
                return false;

            return $json;
        }


        /* RENVOIE LES DONNEES ASSOCIEES AUX CLES DONNEES
        *
        * @keys<Array>                                          Liste des clés associées aux valeurs à récupérer
        *
        * @return data<Array>                                   Renvoie un tableau des valeurs valeur associées aux clés (clé1->valeur1), FALSE si erreur
        *
        */
		public function fetchAll($keys){
            /* (1) On récupère fetch() pour toutes les clés */
            $wrapper = array();

            foreach($keys as $key){
                $data = $this->fetch($key);

                // Si aucune erreur, on ajoute l'entree au 'wrapper'
                if( $data !== false )
                    $wrapper[$key] = $data;
            }

            /* (2) On retourne le résultat */
            return $wrapper;
        }


        /* RENVOIE LES DONNEES ASSOCIEES A UN CHAMP DE RECHERCHE
        *
        * @nomParam<typeParam>                                     Description du param
        *
        * @return nomRetour<typeRetour>                         Description du retour
        *
        */
		public function filter($data){} // select() en comparant $data
		public function delete($key){}


    }