303 MGraphics.ru - Учебник по PHP 4 - Справочник внутренних функции языка
Уроки photoshopa


Учебник по PHP 4

Справочник внутренних функции языка

Условия перепечатки материалов

Рейтинг статьи: 44444
Проголосовало 8 человек.
Оцените статью:

Внутренние функции

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

	<?$t=time()>

Эта запись присваивает значение, возвращаемое функцией time(), переменной t.

Алфавитный Список функций
Abs(arg)

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

BinDec(binary_string)

BinDec возвращает десятичный эквивалент двоичного числа, представленного параметром binary_string. Самый большое число, которое может быть преобразовано - длиной 31 бит или 4294967295 в десятичном выражении. См. также функцию DecBin().

ChDir(dir)

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

ChGrp(file,group)

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

ChMod(file,perms)

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

ChOwn(file,owner)

ChOwn изменяет владельца заданного файла. Обратите внимание, что это будет работать только в том случае, если PHP/FI выполняется от имени суперпользователя (что вообще то не очень хорошая идея).

Chr(arg)

Chr возвращает символ ASCII, заданный целочисленным аргументом.

closeDir()

CloseDir закрывает каталог, открытый функцией openDir.

Cos(arg)

Cos возвращает косинус аргумента, заданного в радианах. См. также Sin() и Tan()

Count(array)

Count возвращает число элементов в переменной типа массив. Если переменная не является массивом, возвращаемое значение будет 1 (потому что нормальная переменная подобна массиву с одним элементом). Если переменная не определена, возвращаемое значение будет 0.

Crypt(string,[salt])

Функция Crypt шифрует строку, используя стандартный в Unix метод шифрования - DES . Аргументами являются строка, которую нужно зашифровать и необязательная двух-символьная строка - затравка, служащая базой для шифрования. См. справку по функции Crypt для вашей системы Unix, для более полной информации. Если на вашей системе функция crypt не поддерживается, то Вы можете использовать пакет UFC-crypt Глэда Майкла, который является паблик домен; пакет был разработан в Дании и следовательно на него не распространяются ограничения, накладываемые экспортными законами США, так как Вы получаете его по ftp с сервера за пределами США.

Date(format,time)

Функция Date используется для отображения времена и даты различными способами. Функция принимает, в качестве аргументов, строку формата и время. Если параметр, задающий время, опущен, будут использоваться текущее время и дата . Параметр time задается в виде целого числа, в секундах начиная с Unix эпохи - 1 января 1970. Строка форматирования используется для указания, какие компоненты даты / времени нужно отображать и как они должны быть отформатированы. Следующие символы распознаются внутри строки формата. Любой неопознанный символ будет выводиться точно, как задан:

  • Y - Год напр. 1995
  • y - год напр. 95
  • M - Месяц напр. Oct
  • m - месяц напр. 10
  • M - Месяц напр. October
  • D - День напр. Fri
  • l - День напр. Friday
  • d - день напр. 27
  • z - День года напр. 299
  • H - Час в 24-м формате напр. 13
  • h - Час в 12-м формате напр. 1
  • i - Минуты напр. 5
  • s - Секунды напр. 40
  • U - Секунды с начала эпохи напр. 814807830 + A - AM/PM
  • a - am/pm
dbList()

dbList выводит информацию относительно поддержки db, скомпилированной в PHP.

dbmClose(filename)

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

dbmDelete(filename,key)

dbmdelete удаляет пару ключ/содержимое, задаваемую заданным параметром key.

dbmFetch(filename,key)

dbmFetch возвратит содержимое строки, связанной с данным ключом.

dbmFirstKey(filename)

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

dbmInsert(filename,key,content)

dbmInsert вставляет новую пару данных ключ/содержимое в dbm файл. Если ключ уже существует, вставка потерпит неудачу.

dbmNextKey(filename,key)

dbmNextKey возвращает следующий, после заданного, ключ. Вызывая dbmfirstkey(), и сопровождая этот вызов последовательными обращениями к dbmnextkey() можно просмотреть каждую пару ключ/содержимое dbm файла.

dbmOpen(filename,mode)

dbmOpen() открывает dbm файл. Первый аргументпредставляет собой полное имя файла dbm, с указанием пути, а второй - режим, в котором открывается файл; режим может быть одним из: "r", "n" или "w" толко для чтения, создание нового (подразумевается запись) и для записи соответственно. Если используется поддержка ndbm , ndbm фактически создаст файлы filename.dir и filename.pag. Gdbm использует только один файл, поддерживается как обычный ascii файл, и Berkeley libdb создает файл filename.db. Обратите внимание, что PHP организует свою собственную блокировку файла, в дополнение к любым блокировкам, которые могут быть выполнены непосредственно библиотекой dbm. PHP не удаляет файлы блокировок с расширением .lck, которые он создает. Это просто для того, чтобы использовать для файлов блокировок фиксированные иноды. Для более подробной информации относительно dbm файлов, можно обратиться к справочной системе Unix, или получить GNU gdbm с ftp://prep.ai.mit.edu/pub/gnu.

dbmReplace(filename,key,content) dbmReplace похожа на функцию dbminsert(); единственое различие состоит в том что, если ключ уже существует, старое содержимое строки будет заменено на новое.

DecBin(number)

DecBin возвращает строку, содержащую двоичное представление заданного, в качестве аргумента, числа. Самое большое число, которое может быть преобразовано ограничено длиной 31 бит или 4294967295 в десятичном представлении. См. также функцию BinDec().

