cms/wtrmln/libs/db.php

   1 <?php if(!defined('WTRMLN_IS')) die;
   2 /********************************************************************
   3
   4   Watermelon CMS
   5
   6 Copyright 2008 Radosław Pietruszewski
   7
   8 This program is free software; you can redistribute it and/or
   9 modify it under the terms of the GNU General Public License
  10 version 2 as published by the Free Software Foundation.
  11
  12 This program is distributed in the hope that it will be useful,
  13 but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  15 GNU General Public License for more details.
  16
  17 You should have received a copy of the GNU General Public License
  18 along with this program; if not, write to the Free Software
  19 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
  20
  21 ********************************************************************/
  22
  23 /*
  24  * Lib DB
  25  * wersja 1.9.5
  26  *
  27  * Komunikacja z bazą danych
  28  *
  29  */
  30
  31 class DB
  32 {
  33    /*
  34     * public static int $queriesCounter
  35     *
  36     * licznik zapytań (liczba wykonanych zapytań)
  37     */
  38    public static $queriesCounter = 0;
  39
  40    /*
  41     * public static array $errorList
  42     *
  43     * lista (log) błędów. Przydatne w debbugowaniu
  44     *
  45     * $errorList = array(string $error[, string $error[, ...]])
  46     *   $error = treść błędu
  47     */
  48
  49    public static $errorList = array();
  50
  51    /*
  52     * private static mysql_link $link
  53     *
  54     * resource bazy danych (zwracany przez mysql_connect)
  55     */
  56
  57    private static $link;
  58
  59    /*
  60     * private static DB $instance
  61     *
  62     * Zawiera instancję tej klasy
  63     *
  64     * DEPRECATED - Niedługo to coś zostanie wywalone z kodu. Póki co tylko
  65     * zakomentowane. (Akcja wywalanie singletona)
  66     */
  67
  68    //private static $instance = NULL;
  69
  70    /*
  71     * private static string $prefix
  72     *
  73     * prefiks nazw tabel (np. tabela 'users' wraz z prefiksem 'wcms_' to 'wcms_users')
  74     */
  75
  76    private static $prefix;
  77
  78    /*
  79     * public void connect(string $host, string $user, string $pass, string $name, string $prefix)
  80     *
  81     * Łączy z bazą danych
  82     *
  83     */
  84    public function connect($host, $user, $pass, $name, $prefix)
  85    {
  86       self::$link = @mysql_connect($host, $user, $pass);
  87
  88       self::$prefix = $prefix;
  89
  90       if(!self::$link)
  91       {
  92          panic('Lib DB: 0');
  93       }
  94
  95       $dbselect = @mysql_select_db($name);
  96
  97       if(!$dbselect)
  98       {
  99          panic('Lib DB: 1');
 100       }
 101    }
 102
 103    /*
 104     * public DBresult query(string $query)
 105     *
 106     * Zapytanie do bazy danych
 107     *
 108     * Zwraca FALSE w przypadku porażki
 109     *
 110     */
 111
 112    public static function query($query)
 113    {
 114       // jeśli jakaś nazwa tabeli w "panie kopniętym" zaczyna się od
 115       // podwójnego podkreślnika, zamienia na prefix
 116
 117       $query = str_replace('`__', '`' . self::$prefix, $query);
 118
 119       // poniżej eksperymentalny kod. Może zostanie, może nie :P
 120
 121       $numargs = func_num_args();
 122       $arg_list = func_get_args();
 123       for($i = 1; $i < $numargs; $i++)
 124       {
 125          $query = str_replace('%' . $i, $arg_list[$i], $query);
 126       }
 127
 128       // inkrementujemy licznik zapytań
 129
 130       self::$queriesCounter++;
 131
 132       $queryResult = mysql_query($query);
 133
 134       if($queryResult)
 135       {
 136          return new DBresult($queryResult);
 137       }
 138       else
 139       {
 140          self::$errorList[] = mysql_error();
 141          return FALSE;
 142       }
 143    }
 144
 145    /*
 146     * public string[] errorList()
 147     *
 148     * Zwraca zawartość listy błędów
 149     *
 150     */
 151
 152    public static function errorList()
 153    {
 154       return self::$errorList;
 155    }
 156
 157    /*
 158     * public string lastError()
 159     *
 160     * Zwraca ostatni napotkany błąd
 161     *
 162     */
 163
 164    public static function lastError()
 165    {
 166       return end(self::$errorList);
 167    }
 168
 169    /*
 170     * public int queries()
 171     *
 172     * Zwraca liczbę wykonanych zapytań
 173     *
 174     */
 175
 176    public static function queries()
 177    {
 178       return self::$queriesCounter;
 179    }
 180
 181    /*
 182     * public static DB Instance()
 183     *
 184     * Singleton... (zwraca instancję tej klasy)
 185     *
 186     * DEPRECATED - Niedługo to coś zostanie wywalone z kodu. Póki co tylko
 187     * zakomentowane. (Akcja wywalanie singletona)
 188     */
 189    /*
 190    public static function Instance()
 191    {
 192       if(!self::$instance instanceof self)
 193       self::$instance = new self;
 194       return self::$instance;
 195    }
 196    */
 197 }
 198
 199 ############
 200 ############
 201 ############
 202
 203 class DBresult
 204 {
 205    public $res;  // resource zwrócony przez DB::query
 206
 207    /*
 208     * public void DBresult(resource $res)
 209     *
 210     * Ustawia $this->res
 211     *
 212     */
 213    public function DBresult($res)
 214    {
 215       $this->res = $res;
 216    }
 217
 218    /*
 219     * public int num_rows()
 220     *
 221     * Zwraca ilość znalezionych wyników
 222     *
 223     */
 224
 225    public function num_rows()
 226    {
 227       return mysql_num_rows($this->res);
 228    }
 229
 230    /*
 231     * public object to_obj()
 232     *
 233     * Zwraca dane w postaci obiektu
 234     *
 235     */
 236
 237    public function to_obj()
 238    {
 239       return mysql_fetch_object($this->res);
 240    }
 241
 242    /*
 243     * public array to_array()
 244     *
 245     * Zwraca dane w postaci tablicy
 246     *
 247     */
 248
 249    public function to_array()
 250    {
 251       return mysql_fetch_array($this->res);
 252    }
 253 }
 254
 255 ?>