Глава №18.

Справочник по PHP и Lite

PHP

Здесь вы найдете краткое справочное руководство по РНР. Список приведенных функций относится к РНР 3. Описаны те функции, которые работают с MySQL и mSQL, но пропущены функции для работы с другими серверами баз данных, такими как Ababas D, dbm, Oracle и PostgreSQL.

abs

$pos_num = abs($number);

Abs возвращает абсолютное значение аргумента number.

addslashes

$escaped_string = addslashes($string); .

Возвращает копию строки string , в которой экранированы все символы $ \ или '.

asort

$sorted_array = asort($array);

Возвращает отсортированную копию ассоциативного массива array, asort работает только с ассоциативными массивами. Для сортировки обычных массивов используйте sort. Если первый элемент массива является числом, возвращаемый массив будет отсортирован по порядку, иначе он будет отсортирован по алфавиту.

bindec

$decimal = bindec($binary);

Функция возвращает десятичный эквивалент указанного двоичного числа binary.

ceil

$higher_integer = ceil($number);

Округляет заданное число до следующего целого числа и возвращает результат как число с плавающей запятой.

chdir

chdir($directory);

Изменяет текущий рабочий каталог на каталог, заданный аргументом.

chgrp

chgrp($file,Sgroupj;

Изменяет идентификатор группы заданного файла на группу, указанную в аргументе.

chimed

chimed($file,$permissions);

Функция изменяет права доступа к файлу на указанные в аргументе permissions . Этот аргумент задается в восьмеричном виде.

chown

chown($file, Sowner);

Изменяет владельца заданного файла на указанного в аргументе owner. Эта функция будет работать только в том случае, если РНР выполняется от имени суперпользователя, что обычно не рекомендуется.

chop

$stripped_string = chop($string);

Возвращает строку string , у которой удалены все имевшиеся концевые пробелы, табуляции и символы новой строки.

chr

$character = chr($number);

Возвращает символ ASCII, соответствующий заданному числовому аргументу. Шестнадцатеричные и восьмеричные числа обозначаются как 0xff и 077 соответственно. Остальные числа считаются десятичными.

clearstack

clearstack();

Очищает текущий стек. Эта функция создана специально, чтобы обойти некоторые ограничения в дизайне РНР. Если у вас есть пользовательская функция, содержащая большой цикл, вы можете столкнуться с проблемами, связанными с нехваткой стекового пространства. Если это происходит, вызовите clearstack() из этого цикла. Недостаток данного метода в том, что вашу функцию невозможно будет вызвать из другой функции. Результат функции следует сохранить в переменной, которая может быть затем использована по вашему усмотрению.

clearstatcache

clearstatcache();

Очищает кэш, используемый всеми функциями, которые получают информацию о файлах. Так как доступ к такой информации занимает достаточно много времени, РНР хранит ее в кэше. Если вам необходи-ма уверенность, что используете самую свежую информацию о файле (то есть не кэшированную), вызовите функцию clearstatcache(); перед получением этой информации.

closedir

closed!r($directorу);

Закрывает каталог, открытый функцией opendir.

closelog

closelog();

Останавливает всю журнализацию, выполняемую функцией syslog .

COS

$result = cos($number);

Возвращает косинус аргумента number.

count

$number = count($array);

Возвращает число элементов в массиве array. Если переменная не является массивом, функция вернет значение 1 (так как переменная подобна массиву с только одним элементом). Если аргумент array не указан, функция вернет 0.

crypt

$encrypted_string = crypt($string);

$encrypted_string = crypt($string, $salt);

Шифрует заданную строку. Используется стандартный метод шифрования Unix - DES, тот же, что используется для шифрования паролей и т. д. Можно задать необязательный двухсимвольный аргумент salt (база для шифрования).

date

$formatted_date = date($format,$time);

Вернет time (стандарное время Unix, выдаваемое функцией Time), отформатированное в указанный format. Возвращаемое значение имеет тот же вид, что и format, где все указанные ниже символы заменены на соответствующие значения:

А АМ/РМ

a am/pm

D День (например Sun)

d День (например 13)

F Месяц (например February)

Н Час в 24-часовом формате (например 17)

h Час в 12-часовом формате (например 5)

i Минуты (например 30)

l День (например Sunday)

М Месяц (например Feb)

m Месяц (например 02)

s Секунды (например 27)

Y Год (например 1998)

у Год (например 98)

U Секунды с начала эпохи (отсчета) (например 803537321)

Z День года (например 154)

dblist

$db_info = dblist();

Вернет список СУБД, поддерживаемых РНР.

decbin

$binary = decbin($decimal);

Возвращает двоичный эквивалент указанного десятичного числа.

dexhex

$hex = dechex($decimal);

Возвращает шестнадцатеричный эквивалент указанного десятичного числа.

decoct

$octal = decoct($decimal);

Возвращает восьмеричный эквивалент указанного десятичного числа.

doubleval

$double = doubleval($variable);

Возвращает значение переменной в виде числа с плавающей запятой.

echo

echo [format_string] expression [, expression ...]

He является настоящей функцией, скорее, это встроенная в РНР версия функции printf языка С. В самом простом варианте echo напечатает результат выражения expression . Можно указать до пяти выражений, результат каждого из которых будет напечатан по очереди. Также можно указать строку форматирования, которая должна иметь тот же вид, что и в функции printf языка С или Perl.

end

end($array);

Устанавливает внутренний указатель массива array на последний элемент массива.

ereg

$result = ereg($expression, $string);

$result = ereg($expression, $string, $match_array);

Вернет true, если строка string отвечает регулярному выражению в expression . Если в качестве третьего аргумента указан массив, значение, отвечающее выражению, будет помещено в массив.

eregi

$result = eregi($expression, $string);

$result = eregi($expression, Sstring, $match_array);

Идентично ereg, за исключением того, что при сравнении игнорируется регистр.

ereg_replace

ereg_replace($expression, $replacement_string, $string);

Замещает все части в указанной строке string , которые отвечают выражению expression , строкой replacement_string.

eregi_replace

eregi_replace($expression, $replacement_string, $string);

Идентично ereg_replace, за исключением того, что при сравнении игнорируется регистр.

escapeshellcmd

$safe_string = escapeshellcmd(Sstring);

Возвращает копию строки string, все спецсимволы которой перекодированы так, что строку можно безопасно использовать с функциями exec или system.

eval

eval($string);

Обрабатывает содержимое строки string таким образом, как если бы это был скрипт РНР. Для строки выполняется подстановка переменных, поэтому, если вы хотите использовать переменную в этом «минискрипте», ее следует заэкранировать.

exec

$last_line = exec($command);

$last_line = exec($command, $output_array);

$last_line = exec($command, $output_array, $return_code);

Выполняет в вызываемой подоболочке Unix команду command . Возвращается только последняя строка результата команды. Если вторым аргументом указан массив, все строки, выводимые командой, будут помещены в него. Если есть третий аргумент, в эту переменную записывается код возврата команды.

exit

exit();

Завершение синтаксического анализа HTML-файла.

ехр

$result = exp($number);

Возвращает число е, возведенное в указанную степень.

fclose

fclose($fd);

Закрывает файл, открытый fopen.

feof

$result = feof($fd);

Возвращает true, если файловый дескриптор fd находится в конце файла.

fgets

$line = fgets($fd, $max_bytes);

Возвращает следующую строку (длиной до max_bytes ) из файла, на который указывает fd.

fgetss

$line = fgetss($fd, $max_bytes);

Идентична fgets за исключением того, что эта функция пытается удалить любые теги HTML или РНР при чтении файла.

file

$аггау = file($filename);

Возвращает массив, каждый элемент которого содержит строку файла, указанного в filename.

fileatime

$time = fileatime($filename);

Возвращает (в стандартном формате времени Unix) время последнего доступа к файлу filename . Если эта информация по каким-либо причинам не может быть получена, функция возвращает — 1.

filectime

$time = filectime($filename);

Возвращает время (в стандартном формате времени Unix) последнего изменения статуса файла filename . Если эта информация по каким-либо причинам не может быть получена, функция возвращает -1.

filegroup

$group_id = filegroup($filename);

Возвращает идентификатор группы файла. Если эта информация по каким-либо причинам не может быть получена, функция возвращает -1.

fileinode

$inode = fileinode($filename);

Возвращает индексный дескриптор файла filename . Если эта информация по каким-либо причинам не может быть получена, функция возвращает -1.

filemtime

$time = filemtime($filename);

Возвращает время (в стандартном формате времени Unix) последнего изменения файла filename . Если эта информация по каким-либо причинам не может быть получена, функция возвращает -1.

fileowner

$owner = fileowner($filename);

Возвращает ID владельца файла. Если эта информация по каким-либо причинам не может быть получена, функция возвращает -1.

fileperms

$permissions = fileperms($filename);

Возвращает права доступа к указанному в filename файлу. Если эта информация по каким-либо причинам не может быть получена, функция возвращает —1.

filesize

$size = filesize($filename);

Возвращает размер файла в байтах. Если эта информация по каким-либо причинам не может быть получена, функция возвращает -1.

filetype

$type = filetype($filename);

Возвращает одно из следующих значений, указывающих на тип файла

filename : dir, file, fifo, char, block или link.

floor

$lower_integer = floor($number);

Округляет число number до ближайшего меньшего целого и возвращает результат в виде числа с плавающей запятой.

flush

flush();

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

fopen

$fd = fopen($filename, $mode);

Открывает файл в режиме mode и возвращает указатель на дескриптор, связанный с открытым файлом. Как и в функции fopen языка С, режим может быть одним из следующих: «r», «r+», «w», «w+», «a», «а+». Функция возвращает -1, если файл невозможно открыть.

fputs

fputs($fd, $string);

Записывает строку string в файл, связанный с дескриптором fd.

fpassthru

fpassthru($fd);

Печатает все оставшиеся данные файла, на который указывает дескриптор fd.

fseek

fseek($fd, $position);

Устанавливает дескриптор файла fd на позицию (смещение от начала файла), указанную в аргументе position.

fsockopen

$fd = fsockopen($hostname,$port);

Открывает соединение с hostname на порте port и возвращает дескриптор файла, связанный с открытым соединением. Если номер порта равен 0, аргумент hostname будет рассматриваться как имя в стиле имени файла сокета Unix на локальном хосте. В случае ошибки функция вернет следующие значения: -3, если не удалось создать сокет; —4, если не удалось разрешить имя хоста (установить IP-адрес); —5, если в соединении было отказано или оно закончилось по тайм-ауту; -6, если потерпел неудачу вызов fdopen() и, наконец, -7, если потерпел неудачу вызов setvbuf().

ftell

Sposition = ftell($fd);

Возвращает позицию указателя в файле, связанном с fd. Это значение можно использовать в качестве аргумента для fseek.

getaccdir

$directory = getaccdir();

Возвращает имя каталога, где хранятся файлы конфигурации РНР.

getenv

$value = getenv($variable);

Возвращает значение переменной окружения, указанной в variable .

gethostbyname

Saddress = gethostbyname($hostname);

Возвращает IP-адрес указанного в hostname хоста.

gethostbyaddr

$hostname = gethostbyaddr($address);

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

getimagesize

$file_info_array = getimagesize($filename);

Возвращает массив информации о графическом изображении в указанном filename. Первый элемент массива- ширина изображения, второй - высота, и третий - тип рисунка. В настоящее время распознаются типы GIF, JPG и PNG. Четвертым элементом является строка формата «width=xxx height=yyy», которая может непосредственно использоваться в теге HTML <IMG>.

getlastaccess

$time = getlastaccess();

Возвращает дату и время (в стандартном формате Unix) последнего обращения к странице. Эта функция будет работать, только если РНР был откомпилирован с опцией регистрации доступа.

getlastbrowser

$browser = getlastbrowser();

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

getlastemail

$email = getlastemail();

Возвращает адрес электронной почты пользователя, который последним обращался к странице. Эта функция работает, только если РНР был откомпилирован с опцией регистрации доступа.

getlasthost

$host = getlasthost();

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

getiastmod

$time = getlastmod();

Возвращает время (в стандартном формате времени Unix) последнего изменения страницы. Эта функция работает, только если РНР был откомпилирован с опцией регистрации доступа.

getlastref

$url = getlastref();

Возвращает URL узла, с которого пришел последний посетитель страницы. Эта функция работает, только если РНР был откомпилирован с опцией регистрации доступа.

getlogdir

$directory = getlogdir();

Возвращает каталог, в котором находятся журналы регистрации РНР.

get my in ode

$inode = getmyinode();

Возвращает указатель inode HTML-файла, содержащего текущий скрипт РНР.

getmypid

$pid = getmypid();

Возвращает идентификатор текущего РНР-процесса.

getmyuid

$id = getmyuid();

Возвращает идентификатор пользователя владельца HTML-файла, содержащего текущий скрипт.

getrandmax

$number = getrandmax();

Возвращает максимально возможное число, которое может вернуть функция rand.

getstartlogging

$time = getstartlogging();

Возвращает время (в стандартном формате Unix) начала регистрации на странице HTML, которая содержит текущий скрипт.

gettoday

$hits = gettoday();

Возвращает число обращений к данной странице, начиная с 0 часов текущих суток.

gettotal

$hits = gettotal();

Возвращает общее число обращений к текущей странице с начала регистрации доступа к странице.

gettype

$type = gettype($variable);

Возвращает одно из следующих значений: «integer», «double» или «string», указывающих на тип заданной переменной variable .

gmdate

$formatted_date = gmdate($format, $time);

Идентично Date за исключением того, что для обработки значений используется время по Гринвичу (GMT) вместо местного времени.

header

header($header_string);

Выводит header_string как HTTP-заголовок. Эта функция должна использоваться перед любым HTML-текстом в файле и перед любыми командами РНР, которые выдают какой-либо результат.

hexdec

$decimal = hexdec($hex);

Возвращает десятичный эквивалент шестнадцатеричного аргумента hex.

htmlspecialchars

$html_string = htmlspecialchars($string);

Возвращает строку string, заменяя любые специальные символы (включая <, >, &, " и все ASCII-символы с кодами от 160 до 255) на соответствующие им HTML-коды.

imagearc

imagearc($image, $сх, $су, $width, $height, $start, $end, $color);

Рисует сектор эллипса в изображении image цветом, указанным в color. Центр эллипса находится в точке (сх, су), ширина указана аргументом width, высота- height, начальная и конечная точки указываются в градусах аргументами start и end соответственно.

imagechar

imagechar($image, $size, $x, $y, $character, $color);

Рисует символ character в изображении image цветом, назначенным в color, с размером шрифта size. Левый верхний угол символа находится в точке (х, у).

imagecharup

imagecharup($image, $size, $x, $y, $character, $color);

Функция идентична imagechar за исключением того, что символ выводится вертикально, (х, у) указывают на координаты верхнего левого угла.

imagecolorallocate

$color = imagecolorallocate($image, $red, $green, $blue);

Возвращает цвет для работы с изображением image, используя указанные RGB-компоненты.

imagecolortransparent

imagecolortransparent($image, $color);

Устанавливает color как прозрачный цвет для изображения image.

imagecopyresized

imagecopyresized($dest_image, $src_image, $dest_x, $dest_y, $src_x, $src_y, $dest_width, $dest_heigth, $src_width, $src_heigth);

Копирует прямоугольную область из изображения src_image в изображение dest_image , изменяя размер, если это необходимо. Аргументы dest_x и dest_y являются координатами левой верхней вершины прямоугольника в принимающем изображении, a dest_height и dest_width - его высотой и шириной. Аргументы src_x, src_y,' src_width, и src_heigth являются соответствующими значениями для изображения-источника.

imagecreate

$image = imagecreate($width, $height);

Возвращает идентификатор изображения, указывающий на новое изображение с заданными размерами.

imagecreatefromgif

$image = imagecreatefromgif($filename);

Возвращает идентификатор изображения, указывающий на изображение в заданном файле filename .

imagedestroy

imagedestroy($image);

Освобождает все ресурсы, занятые image.

imagefill

imagefill($image, $х, $у, $color);

Выполняет заливку изображения image цветом color, начиная с точки (х,у).

imagefilledpolygon

imagefilledpolygon($image, $points_array, $num_points, $color);

Создает многоугольник в image, заполненный цветом color. Второй аргумент является массивом вершин многоугольника. Первые два элемента - это значения х и у первой вершины. Следующие два элемента— координаты следующей вершины и т. д. Третий аргумент указывает на число вершин многоугольника.

imagefilledrectangle

imagefilledrectangle($image, $х1, $у1, $х2, $у2, $color);

Создает прямоугольник в image, заполненный цветом color. Аргументы х1 и у1 образуют верхнюю левую вершину прямоугольника, а х2 и у2 — правую нижнюю.

imagefilltoborder

imagefilltoborder($image, $x, $y, $border, $color);

Функция идентична imagefill за исключением того, что заливка цветом прекращается там, где встречается цвет border.

imagegif

imagegif($image);

imagegif($image, $filename);

Выводит изображение image как рисунок GIF. Если указан второй аргумент, рисунок GIF будет записан в этот файл, иначе он будет направлен прямо в броузер.

imageinterlace

imageinterlace($image, $interlace);

Функция переключает бит чередования для изображения image на значение interlace , которое может быть равно 1 (включить) или 0 (выключить).

imageline

imageline($iraage, $х1, $у1, $х2, $у2, $color);

Создает линию указанного в color цвета от точки (х1, у2) до точки (х2, у2) в изображении image.

imagepolygon

imagepolygon($image, $points, $numpoints, $color);

Функция идентична imagef illedpolygon за исключением того, что многоугольник не заполняется.

imagerectangle

imagerectangle($image, $х1, $у1, $х2, $у2, $color);

Функция идентична imagefilledrectangle за исключением того, что прямоугольник не заполняется.

imagesetpixel

imagesetpixel($image, $x, $y, $color);

Рисует точку в изображении image в позиции (х, у) цветом, указанным в color.

imagestring

imagestring($image, $size, $x, $y, $string, $color);

Функция идентична imagechar за исключением того, что она выводит всю строку string.

imagestring up

imagestringup($image, Ssize, $x, $y, $string, $color);

Функция идентична imagecharup за исключением того, что она выводит всю строку string.

imagesx

$x_size = imagesx($image);

Возвращает ширину в пикселах изображения, указанного в image.

imagesy

$y_size = imagesy($image);

Возвращает высоту изображения в пикселах.

include

include($filename);

Вставляет файл, указанный в filename , в текущую страницу. Выполняется полный синтаксический PHP-анализ подключаемого файла. В поисках файла filename просматривается каждый из каталогов, указанных в переменной окружения PHP_INCLUDE_ PATH.

initsyslog

initsyslog();

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

intval

$integer = intval($variable);

Возвращает содержимое variable в виде целого числа.

isset

$defined = isset($variable);

Возвращает 1, если переменная variable определена, иначе вернет 0.

key

$key = key($array);

Возвращает ключ текущего элемента массива array. Для ассоциативного массива возвращает имя ключа. Для обычного массива возвращает номер элемента.

link

link($target, $filename);

Создает жесткую ссылку от filename к target.

linkinfo

$info = linkinfo($filename);

Возвращает истинное значение, если ссылка, указанная в filename , существует (но не обязательно существует файл, на который указывает ссылка). В случае ошибки функция возвращает —1.

log

$result = log($number);

Возвращает натуральный логарифм аргумента number.

log10

$result = Iog10($number);

Возвращает логарифм по основанию 10 аргумента number.

logas

logas($filename);

Регистрирует посещение текущей страницы как посещение указанного filename вместо файлового имени страницы.

mail

mail($to, $subject, $message);

mail($to, $subject, $message, $headers);

Посылает электронное письмо по адресу, указанному в параметре to, с темой, указанной в параметре subject, и поместит в тело письма значение аргумента message . Если указан четвертый аргумент, он добавляется к заголовку письма.

max

$maximum = max($array);

Возвращает максимальное значение в массиве array. Если это строковый массив, функция возвращает элемент, последний по алфавиту.

md5

$hash = md5($string);

Возвращает хэш (MD5) строки string .

microtime

$ms = microtime();

Возвращает строку, содержащую часть текущей секунды (в виде десятичной дроби), за которой следует стандартное время Unix.

min

$minimum = min($array);

Возвращает минимальное значение в массиве array. Если это строковый массив, функция вернет элемент, который был бы первым по алфавиту.

mkdir

mkdir($directory, $mode);

Создает каталог directory с указанным режимом mode, mode должно быть восьмеричным значением.

mktime

$time = mktime($hour,$minute,$second,$month,$day, Syear);

Возвращает время в стандартном формате времени Unix, основываясь на заданных аргументах. Если указано менее шести параметров, параметры справа считаются соответствующими текущему значению времени (например, если дано четыре параметра, используются текущий день и год).

msql mysql

$result = msql($database, $query);

$result = mysql($database, $query);

Посылает запрос query базе данных mSQL/MySQL, указанной в аргументе database. Для не SELECT-запросов функция возвращает 0 для mSQL 1.x и MySQL, а для mSQL 2.x возвращает число измененных записей. Для запроса SELECT функция возвращает идентификатор результата, который может быть использован в других функциях msql_ *. В случае ошибки функция вернет -1.

my sql_af f ected_ro ws

$num_rows = mysql_affected_rows();

Возвращает число записей, измененных последней из команд INSERT, UPDATE или DELETE.

msql_close mysql_close

msql_close(); mysql_close();

Закрывает подключение к серверу базы данных mSQL/MySQL.

msql_connect mysql_connect

msql_connect($hostname);

mysql_connect($hostname);

mysql_connect($hostname, Susername);

mysql_connect($hostname, $username, Spassword);

Создает соединение с сервером базы данных mSQL/MySQL на указанном хосте hostname. Подключение к серверу на локальном хосте осуществляется с помощью m(y)sql_connect("localhost"). Если при первом вызове m(y)sql нет подключения к базе данных, подключение к локальному хосту создается автоматически. Для MySQL может быть указан необязательный аргумент username или комбинация username/ password. Если PHP запущен в расширенном режиме безопасности (называемом SAFE MODE), username должен принадлежать либо владельцу HTML-документа, либо владельцу процесса веб-сервера.

msql_createdb mysql_createdb

msql_createdb($database); mysql_createdb($database);

Создает указанную базу данных.

msql_dbname mysql_dbname

$db = msql_dbname($result, $i);

$db = mysql_dbname($result, $i);

Вернет имя базы данных, хранящееся в i-том поле результата, возвращенного функцией m(y)sql_listdbs .

msql_dropdb mysql_dropdb

msql_dropdb($database);

mysql_dropdb($database);

Удаляет базу данных database и все ее таблицы.

msqHieldflags mysql_fieldflags

$flags = msql_fieldflags($result, $i);

$flags = mysql_fieldflags($result, $i);

Возвращает флаги для в i-того поля в result. Возвращаемое значение может быть одним из следующих: «primary key», «not null», «not null primary key» или << >>.

msql_fieldlen mysql_fieldlen

$length = msql_fieldlen($result, $i);

$length = mysql_fieldlen($result, $i);

Возвращает длину i-го поля в result.

msql_fieldname mysql_fieldname

$name = msql_fieldname($result, $i);

$name = mysql_fieldname($result, $i);

Возвращает имя столбца i-го поля в result .-

msql_fieldtype mysql_fieldtype

$type = msql_fieldtype($result, $i);

$type = mysql_fieldtype($result, $i);

Возвращает тип i-го поля в result (то есть «char», «real» и т. д.).

msql_freeresult mysql_freeresult

msql_freeresult($result);

mysql_freeresult($result);

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

mysql_insertjd

$id_num = mysql_insert_id();

Возвращает идентификационный номер, использовавшийся при последней команде INSERT, содержавшей поле auto_increment.

msql_listdbs mysql_listdbs

$result = msql_listdbs();

$result = mysql_listdbs();

Возвращает указатель на результат, содержащий список имен всех баз данных, доступных на сервере mSQL/MySQL. Функция m(y)sql_dbname может выбирать значения из этого указателя.

msql_listfields mysql_listfields

$result = msql_listfields($database, $table);

$result = mysqllistfields($database, $table);

Вернет указатель на результат, дающий информацию о полях таблицы table в назначенной базе данных. Функции m(y)sql_fieldflags , m(y)sql_fieldlen , m(y)sql_fieldname и m(y)sql_ fieldtype могут выбирать значения из этого указателя.

msql_isttables mysql_listtables

$result = msql_listtables($database);

$result = mysql_listtables($database);

Возвращает указатель на результат, содержащий имена всех таблиц базы данных database . Функция m(y)sql_tablename может выбирать значения из этого указателя.

msql_numfields mysql_numfields

$num_fields = msql_numfields($result);

$nuni_fields = mysql_numfields($result);

Возвращает число полей в result.

msql_nurn rows msql_numrows

$num_rows = msql_numrows($result);

$num_rows = mysql_numrows($result);_

Возвращает количество записей в result.

msql_regcase

$new_string = msql_regcase($string);

Возвращает копию строки string, преобразованную в регулярное выражение, необходимое для выполнения поиска не зависящих от регистра совпадений в запросе mSQL.

msql_result mysql_result

$result_string = msql_result($result, $i, $field);

$result_string = mysql_result($result, $1, $field);

Данная функция возвращает значение из указанного поля field 1-й записи набора result. Аргумент field - это имя столбца, и он может быть указан как table, field для результирующих наборов, использующих соединения таблиц. В аргумент field допускается включение любой внутренней функции MySQL, которая может обрабатывать результаты SELECT, например, mysql_result ($result, $i, "length($field)") .

msqljtablename mysql_tablename

$name = msql_tablename($result, $i);

$name = mysql_tablename($result, $i);

Вернет имя таблицы, хранящееся в i-м поле результата, возвращенного функцией m(y)sql_listtables .

next

next($array);

Перемещает указатель массива array на следующий элемент и возвращает текущий.

octdec

$decimal = octdec($octal);

Возвращает десятичный эквивалент восьмеричного аргумента octal.

opendir

opendir($directory);

Открывает указанный каталог для использования с функцией readdir. Вы должны закрыть каталог с помощью closedir после работы с ним.

openlog

openlog($ident, $options, $facllity);

Открывает для записи системный журнал. Эту функцию необходимо вызывать после initlog и до первого вызова syslog . Аргументы те же, что и при вызове системной функции Unix openlog . Значение ident предваряет каждую запись журнала и обычно является именем программы. Значение options может быть одним из следующих: LOG_CONS (выводить журнал на консоль, если произошла ошибка в стандартной процедуре); LOG_NDELAY (открыть журнал немедленно вместо ожидания первой записи журнала); LOG_PERROR (записывать также в stderr); LOG_PID (включать идентификатор процесса (PID) в каждую запись журнала). Можно комбинировать эти параметры с помощью побитового ИЛИ (например (LOG_DELAY | LOG_PERROR LOG_PID)). Facility - это один из установленных системой уровней журнализации (например, LOG_SYSLOG, LOG_USER, LOG_KERN и т. д.).

ord

$number = ord($character);

Возвращает ASCII-значение символа character.

parse_str

parse_str($string);

Разбирает строку URL в формате "переменная 1=значение1 &переменная2=значение2" и инициализирует переменные, присваивая им соответствующие значения. Программа РНР выполняет эту функцию автоматически для приходящих из форм данных в начале каждого скрипта.

passthru

passthru($command);

passthru($command, $returevalue);

Выполняет внешнюю команду command и выдает все результаты ее выполнения непосредственно броузеру. Если указан второй аргумент, туда помещается возвращаемое значение.

pclose

pclose($fd);

Закрывает канал, открытый функцией рореп.

phpinfo

phpinfo();

Печатает информационную страницу, полезную при отладке установки РНР. Это та же страница, которая печатается при добавлении «?info» к любому РНР URL, или если вы обращаетесь непосредственно к двоичным файлам РНР (то есть, http://www.myserver.com/cgi-bin/php).

phpversion

$version = phpversion();

Возвращает номер версии текущего запущенного РНР.

popen

$fd = popen($command, $mode);

Запускает внешнюю команду command и либо посылает ей данные (если установлен режим записи: mode = «w»), либо читает данные из команды (если в mode указать «r»). Любой файловый дескриптор, открытый таким образом, должен быть закрыт функцией pclose.

pos

$position = pos($array['element']);

Возвращает число - позицию указанного элемента ' element' в ассоциативном массиве а г ray.

pow

$result = pow($x, $y);

Возвращает х, возведенное в степень у.

prev

Selement = prev($array);

Перемещает внутренний указатель массива а г ray на предыдущий элемент и возвращает его.

putenv

putenv($string);

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

quote met a

$quoted_string = quotemeta($string);

Возвращает строку string, в которой все специальные символы экранированы таким образом, что ее можно безопасно использовать в регулярных выражениях.

rand

$number = rand();

Возвращает случайное число в диапазоне от 0 и до числа RANDMAX, определяемого системой. Вы должны указать начальное число генератору случайных чисел, используя srand в начале вашего скрипта. Сделать это необходимо только один раз.

readdir

$file = readdir();

Возвращает следующий элемент из текущего открытого каталога и сдвигает указатель каталога. Новые обращения к этой функции будут возвращать следующие элементы каталога до тех пор, пока записи об элементах каталога не закончатся.

readfile

$filesize = readfile($filename);

Выдает содержимое файла filename непосредственно броузеру и возвращает размер файла. Эту функцию можно спокойно выполнять с двоичными файлами, такими как файлы изображений.

readlink

$filename = readline($link);

Возвращает путь к настоящему файлу, на который ссылается link. В случае ошибки функция вернет -1.

reg_match

$result = reg_match($expression, $string);

$result = reg_match($expression, $string, $array);

Функция идентична ereg. Она поддерживается только для обратной совместимости с предыдущими версиями РНР.

reg_replace

reg_replace($expression, $replacement, $string);

Идентична ereg_replace. Эта функция поддерживается только для обратной совместимости с предыдущими версиями РНР.

reg_search

$partial_string = reg_search($expression, $string);

$partial_string = reg_search($expression, $string, $array);

Функция идентична ereg за исключением того, что она возвращает часть строки string , оставшуюся после первого совпадения. Если совпадения не обнаружено, функция возвращает пустую строку. Эта функция поддерживается только для обратной совместимости с предыдущими версиями РНР.

rename

rename($oldfile, $newfile);

Переименовывает oldfile в newfile .

reset

reset($array);

Перемещает внутренний указатель массива array на первый элемент и возвращает этот элемент.

return

return($value);

Выходит из пользовательской функции и возвращает значение value.

rewind

rewind($fd);

Устанавливает указатель файла f d в начало файла.

rewinddir

rewinddir();

Передвигает указатель текущего каталога на начало каталога.

rmdir

rmdir($directory);

Удаляет каталог directory , если он пуст.

rsort

$sorted_array = rsort($array)

Возвращает отсортированную в порядке убывания копию ассоциативного массива array. Если первый элемент массива является числом, возвращаемый массив будет отсортирован по порядку, иначе он будет отсортирован по алфавиту.

setcookie

setcookie($name);

setcookie($name, $value, $expire, $path, $domain, $secure);

Посылает броузеру cookie с указанными атрибутами. Если задано только имя name, cookie с таким именем будет удален из броузера. Для пропуска одного из аргументов он может быть заменен на "" (или на 0 в случае с expire и secure).

seterrorreporting

seterrorreporting($value);

Если значение value равно 0, выдача сообщений об ошибках отключается, иначе все сообщения выводятся в обычном режиме.

setlogging

setlogging($value);

Если значение value является ненулевым, журнализация доступа к текущей странице будет разрешена, иначе - запрещена.

setshowinfo

setshowinfo($value);

Если значение value не нулевое, внизу страницы будет напечатан информационный нижний колонтитул.

settype

settype($variable, $type);

Устанавливает тип переменной variable в тип type, который может быть integer, double или string .

shl

$value = shl($number, $b);

Возвращает значение number, сдвинутое влево на заданное в b число бит.

shr

$value = shr($number, $b);

Возвращает значение number, сдвинутое вправо на заданное в b число бит.

sin

$value = sin($number);

Возвращает синус аргумента number (в радианах).

sleep

sleep($seconds);

Останавливает обработку страницы на указанное количество секунд.

sort

$sorted_array = sort($array)

Возвращает отсортированную в порядке возрастания копию неассоциативного массива array. Если первый элемент массива является числом, возвращаемый массив будет отсортирован по порядку, иначе он будет отсортирован по алфавиту.

soundex

$soundex_key =soundex($string);

Возвращает ключ soundex строки string .

sprintf

$string = sprintf($format, $arg, [$arg, $arg, ...]);

Возвращает форматированную строку format, в который каждый индикатор переменной в стиле С printf заменяется соответствующим значением arg. Можно указать до 5 аргументов.

sqrt

$value = sqrl($number);

Возвращает квадратный корень числа number.

srand

srand($integer);

Инициализирует генератор случайных чисел целочисленным аргументом integer. Эту функцию необходимо вызвать один (и только один) раз в начале любого скрипта, в котором вы используете функцию rand.

strchr strstr

$substring = strchr($string, $value);

$substring = strstr($string, $value); .

Возвращает часть строки string после первого обнаружения символа value в строке, strchr и strstr - идентичные функции, и включены обе для полноты.

strtr

strtr($string, $set1, $set2);

Все символы в строке string, которые входят в набор setl, функция преобразует в соответствующие символы в наборе set2. Если set1 длиннее set2, последний символ из set2 используется для «лишних» символов из set1. Если set2 длиннее set1, «лишние» символы из set2 игнорируются.

stripslashes

$plain_string = stripslashes($escaped_string);

Удаляет все управляющие символы из строки escaped_string .

strlen

$length = strlen($string);

Возвращает длину строки string .

strrchr

$substring = strrchr($string, $character);

Просматривает с конца строку string в поисках указанного символа. Функция возвращает часть строки, начиная с места, где был найден искомый символ character. Если символ не обнаружен, возвращается пустая строка.

strtok

$substring = strtok($string, $characters);

$substring = strtok($characters);

Разделяет строку string на подстроки, используя в качестве разделителя любой символ, указанный в characters . После первого вызова strtok не указывайте строковый аргумент в последующих вызовах, в этом случае функция вернет каждую удачно выделенную подстроку, пока не будет достигнут конец string .

strtolower

$lc_string = strtolower($string);

Возвращает string , где все символы преобразованы в символы нижнего регистра.

strtoupper

$uc_string = strtoupper($string);

Возвращает string , где все символы преобразованы в символы верхнего регистра.

strval

$string = strval($variable);

Возвращает переменную variable в виде строкового значения.

substr

$substring = substr($string, $start, Slength);

Возвращает часть строки string , которая начинается с позиции start (0 является первым символом) и имеет длину в length символов.

symlink

symlink($target, $filename);

Создает символическую связь (ссылку) от filename к target.

syslog

syslog($level, $message);

Записывает сообщение message в системный журнал с уровнем level.

system

$results = system($command);

$results = system($command, $return_value);

Выполняет указанную внешнюю команду command и возвращает все результаты. Если задан второй аргумент, туда записывается возвращаемое значение (код возврата) команды.

tan

$value = tan($number);

Возвращает тангенс аргумента number (в радианах).

tempnam

$filename = tempnam($path, $prefix);

Возвращает имя файла с префиксом prefix, который будет уникальным в каталоге, указанном в path.

time

$time = time();

Возвращает текущее время в стандартном формате времени Unix (число секунд после 1 января 1970 года).

umask

$umask = umask();

umask($umask);

Возвращает текущую маску umask, если аргумент не указан. Если аргумент umask указан, устанавливает umask в указанное значение (которое должно быть восьмеричным числом).

uniqid

$result = uniqid();

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

unlink

unlink($filename);

Удаляет указанный файл.

unset

unset($variable);

Сбрасывает значение указанной переменной, которая может быть элементом массива. При применении данной функции к массиву удаляется весь массив.

urldecode

$decoded_string = urldecode($string);

Возвращает копию строки string, в которой все экранированные спецсимволы URL раскодируются в их значения. Это делается автоматически для всех входящих данных.

urlencode

$encoded_string = urlencode($string);

Возвращает копию строки string, в которой все спецсимволы закодированы для использования в URL.

usleep

usleep($ms);

Задерживет синтаксический анализ скрипта на заданное в ms число микросекунд.

virtual

virtual($filename);

Подключает файл filename точно так же, как в обычном файле HTML это делает тег <!--#include virtual=»$filename» --> . Эта функция полезна только вместе с веб-сервером Apache.

Lite

Lite - это язык сценариев, используемый W3-mSQL. Его синтаксис очень похож на С и еще больше на Perl. Фактически, многие скрипты Lite синтаксически неотличимы от сценариев Perl. Однако Lite лишен многих расширенных возможностей Perl.

Ниже приводится краткий справочник стандартных функций Lite, доступных при использовании W3-mSQL.

chdir

$result = chdir($path)

Изменяет каталог на указанный путь. Если операцию произвести не удалось, возвращается отрицательное целое число.

chmod

$result = chmod($filename, $mode)

Изменяет режим указанного файла на значение, заданное в mode. Если операцию произвести не удалось, возвращается отрицательное целое число. Значение mode может быть задано как десятичное, восьмеричное или шестнадцатеричное.

chop

$string = chop($string)

Возвращает строку, у которой удален последний символ. Это весьма удобно для удаления символа конца строки из строк, прочитанных функцией read In.

close

close ($fd)

Закрывает файл, связанный с указанным файловым дескриптором.

ctime

$time = ctime($time)

Преобразует время time, заданное некоторым числом секунд с начала отсчета, в обычное текстовое представление времени Unix.

echo

echo($string)

Печатает заданную строку. Все переменные в строке заменяются на их значения.

fprintf

fprintf($fd, $string [, arg ...])

Работает как функция С (или Perl) с тем же именем. Первый аргумент - это файловый дескриптор. Отформатированная строка печатается в файл, связанный с файловым дескриптором.

gethostbyaddr

$hostinfo = gethostbyaddr($address)

Возвращает тот же массив, что и gethostbyname() для указанного IP-адреса. IP-адрес должен быть задан десятичной строкой типа «127.0.0.1». В официальной документации к W3-mSQL эта функция называется и gethostbyaddr , и gethostbyaddress . На момент написания этих строк gethostbyadd ress не было среди функций W3-mSQL.

gethostbyname

$hostinfo = gethostbyname($host)

Возвращает массив информации об указанном хосте. Первый элемент массива - это имя хоста, второй элемент - это его IP-адрес.

getpid

$pid = getpid()

Возвращает идентификатор процесса (PID) программы Lite.

getpwnam

$entry = getpwnam($username)

Возвращает массив информации о пользователе с пользовательским именем username . В массиве имеются следующие поля:

  1. Имя пользователя.
  2. Пароль.
  3. UID.
  4. GID.
  5. GECOS (полное имя и другая дополнительная информация).
  6. Домашний каталог.
  7. Оболочка.

getpwuid

$entry = getpwuid($UID)

Возвращает массив, идентичный массиву, возвращаемому getpwnam для пользователя с пользовательским ID $UID.

includeFile

includeFile($filename)

Эта функция подключает файл filename к результату программы. Файл никак не изменяется и не анализируется.

kill

$result = kill($pid, $signal)

Посылает сигнал signal процессу pid. Если операцию выполнить не удалось, возвращается отрицательное целое число.

link

$result = link($file, $newlinkname)

Создает «жесткую» ссылку от file к newlinkname . Если операцию совершить не удалось, возвращается отрицательное целое число.

mkdir

$result = mkdir($directoryname)

Создает каталог с указанным именем. Если операцию выполнить не удалось, возвращается отрицательное целое число.

msqIConnect

$socket = msqlConnect($host)

Подключается к серверу mSQL на хосте host. Возвращает номер соке-та, используемый для последующей связи с сервером баз данных. При неудаче возвращается отрицательное целое число.

msqICIose

msqlClose($socket)

Закрывает подключение, указанное сокетом socket.

msqIDataSeek

msqlDataSeek($result, $location)

Помещает 'указатель' для result среазу перед записью. Указав location 0, вы поместите указатель в начало данных. Следующий вызов msqlFetchRow выберет строку сразу после location.

msqlEncode

$string = msqlEncode($string)

Функция возвращает перекодированную копию строки string, которую можно использовать в запросе mSQL.

msqlFetchRow

$row = msqlFetchRow($result)

Эта функция возвращает в виде массива следующую доступную запись из result.

msqIFieldSeek

msqlFieldSeek($result, Slocation)

Функция изменяет 'указатель' на результат, возвращаемый msqllnitFieldList, так же как msqIDataSeek изменяет результат msqlStoreResult . ..

msqIFreeResult

msqlFreeResult($result)

Функция освобождает всю память, использованную результатом, выбранным из базы с помощью msqlStoreRcsult . Эту функцию необходимо вызывать для каждого результата, с которым вы закончили работать.

msqllnitFieldList

$result = msqlInitFieldList($socket, $database, $table)

Создает информационную таблицу о таблице table в базе данных database на сервере, указанном аргументом socket.

msqIListDBs

$databases = msqlListDBs($socket)

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

msqIListField

$tableinfo = msqlListField($result)

Возвращает массив информации о следующем поле таблицы, созданной msqllnitFieldList , указываемой аргументом result. Каждый последующий вызов функции msqIListField выдает новый массив информации, пока не закончатся поля таблицы. Массив состоит из следующих полей:

  1. Имя поля
  2. Имя таблицы
  3. Тип таблицы
  4. Длина
  5. Флаги

msqIListTables

$tables = msqlListTables($socket, $database)

Возвращает массив имен доступных таблиц базы данных database на сервере, указанном аргументом socket.

msqINumRows

msqlNumRows($result)

Возвращает количество записей в данных, содержащихся в result.

msqIQuery

$result = msqlQuery($socket, $query)

Пытается послать запрос query к подключению, указанному аргументом socket. Если запрос не был успешно выполнен, возвращается отрицательное целое число.

msqISelectDB

$result = msqlSelectDB($socket, $database)

Функция пытается подключить socket к базе данных, указанной аргументом database . Если попытка не удалась, возвращается отрицательное целое число.

msqIStoreResult

$result = msqIStoreResult

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

open

$fd = open($file, $mode)

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

> Открыть файл для записи

<Открыть файл для чтения

<> Открыть файл для чтения или записи

Создать именованный канал и открыть его для чтения

>Р Создать именованный канал и открыть его для записи

<| Выполнить файл как команду и прочесть результаты

>| Выполнить файл как команду и сделать запись в процесс

pid

$pid = getppid()

Возвращает идентификатор (PID) родительского для программы Lite процесса.

printf

printf($string [, arg, ... ])

Работает как функция С (или Perl) с тем же именем. Значение переменных не подставляется; для ввода переменных в строку необходимо использовать стандартное для С форматирование '%s'.

read

$data = read($fd, $length)

Читает указанное в length число байт из заданного файлового дескриптора.

readln

$line =readln($fd)

Читает следующую строку из указанного файлового дескриптора.

readtok

$data = readtok($fd, $token)

Функция читает данные из указанного файлового дескриптора, пока не встретит маркер token. Используется только первый символ из token.

rename

$result = rename($oldname, $newname)

Функция пытается переименовать указанный файл (или каталог) из oldname в newname . Если операцию совершить не удалось, возвращается отрицательное целое число.

rmdir

$result = rmdir($path)

Функция пытается удалить указанный каталог. Если операцию совершить не удалось, возвращается отрицательное целое число.

setContentType

setContentType($string)

Заменяет заданный по умолчанию тип содержимого HTML-страницы, содержащей скрипт, на значение, указанное в string. Эта функция должна быть самой первой строкой документа. Перед ней не должно быть даже пустой строки.

sleep

sleep($time)

Останавливает работу программы на указанное количество секунд.

split

$strings = split($string, $token)

Разделяет заданную строку на массив строк, используя как разделитель символ token..

stat

$stat = stat($file)

Возвращает массив информации о файле file. В массиве содержатся следующие элементы:

  1. Номер inode.
  2. Режим файла.
  3. Количество ссылок на файл.
  4. UID.
  5. GID.
  6. Размер файла.
  7. Atime.
  8. Mtime.
  9. Ctime.
  10. Размер блока файловой системы (в байтах).
  11. Количество используемых блоков файловой системы.

strftime

$time = strftime($format, $time)

Преобразует время Unix в текстовое представление времени, используя заданный формат format. Все описанные ниже последовательности в строке format заменяются на соответствующие им значения:


День недели в виде местных сокращений названий дней недели.


День недели в виде местных полных названий дней недели.

%b

Месяц в виде местных сокращенных названий.


Месяц в виде местных полных названий месяцев.

%d

День месяца (01-31).

%D

День в виде % m/% d/% у.


День месяца (1-31, перед числами первого десятка добавляется пробел).


Час (00-23).

%I

Час (00-12).

%j

День в году (001-366).

%h

Часы (0-23, отделенные пробелами).

%l

Часы (1-12, отделенные пробелами).

%m

Номер месяца (01—12).

%M

Минуты (00-59).


AM или РМ.

%S

Секунды (00-59).


Время в виде % Н:% М:% S.

%U

Номер недели в году (01-52).

%w

День недели (0-6, воскресенье является 0).

%y

Год века (00-99).

%Y

Год, включая век (например 1999).

strseg

$string = strseg($string, $start, $end)

Возвращает подстроку из указанной строки, которая начинается с позиции start и закачивается на позиции end от начала строки.

sub

$string = sub($string, $ехр1, $ехрr2)

Заменяет любые вхождения exprl в string на значение ехрг2. Значения exprl и ехрг2 могут быть разными по длине, строка string автоматически будет укорочена либо удлинена.

substr

$string = substr($string1, $regexp, $string2)

Находит подстроку в строке string"!, которая отвечает регулярному выражению regexp. Каждой части регулярного выражения, заключенной в скобки, присваивается переменная $1, $2, $3 и т. д., содержащая результат совпадения, если оно было найдено. Возвращается значение string2 , с расширенными переменными (включая $1, $2, $3 и т. д.).

tr

$string = tr($string, $list1, $list2)

Функция замещает все символы из списка listl, которые находит в строке string, их эквивалентом в списке list2 (например, tr("Robby", "oy", "ai") вернет строку «Rabbi»). Список символов может содержать диапазон символов, разделенный "-". В частности, tr("e.e. cummings", "a-z," "A-Z") вернет строку «E.E. CUMMINGS.»

truncate

$result = truncate($fale, $length)

Функция пытается сократить размер файла до указанной в байтах длины length . Обычно используется для создания файла с нулевой длиной. Если попытка не удалась, вернется отрицательное целое число.

umask

umask($mask)

Устанавливает umask текущего процесса в заданное значение mask, которое может быть десятичным, восьмеричным или шестнадцатерич-ным.

unixtime2*

$year = unixtime2year($time)

$month = unixtime2month($time)

$day = unixtime2day($time)

$hour = unixtirne2hour($time)

$min = unixtime2min($time)

$sec = unixtime2sec($time)

Данные функции берут в качестве аргумента значение времени в формате Unix и возвращают запрашиваемое значение. Например, функция unixtime2day(time()) может вернуть текущий день месяца (значение от 1 до 31).

unlink

$result = unlink(«filename»)

Удаляет указанный файл. Если удалить файл не удалось, возвращается отрицательное целое число.

urIEncode

$string = urlEncode($string)

Эта функция возвращает копию строки string , которая перекодирована для безопасной вставки в URL.