DecHex(number)

DecHex преобразовывает десятичное число в шестнадцатеричный строку. См. также функцию HexDec().

DecOct(number)

DecOct преобразует десятичное число в восьмиричное число. См. также OctDec().

doubleval(variable) Doubleval возвращает значение переменной типа double (с плавающей запятой) . См. также функции strval() и intval().
Echo [format_string] expression [, expression [,...]]

Echo не является функцией. То есть, Вы не помещаете скобки вокруг передаваемых параметров. Используется, для отображения результатов вычисления функций или переменных PHP. Специальные эскейп символы , n, r и t могут использоваться для вывода символов новая строка, возврат каретки и табуляции соответственно. Format_string необязательный аргумент, и если он не задан, не будет выполняться никакого форматирования вывода. Строка формата подобна строке форматирования функции printf в C . См. справку printf для более полной информации. Одно командой echo может быть выведено до 5 выражений. Если Вы попробуете вывести больше, то получите от синтаксического анализатора сообщение об ошибке. Обратите внимание, что тип выражений не важен. Выражения "автомагически" преобразуются к нужному типу в соответствии с типамт, определенными строкой форматирования, если таковая присутствует. Если Вы желаете отформатировать что-либо и присвоить отформатированную строку переменной, то вместо того чтобы выводить это, используйте функцию sprintf().

Следующие преобразования допустимы,

%d %i
Выводит десятичное число со знаком.
%o
Выводит восьмеричное число.
%u
Выводит десятичное число без знака.
%x %X
Выводит шестнадцатеричное число.
%f
Выводит число с плавающей запятой.
%e %E
Выводит число с плавающей запятой в экспоненциальной форме.
%g %G
Выводит число с плавающей запятой в экспоненциальном формате или нормальной записи.
%c
Выводит одиночный символ.
%s
Выводит строку символов.
%%
Выводит знак процента.

Следующие флаги поддерживаются.

'-'
Выровнивание по левому краю поля.
'+'
Гарантирует, что целые числа имеют знак (со знаком плюс/минус).
' '
Тоже что и '+', но вместо знака "плюс" используется пробел .
'#'
Выводит префиксы для шестнадцатеричных и восьмеричных чисел.
'''
Разделяет цифры на группы (обычно группы отделяются запятой по три).
'0'
Заполнение поля нулями.
Все эти флажки зависят от того, поддерживает ли их ваша функция printf библиотеки C (''', например, является расширением GNU).

Для большинства преобразований можно задавать ширину поля и точность, как показано в файле demo_echo.html в каталоге /examples. Задавать модификаторы типа не обязательно, и, фактически, PHP будет жаловаться, если модификатор типа не имеет смысла (который почти всегда имеет место). PHP будет жаловаться относительно (и отказываться воспринимать) чего-либо, что не распознать. Любые дополнительные параметры, которые не требуются строкой форматирования, игнорируются.

End(variable)

End перемещает внутренний указатель массива для данной переменной к последнему элементу массива и возвращает значение этого элемента. Это бывает полезно для перебора элементов ассоциативного массива в обратном порядке. См. также Reset() и Prev(). Следующий пример перебирает ассоциативный массив в обратном порядке:

	<?
	  Reset($array);
	  $first_key = key($array);
	  End($array);
	  $k = key($array);
	  while($k != $first_key); 
	     echo $array[$k];
	     prev($array);
	     $k = key($array); 
	  endwhile;
	  echo $array[$k];
	>
EscapeShellCmd(string)

EscapeShellCmd экранирует любые символы в строке, который могут использоваться специальным образом при задании выполняющихся команд шелл-оболочки. Эта функция должна использоваться, чтобы удостовериться, что любые специальные символы, получаемые из ввода пользователя экранируются прежде чем будут переданы функциям Exec() или System(). Стандартное использование этой функции может быть:

	<?system(EscapeShellCmd($cmd))>
Eval(string)

Eval берет содержимое строки аргумента и, обрабатывает, это подобно мини PHP/FI скрипту. Выполняется как отдельный скрипт PHP/FI. Любые установки или обращения к переменным внутри eval будут из глобальной области видимости текущего контекста оператора eval. Для строковых аргументов выполняется подстановка переменных замена выполнена на параметрах ряда, таким образом если в выражении нужно использовать переменные , то их нужно экранировать. Несколко примеров:

	$a = "echo phpversion();";
	eval($a);

	eval("echo phpversion();");

	eval("$a=1; echo $a;");
Exec(command_string [, array [,return_var]])

Exec выполняет заданную команду unix, однако ничего при этом не выводит. Функция просто возвращает последнюю строку из результатов выполнения команды. Если нужно выполнить команду и получить все данные, переданные непосредственно, без какого-либо вмешательства обратно, используйте функцию PassThru(). Если в качестве аргумента задан массив , то этот массив будет заполнен каждой строкой вывода команды unix, начиная с элемента [0]. Если наряду с параметром массива присутствует параметр return_var, то в эту переменную будет записан код возврата выполненной команды unix. Обратите внимание, что, если Вы собираетесь позволить чтобы данные, поступающие из ввода пользователя, были переданы этой функции, то нужно использовать функцию EscapeShellCmd(), чтобы удостовериться, что пользователи не смогут передать для выполнения в системе произвольных команд. См. также функцию System().

Exit

Команда Exit используется, для завершения синтаксического анализа сразу же, как только будет проанализирован этот тэг.

