Здесь вы найдете краткое справочное руководство по РНР. Список приведенных функций относится к РНР 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)
He является настоящей функцией, скорее, это встроенная в РНР версия функции printf языка С. В самом простом варианте echo напечатает результат выражения expression . Можно указать до пяти выражений, результат каждого из которых будет напечатан по очереди. Также можно указать строку форматирования, которая должна иметь тот же вид, что и в функции printf языка С или Perl.
end
end($array);
Устанавливает внутренний указатель массива array на последний элемент массива.
Вернет true, если строка string отвечает регулярному выражению в expression . Если в качестве третьего аргумента указан массив, значение, отвечающее выражению, будет помещено в массив.
Идентично ereg_replace, за исключением того, что при сравнении игнорируется регистр.
escapeshellcmd
$safe_string = escapeshellcmd(Sstring);
Возвращает копию строки string, все спецсимволы которой перекодированы так, что строку можно безопасно использовать с функциями exec или system.
eval
eval($string);
Обрабатывает содержимое строки string таким образом, как если бы это был скрипт РНР. Для строки выполняется подстановка переменных, поэтому, если вы хотите использовать переменную в этом «минискрипте», ее следует заэкранировать.
Выполняет в вызываемой подоболочке 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();
Возвращает каталог, в котором находятся журналы регистрации РНР.
Возвращает максимально возможное число, которое может вернуть функция 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-текстом в файле и перед любыми командами РНР, которые выдают какой-либо результат.
Возвращает строку string, заменяя любые специальные символы (включая <, >, &, " и все ASCII-символы с кодами от 160 до 255) на соответствующие им HTML-коды.
Рисует сектор эллипса в изображении image цветом, указанным в color. Центр эллипса находится в точке (сх, су), ширина указана аргументом width, высота- height, начальная и конечная точки указываются в градусах аргументами start и end соответственно.
Копирует прямоугольную область из изображения 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, начиная с точки (х,у).
Создает многоугольник в image, заполненный цветом 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.
Функция идентична 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 должно быть восьмеричным значением.
Возвращает время в стандартном формате времени 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-документа, либо владельцу процесса веб-сервера.
Вернет имя базы данных, хранящееся в 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.
Данная функция возвращает значение из указанного поля 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 на следующий элемент и возвращает текущий.
Открывает указанный каталог для использования с функцией readdir. Вы должны закрыть каталог с помощью closedir после работы с ним.
openlog
openlog($ident, $options, $facllity);
Открывает для записи системный журнал. Эту функцию необходимо вызывать после initlog и до первого вызова syslog . Аргументы те же, что и при вызове системной функции Unix openlog . Значение ident предваряет каждую запись журнала и обычно является именем программы. Значение options может быть одним из следующих: LOG_CONS (вывод