DB Klassenreferenz

Aufstellung aller Elemente

Öffentliche Methoden
	DB ($conf)
	connect ()
	query ($query)
	affectedRows ()
&	getOne ($query)
&	getRow ($query)
&	getCol ($query)
&	getAssoc ($query, $force_array=false)
&	getAll ($query)
Öffentliche Attribute
	$id
	$conf
	$available
	$error
	$client

---

Ausführliche Beschreibung

Definiert in Zeile 33 der Datei db.class.php.

---

Dokumentation der Elementfunktionen

DB::affectedRows

(

)

Ermittelt die Anzahl der betroffenen Zeilen nach einer Datebank-Anfrage.

Rückgabe:

unknown

Definiert in Zeile 169 der Datei db.class.php.

     {
          return $this->client->affectedRows( $query );
     }

DB::connect

(

)

Verbindung zur Datenbank aufbauen.

Rückgabe:

Status

Definiert in Zeile 94 der Datei db.class.php.

Benutzt Logger::debug().

Wird benutzt von DB().

     {
          // Ausführen des Systemkommandos.
          if   ( !empty($this->conf['cmd']))
          {
               $ausgabe = array();
               $rc      = false;

               Logger::debug("Database command executing: ".$this->conf['cmd']);
               exec( $this->conf['cmd'],$ausgabe,$rc );
               
               foreach( $ausgabe as $zeile )
                    Logger::debug("Database command output: ".$zeile);
               
               if   ( $rc != 0 )
               {
                    $this->error     = 'Command failed: '.implode("",$ausgabe);
                    $this->available = false; 
                    return false;
               }
          }
          
          $type = $this->conf['type'];
          $classname = 'db_'.$type;
          
          $this->client = & new $classname;

          $ok = $this->client->connect( $this->conf );
          
          if   ( ! $ok )
          {
               $this->error     = $this->client->error;
               $this->available = false;
               return false; 
//             if   ( empty($this->error) )
//                  $this->error = 'Error while connecting to database.';
          }

          $this->available = true;
          return true;
     }

DB::DB

(

$

conf

)

Kontruktor. Erwartet die Datenbank-Konfiguration als Parameter.

Parameter:

Array

$conf

Rückgabe:

Status

Definiert in Zeile 78 der Datei db.class.php.

Benutzt $conf und connect().

     {
          $this->available = false;
          $this->conf      = $conf;
          
          $this->connect();
          
          return $this->available;
     }

& DB::getAll

(

$

query

)

Ermittelt alle Datenbankergebniszeilen.

Parameter:

String

$query

Rückgabe:

Array

Definiert in Zeile 308 der Datei db.class.php.

Benutzt query().

     {
          $res = $this->query( $query );

          $results = array();
          $numRows = $res->numRows();

          for( $i=0; $i<$numRows; $i++ )
          {
               $row = $res->fetchRow($i);
               $results[] = $row;
          }

          $res->free();

          return $results;
     }

& DB::getAssoc	(	$	query,
		$	force_array = false
	)

Ermittelt ein assoziatives Array aus der Datenbank.

Parameter:

	String	$query
	Boolean	$force_array

Rückgabe:

Array

Definiert in Zeile 260 der Datei db.class.php.

Benutzt query().

     {
          $res = $this->query($query);

          $numCols = $res->numCols();
          $numRows = $res->numRows();

          $results = array();

          if ( $numCols > 2 || $force_array )
          {
               for( $i=0; $i<$numRows; $i++ )
               {
                    $row = $res->fetchRow($i);

                    $keys = array_keys($row);
                    $key1 = $keys[0];

                    unset( $row[$key1] );
                    $results[ $row[$key1] ] = $row;
               }
          }
          else
          {
               for( $i=0; $i<$numRows; $i++ )
               {
                    $row = $res->fetchRow($i);

                    $keys = array_keys($row);
                    $key1 = $keys[0];
                    $key2 = $keys[1];

                    $results[ $row[$key1] ] = $row[$key2];
               }
          }

          $res->free();

          return $results;
     }

& DB::getCol

(

$

query

)

Ermittelt eine (die 1.) Spalte aus dem Datenbankergebnis.

Parameter:

String

$query

Rückgabe:

Array

Definiert in Zeile 231 der Datei db.class.php.

Benutzt query().

     {
          $res = $this->query( $query );
          
          $ret = array();

          $numRows = $res->numRows();
          
          for( $i=0; $i<$numRows; $i++ )
          {
               $row = $res->fetchRow($i);
               
               $keys = array_keys($row);
               $ret[] = $row[ $keys[0] ];
          }

          $res->free();

          return $ret;
     }

& DB::getOne

(

$

query

)

Ermittelt genau 1 Datenbankergebnis aus einer SQL-Anfrage. Falls es mehrere Treffer gibt, wird die 1. Spalte aus der 1. Zeile genommen.

Parameter:

String

$query

Rückgabe:

String

Definiert in Zeile 182 der Datei db.class.php.

Benutzt query().

     {
          $res = $this->query($query);

          if   ( $res->numRows() > 0 )
          {
               $row = $res->fetchRow( 0 );
               $res->free();
     
               $keys = array_keys($row);
     
               return $row[ $keys[0] ];
          }
          else
          {
               $res->free();
               $leer = '';
               return $leer;
          }
     }

& DB::getRow

(

$

query

)

Ermittelt eine Zeile aus der Datenbank.

Parameter:

String

$query

Rückgabe:

Array

Definiert in Zeile 210 der Datei db.class.php.

Benutzt query().

     {
          $res = $this->query($query);

          if   ( $res->numRows() > 0 )
               $row = $res->fetchRow( 0 );
          else
               $row = array();

          $res->free();

          return $row;
     }

DB::query

(

$

query

)

Ausführen einer Datenbankanfrage.

Parameter:

String

$query

Rückgabe:

Object (Result)

Definiert in Zeile 143 der Datei db.class.php.

Benutzt Logger::trace() und Logger::warn().

Wird benutzt von getAll(), getAssoc(), getCol(), getOne() und getRow().

     {
          Logger::trace('DB query: '.substr($query,0,45).'...');

          $result = $this->client->query($query);
          
          if   ( $result === FALSE )
          {
               $this->error = $this->client->error;
               
               if   ( true )
               {
                    Logger::warn('Database error: '.$this->error);
                    die('Database Error:<pre style="color:red">'.$this->error.'</pre>');
               }
          }
               
          return new DB_result( $this->client,$result );
     }

---

Dokumentation der Datenelemente

DB::$available

Definiert in Zeile 54 der Datei db.class.php.

DB::$client

Definiert in Zeile 68 der Datei db.class.php.

DB::$conf

Definiert in Zeile 47 der Datei db.class.php.

Wird benutzt von DB().

DB::$error

Definiert in Zeile 61 der Datei db.class.php.

DB::$id

Definiert in Zeile 40 der Datei db.class.php.

---

Die Dokumentation für diese Klasse wurde erzeugt aufgrund der Datei:

• db/db.class.php