Exp(arg)

Exp возвращает e, с степени arg.

fclose($fd)

fclose() закрывает файл, открытый fopen(). Аргумент - на файловый дескриптор, который возвращается вызовом fopen().

feof($fd)

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

fgets($fd,bytes)

fgets() считаетыват строку из файла, открытого fopen(). Аргументы - файловый дескриптор, возвращаемый fopen() и максимальное число байт для считывания. Чтение оканчивается, когда считано максимальное число байтов, или на конце строки. Эта функция подобна вызову fgets() в C. См. также fputs().

fgetss($fd,bytes)

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

$array = File(filename)

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

fileAtime(filename)

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

fileCtime(filename)

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

fileGroup(filename)

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

fileInode(filename)

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

fileMtime(filename)

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

fileOwner(filename)

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

filePerms(filename)

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

fileSize(filename)

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

$fp = fopen(filename,mode)

Fopen() открывает файл и возвращает указатель на дескриптор файла. Если файл не существует, или если к нему нельзя было обратиться по какой-либо другой причине, эта функция возвращает -1. Функция подобна вызову C fopen(). Параметр filename - относительный или абсолютный путь к файлу, который нужно открыть, и параметр режима - один из, "r", "r+", "w", "w+", "a", "a+". См. справку Unix по вызову fopen() для более полной информации. См. также описание функции popen(). См. также описание функции fclose().

Пример:

	$fp = fopen("/home/rasmus/file.txt","r");
fputs(fp,string)
Fputs() записывает строку в файл, открытый функцией fopen(). Параметры - указателя дескриптора файла, который возвращается fopen() и строка для записи. Обратите внимание, что аргумент строка может содержать специальные символы, n, r и t, для вывода новой строки, возвраты каретки и табуляции соответственно. См. также fgets().
fseek(fp,pos)

Fseek() устанавливает указатель файла, заданный параметром $fd; Значением fp является значение возвращаемое вызовом fopen(). Указатель файла установливается от начала файла плюс смещение, определяемое параметром pos. См. также ftell() и rewind().

fp = fsockopen(hostname,port)

Fsockopen() открывает cокет соединение и возвращает указателя дескриптора файла. Этот указатель дескриптора файла может использоваться функциями fgets, fputs и fclose. Параметры - адрес сервера и номер порта. Возвращаемые значения: -3, если нелзя было создать сокет, -4, если потерпела неудачу попытка поиска адреса соответствующего имени сервера hostname , -5 если, в соединение отказано, или закончилось тайм-аутом, -6 если потерпело неудачу вызов фактический вызов fdopen() или -7, если потерпел неудачу вызов setvbuf(). Если номер порта равен 0, то параметр hostname будет рассматриваться как имя файла для сокета файлового пространства имен (File NameSpace), если ваша операционная система их поддерживает.

pos = ftell(fp)

Ftell() возвращает позицию указателя файла, заданного параметром fp, возвращаемого обращением к fopen(). Позиция может быть использована в качестве параметра для fseek(). См. также fseek() и rewind().

getAccDir()

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

GetEnv(string)

GetEnv возвращает значение значения переменной среды, заданной строкой. Обычно эта функция не используется, так как переменные окружения доступны PHP/FI непосредственно. Если сделанна ссылка на переменную, которая не найдена во внутренней таблице идентификаторов, то автоматически просматривается среда окружения. GetEnv нужно использовать, когда необходимо гарантировать, что переменная среды окружения не будет перезаписана поверх нормальной переменной PHP/FI. Механизмы защиты, которые полагаются на переменные, определяемые http-сервером, таких как REMOTE_ADDR и REMOTE_HOST, должны получать значения этих переменных, используюя GetEnv вместо того, стобы непосредственно обращаться к ним (напр. $REMOTE_ADDR), чтобы избежать, что кто-либо, составив фальшивую форму и передав данные на ваш сервер, сможет обойти какой-либо механизм защиты, который мог-бы быть у вас.

getHostByName(domain_name)

GetHostByName преобразует переданное имя домена в IP адрес в формате nnn.nnn.nnn.nnn.

getHostByAddr(ip_address)

GetHostByAddr преобразует данный IP адрес в формате nnn.nnn.nnn.nnn в полное имя домена.

getLastAccess()

GetLastAccess возвращает дату и время последнего обращения к странице, в формате unix. Это значение может быть передано, впоследствии функции Date() для форматирования.
Эта функция доступна, только если PHP компилировался с опцией регистрации доступа.

getLastbrowser()

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

getLastEmail()

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

getLastHost()

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

getLastMod()

GetLastMod возвращает дату и время, в формате unix, времени последней модификации страницы. Это значение может быть передано функции Date() для форматирования.
Эта функция доступна, только если PHP компилировался с опцией регистрации доступа.

getLastref()

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

getLogDir()

GetLogDir возвращает каталог, в котором могут быть найдены журналы регистрации PHP . Фактические файлы журналов регистрации находятся внутри этого каталога. Каждый подкаталог представляет собой числовой идентификатор пользователя пользователя, которому принадлежат файлы журнала регистрации . Затем внутри каждого каталога находится ряд файлов в виде dbm, каждый с числовым inode файла, который они представляют как первичная компонента в имени файла.

getMyInode()

GetMyInode возвращает числовой inode текущего HTML файла.

getMyPid()

GetMyPid() возвращает текущий идентификатор процесса php.

getMyUid()

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

