ƒокументаци€
HTML CSS PHP PERL другое

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

 

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

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. —трока форматировани€ используетс€ дл€ указани€, какие компоненты даты / времени нужно отображать и как они должны быть отформатированы. —ледующие символы распознаютс€ внутри строки формата. Ћюбой неопознанный символ будет выводитьс€ точно, как задан:

 

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. ѕараметры - команда дл€ выполнени€ и режим открыти€ файла. –ежим может быть или "r" дл€ чтени€ или "w" дл€ записи. —м. справку по библиотечной функции popen в UNIX C дл€ большего количества деталей. Ћюбой файл, открытый с popen () должен быть закрыт, функцией pclose().

Prev(variable)

Prev перемещает внутренний указатель массива дл€ заданной переменной variable к предыдущему элументу массива. ≈сли указатель уже находитс€ в начале списка, указатель установитс€ на первый элемент. ‘ункци€ возвращает значение нового элемента. Ёта функци€ полезна дл€ просмотра ассоциативных массивов в обратном пор€дке. —м. пример при описании End(), а также см. Next().

PutEnv(string)

PutEnv помещает заданную строку в среду окружени€. Ќе особо полезна€, так как локальные переменные окружени€ затираютс€ снаружи, когда PHP заканчивает работу со страницей, но в некоторых случа€х полезна, если где-либо в программе PHP провер€ютс€ переменные окружени€. Ќапример, если ¬ы хотите выполн€ть несколько процессов дэймона mSQL, нужно будет использовать PutEnv, чтобы переключатьс€ между различными соединени€ми.

QuoteMeta(arg)

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

Rand()

Rand возвращает случайное число между 0 и RANDMAX. RANDMAX может быть определен функцией getRandMax. ќбычно специфический диапазон выбираетс€, просто примен€€ оператор модул€ к результату.

readDir()

ReadDir читает следующий элемент из текущего открытого каталога.  ак только элемент считан, указатель продвигаетс€ к следующему элементу в каталоге иследующее обращение к этой функции возвратит следующий элемент каталога. ѕеред вызовом этой функции используйте openDir, дл€ того чтобы открыть каталог .

ReadLink(path)

ReadLink делает тоже что и функци€ C readlink и возвращает содержимое символического св€зи path или -1 в случае ошибки. —м. также LinkInfo.

reg_Match(expr,arg[,regs])

