Using Relevance Rankings for Full Text and Boolean Searches with MySQL - Building an additional example (
Page 4 of 4 )
In consonance with the concepts deployed in the previous section, the last example that I'm going to show you here will consist of demonstrating how MySQL is capable of returning different relevance rankings according to the search terms entered in a web form.
In this case, I'm going to use two concatenated search words to return a couple of relevance values from the previous "USERS" database table, instead of only one. I'm going to use the pair of source files that you learned in the beginning of the article, so here are their respective signatures:
(definition of form.htm file)
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-
8859-1" />
<title>Working with relevance results</title>
<style type="text/css">
body{
padding: 0;
margin: 0;
background: #fff;
}
h1{
font: bold 16px Arial, Helvetica, sans-serif;
color: #000;
text-align: center;
}
p{
font: bold 11px Tahoma, Arial, Helvetica, sans-serif;
color: #000;
}
#formcontainer{
width: 40%;
padding: 10px;
margin-left: auto;
margin-right: auto;
background: #6cf;
}
</style>
</head>
<body>
<h1>Working with relevance results</h1>
<div id="formcontainer">
<form action="search.php" method="get">
<p>Enter search term here : <input type="text" name="searchterm"
title="Enter search term here" /><input type="submit"
name="search" value="Search Now!" /></p>
</form>
</div>
</body>
</html>
(definition of search.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');
}
}
}
try{
// connect to MySQL
$db=new MySQL(array
('host'=>'host','user'=>'user','password'=>'password',
'database'=>'database'));
$searchterm=$db->escapeString($_GET['searchterm']);
$result=$db->query("SELECT firstname, MATCH
(firstname,lastname,comments) AGAINST('$searchterm') AS
relevance FROM users");
if(!$result->countRows()){
echo 'No results were found.';
}
else{
echo '<h2>Users returned are the following:</h2>';
while($row=$result->fetchRow()){
echo '<p>Name: '.$row['firstname'].' Relevance: '.$row
['relevance'].'</p>';
}
}
}
catch(Exception $e){
echo $e->getMessage();
exit();
}
?>
Now, after listing the two previous source files, please study the following results returned by MySQL after entering the search string "alejandro+susan" in the corresponding web form:
// PHP file displays the following:
/*
Users returned are the following:
Name: Alejandro Relevance: 1.0167628961849
Name: John Relevance: 0
Name: Susan Relevance: 1.0277009445163
Name: Julie Relevance: 0
*/
As you can see, in the previous case the search query has returned two different relevance rankings in accordance with the inputted search terms. Hopefully, this last example should give you a better idea of the way that MySQL handles relevance values.
As usual with many of my articles on PHP development, feel free to modify all the code samples shown here, so you can start quickly implementing full-text searches in your own web applications.
Final thoughts
In this second article of the series, I provided you with a basic introduction to using relevance rankings when performing full-text searches with MySQL. In the final part I'm going to complete this interesting subject by teaching you how to use Boolean operators with your search queries.
You've been warned, so don't miss it!