getRandMax()

GetRandMax возвращает максимально возможное случайное число, которое может вернуть функция Rand. Если возвращенное значение кажется, не совсем точным, смотрите файл php.h в дистрибуции PHP для более подробной информации.

getStartLogging()

GetStartLogging возвращает время и дату в, формате Unix, времени начала регистрации на текущей странице. Более точные значения получаются при использовании регистрации на основе mSQL, так как маркер времени хранится в каждом из файла регистрации. Для dbm-регистрации возвращается время создания каталог файлов регистрации пользователем.

getToday()

GetToday возвращает общее число обращений к текущая странице с 12 пополуночи локального времени.
Эта функция доступна, только если PHP компилировался с опцией регистрации доступа.

getTotal()

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

GetType(variable)

GetType возвращает тип переменной. Возвращаемое значение это строка, содержащая одно из значений: "integer", "double" или "string". См. также функци. SetType().

gmDate(format,time)

GmDate идентична функции Date если, за исключением того факта, что используется время по Гринвичу.

Header "header_string"

Команда Header используется в начале HTML файла, для того чтобы послать необработанные строку HTTP заголовка. См. Спецификацию HTTP для более полной информации относительно необработанных заголовков http.

HexDec(hex_string)

HexDec преобразовывает шестнадцатеричный строку в десятичное число. См. также функцию DecHex().

HtmlSpecialChars(string)

HtmlSpecialChars преобразовывает любые символы c ascii кодами со 160 по 255 в параметре string к их соответствующему HTML представлению. Функция возвращает преобразованную строку.

ImageArc (im, cx, cy, w, h, s, e, col)

ImageArc выводит частичный эллипс, с центром в cx, cy (верхний левый угол имеет координаты - 0,0) в изображение, представленное im. W и h определяют ширину и высоту эллипса соответственно, в то время как начальная и конечная точки задаются в градусах, параметрами s и e.
Эта функция доступна только, если в PHP включена поддержка GD .

ImageChar(im, size, x, y, c, col)

ImageChar выводит символ c в изображение, заданное переменной im с координатами x, y (верхний левый угол - 0,0) цветом col. Параметр размера может быть 1, 2, 3, 4 или 5 задавая размер шрифта, который нужно использовать. 1 самый маленький, и 5 самый большой.
Эта функция доступна только, если в PHP включена поддержка GD.

ImageCharUp(im, size, x, y, c, col)

ImageCharUp выводит символ c вертикально, в изображение, заданное im с координатами x, y (верхний левый угол - 0,0) цветом col . Параметр размера может быть 1, 2, 3, 4 или 5 задавая размер шрифта, который нужно использовать. 1 самый маленький, и 5 самый большой.
Эта функция доступна только, если в PHP включена поддержка GD.

col = ImageColorAllocate(im, red, green, blue)

ImageColorAllocate возвращает идентификатор цвета, представленного RGB составляющими компонентами цвета. Параметр im - значееие возвращаемое функцией ImageCreate. ImageColorAllocate должна вызываться для создания каждого цвета, который используется в изображении, представляемом im.
Эта функция доступна только, если в PHP включена поддержка GD.

ImageColorTransparent(im, col)

ImageColorTransparent устанавливает прозрачный цвет для изображения im в значение col. Im - идентификатор изображения, возвращаемый фнкцией ImageCreate, и col - идентификатор цвета, возвращаемого ImageColorAllocate.
Эта функция доступна только, если в PHP включена поддержка GD.

ImageCopyResized(dst_im, src_im, dstX, dstY, srcX, srcY, dstW, dstH, srcW, srcH)

ImageCopyResized копирует прямоугольную область одного изображения в другое изображение. Dst_im - изображение назначения, src_im - идентификатор исходного изображения. Если координаты, ширина и высоты исходного изображения и изображения получателя различаются, то будет выполненно соответственно растяжение, или стягивание фрагмента. Координаты задаются относительно верхнего левого угла. Эта функция может быть использована для копирования области внутри одного и того же изображения (если dst_im тоже что и src_im) но если регионы накладываются, то результаты будут непредсказуемы.
Эта функция доступна только, если в PHP включена поддержка GD.

im = ImageCreate(x_size, y_size)

ImageCreate возвращает идентификатор изображения, представляющий пустое изображение с размерами x_size и y_size.
Эта функция доступна только, если в PHP включена поддержка GD.

im = ImageCreateFromGif(filename)

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

ImageDestroy(im) ImageDestroy освобождает всю память, связанную с изображением im. Im - идентификатор изображения, возвращенный функцией ImageCreate.
Эта функция доступна только, если в PHP включена поддержка GD.
ImageFill(im, x, y, col) ImageFill выполняет заливку изображения, заливка начинается точки с координатами x, y (верхний левый угол - 0,0), цветом col в изображении im.
Эта функция доступна только, если в PHP включена поддержка GD.
ImageFilledPolygon(im, points, num_points, col)

ImageFilledPolygon создает заполненный многоугольник в изображении im. Points - массив PHP, содержащий вершины многоугольника. То есть. Points[0] = x0, points[1] = y0, points[2] = x1, points[3] = y1, и т.д. num_points - общее количество вершины.
Эта функция доступна только, если в PHP включена поддержка GD.

ImageFilledRectangle(im, x1, y1, x2, y2, col)

