В этом разделе приводятся описания наиболее часто используемых функций, позволяющих работать с MySQL средствами PHP.
Замечание
SQL может применятся в прикладных программах двумя способами: в виде встроенного SQL и интерфейса программирования приложений (Application Program Interface, API). Первый способ напоминает использование PHP - инструкции SQL размещаются среди кода прикладной программы. В настоящий момент такой стиль не поддерживает ни MySQL ни PHP. Второй подход заключается в том, что программа взаимодействует с СУБД посредством совокупности функций. Именно такой подход используется при взаимодействии PHP и MySQL.
mysql_connect
resource mysql_connect ([string server [, string username [, string password]]])
Эта функция устанавливает соединение с сервером server MySQL и возвращает дескриптор соединения с базой данных, по которому все другие функции, принимающие этот дескриптор в качестве аргумента, будут однозначно определять выбранную базу данных. Вторым и третьим аргументами этой функции являются имя пользователя username и его пароль password соответственно:
$dblocation = "localhost"; // Имя сервера
$dbuser = "root"; // Имя пользователя
$dbpasswd = ""; // Пароль
$dbcnx = @mysql_connect($dblocation,$dbuser,$dbpasswd);
if (!$dbcnx) // Если дескриптор равен 0 соединение не установлено
{
echo("
В настоящий момент сервер базы данных не доступен, поэтому
корректное отображение страницы невозможно.
exit();
}
?>
Переменные $dblocation, $dbuser и $dbpasswd хранят имя сервера, имя пользователя и пароль, и, как правило, прописываются в отдельном файле (к примеру, config.php), который потом вставляется в каждый PHP-файл, в котором имеется код для работы с MySQL:
$dblocation = "localhost";
$dbname = "forum";
$dbuser = "root";
$dbpasswd = "";
?>
mysql_close
bool mysql_close ([resource link_identifier])
Эта функция разрывает соединение с сервером MySQL, и возвращает true при успешном выполнении операции и false в противном случае. Функция принимает в качестве аргумента дескриптор соединения с базой данных, возвращаемый функцией mysql_connect.
К примеру:
// устанавливаем соединение с базой данных
$dbcnx = @mysql_connect($dblocation,$dbuser,$dbpasswd);
if (!$dbcnx)
{
// Выводим предупреждение
echo ("<P>В настоящий момент сервер базы данных не доступен, поэтому
корректное отображение страницы невозможно.</P>");
// Завершаем работу в случае неудачи
exit();
}
if(mysql_close($dbcnx)) // разрываем соединение
{
echo("Соединение с базой данных прекращено");
}
else
{
echo("Не удалось завершить соединение");
}
mysql_select_db
bool mysql_select_db (string database_name [, resource link_identifier])
Использование этой функции эквивалентно вызову команды USE в SQL-запросе, т. е. функция mysql_select_db выбирает базу данных для дальнейшей работы, и все последующие SQL-запросы применяются к выбранной базе данных. Функция принимает в качестве аргументов название выбираемой базы данных database_name и дескриптор соединения resource. Функция возвращает true при успешном выполнении операции и false в противном случае. К примеру:
// Код соединения с базой данных
if (!@mysql_select_db($dbname, $dbcnx))
{
echo( "
В настоящий момент база данных не доступна, поэтому
корректное отображение страницы невозможно.
exit();
}
?>
Имеет смысл помещать функции для соединения и выбора базы данных в тот же файл (config.php), где объявлены переменные с именами сервера, пользователя и паролем:
$dblocation = "localhost";
$dbname = "softtime";
$dbuser = "root";
$dbpasswd = "";
$dbcnx = @mysql_connect($dblocation,$dbuser,$dbpasswd);
if (!$dbcnx)
{
echo( "
В настоящий момент сервер базы данных не доступен, поэтому
корректное отображение страницы невозможно.
exit();
}
if (!@mysql_select_db($dbname, $dbcnx))
{
echo( "
В настоящий момент база данных не доступна, поэтому
корректное отображение страницы невозможно.
exit();
}
?>
mysql_query
resource mysql_query (string query)
Эта функция применяется для отправки серверу SQL-запросов. Функция возвращает дескриптор запроса в случае успеха и false в случае неудачного выполнения запроса. В листинге 13.32 показан код, с помощью которого извлекается одна строка из таблицы authors базы данных forum.
include "config.php";
$ath = mysql_query("select * from authors;");
if($ath)
{
$author = mysql_fetch_array($ath);
echo "
имя = ".$author['name']."
";
echo "пароль = ".$author['passw']."
";
echo "e-mail = ".$author['email']."
";
echo "url = ".$author['url']."
";
echo "ICQ = ".$author['icq']."
";
echo "about = ".$author['about']."
";
echo "photo = ".$author['photo']."
";
echo "time = ".$author['time'];
}
else
{
echo "
Error: ".mysql_error()."
";exit();
}
?>
Результат выполнения показан на следующем рисунке:
mysql_fetch_array
array mysql_fetch_array (resource result)
Эта функция возвращает значения полей в виде ассоциативного массива, в качестве аргумента принимает дескриптор запроса возвращаемый функцией mysql_query. Вот как с помощью этой функции можно вывести все строки таблицы authors:
include "config.php";
$ath = mysql_query("select * from authors;");
if($ath)
{
// Определяем таблицу и заголовок
echo "
| имя | пароль | url | |
| ".$author['name']." | ".$author['passw']." | ".$author['email']." | ". $author['url']." |
}
else
{
echo "
Error: ".mysql_error()."
";
exit();
}
?>
Результат показан на следующем рисунке:
mysql_result
mixed mysql_result (resource result, int row)
С помощью этой функции можно получить доступ к отдельному полю записи. Допустим, нам нужно вывести имя автора, который первым найдется в базе данных. Сделать это можно следующим образом:
include "config.php";
$ath = mysql_query("select name from authors;");
if($ath)
{
echo mysql_result($ath,0,'name');
}
else
{
echo "
Error: ".mysql_error()."
";
exit();
}
?>
mysql_fetch_object
object mysql_fetch_object (resource result)
Эта функция возвращает поля записи данных в виде объекта. Ниже приведен пример, в котором с помощью этой функции из таблицы authors выводятся имя, URL и e-mail авторов.
include "config.php";
$ath = mysql_query("select * from authors;");
if($ath)
{
while($row = mysql_fetch_object($ath))
{
echo "
name: ".$row->name."
";echo "
url: ".$row->url."
";echo "
email: ".$row->email."
";}
}
else
{
echo "
Error: ".mysql_error()."
";
exit();
}
?>
Результат выполнения показан на следующем рисунке:
mysql_fetch_row
array mysql_fetch_row (resource result)
В отличие от функции mysql_fetch_object, эта функция возвращает не объект, а массив, в котором содержатся значения полей:
include "config.php";
$ath = mysql_query("select * from authors;");
if($ath)
{
while($row = mysql_fetch_row($ath))
{
echo "
name: ".$row[1]."
";echo "
url: ".$row[4]."
";echo "
email: ".$row[3]."
";}
}
else
{
echo "
Error: ".mysql_error()."
";
exit();
}
?>
Результат выполнения этого кода в точности совпадает с приведённым выше.