Программный интерфейс

языка РНР

Это приложение посвящено описанию программного интерфейса языка написания сценариев РНР для MySQL. Данный программный интерфейс состоит из набора функций, обеспечивающих взаимодействие с серверами MySQL, и получения доступа к базам данных.

Рекомендуется использовать это приложение как справочное руководство, поскольку оно включает только краткие фрагменты кода, иллюстрирующие использование программного интерфейса языка РНР. Полностью завершенные сценарии, а также рекомендации по их написанию можно найти в главе 8, Интерфейс API для языка написания сценариев РНР. Здесь же описаны только функции, которые непосредственно связаны с MySQL. Руководство по РНР (в настояшее время это порядка 800 страниц) содержит около 600 страниц справочного материала, поэтому данное приложение может только подытожить определенную часть возможностей РНР. Для получения полного справочного руководства по РНР посетите Web-узел РНР по следующему адресу:

http: www.php.net/

Написание сценариев РНР

Сценарии РНР представляют собой простые текстовые файлы, которые могут содержать смесь кода HTML и РНР. В процессе интерпретации таких сценариев создается Web-страница, которая отправляется клиенту. HTML-код копируется в выводимые данные без предварительной интерпретации. Код РНР обрабатывается и заменяется создаваемыми выходными данными (или просто удаляется при отсутствии вывода).

Средства РНР приступают к интерпретации файла в режиме HTML. Переключаться в режим кода РНР и обратно можно с помощью специальных тэгов, отражающих соответственно начало и конец кода РНР. Количество переключений между режимами в одном файле не ограничено. Язык РНР распознает четыре типа тэгов, причем некоторые из них должны явным образом добавляться, если пользователь желает воспользоваться ими. Один из способов сделать это - включить тэги в файл инициализации РНР, php3.ini. Месторасположение этого файла зависит от системы, хотя зачастую его можно найти в каталоге /usr/local/lib.

РНР распознает тэги следующих типов.

В стиле по умолчанию (the default style) используются тэги

<?php И ?> :

<?php echo ( Код РНР ); ?>

В стиле с коротким тэгом открытия (short-open-tag style) используются тэги <? и ?>

<? Echo ( Код РНР ); ?>

Этот стиль тэгов можно активизировать с помощью установки в файле инициализации РНР:

short open tag = On; *

В совместимом с Active Server Page стиле (Active Server Page-comapible style) используются тэги <% и %> :

<% echo ( Код PHP: ; %>

Тэги этого стиля также можно активизировать с помощью установки в файле инициализации РНР;

asp tags = On;

Поддержка ASP-тэгов была добавлена в РНР версии 3.0.4.

При работе с HTML-редактором, который не распознает другие стили, можно использовать тэги <SCRIPT> и </SCRlPT>; <SCRIPT LANGUAGE= php > echo ( Код PHP ); </SCRIPT>

функции

Этот раздел посвящен описанию связанных с MySQL функций языка РНР. В последующем изложении необязательно задаваемая информация заключается в квадратные скобки ([ ]).

Многие описанные далее функции считывают необязательный параметр link id (идентификатор связи), который определяет соединение с сервером MySQL. Если при вызове функции идентификатор связи не задается, вместо него используется последнее открытое соединение. Некоторые функции попытаются установить соединение самостоятельно, если идентификатор связи не задан и нет ни одного открытого соединения.

Параметр result id представляет собой идентификатор результирующего набора, возвращаемый обычно функциями mysql db query () и mysql query() .

Некоторые функции в случае возникновения ощибки помимо возвращения значения состояния выводят еще и сообщение об ощибке. При работе в Web это сообщение появляется в отправляемых клиентскому броузеру данных вывода, что не всегда желательно. Чтобы исключить вывод сообщения об ощибке (возможно, закодированного), перед именем вызываемой функции необходимо установить символ @ . Например, чтобы отменить вывод сообщения об ошибке функцией mysql pconnect (), можно задать ее следующим образом: <?php

Slxnk = @mysql pconnect ( pxt-vxper.snake.net , paul , secret )

or dxe ( Невозможно установить соединение ); prxnt ( Соединение установлено успешно );

Второй способ избежать вывода сообщения об ошибке - воспользоваться функцией error reporting ()

<?php

error reportxng (0); #отменить все сообщения об ошибках

$1хпк = @mysql pconnect ( pxt-vxper.snake.net , paul , secret )

or die ( Невозможно установить соединение ); prxnt ( Соединение установлено успешно );

?>

Многие сценарии из приведенных примеров выводят после подключения к серверу MySQL сообщение Соединение установлено успешно . Это позволяет убедиться в том, что сценарий выводит данные, если, конечно, он используется исключительно в личных целях. Сценарии РНР, которые вовсе ничего не выводят, в некоторых броузерах вьщают предупреждение page contains no data (страница не содержит данных).

В последующих описаниях выражение запрос select означает запрос select или любой другой, возвращающий строки, например, describe, explain ИЛИ show.