ImageFilledRectangle создает заполненный цветом col прямоугольник в изображении im, заданный верхней левой координатой x1, y1 и заканчивающийся правой нижней координинатой x2, y2. 0,0 - верхний левый угол изображения.
Эта функция доступна только, если в PHP включена поддержка GD.

ImageFillToBorder(im, x, y, border, col)

ImageFillToBorder выполняет заливку, причем цвет у границы, изображения определяется этой границей. Отправная точка для заливки - x, y (верхний левый угол- 0,0) и область заполняется цветом col.
Эта функция доступна только, если в PHP включена поддержка GD.

ImageGif(im [,filename])

ImageGif создает файл GIF, с именем filenam из изображения im. Параметр im - значение возвращенное функцией ImageCreate. Параметр имени файла необязательный, и если он опущен, будет возвращен непосредственно необработанный поток изображения. Посылая content-type image/gif, с использованием функции Header(), Вы можете создать программу PHP/FI, которая возвращает GIF изображение непосредственно используя эту функцию.
Эта функция доступна только, если в PHP включена поддержка GD.

ImageInterlace(im, interlace)

ImageInterlace включает, либо выключает бит чередования (interlace). Если interlace равен 1, изображение im будет отображено в режиме interlace, и если interlace - 0, бит чередования выключается. Эта функция доступна только, если в PHP включена поддержка GD.

ImageLine(im, x1, y1, x2, y2, col)

ImageLine рисует линию из точки x1, y1 до точки x2, y2 (верхний левый угол - 0,0) в изображении im цветом col.
Эта функция доступна только, если в PHP включена поддержка GD.

ImagePolygon (im, points, num_points, col)

ImagePolygon создает многоугольник в изображении im. points - массив PHP, содержащий вершины многоугольника. То есть. points[0] = x0, points[1] = y0, points[2] = x1, points[3] = y1, и т.д. Num_points - общее число вершин.
Эта функция доступна только, если в PHP включена поддержка GD.

ImageRectangle (im, x1, y1, x2, y2, col)

ImageRectangle создает прямоугольник цвета col в изображении im начиная с верхнего левого угла с координатой x1, y1 и заканчивая правым нижним углом с координатами x2, y2. 0,0 - верхний левый угол изображения.
Эта функция доступна только, если в PHP включена поддержка GD.

ImageSetPixel(im, x, y, col)

ImageSetPixel выводит пиксель в точке x, y (верхний левый угол - 0,0) в изображении im цветом col.
Эта функция доступна только, если в PHP включена поддержка GD.

ImageString (im, size, x, y, s, col)

ImageString выводит строку s в изображение, заданное аргументом im, координатами x, y (верхний левый угол - 0,0) и цветом col. Параметр size может быть 1, 2, 3, 4 или 5, задавая размер шрифта, который нужно использовать. 1 самый маленький, и 5 самый большой.
Эта функция доступна только, если в PHP включена поддержка GD.

ImageStringUp (im, size, x, y, s, col)

ImageStringUp выводит строку s вертикально в изображение, заданное im, координатами x, y (верхний левый угол - 0,0) и цветом col. Параметр size может быть 1, 2, 3, 4 или 5, задавая размер шрифта, который нужно использовать. 1 самый маленький, и 5 самый большой.
Эта функция доступна только, если в PHP включена поддержка GD.

ImageSX(im)

ImageSX возвращает ширину изображения, заданного im.

ImageSY(im)

ImageSY возвращает высоту изображения, заданного im.

Include filename Команда Include может использоваться для того, чтобы вставить другие файлы в текущий html файл. Это чрезвычайно удобно для заголовков и нижних колонтитулов, которые возможно должны быть включены в сотни HTML файлов. При использовании команды include если потребуется изменить заголовок или колонтитул, то вам нужно будет изменить заголовок или файл с нижними колонтитулами только одном месте. Так как полный синтаксический анализ PHP выполняется и для включенного файле, то вы можете также использовать команду include, чтобы включить общие для всех фрагменты программ PHP. Это что-то вроде примитивной общедоступной библиотеки программ, которые могут быть вызваны из вашего HTML файла.
intval(variable)

Intval возвращает значение переменной, приведенное к типу long integer. См. также функции strval() и doubleval().

IsSet(variable)

Функция IsSet возвращается 1, если данная переменная определена, и 0, если нет.

Key(variable)

Key возвращает ключ текущего элемента массива. Текущий элемент определяется позицией указателя массива для данной переменной. Этим указателем массива можно управлять с помощью функций Reset(), End(), Next(), и Prev(). Эта функция в основном используется для определения значения ключа для элемента ассоциативного массива, хотя она также будет работать и для нормального массива .

Link(target,link)

Link() создает жесткую связь. См. функцию Symlink() для создания символических связей. См. также функции ReadLink и LinkInfo.

LinkInfo(path)

LinkInfo возвращает st_dev поле структуры stat в Unix, возвращаемой системным вызовом lstat . Эта функция используется, чтобы проверить, существует ли действительно связь (указанная аргументом path), (используется тот же самый метод, что и в макрокоманде S_ISLNK, определенной в stat.h). Возвращает -1 в случае ошибки.

Log(arg)

Файл регистрации возвращает натуральный логарифм аргумента.

Log10(arg)

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

Max(array)

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