Reg_Match возвращает не нуль, если регул€рное выражение нашло соответсвти€ в строке аргумента. Ќапример, условие, <?if (reg_match (" ^This. * ", "This is an example string")>, будет истинно, так как выражение "^This. *" говорит, что нужно найти слово This в начале строки и затем могут следовать любые символы. ≈сли параметр присутствует regs , то match-регистры, заполн€ют позиции 0-10 в массиве, заданном параметром regs. –егистр 0 будет всегда содержать полную совпавшую строку. ƒл€ подробной информации относительно регул€рных выражений, см. раздел регул€рные выражени€, этого документа.

reg_replace(expr,replace,arg)

Reg_Replace просматривает весь строку параметра и замен€ет любые части строки, совпавшие с данным выражением, строкой дл€ замены. Ќапример, в строке, "This is an example string" мы могли бы очень легко замен€ть каждый пробел на черточку с помощью команды: reg_replace(" ", "-", "This is an example string"). ƒл€ более полной информации относительно регул€рных выражений, см. раздел регул€рные выражени€, этого документа.

reg_Search(expr,arg[,regs])

Reg_Search просмотрит всю строку аргумента дл€ любых пар в поисках любых соответствий дл€ заданного регул€рного выражени€. ≈сли соответствие найдено, она возвратит часть строки, начина€ с места соответстви€. ≈сли не найдено никаких соответствий , то возвращаетс€ строка нулевой длины. ≈сли параметр regs присутствует, то match регистры, заполн€ютс€ в позици€х 0-10 массива, заданного параметром regs. ¬ регистре 0 всегда будет полна€ строка. ƒл€ более полной информации относительно регул€рных выражений, см. раздел регул€рные выражени€, этого документа.

Rename(old,new)

ѕереименовывает файл из old в new. ѕодобна функции C rename в Unix.

Reset(variable)

Reset перемещает внутренний указатель массива дл€ заданной переменной типа массив к первому элементу массива и возвращает значение этого элемента. Ёто полезно дл€ просмотра ассоциативных и не-индексированных массивов. —м. также End() и Next(). —ледующий пример перебирает ассоциативный массив:

 

	<?
	  Reset($array);
	  $i=0;
	  while($i < count($array)); 
	    echo $array[]; /* pointer automatically moves ahead one */ 
	    $i++;
	  endwhile;
	>
return(value)

Return возвращает управление из текущего вызова функции и возвращает определенное значение обратно к вызывающему оператору. —м. раздел определ€емые пользователем функци€м дл€ более полной информации.

rewind($fd)

rewind() сбрасывает указатель файла, заданный параметром $fd, который €вл€етс€ значением, возвращенным вызовом fopen(). ”казатель файла установливаетс€ в начало файла. —м. также ftell() и fseek().

rewindDir()

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

RmDir(dir)

RmDir() удал€ет данный каталог. —м. функцию unlink() дл€ удалени€ регул€рных файлов.

SetCookie(name,value,expire,path,domain,secure)

SetCookie() определ€ет cookie, который будет послан нар€ду с остальной частью информации заголовка. ¬се параметры за исключением name необ€зательны. ≈сли задан только параметр name, cookie с этим именем name будет удалено от удаленного пользовател€. ¬ы можете также замен€ть любой параметр на пустую строку ("") чтобы пропустить этот параметр. ѕараметры expire и secure - целые числа и не могут быть пропущены, указанием пустой строки. ¬место этого используйте нуль (0). ѕараметр expire - регул€рное целое число Unix, задающее врем€, в таком-же виде, в каком возвращают его функции time() или mktime(). ниже привод€тс€ некоторые примеры:

 

	SetCookie("TestCookie","Test Value"); 
	SetCookie("TestCookie",$value,time()+3600);  /* expire in 1 hour */ 
	SetCookie("TestCookie",$value,time()+3600,"/~rasmus/",".utoronto.ca",1);

ќбратите внимание, что value часть cookie будет автоматически url кодирована, когда ¬ы посылаете cookie, а когда получаете, автоматически декодируетс€ и присваиваетс€ переменной с тем же самым именем что и им€ cookie. “о есть. „тобы просмотреть содержимое нашего теста cookie в программе, просто сделайте:

 

	echo $TestCookie;
SetErrorReporting(arg)

SetErrorReporting устанавливает текущее значение состо€ни€ выдачи ошибок, по значению параметра arg. ≈сли ненулевое, ошибки будут выводитс€, и если 0 не будут. ‘ункци€ возвращает предыдущую состо€ние о выводе ошибок . Ёто - более общий способ отключени€ вывода сообщений об ошибках, чем, предшествующий функци€м символ '@'. —м. раздел ѕодавление вывода сообщений об ошибках при обращении к функци€м дл€ более полной информации.

SetLogging(arg)

SetLogging() разрешает или запрещает регистрацию статистики доступа дл€ страницы. ≈сли параметр arg ненулевой, регистраци€ включена, если нуль выключена.

SetShowInfo(arg)

SetShowInfo() разрешает или запрещает вывод информационных нижних колонтитулов внизу всех страниц, загружаемых PHP. ≈сли параметр arg ненулевой, нижние колонтитулы вывод€тс€, если нуль - нет.

SetType(variable,type)

SetType устанавливает тип переменной. ѕараметр type - один из, "integer", "double" или "string". —м. также функцию GetType().

Sin(arg)

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

Sleep(secs)

Sleep выполн€ет задержку на secs секунд. ѕодобна функции C sleep() в Unix. —м. также функцию USleep().

Sort(array)

Sort используетс€, чтобы сортировать массив PHP в пор€дке возрастани€. ‘ункци€ понимает три типа переменных; если массив содержит строки - сортирует в алфавитном пор€дке, и численно, если массив содержит числа. ¬ случае массива, который содержит, смесь типов, первый тип в массиве определит метод сортировки.

Sprintf(format,arg)

Sprintf возвращает строку, созданную форматированным выводом, определ€емого параметрами format и arg. ‘ункци€ подобна версии команды echo, за исключением того что эта функци€ только возвращает строку, в то врем€ как echo отображает ее. ќна подобна, также, одноименной функции C. –азличием €вл€етс€ то, что эта верси€ не воспринимает множество параметров arg. ≈сли нужно форматировать множество параметров в одну строку, просто вызовите sprintf() один раз дл€ каждого параметра. ќбратите внимание, что тип параметра не вли€ет на вывод. “ип параметра - "автомагически" преобразуетс€, чтобы соответствовать типу, определенному в строке формата.

Sqrt(arg)

Sqrt возвращает квадратный корень параметра.

Srand(integer)

Srand инициализирует генератор случайных чисел. Ёта функци€ принимает любое целое число в качестве аргумента. ћожно дл€ выбора инициализационного число, использовать функцию date, чтобы задать текущее количество прошедших секунд, по окончании минуты. ќбратите внимание, что эта функци€ не возвращает значение! Ёта функци€ просто инициализирует генератор случайных чисел дл€ последующих обращений к функции rand(). Ќапр.

 

	<?srand(date("s")>
strchr(string,arg)

Strchr и strstr - фактически идентичные функции. ќни могут взаимозамен€мы при использовании и включены обе в цел€х завершенности. ќни возвращают часть строки параметра, начина€ с места, где найдена данна€ подстрока . Ќапример, в строке, "This is an example string" , вызов: <echo strstr($string, "an ") > возвратил бы строку: "an example string".

strlen(string)

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

strrchr(string, arg)

Strrchr будет искать одиночный символ, начина€ с конца аргумента string, двига€сь к началу. ќна возвращает строку, начина€ с символа поиска, если символ был найден и пустую строку, если этого не произошло.

strstr(string,arg)

Strstr и strchr - фактически идентичные функции. ќни могут использоватьс€ взаимозамен€емо и включены обе толко дл€ законченности. ќни возвращают часть параметра string, начина€ с места, где найдена данна€ подстрока . Ќапример, в строке, "This is an example string" выше, вызов: <? echo strstr ($string, "an")> возвратил бы строку: "an example string".

strtok(string,arg)

Strtok используетс€ дл€ разбивки строки. “о есть если есть строка подобно "This is an example string" ¬ы могли бы разбить эту строку на индивидуальные слова, использу€ пробел как маркер. ¬ы использовали бы следующую программу:

 

	<?
	  $string = "This is an example string"; 
	  $tok = strtok($string," "); 
	  while($tok);
	     echo "Word=$tok<br>";
	     $tok = strtok(" "); 
          endwhile;
	>

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

strtolower(string)

Strtolower преобразует все символы, аргумента string, в символы строчных букв.

strtoupper(string)

Strtoupper преобразует все символы строки в символы верхнего регистра.

strval(variable)

Strval возвращает строковое значение переменной. —м. также функции intval() и doubleval().

substr(string, start, length)

Substr возвращает часть заданной строки. ѕозици€ начала задаетс€ параметром start. ѕерва€ позици€ в строке - позици€ 0. ј параметр length определ€ет количество символов от позиции начала.

Symlink(target,link)

Symlink() создает символическую св€зь. —м. функцию Link(), дл€ создани€ жестких св€зей.

System(command_string [,return_var])

System - подобна команде system() C, в которой выполн€етс€ заданна€ команда unix и выводитс€ результат. ≈сли в качестве второго аргумента задаетс€ переменна€ , то в эту переменную будет записан код возврата выполненной команды unix . ќбратите внимание, что, если ¬ы собираетесь позвол€ть данные, вводимые пользователем были переданны этой функции System, то нужно использовать функцию EscapeShellCmd(), чтобы удостоверитьс€, что пользователи не смогут таким приемом передать на выполнение системе произвольную команду. ≈сли нужно выполнить команду и получить все данные, выводимые командой обратно без любого вмешательства, использйте функцию PassThru(). —м. также функцию Exec.

Tan(arg)

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

TempNam(path, prefix)

TempNam возвращает уникальное им€ файла, размещенное в каталоге, заданном аргументом path с префиксом имени файла, заданным аргументом prefix. »дентична функции C tempnam() в Unix.

Time()

Time просто возвращает текущее местное врем€ в секундах начина€ с периода Unix (00:00:00 €нварь. 1 1970). Ёквивалентна вызову Date("U"). ≈сли нужна степень детализации выше чем по секундам, используйте функцию Microtime.

Unlink(filename)

Unlink удал€ет файл с именем filename. ѕодобна функции C unlink() в Unix. —м. функцию RmDir() дл€ удалени€ каталогов.

UnSet($var)

UnSet сбрасывает значение заданной переменной. ¬ случае массива, очищаетс€ весь массив. ќбратите внимание, что индивидуальные элементы массива не могут быть сброшены этой командой.

UrlDecode(arg) UrlDecode декодирует строку, закодированную функцией UrlEncode. ѕри типичном использовании, не нужно декодировать URL кодированные строки, так как они автоматически декодируютс€, когда строки передаютс€ между страницами. ќднако, эта функци€ была включена, дл€ законченности, .
UrlEncode(arg)

UrlEncode кодирует любые символы параметра arg, которые - не вход€т в множество символов "a-zA-Z0-9_-". «амен€€ их %xx, где xx - ASCII значение этих символов в шестнадцатеричном представлении. ¬озвращаетс€ кодированна€ строка.

USleep(microsecs)

USleep задерживет выполнение на заданное число микросекунд. ѕодобна функции C usleep() в Unix . —м. также функцию Sleep().

Virtual(filename)

Virtual - Apache -специфическа€ функци€, котора€ €вл€етс€ эквивалентом <!-- #include virtual ... --> в mod_include. ќна выполн€ет под-запрос Apache. Ёто полезно дл€ включени€ CGI программ или .shtml файлов, или еще чего-либо, что должно быть передано дл€ разбора Apache (дл€ .phtml файлов, лучше использовать директиву <?Include>.

© 2000- NIV