Performing searches with MySQL and PHP 5 - MySQL

As you might have guessed, developing the business logic that drives this MySQL-based search application is reduced to defining a couple of PHP classes. These classes will be responsible for performing some crucial tasks, such as connecting to MySQL and executing a specific SELECT statement, as well as returning to the browser the corresponding database results in accordance with the search terms entered on the online form that you saw previously.

To perform all of the aforementioned tasks, below I defined two basic PHP classes. You'll probably find them quite familiar, since I have used them with some of my previous articles on PHP development published here on the prestigious Developer Shed network.

The classes in question have been wrapped into one single file, called "mysql.php", whose signature looks like this:

(definition of "mysql.php" file)

<?php

// define 'MySQL' class

class MySQL{

private $conId;

private $host;

private $user;

private $password;

private $database;

private $result;

const OPTIONS=4;

public function __construct($options=array()){

if(count($options)!=self::OPTIONS){

throw new Exception('Invalid number of connection parameters');

}

foreach($options as $parameter=>$value){

if(!$value){

throw new Exception('Invalid parameter '.$parameter);

}

$this->{$parameter}=$value;

}

$this->connectDB();

}

// connect to MySQL

private function connectDB(){

if(!$this->conId=mysql_connect($this->host,$this->user,$this-
>password)){

throw new Exception('Error connecting to the server');

}

if(!mysql_select_db($this->database,$this->conId)){

throw new Exception('Error selecting database');

}

}

// run query

public function query($query){

if(!$this->result=mysql_query($query,$this->conId)){

throw new Exception('Error performing query '.$query);

}

return new Result($this,$this->result);

}

public function escapeString($value){

return mysql_escape_string($value);

}

}

// define 'Result' class

class Result {

private $mysql;

private $result;

public function __construct(&$mysql,$result){

$this->mysql=&$mysql;

$this->result=$result;

}

// fetch row

public function fetchRow(){

return mysql_fetch_assoc($this->result);

}

// count rows

public function countRows(){

if(!$rows=mysql_num_rows($this->result)){

return false;

}

return $rows;

}

// count affected rows

public function countAffectedRows(){

if(!$rows=mysql_affected_rows($this->mysql->conId)){

throw new Exception('Error counting affected rows');

}

return $rows;

}

// get ID form last-inserted row

public function getInsertID(){

if(!$id=mysql_insert_id($this->mysql->conId)){

throw new Exception('Error getting ID');

}

return $id;

}

// seek row

public function seekRow($row=0){

if(!is_int($row)||$row<0){

throw new Exception('Invalid result set offset');

}

if(!mysql_data_seek($this->result,$row)){

throw new Exception('Error seeking data');

}

}

}

?>

As illustrated above, the previous PHP file uses a pair of MySQL processing classes to perform a search process against one or more selected databases. Also, you should notice that the versatile and extensible structure offered by the above PHP classes makes it really easy to implement an internal search engine on any existing web site, a feature that speaks for itself about the expandability of this MySQL-based search application.

So far, so good. At this time you hopefully grasped the business logic that stands behind this search engine, since it only requires a few simple PHP classes to perform the corresponding searches on the MySQL server. So what's the next step? 

Well, assuming that you may want to see how all the previously defined files can be linked with each other to implement a fully-functional search application, in the following section I'm going to develop an illustrative example to show you how to put this MySQL-based search engine to work quickly.

To learn how this hands-on example will be developed, please click on the link that appears below and keep reading.