Microtime() Microtime() возвращает строку "msec sec" где sec - число секунд, отсчитанных от 00:00 , 1 января, 1970 по Гринвичу, а msec - микросекундная часть (как доля секунды). Напр. "0.87633900 825010464".
Эта функция доступна только на операционных системах, которые поддерживают системный вызов gettimeofday() .
Min(array) Min возвращает минимальное значение массива PHP. То есть она просмотрит весь массив, для поиска минимального элемента. Если это массив строк, возвращаемая строка представляет собой строку, которая была бы первой в массиве по алфавиту, если этот массив сортирован.
MkDir(dir,mode)

MkDir создает каталог. Параметр mode должен быть задан в восьмеричном представлении.

MkTime(hour,min,sec,mon,day,year)

MkTime возвращает время в представлении Unix (long integer) формат, которое соответствует дате и времени, заданными аргументами. Параметры могут быть опущены, в этом случае данная компонента установливается к текущему значению согласно текущему местному времени и дате. Эти параметры могут опускаться только справа налево. То есть допутсима запись MkTime(hour, min, sec), а MkTime(mon, day, year) нет.

$result = msql($database,$query)

Msql посылает запрос mSQL. Параметры - имя базы данных, строка запроса. То есть. <? Msql ("MyDatabase", "select * from table") >. Возвращаемое значение из этой функции - идентификатор результата, который используется для того, чтобы можно было обратиться к результатам из других функций msql. Идентификатор результата - положительное целое число. Функция возвращает 0, в случае если не был создан никакой идентификатор результата. Дело обстоит таким образом для любых запросов, которые ничего не возвращают, что - нибудь, типа create, update, drop, insert и delete. Если происходит ошибка функция возвращает -1. Строка, описывающая ошибку будет помещена в переменную $phperrmsg, и если функция не была вызвана как @msql() то эта строка ошибки будет также выведена.
Эта функция доступна только, если в PHP разрешена поддержка mSQL .

msql_connect($hostname)

Msql_Connect задает имя сервера или его IP адрес, на котором постоянно находится сервер базы данных mSQL . Эта функция эквивалентна функции msqlConnect() в mSQL C API. Одно различие между этой функцией и ее эквивалентом С API - то, что, если функция не вызывается, то по умолчанию устанавливается соединение с локальным серверм при первом обращении к функции msql(). И, не имеется никакой потребности в функции msql_close, так как в любой момент может быть активно только одно соединение. Если в файле сделано второе обращение к msql_connect (), то соединение с первым сервером втоматически закрывается. Чтобы явно соединиться с msql дэймоном на локальном сервере, используйте: <? Msql_connect ("localhost") >
Эта функция доступна только, если в PHP разрешена поддержка mSQL.

msql_CreateDB($database)

Msql_CreateDB создает заданную базу данных.
Эта функция доступна только, если в PHP разрешена поддержка mSQL .

msql_dbName($result,$i)

Msql_dbName возвращает имя базы данных, сохраненное в позиции $i результата, возвращенного функцией msql_ListDbs(). Msql_NumRows() функция может быть использована, для того чтобы определить, сколько доступно имен баз данных.
Эта функция доступна только, если в PHP разрешена поддержка mSQL.

msql_DropDB($database)

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

msql_FieldFlags($result,$i)

Msql_FieldFlags возвращает флаги для заданного поля. В настоящее время это может быть - "not null", "primery key", комбинация из этих двух или "" (пустая строка).
Эта функция доступна только, если в PHP разрешена поддержка mSQL.

msql_FieldLen($result,$i)

Msql_FieldLen возвращает длину заданного поля.
Эта функция доступна только, если в PHP разрешена поддержка mSQL.

msql_FieldName($result,$i)

Msql_FieldName возвращает имя заданного поля. Параметры функции - идентификатор результата и индекс поля. То есть. Msql_FieldName($result, 2); возвратит имя второго поля в идентификаторе результата result.
Эта функция доступна только, если в PHP разрешена поддержка mSQL.

msql_FieldType($result,$i)

Msql_FieldType подобна функции msql_FieldName() . Параметры идентичны, но возвращается тип поля. Это будет один из "int", "char" или "real".
Эта функция доступна только, если в PHP разрешена поддержка mSQL.

msql_FreeResult($result)

Msql_FreeResult должна вызваться только, если вы волнуетесь, что ваша программа привыполнении занимает слишком много памяти. Вся занимаемая память будет автоматически освобождена по окончании выполнения программы. Но, если Вы уверены, что не данные результата нигде в программе более не понадобятся, Вы можете вызвать msql_freeresult с идентификатором результата, в качестве аргумента, и ассоциированная с ним память будет освобождена.
Эта функция доступна только, если в PHP разрешена поддержка mSQL.

$result = msql_ListDBs()

msql_ListDBs возвратит указатель результата, содержащий список доступных баз данных, из текущего дэймона mSQL. Используйте функцию msql_dbName(), чтобы перебрать этот массив указателя результата.
Эта функция доступна только, если в PHP разрешена поддержка mSQL.

$result = msql_Listfields ($database,$tablename)

msql_listfields отыскивает информацию относительно заданного имени таблиц tablename. Параметры - имя базы данных, и имя таблицы. Возвращается указатель результата, который может использоваться с msql_fieldflags, msql_fieldlen, msql_fieldname, msql_fieldtype. Идентификатор результата - положительное целое число. Функция возвращает -1, если произошла ошибка. Строка, описывающая ошибку будет помещена в $phperrmsg, и если функция вызывалась не как @msql(), будет также выведена.
Эта функция доступна только, если в PHP разрешена поддержка mSQL.

$result = msql_ListTables($database)

