Читать онлайн «Справочник по PHP». Страница 41

phpcredits(CREDITS_GENERAL);

Флаги можно комбинировать следующим образом:

phpcredits(CREDITS_GROUP + CREDITS_DOCS + CREDITS_FULLPAGE);

Далее приведу список доступных флагов:

php_sapi_name

Получение типа интерфейса между Web-сервером и PHP.

Синтаксис:

string php_sapi_name();

Возвращает строку, содержащую строчными буквами тип интерфейса. Для CGI PHP, это будет строка "cgi", для mod_php под Apache - "apache" и т.п.

$sapi_type = php_sapi_name();

if($sapi_type == "cgi")

echo "Это CGI PHPn";

else

echo "Это не CGI PHP а $sapi_type";

php_uname

Определение операционной системы.

Синтаксис:

string php_uname();

Возвращает строку, содержащую название операционной системы, например "Windows NT MYCOMP 5.1 build 2600".

if(substr(php_uname(),0,7) != "Windows") {

die("Этот сценарий должен выполняться в Windows.");

}

ini_set

Изменение параметра конфигурации.

Синтаксис:

string ini_set(string varname, string newvalue);

Устанавливает для указанного параметра varname значение newvalue. При успехе возвращает прежнее значение, при ошибке - false.

ini_alter

Тоже, что и ini_set().

Синтаксис:

string ini_alter(string varname, string newvalue);

ini_get

Эта функция получает значения параметров конфигурации.

Синтаксис:

string ini_get(string varname);

Возвращает текущее значение параметра конфигурации, заданное в переменной varname.

Данная функция позволяет получить все доступные в PHP параметры.

В случае ошибки возвращает false.

ini_restore

Производит восстановление параметра конфигурации.

Синтаксис:

string ini_restore(string varname);

Устанавливает значение параметра конфигурации varname в первоначальное.

echo ini_set("precision",20).ini_get("precision").

ini_restore("precision").ini_get("precision");

// Выведет 14 20 14

get_cfg_var

Получает значения параметра непосредственно из файла php.ini.

Синтаксис:

string get_cfg_var(string varname);

Надо отметить, что в отличии от функции ini_get(), которая возвращает текущее значение параметра, функция get_cfg_var() возвращает значение параметра, которое установлено в файле конфигурации php.ini. Также эта функция не возвращает другие параметры (например, из конфигурации самого сервера).

getenv

Функция возвращает значение переменной окружения.

Синтаксис:

string getenv(string varname);

$ip = getenv("REMOTE_ADDR");

echo "Ваш IP-адрес: $ip";

Список переменных окружения можно посмотреть в Приложения-Переменные окружения, или при помощи функции phpinfo().

Эта функция не работает в модуле PHP ISAPI.

putenv

Устанавливает переменную окружения.

Синтаксис:

void putenv(string setting);

putenv("UNIQID=$uniquid");

get_magic_quotes_gpc

Получает текущее значение параметра magic_quotes_gpc.

Синтаксис:

long get_magic_quotes_gpc();

Эта функция возвратит 0 для Off и 1 для On.

get_magic_quotes_runtime

Предназначена для получения текущего значения параметра magic_quotes_runtime.

Синтаксис:

long get_magic_quotes_runtime();

Эта функция возвратит 0 для Off и 1 для On.

set_magic_quotes_runtime

Предназначена для установки текущего значения параметра magic_quotes_runtime.

Синтаксис:

long set_magic_quotes_runtime(int new_setting);

Для установки magic_quotes_runtime в Off задайте параметр new_setting равным 0, а для установки в On равным 1.

php_logo_guid

Функция получения GUID логотипа PHP.

Синтаксис:

string php_logo_guid();

Строка

echo php_logo_guid();

возвратит

PHPE9568F34-D428-11d2-A769-00AA001ACF42

zend_logo_guid

Функция получения GUID логотипа Zend.

Синтаксис:

string zend_logo_guid();

Строка

echo zend_logo_guid();

возвратит

PHPE9568F35-D428-11d2-A769-00AA001ACF42

mysql_connect

Устанавливает сетевое соединение с базой данных MySQL.

Синтаксис:

int mysql_connect([string $hostname[:port][:/path/to/socket][, [,string $username [,string $password]]])

Функция mysql_connect() устанавливает сетевое соединение с базой данных MySQL, расположенной на хосте $hostname, и возвращает идентификатор открытого соединения. Вся дальнейшая работа ведется именно с этим идентификатором. При регистрации указывается имя пользователя $username и пароль $password. Строка $hostname также может включать в себя номер порта в виде "hostname:port" или путь к сокету для локальной машины в системах Unix - ":/path/to/socket" (если сервер MySQL настроен не на стандартный, а на какой-то другой порт).

При ошибке выдается предупреждение. Выдачу сообщения об ошибке можно блокировать, указав перед именем функции оператор "@".

При следующем запуске функции с теми же самыми аргументами второе соединение не будет открыто, а функция возвратит идентификатор уже существующего.

В конце сценария обычно принято закрывать подключения функцией mysql_close(), но этого можно не делать, т.к. PHP автоматически закрывает все (неустойчивые) подключения при завершении сценария.

<?php

$conn = mysql_connect ("localhost", "username", "pass")

or die ("Соединение не установлено!");

print ("Соединение установлено!");

mysql_close($conn);

?>

mysql_pconnect

Устанавливает устойчивое сетевое соединение с базой данных MySQL.

Синтаксис:

int mysql_pconnect([string $hostname[:port][:/path/to/socket][, [,string $username [,string $password]]])

Функция mysql_pconnect() устанавливает устойчивое сетевое соединение с базой данных MySQL, расположенной на хосте $hostname, и возвращает идентификатор открытого соединения. Вся дальнейшая работа ведется именно с этим идентификатором. При регистрации указывается имя пользователя $username и пароль $password. Строка $hostname также может включать в себя номер порта в виде "hostname:port"или путь к сокету для локальной машины в системах Unix - ":/path/to/socket" (если сервер MySQL настроен не на стандартный, а на какой-то другой порт).

При ошибке выдается предупреждение. Выдачу сообщения об ошибке можно блокировать, указав перед именем функции оператор "@".

При следующем запуске функции с теми же самыми аргументами второе соединение не будет открыто, а функция возвратит идентификатор уже существующего.

mysql_pconnect() действует аналогично mysql_connect(), но с двумя отличиями:

mysql_close

Закрывает установленное ранее соединение с базой данных.

Синтаксис:

int mysql_close ([int link_identifier])

Закрывает соединение с MySQL-сервером с идентификатором link_identifier, или последнее открытое соединение, если используется без идентификатора.

Возвращает true при удачном закрытии или false при ошибке.

Использование этой функции не обязательно, т.к. PHP автоматически закрывает все неустойчивые подключения при завершении работы сценария.

Подключения, установленные функцией mysql_pconnect(), не закрываются.

<?php

$conn = mysql_connect ("localhost", "username", "pass")

or die ("Соединение не установлено!");

print ("Соединение установлено!");

mysql_close($conn);

?>

mysql_change_user

Изменяет параметры подключения.

Синтаксис:

int mysql_change_user(string user, string password [, string database [, int link_identifier]])

Если не указывается БД или подключение, то используется последняя активная БД.

Если авторизация не произошла, то параметры подключения не изменяются.

Работает с MySQL 3.23.3 и выше.

mysql_list_dbs

Возвращает список БД на сервере.

Синтаксис:

int mysql_list_dbs([int link_identifier])

Возвращает набор записей, содержащий список БД на сервере.

$bd=mysql_connect("localhost", "name", "pass");

$bd_list=mysql_list_dbs($bd);

while($row=mysql_fetch_object($bd_list)) {

echo $row->Database."n";

}

Надо отметить, что список баз данных можно получить не имея привелегий, т.е. не указывая пароль доступа.

mysql_db_name

Возвращает имя базы данных из списка.

Синтаксис:

int mysql_db_name(int result, int row [, mixed field])

Параметр result задает дескриптор набора записей, полученных при помощи функции mysql_list_dbs(). Аргумент row указывает номер записи.

В случае ошибки данная функция возвращает false.

mysql_connect("localhost", "username", "pass");