msql_ListTables берет имя базы данных в качестве аргумента, и возвращает указатель результата очень похожий на тот что вовращает msql(). msql_TableName() может быть использована для того, чтобы извлечь фактические имена таблиц из указателя результата.
Эта функция доступна только, если в PHP разрешена поддержка mSQL.

msql_NumFields($result)

Msql_NumFields возвращает количество полей в результате result. Параметр - идентификатор результата, возвращенный функцией msql().
Эта функция доступна только, если в PHP разрешена поддержка mSQL.

msql_NumRows($result)

Msql_NumRows просто возвращает количество строк в результате result. Параметр - идентификатор результата, возвращенный функцией msql().
Эта функция доступна только, если в PHP разрешена поддержка mSQL.

msql_RegCase(string)

Msql_RegCase берет строку в качестве аргумента и преобразовывает ее в регулярное выражение, необходимое, чтобы послать запрос mSQL, для получения результат независимого от регистра. Она преобразует строку типа "abc" в "[Aa][Bb][Cc]".
Эта функция доступна только, если в PHP разрешена поддержка mSQL.

msql_Result($result,$i,field)

Msql_Result отображает поле из возвращенной записи. Параметры - идентификатор результата, возвращенный функцией msql(), целое число, которое является индексом записи, которую нужно просмотреть и имя поля. Параметр поля поддерживает "table.field" синтаксис для обработки обьединения.Эту функцию возможно лучше всего рассмотреть на примере:

<?
  $name = "bob";
  $result = msql($database,"select * from table where firstname='$name'"); 
  $num = msql_numrows($result); 
  echo "$num records found!<p>";
  $i=0;
  while($i < $num);
     echo msql_result($result,$i,"fullname");
     echo "<br>";
     echo msql_result($result,$i,"address");
     echo "<br>";
     $i++;
  endwhile;
>

Эта программа подключается к серверу mSQL на локальной машине, устанавливает переменную name в значение bob и посылает запрос, который запрашивает информацию о всех полях из таблицы, в которых поле firstname установлено в значение bob. Затем программа отображает количество найденных записей, и затем в цикле проходит по всем найденным записям и отображает значения полей fullname и address для каждой записи. Как можно увидеть, было бы тривиально добавить, что HTML тэги вокруг напечатанных полей, для форматирования результатов в таблицу или любым желаемым способом. Обратите внимание, что нет вызова connect(). Msql_connect должна быть вызвана только если желательно подключиться к базе данных на удаленном сервере.
Эта функция доступна только, если в PHP разрешена поддержка mSQL.

msql_TableName($result,$i)

Msql_TableName берет указатель результата, возвращенный функцией msql_ListTables(), также как целочисленный индекс и возвращает имя таблицы. Функция Msql_NumRows() может использоваться для определения количества таблиц в указателе результата. Пример:

<?
  $result = msql_listtables("dbname");
  $i=0;
  while($i <  msql_numrows($result));
     $tb_names[$i]=msql_tablename($result, $i);
     echo $tb_names[$i];
     echo "<BR>";
     $i++;
  endwhile;
>

Эта функция доступна только, если в PHP разрешена поддержка mSQL.
Next(variable)

Next перемещает внутренний указатель массива к следующему элементу массива. Это происходит автоматически, когда к массиву обращаются, используя не-индексированный метод ($array []). Функция возвращает значение нового элемента. Эта функция может использоваться, чтобы переместить указатель, вперед, без необходимости явного обращения к массиву. Можно использовать ее, чтобы просмотреть ассоциативный массив и только выводить значения ключей массива а не фактическое содержимое.

<?
  Reset($array);
  $i=0;
  while($i < count($array)); echo key($array);
    next($array);
    $i++;
  endwhile;
>
OctDec(octal_number)

OctDec преобразовывает восьмиричное число в десятичное число. См. также DecOct().

openDir(directory)

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

Ord(arg)

Ord возвращает ASCII значение первого символа параметра.

PassThru(command_string [,return_var]) PassThru() похожа на функцию Exec(), которая выполняет команду Unix. Если параметр return_var присутствует, то в него будет помещен код возврата команды Unix. Эта команда должна использоваться вместо Exec или System, когда вывод команды Unix - представляет собой двоичные данные, которые должны быть переданы непосредственно обратно броузеру.Общее применение для этой функции может быть, если нужно выполнить что-либо вроде pbmplus утилит, которые могут непосредственно выводить поток изображения. Устанавливая content-type в image/gif и вызывая затем программу pbmplus, для того чтобы вывести gif, Вы можете создавать программы PHP/FI, которые непосредственно выводят изображения .
pclose(fp)

Pclose закрывает канал открытый с использованием функции popen().

pg_Close(connection_id)

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

$connection = pg_Connect(host, port, options, tty, dbname)

Pg_Connect открывает соединение с базой данных Postgres95. Каждый из параметров представляет собой строку в кавычках, включая и номер порта. Параметры options и tty необязательны и могут быть пустыми строками. Эта функция возвращает идентификатор соединения connection. Этот идентификатор необходим другим функциям Postgres95. Можно иметь множество открытых соединений сразу. Эта функция вернет 0 при ошибке.
Эта функция доступна только если в PHP включена поддержка Postgres95.

pg_DBname(connection_id)

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

pg_ErrorMessage(connection_id)

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

$result = pg_Exec(connection_id, query_string)

Pg_Exec пошлет оператор SQL к базе данных Postgres95, определенной параметром connection_id. Connection_id должен быть легальный идентификатор, который был возвращен pg_Connect. Значение, возвращаемое этой функции, - идентификатор, который нужно использовать, для обращения к результатам других функций Postgres95. Эта функция возвращает 0 при ошибке, 1 когда команда выполненна правильно, но не ожидается возвращения данных (например команды insert или update). Обратите внимание, что select, который тоже не возвращают никаких данных, будет возвращать верный результат больше 1.
Эта функция доступна только если в PHP включена поддержка Postgres95.

pg_FieldName(result_id, field_number)

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

pg_FieldPrtLen(result_id, row_number, field_name)

Pg_FieldPrtLen возвращает фактическую, печатаемую, длину (число символов) заданного значения в результате Postgres95. Строки нумеруются начиная с 0. Этот функция возвращает -1 при ошибке.
Эта функция доступна только если в PHP включена поддержка Postgres95.

pg_FieldNum(result_id, field_name)

Pg_FieldNum возвращает номер слота столбца, который соответствует к field_name в данном идентификаторе результата Postgres95. Поля нумеруюются с 0. Функция возвращает -1 при ошибке.
Эта функция доступна только если в PHP включена поддержка Postgres95.

pg_FieldSize(result_id, field_name)

Pg_FieldSize возвращает размер памяти (в байтах) поля field_name в данном идентификаторе результата Postgres95. Размер поля 0 указывает поле переменной длины. Эта функция возвращает -1 при ошибке.
Эта функция доступна только если в PHP включена поддержка Postgres95.

pg_FieldType(result_id, field_number)

Pg_FieldType возвращает строку, содержащую имя типа данных поля для заданного идентификатора результата Postgres95. Поля нумеруются с 0.
Эта функция доступна только если в PHP включена поддержка Postgres95.

pg_FreeResult(result_id)

Pg_FreeResult должна вызваться только, если вы волнуетесь что программа занимает слишком много памяти во время выполнения. Вся память занимаемая результатами будет автоматически освобождена по окончании программы. Но, если Вы уверены, данные результаты нигде в программе больше не потребуются, Вы можете вызвать pg_freeresult с идентификатором результата, в качестве параметра и связанная с результатом память будет освобождена.
Эта функция доступна только если в PHP включена поддержка Postgres95.

pg_GetLastOid()

Pg_GetLastOid может быть использована для того, чтобы отыскать Oid, присвоенный вставляемому кортежу, если последняя команда, посланная через pg_Exec была SQL insert. Эта функция возвращает положительное целое число, если есть справедливый Oid, и -1, если произошла ошибка, или последняя команда, посланная через pg_Exec была не insert.
Эта функция доступна только если в PHP включена поддержка Postgres95.

pg_Host(connection_id)

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

pg_NumFields(result_id)

Pg_NumFields возвращает количество полей (столбцов) в результате Postgres95. Параметр - идентификатор результата, возвращенный pg_Exec. Эта функция возвращает -1 при ошибке.
Эта функция доступна только если в PHP включена поддержка Postgres95.

pg_NumRows(result_id)

Pg_NumRows возвращает число строк в результате Postgres95. Параметр - идентификатор результата, возвращенный pg_Exec. Эта функция возвращает -1 при ошибке.
Эта функция доступна только если в PHP включена поддержка Postgres95.

pg_Options(connection_id)

Pg_Options возвращает строку, содержащую опции, определенные заданные для данного идентификатора соединения Postgres95.
Эта функция доступна только если в PHP включена поддержка Postgres95.

pg_Port(connection_id)

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

pg_Result(result_id, row_number, field name/index)

Pg_Result будет возвращать значения из идентификатора результата, полученного pg_Exec. Row_number и name_field определяют ячейку в таблице, которая будет возвращена в качестве результата. Строки нумеруюются с 0. Вместо того, задавать имя поля, можно задавать индекс поля в виде числа без кавычек. Индексы полей начинаются с 0.

Postgres95 имеет множество встроенных типов и здесь непосредственно поддерживаются только основные. Все формы integer, boolean и oid типов возвращаются как integer. Все виды типов float и real возвращаются как double. Все другие типы, включая массивы возвращаются в виде строк, форматированных также как они форматированы Postgres95 программах 'psql' или 'monitor'.

Поддержка для возврата массивов PHP числовых и строковых данных из результата Postgres95 запланирована на более позднюю дату.
Эта функция доступна только если в PHP включена поддержка Postgres95.

pg_tty(connection_id)

Pg_tty возвращает, имя tty на который выводится отладочная информация Postgres95, для заданного идентификатора соединения.
Эта функция доступна только если в PHP включена поддержка Postgres95.

phpInfo()

PhpInfo выводит ту же самую страницу, которую Вы получите при добавлении "?info" к URL, анализируемый PHP/FI или при выполнении непосредственно php.cgi. Это особенно полезно для отладки программ, в случае когда PHP/FI собран в виде модуля Apache, так как отображается ряд полезных внутренних данных.

phpVersion()

PhpVersion возвращает номер версии выполняющегося в данный момент PHP/FI.

fp = popen(command,mode)

Popen открывает канал к команде и возвращает указатель файла. Этот указатель файла может использоваться функциями fgets, fputs и fclose. Параметры - команда для выполнения и режим открытия фа

Разместил: Vulko
Опубликовано: 15.02.2004
Статья "Учебник по PHP 4 - Справочник внутренних функции языка" прочтена 12670 раз.





Последние новости