Вы можете определять функции внутри программы PHP со следующим синтаксисом:

GD (графическая библиотека для создания GIF) Поддержка в PHP

PHP поддерживает библиотеку GD версии 1.2 написанной Томасом Бутеллом. Непосредственно в PHP нет никакого кода GD . Если Вы хоттите использовать поддержку GD в PHP/FI, Вам нужно получить библиотеку GD с http://www.boutell.com/gd/gd1.2.tar.Z, инсталлировать ее, и затем переустановить PHP.

Не все возможности GD поддерживаются PHP. Для списка поддерживаемых функций см. Алфавитный Список функций. Все функции GD начинаются со слова, Image.

Подробная информация относительно пакета GD доступна по: http://www.boutell.com/gd/.

GD 1.2 - copyright 1994, 1995 Quest Protein Database Center, Cold Springs Harbor Labs.

IMAGE SUBMIT и PHP

При передаче формы на рассмотрение, можно использовать картинку, вместо стандартного представления кнопки. Это можно сделать, указав тэг:

Инструкции по установке

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

- Можете ли Вы выполнять оба метода GET и POST из программы cgi на вашем сервере?
Это не важно, если Вы устанавливаете пакет в виде модуля Apache. Если нет, Вы не сможете использовать этот пакет. У многих ISP CGI скрипты также запрещены или строго ограничены. Если на вашей системе дело обстоит именно так, поговорите с вашим системным администратором и попросите, чтобы он(она) взглянул(а) на этот пакет, может он(она) установит его для Вас.

- Если на вашей системе установлен mSQL, то вам нужно знать его основной каталог.

- Если на вашей системе установлен Postgres95, то вам тоже нужно знать его основной каталог.

- Если Вы собираетесь хранить лог-файл и файлы конфигурации доступа в каталоге, смонтированном по NFS, и ваша система не обеспечивает блокирование файлов по NFS - Вам нужно будет определить переменную NFS_HACK вручную в файле src/Makefile, и, возможно, придется использовать немного измененную версию библиотеки gdbm. См. файл nfs_hack.txt в каталоге doc для более подробной информации относительно этого.

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

- Если Вы устанавливаете пакет в виде модуля Apache, Вам необходимо знать расположение каталога с исходными текстами Apache.

Итак, что же я могу делать с PHP/FI?

Во-первых, обратите внимание, если страница обрабатывается PHP/FI, то добавляется нижний колонтитул с информацией относительно количества обращений к вашей странице (в том случае, если Вы скомпилировали программу с опцией регистрации доступа). Это - всего лишь малая часть того что PHP/FI может сделать для Вас. Программа (модуль) играет другую очень важную роль - интерпретатор форм cgi (часть имени FI). Например, если Вы создаете форму на одной из ваших web страниц, то вам нужно что-нибудь для обработки информации, связанной с этой формой. Даже если вы хотите только передать информацию в другую web страницу, вам нужно будет иметь программу cgi, которая это сделает. PHP/FI делает чрезвычайно простым делом получение данных из форм и их обработку.

Простой пример

Предположим, что у вас есть форма:

Как программа PHP обрабатывает методы данных GET и POST

PHP обнаруживает оба метода GET и POST , исходящие из HTML формы. Одна важная деталь, для понимания - это то что метод, POST всегда обрабатывается раньше, если присутствуют оба из них. Если переменная PHP определяется методом POST, или если переменная определена дэймоном HTTP в среде окружения Unix, то метод GET не может перезаписать ее. Это должно предотвратить ситуацию когда кто-либо добавит строку ?REMOTE_HOST=some.bogus.host к его URL и таким образом, подчунуть механизму регистрации PHP, эти альтернативные данные. Однако POST методу, разрешено перезаписывать эти переменные.

Любая компонента данных GET (данные после '?' в URL) которая имеет форму, word=something, определит переменную $word, содержащую значение something. Даже если данные не определены в этой форме, к ним все равно можно обратиться через массив $argv. Например, в URL подобно:

Конструкции Языка

Раз уж затронуты языковые конструкции, следует сказать, что язык PHP совершенно прост. Следующие команды используются, для управления ходом выполнения:

if(условие) else elseif(условие) endif switch(выражение) case выражение default break endswitch while endwhile include exit Синтаксис условных выражений подобен синтаксису в языке C. == проверка на равенство.!= означает не равно. Также поддерживаются: >, <, >=, <=. Условное И - &&, условное ИЛИ - ||.

Примеры:

Конструкция Switch

Контроль доступа

Если вы решили включить контроль доступа - при компиляции пакета, Вы добавьте "?config" к любому URL, чтобы редактировать файл управления доступом. То есть.

http://your.machine.domain/cgi-bin/php.cgi/path/file.html?config

Ваш пароль конфигурации будет первоначально установлен вашему идентификатору пользователя. Если ваш идентификатор пользователя не работает как ваш пароль, это скорее всего означает, что PHP не смог прочитать файл /etc/passwd, чтобы определить ваш пользовательский идентификатор. Если дело обстоит таким образом, начальный пароль будет "php". Будет совсем не лишне изменить этот пароль. Обратите внимание, что разные пользователи могут поддерживать свои собственные файлы конфигурации с помощью одного выполняемого PHP/FI модуля.

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

Второй раздел окна "?config" состоит из ряда таблиц. Каждая таблица определяет набор правил. Первый набор правил - всегда задает набор правил по умолчанию. Эти правила используются, если страница не имеет специально определенного для нее набора правил. После заданного по умолчанию набора правил может следовать любое количество специфических таблиц наборов правил.

Чтобы добавить набор правил для конкретного файла, введите URL файла в вашем броузере, и добавьте ?config к концу URL. В появившемся окне конфигурации вы увидете, что для этой страницы был добавлен набор правил , если его еще там не было. Следующая иллюстрация показывает два простых набора правил. Сначала набору правил, заданному по умолчанию, который указывает только что доступ изо всех доменов должен регистрироваться, и второй для файла /~rasmus/test.html, и только для этого файла, всем пользователям, приходящим из домена ".edu", будет отказано в доступе.

Для редактирования набора правил поля изменяйте до тех пор, пока не будет достигнута желаемая конфигурация и затем нажмите кнопку "Submit Changes". Если нужно большее количество правил, нажмите кнопку "Add Rule", и затем подредактируйте добавленное правило.

Чтобы удалить правило, выберите переключатель справа от правила, и нажмите кнопку "Submit Changes". Экран будет, перерисован и правило должно исчезнуть.

Обратите внимание, что нужно ввести регулярное выражение в поле шаблона. См. раздел по регулярным выражениям.

Краткая Хронология

Модуль PHP начал жизнь как простая небольшая cgi оболочка, написанная на Perl. Я написал это за полдня между контрактами, поскольку нуждался в быстром инструменте для отслеживания тех, кто читал мое интерактивное резюме. Даже не предполагалось, что оболочка будет использоваться кем-то кроме меня. Узел сети, на котором лежало мое резюме, был чрезвычайно перегружен и имел постоянные проблемы с "форканьем" процессов. Я переписал Perl-оболочку на C, чтобы избавиться от значительных непроизводительных затрат из-за необходимости запуска Perl при каждом обращении к моему резюме.

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

В то же самое время я начал играть с базами данных и написал инструмент для включения запросов SQL в web страницы. Это была отдельная CGI-оболочка, которая анализировала запросы SQL и облегчала создание форм и таблиц, основанных на этих запросах. Этот инструмент был именован Интерпретатор Форм (Form Interpreter <FI>).

PHP/FI версии 2.0 - полная перезапись из этих двух пакетов, объединенных в одиночную программу. Это теперь развилось по сути в простой язык программирования, внедренный внутрь HTML файлов. Первоначальный акроним, PHP, прижился, правда теперь не соответствует действительности. PHP/FI сегодня используется больше для создания целых web серверов, чем для малых домашних страниц. Модуль устраняет потребность в многочисленных малых cgi программах на Perl, позволяя Вам поместить простые скрипт-программы непосредственно в ваши HTML файлы. Это увеличивает общую производительность ваших web страниц, хотя бы потому что нет непроизводительных затрат на запуск Perl-а. Пакет также упрощает управление большими web серверами, помещая все компоненты web страницы в одиночном файле html. Всторенная поддержка различных баз данных делает тривиальной разработку web страниц с доступом к базам данных. Многие находят, что иметь дело с внедренным в html-документы языком намного проще, чем создавать отдельные HTML и CGI файлы .

В этой документации любые ссылки PHP, FI или PHP/FI все относятся к одному и тому же. Различие между PHP и FI - только концептуальное. И PHP и FI созданы из одного и того же исходного текста. Когда я формирую пакет данных без какой-либо регистрации доступа или поддержки ограничения доступа, я вызываю мой выполняемый модуль FI. Когда я форматирую документы, используя эти опции, я называю его PHP.

Математические Выражения

PHP поддерживает полный набор математических операций, в выражениях. Учитывается порядок операций. Следующие операторы допустимы:

Область видимости переменных

Область видимости переменной это контекст, внутри которого она определена. Главным образом все переменные PHP/FI имеют только одину область. Однако, внутри определяемых пользователем функций действует локальная для функции область видимости. Любая переменная, используемая внутри функции по умолчанию ограничена локальной областью видимости. Например:

Относительный против Абсолютного URL - или, почему не отображаются мои изображения?

Общая проблема для всех программ CGI состоит в том, что программа HTTPD изменяет текущий каталог на тот, в котором находится загружаемый документ. В случае программы CGI, текущий каталог установлен на каталог, где находится программа CGI. Обычно это не проблема, за исключением тех случаев, когда это приводит к относительному URL.

Относительный URL это тот, который полагает что текущий каталог, является также и каталогом, в котором размещен HTML файл . Так, например, если у меня есть URL:

Переадресация CGI

Хороший способ выполнять PHP/FI - используя модуль переадресации cgi с http сервером Apache. Обратите внимание, что вам не нужно волноваться относительно модулей переадресации, если PHP/FI используется в виде модуля Apache. Существует два таких модуля переадресации. Один из них разработан Дэйвом Андерсеном <angio@aros.net>, и доступен по ftp://ftp.aros.net/pub/util/apache/mod_cgi_redirect.c, и другой идет вместе с исходными текстами Apache и называется mod_actions.c. Эти модули очень похожи. Есть лишь небольшая разница в их использовании. Оба были протестированы и оба работают с PHP/FI.

Одно большое "но": на момент написания документа (апрель. 20/96) - то, что текущий официальный выпуск Apache (1.0.5) имеет серьезное ограничение, которое препятствует получению данных в переадресованных cgi запросах метода POST. Я разрешил эту проблему и устранил этот недостаток в моей версии Apache, есть также официальный патч, доступный в файловом архиве на домашней странице PHP.

Вторая довольно большая проблема с Apache, 1.0.x - то, что он не выравнивает тип double правильно на большинстве архитектур. Вы получаете странные ошибки типа BUSERROR от вашего httpd при использовании mod_php, для решения этой проблемы нужно или обновление Apache до 1.1 или подредактировать файл alloc.c Apache. В этом файле найдите следующий фрагмент кода:

Перегруженные Операторы и работа с типами данных

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

Проблема состоит в том, что PHP понимает 3 типа переменных. Integer, Double и String. Когда переменной впервые присваивается значение, PHP автоматически оперделяет тип этой переменной.

То есть.

Переменные

Поддерживаются три типа переменных. Длинные целые (long int) , двойной точности с плавающей запятой (double) и символьные строки (strings). Тип переменных обнаруживается автоматически. Например:

PHP/FI и виртуальные сервера

PHP прекрасно работает на виртуальных хостах, которые поддерживаются некоторыми дэймонами http. Одна проблема, которая может произойти при такой установке, связана с различиями в способе, которым httpd устанавливает переменную окружения SCRIPT_NAME. Обычно ее значение установливается равным пути выполняемой в текущий момент программы CGI относительно директории ROOT_DIR сервера httpd. Однако, при использовании виртуального домена , некоторые httpd не устанавливают правильно значение переменной SCRIPT_NAME - относительно самого верхнего каталога виртуалного домена, как это должно быть. Если добавление ?config к URL дает Вам сообщение об ошибке: "invalid URL", значит эта проблема у вас существует. Вам нужно будет подредактировать файл php.h и устанавить значение переменной VIRTUAL_PATH, чтобы указать путь к вашему выполняемому файлу php.cgi относительно вашего каталога верхнего уровня .

Подавление Ошибок при обращении к функциям

Иногда бывает желательно игнорировать фатальные ошибки, о которых могут сообщать специфические функции PHP. Например, Вы захотите игнорировать ошибки от вызова dbmopen() и просто проверять возвращаемое значение обращения, без того, чтобы сообщение об ошибке появлялось на экране web. Это может быть сделано, помещая символ "@" перед именем функции. То есть.

Поддержка Cookie

PHP/FI поддерживает HTTP cookies как определено Спецификациями Netscape. Cookies - механизм для сохранения данных в удаленном броузере и таким образом трэкинг или идентификация возвращаемая пользователем . Вы можете устанавливать cookies, используя функцию SetCookie() . Cookies - часть HTTP заголовка, таким образом функция SetCookie() должна вызваться до того как какие-либо данные будут посланы для вывода удаленному броузеру. Это - то же самое ограничение что касается функции Header() .

Любое значени cookies посланного Вам от пользователя, превратится автоматически в переменную PHP/FI точно так же как методах GET и POST.

Если Вы желаете привоить несколько значений к одиночному cookie, просто добавьте [] к имени cookie. Например:

Поддержка FastCGI

PHP/FI может быть скомпилирован с поддержкой FastCGI. Но прежде вам нужно будет выбрать и скомпилироватьFCGI Development Kit для вашей платформы. А также рабочий модуль переадресации CGI. Затем следуйте инструкциям, изложенным в документации по FastCGI, для конфигурирования пакета FastCGI применительно к вашей платформе. Если Вы используете модуль mod_fastcgi с сервером Apache, ниже приводятся пошаговые инструкции:

Подредактируйте ваш файл конфигурации Apache(Configuration), и добвьте модуль mod_fastcgi, затем перетранслируйте Apache. Подредактируйте файл конфигупации srm.conf и добавьте строки:
AddType application/x-httpd-fcgi .fcgi
AppClass /usr/local/etc/httpd/fcgi-bin/php.fcgi -processes 4
AddType application/x-httpd-fphp .fhtml
Action application/x-httpd-fphp /fcgi-bin/php.fcgi
Скопируйте php.cgi в /usr/local/etc/httpd/fcgi-bin/php.fcgi

Теперь, любые страницы с расширением .fhtml будут переданы для обработки процессу FastCGI - php.fcgi , который уже выполняется. Php.fcgi все еще будет работать как обычный CGI, так что можно просто создать символический линк от php.cgi к php.fcgi.

Если Вы не используете Apache, вышеупомянутые шаги будут подобны, но не идентичны. Механизмы переадресации CGI доступны для NCSA и Netscape серверов на файловом архиве PHP/FI.

Поддержка mSQL

mSQL это мини-SQL и это небольшой и простой SQL сервер баз данных, написанный Дэвидом Хьюджесом. Он доступен по ftp://ftp.bond.edu.au/pub/Minerva/msql

PHP/FI обладает богатым набором функций поддержки mSQL:

msql() msql_Connect() msql_CreateDB() msql_dbName() msql_DropDB() msql_FieldFlags() msql_FieldLen() msql_FieldName() msql_FieldType() msql_FreeResult() msql_ListDBs() msql_Listfields() msql_ListTables() msql_NumFields() msql_NumRows() msql_RegCase() msql_Result() msql_TableName()

В дополнение к этим функциям, PHP/FI может быть также скомпилирован таким образом, чтобы автоматически пропускать, любые прямые одиночные кавычки ( ' ), полученные из методов GET или POST. Если в файле php.h определена переменная MAGIC_QUOTES, то эти кавычки будут автоматически пропускаться, упрощая, передачу данных из форм непосредственно к запросам msql.

мощная база данных являющаяся паблик

Postgres95 - мощная база данных являющаяся паблик домен, которая реализует значительное подмножество языка SQL . Она поддерживает множество типов данных и команды, которые не доступны в mSQL. Подробная информация относительно Postgres95 и непосредственно программного обеспечения может быть найдена по URL: http://epoch.cs.berkeley.edu: 8000/postgres95/.

Следующие функции PHP доступны для Postgres95:

pg_Connect() pg_Close() pg_Host() pg_Port() pg_Options() pg_tty() pg_DBname() pg_Exec() pg_Result() pg_FreeResult() pg_GetLastOid() pg_NumRows() pg_NumFields() pg_FieldNum() pg_FieldName() pg_FieldType() pg_FieldSize() pg_FieldPrtLen() pg_errorMessage()

Обратите внимание: Двоичные указатели не поддерживаются.

В дополнение к этим функциям, PHP/FI может быть скомпилирован, чтобы пропускать любые прямые одиночные символы ( ' ) кавычки, найденные в данных методов GET или POST . Если в файле php.h определена переменная MAGIC_QUOTES, то эти кавычки автоматически будут пропускаться, упрощая, передачу данных из форм непосредственно к запросам Postgres95.

Вот простой скрипт , который соединяется с базой данных Postgres95 на локальном сервере, называющейся 'mydb' и извлеает имена и возрасты людей из таблицы:

Поддержка закачки файлов

PHP/FI автоматически обнаруживает попытку закачки файла из броузера, который поддерживает закачку файлов, основанную на базе форм, как это предложено Е. Небелем и Л. Мазинтером из Xerox и описано в RFC 1867.

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

<FORM ENCTYPE="multipart/form-data" ACTION="_URL_" METHOD=POST> <
INPUT TYPE="hidden" name="MAX_FILE_SIZE" value="1000">
Send this file: <INPUT NAME="userfile" TYPE="file">
<INPUT TYPE="submit" VALUE="Send File">
</FORM>

_URL_ должен указывать на php html файл. Скрытое поле MAX_FILE_SIZE должно предшествовать полю ввода имени файла и его значением является максимальный размер принимаемого файла. Значение задается в байтах. Для этого файла будут определены следующие переменные. При успешной закачке:

$userfile

Временное имя файла, в котором загруженный файл был сохранен на машине сервере.

$userfile_name

Первоначальное имя файла на машине отправителя.

$userfile_size

Размер загруженного файла в байтах.

$userfile_type

MIME тип файла, в том случае если броузер предоставляет эту информацию. например это может быть "image/gif".

$userfile - основная переменная из вышеупомянутых, будет соответствовать полю NAME в форме закачки.

Файлы будут сохранены в заданном для сервера временном каталоге по умолчанию. Это значение может быть изменено путем установки переменной окружения среды TMPDIR для PHP/FI. Хотя, при установке ее с использованием вызова PutEnv () из скрипта PHP/FI, это работать не будет. В качестве альтернативы Вы можете установить временный каталог, редактируя php.h и определив переменную UPLOAD_TMPDIR.

Скрипт PHP/FI, который принимает файл, может выполнить любые логические действия, необходимые для определения что именно должно быть выполнено с закачаннным файлом. Вы можете например использовать $file_size переменную, для того чтобы отбросить любые файлы, которые являются либо слишком маленькими либо слишком большими. Вы можете использовать $file_type переменную, для того чтобы отбросить любые файлы, которые не соответствуют каким-либо критериям типа. Какие бы ни были действия, вам нужно будет удалить файл из временного каталога или переместить его в другое место.

Пожалуйста обратите внимание, что CERN httpd, кажется, удаляет все, начиная с первого пробела в заголовке MIME content-type, который он получает от пользователя. Если дело обстоит таким образом, то CERN httpd не будет поддерживать возможность закачки файлов.

Примечания для хакания кода

Управление памятью внутри PHP/FI - сложная вещь. Так как пакет может выполняться как модуль сервера, мы должны быть очень осторожны относительно ресурсов памяти. Программа должна быть не только реентерабельной, но также нужно учитывать тот факт, что мы можем получить в любое время сигнал по тайм-ауту, по которому управление выбывает из модуля. Мы не получим никакого предупреждения, и не будет времени, чтобы освободить память, которая может быть распределена. И эта память должна быть освобождена, или область данных процесса httpd, с которым мы связаны, может расти неопределенно. Это также применимо, когда PHP выполняется в режиме CGI, так как это может быть установлено, чтобы выполниться как постоянный процесс FastCGI .

Решение состоит в том, чтобы использовать подпулы памяти. Эти пулы автоматически очищаются Apache, по завершению сеанса, или в случае FastCGI, эти пулы очищаются в main.c, каждый раз, когда выполняется цикл оболочки FastCGI. В настоящий момент используются три таких пула. Они пронумерованы 0,1 и 2. Номер подпула является первым аргументом для функций emalloc и estrdup. Пул 0 - Сеансовое время жизни Любая память, распределенная из этого пула будет существовать весь сеанс. Это - хорошая идея использовать этот настолько мало насколько возможно. Например, если кто-то сделает цикл while, который выполняет итерации 1000 раз и внутри этого цикла while, он вызывают что-либо, что распределяет память из пула 0, то эта память будет распределена 1000 раз. Это - быстрый способ исчерпать всю распределенную область данных. Пул 1 - Временное хранение (самое короткое время жизни) Если для чего-либо внутри функции необходим временный рабочий буфер, память для него, должна исходить из этого пула. Этот пул очищается при каждом обращении к yylex(). т.е. память теряется примерно, как только Вы оставляете функцию. Пул 2 - Область выражений (среднее время жизни) Этот пул существует на протяжении существования выражения. Выражением в этом контексте, является полная командная строка PHP/FI. Он не будет очищаться внутри функции, так как выражение верхнего уровня, которое вызвало функцию, не будет завершено до возврата из функции. Флажок ClearIt в функции yylex() указывает, когда будет безопасным очистить этот пул.

Использование подпулов полностью устраняет потребность явно освобождать память где-либо в программе, с одним исключением - памятью распределенной, с использованием регулярного вызова malloc различными библиотеками, которые могут быть слинкованы в PHP. Библиотека gdbm - один из таких примеров.

Примечания к модулю Apache

Выполнение PHP/FI в виде модуля Apache это наиболее эффективный способ использования пакета. В случае если пакет выполняется в виде модуля, то это означает что функциональные возможности PHP/FI объединены с функциональными возможностями сервера Apache в одной программе. Имеется ряд преимуществ для пакета в виде модуля:

Эффективность

Эффективность - намного быстрее чем традиционные программы CGI. Фактически, при выполнении PHP/FI в виде модуля, никакой CGI, не запускается. Скрипт код в HTML файлах выполняется непосредственно процессом web сервера Apache.

Защита

При выполнении модулем модулем, сначала применяются нормальные основанные на httpd правила ограничения доступа определяемые в конфигурационных файлах Apache или в частных .htaccess файлах прежде чем модулю позволяются анализировать файл. В качестве альтернативы, Вы можете также создавать скрипты PHP/FI, которые управляют нормальной httpd-основанной аутентикацией. См. Аутентикация HTTP

. Конфигурируемость

Так как синтаксический анализатор всегда активный внутренний процесс httpd, он может быть сконфигурирован при запуске, с использованием тех же самых файлов конфигурации, которые используются для конфигурации сервера httpd. Модуль может даже быть сконфигурирован на "по-каталожной" основе, путем помещения директив конфигурации PHP в .htaccess файлах.

к базе данных правильны. Что

Затем подредактируйте ваш msql.acl файл, и удостоверитесь, что разрешения на доступ к базе данных правильны. Что - нибудь вроде следующего должно удовлетворить:

Пример 1

http://my.machine/~rasmus/file.html

Фактический HTML файл мог бы быть:

Пример 1

/cgi-bin/php.cgi/file.html?abc+def+EMAIL_ADDR=rasmus@vex.net&var==value

Соответствующие компоненты таблицы идентификаторов PHP будут:

Пример 1

SetCookie("MyCookie[]","Rasmus Lerdorf", time()+3600);

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

Пример 1

<? $conn = pg_Connect("localhost", "5432", "", "", "mydb"); if (!$conn) { echo " An error occured.\n"; exit; } $result = pg_Exec($conn, "select * from table1"); if (!$result) { echo "An error occured.\n"; exit; } $num = pg_NumRows($result); $i = 0; while ($i < $num) { echo "name: "; echo pg_Result($result, $i, "name"); echo " age: "; echo pg_Result($result, $i, "age"); echo "<BR>"; $i++; } pg_FreeResult($result); pg_Close($conn); >

Пример 1

<?$string = "This is a test"; $cnt = reg_match("\(\w*\).*\(\") echo $cnt; echo $regs[0]; echo $regs[1]; echo $regs[2]; >

Вышеупомянутое сначала напечатает количество совпавших символов (14 в этом случае) и затем всю совпавшую строку, споследующим первым словом строки и последним.

`\b'

Задает пустую строку, но только, если она находится в начале или в конце слова. Таким образом, "\bfoo\b" соответствует любому местонахождению "foo" в виде отдельного слова. "\bball\(s\|\)\b" соответствует "ball" или "balls" в виде отдельных слов.

`\B'

Задает пустую строку, если она не в начале или не в конце слова.

`\<'

Задает пустую строку, но только, если она - в начале слова.

`\>'

Задает пустую строку, но только, если она в конце слова.

`\w'

Задает любой символ, являющийся составной частью слова.

`\W'

Задает любой символ, который - не является составной частью слова.

Пример 1

<?$a = 5> <?echo $a>

Это можно записать также в виде:

Пример 1

{ "time",INTFUNC0,UnixTime },

Этот запись отображает строку на лексему INTFUNC0. Вы можете поискать грамматику для лексемы INTFUNC0 в parse.raw, и увидете, что это - общая грамматика для внутреннего вызова функции без параметров. Строка в кавычках, является фактической строкой, которая будет использоваться в .html файлах, для вызова функцию. Имейте в виду, что имена функции PHP/FI регистронезависимы. И заключительный элемент - UnixTime, это реально вызываемая функция.


Пример 1

<?$t=time()>

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


Пример 1

<FORM ACTION="/cgi-bin/php.cgi/~userid/display.html" METHOD=POST> <INPUT TYPE="text" name="name"> <INPUT TYPE="text" name="age"> <INPUT TYPE="submit"> </FORM>

Ваш display. html файл мог бы в этом случае содержать что-нибудь вроде:

Пример 1

union align { /* Types which are likely to have the longest RELEVANT alignment * restrictions... we don't do much with doubles. */char *cp; void (*f)(); long l; FILE *fp; };

Нужно добавить double к этой строке и перетранслировать вашу Apache сервер. Правильный блок кода:

Пример 1

<? if(!$PHP_AUTH_USER) { Header("HTTP/1.0 401 Unauthorized"); Header("WWW-authenticate: basic realm=\"My Realm\""); exit; } else { echo "Hello $PHP_AUTH_USER.<P>"; echo "You entered $PHP_AUTH_PW as your password.<P>"; } >

Вместо простого вывода $PHP_AUTH_USER и $PHP_AUTH_PW, вам возможно захочется проверить правильность имени пользователя и пароля. Возможно, посылая запрос к базе данных, или, осуществляя поиск пользователя в dbm файле.

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

Обратите внимание однако, что вышесказанное не мешает кому-либо, кто контролировал не-аутентифицированные URL украсть пароль от аутентифицированных URL на том же самом сервере. PHP_AUTH_VARS определяется в php.h, может быть установлена в "неопределена", для того чтобы быть уверенным, что эти переменные никогда не будут установлены и таким образом отключить возможность использования mod_php для того чтобы пытаться украсть пароли.

Для каждого пользователя, для которого

Для каждого пользователя, для которого Вы хотите сохранять данные регистрации, нужно создать две таблицы. msqllog шелл скрипт в каталоге scripts сделает это для Вас. Просто введите:

Пример 2

~rasmus/public_html/file.html

Если внутри файла file.html у меня есть тэг:

Пример 2

$argc = 4 $argv[0] = abc $argv[1] = def $argv[2] = EMAIL_ADDR=rasmus@vex.net&var==value $EMAIL_ADDR = rasmus@vex.net $var = value

Обратите внимание, как EMAIL_ADDR часть данных присутствует и в переменной $argv [2], в которой она не анализируется, и создается переменная $EMAIL_ADDR, содержащая значение rasmus@vex.net.

$EMAIL_ADDR переменная использовалась в вышеупомянутом примере, потому что это - полезная переменная, если Вы используете особенности регистрации PHP. Добавляя:

Пример 2

$Count++; SetCookie("Count",$Count, time()+3600); SetCookie("Cart[$Count]",$item, time()+3600);

Пример 2

<; $a = 5; echo $a >

Или даже:

Пример 2

void UnixTime(void) { char temp[32]; sprintf(temp,"%ld",(long)time(NULL)); Push(temp,LNUMBER); }

Обратите внимание, что функция является фунцией void.Это указывает, что она не возвращает ничего. Это может показаться путанным, потому что очевидно функция так или иначе должна возвратить время. Время возвращается, но не как значение возвращаемое функцией. Оно помещается в то, что называется стеком выражений. Стек выражений - просто стек строк и связанных с ними типов. PHP/FI понимает только 3 основных типа переменных: STRING, LNUMBER и DNUMBER. STRING - символьная строка, LNUMBER - длинное целое число, и DNUMBER - значение double или float. В этом примере Time() , значение, которое будет возвращено - время, выраженное в формате Unix (число секунд начиная с января. 1 1970) и - таким образом целое число. Стек выражения принимает только строки, таким образом мы преобразуем, с помощью sprintf, длинное целое число в строку и помещаем это значение в стек, указывая, что это фактически является длинным целым числом с помощью строки: Push(temp,LNUMBER);


Пример 2

<? 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(). Стандартное использование этой функции может быть:

Пример 2

<?echo "Hi $name, you are $age years old!<p>">

Это так просто! PHP/ FI автоматически создает переменную для каждого поля ввода в вашей форме. Вы можете впоследствии использовать эти переменные в ACTION URL файле.

Следующий шаг, если только Вы определили, как использовать переменные, это начать играться с некоторыми тэгами, определяющими логический ход выполнения в ваших страницах. Например, если Вы хотели отобразить различные сообщения, основанные на том, что именно вводит пользователь, Вы используете if/else конструкцию. В примере выше, мы можем отображать различные сообщения, основанные на возрасте, который ввел пользователь, изменив наш display.html:

Пример 2

union align { /* Types which are likely to have the longest RELEVANT alignment * restrictions... we don't do much with doubles. */char *cp; void (*f)(); long l; FILE *fp; double d; };

Проверьте документацию к Apache по тому, как добавлять модуль. Вообще Вы добавляете имя модуля к файлу называемому Configuration. Если вы хотите использовать модуль mod_action, то вам нужно добавить следующую строку:

Module action_module mod_actions.o

Если хотите использовать модуль mod_cgi_redirect.c, добавьте строку:

Module cgi_redirect_module mod_cgi_redirect.o

Затем скомпилируйте ваш httpd, и инсталлируйте его. Чтобы разрешить cgi переадресацию, нужно или создать новый MIME тип в файле mime.types, или использовать команду AddType в вашем srm.conf файле, чтобы добавить тип MIME. Тип MIME, который будет добавлен должен быть чем-нибудь вроде этого:

application/x-httpd-php phtml

Если Вы используете модуль mod_actions.c, Вам нужно добавить следующую строку к вашему файлу srm.conf:

Action application/x-httpd-php /cgi-bin/php.cgi

Если Вы используете mod_cgi_redirect.c, нужно добавить эту строку к srm.conf:

CgiRedirect application/x-httpd-php /cgi-bin/php.cgi

Не пытайтесь одновременно использовать и mod_actions.c, и mod_cgi_redirect.c.

Только если у Вас есть один правильно сконфигурированный cgi модуль переадресации, просто дайте расширение .phtml. Кроме того, если Вы добавляете index.phtml к вашей строке конфигурации DirectoryIndex в файле srm.conf, то верхне-уровневая страница в каталоге будет автоматически анализироваться php, только назовите ваш индексный файл index.phtml.

Netscape HTTPD

Вы можете автоматически переадресовывать запросы к файлам с данным расширением, которые будут обрабатываться PHP/FI, с использованием модуля переадресации CGI сервера Netscape. Этот модуль доступен в файловом архиве на домашней странице PHP/FI. Файл README в пакете подробно объясняет, как конфигурировать модуль для использования с PHP/FI.

NCSA HTTPD

NCSA в настоящее время не поддерживает модули. Чтобы использовать cgi-переадресацию с этим сервером, нужно изменить исходный текст сервера. Патч, для сервера NCSA 1.5 доступен в архиве PHP/FI.

и скрипт создаст соответствующие таблицы.

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

Возможно вы захотите взглянуть на этот скрипт. Он определяет размеры полей ваших регистрационных таблиц. Если, например, Вы знаете, что ваши пути файлов превышают 64 символа, то Вы должны изменить размер имени файла, для таблиц logN и lastN в этом msqllog файле.

Информация о регистрации доступ сохраняется при каждом обращении к странице. Эта информация впоследствии может суммироваться, просмотром этих данных регистрации. Пример скрипта для суммирования данных по регистрации приводится в составе пакета. Это - log.html файл в каталоге examples. Это - анализатор dbm файла регистрации данных. Анализатор msql файла регистрации называется mlog.html. Чтобы выполнять эти скрипты, скопируйте их в каталогу, который доступен с вашего web сервера, и введите:

Пример 3

<IMG SRC="pic.gif">

В случае если file. html загружен обычным образом то gif файл, как и ожидается, будет в ~rasmus/public_html/pic.gif. Однако, если он загружен через программу CGI с URL подобно:

Пример 3

?EMAIL_ADDR=

К любым линкам на странице, где известен email адрес пользователя, Вы можете передавать это значение следующей странице. Система регистрации PHP, будет автоматически просматривать значение этой переменной и записывать его в качестве адреса электронной почты пользователя в файлах регистрации. Для любых пользователей PHP, вышеупомянутое выполняет ту же самую функцию что и добавление ?<!--$email--> к используемому URL. Это выглядит немного сложным сейчас, но сложным является и решение самому сформировать свою собственную страницу.

В вышеприведенном примере Вы также видели, как несколько переменных в методе GET могут быть правильно определены, отделением их друг от друга символом "&". Этот список переменных, разделенный символом "&" должен быть последней (или единственной) компонентой метода GET.

Пример 3

< $a = 5; echo $a; >

Лишние символы пробела, табуляции и новой строки игнорируются. Это нужно для того чтобы форматировать блоки программы PHP, для болшего удобства чтения. Регистр написания имеет значение для имен переменных, но не для имен функций. Позже в этой документации, при обзоре функций, регистр используется только для того, чтобы сделать имена функций более читабельными. В фактической программе Вы можете использовать любой регистр, который пожелаете.Комментарии поддерживаются. Комментарии записываются точно так же как комментарии в Языке C. /* начинает комментарий, */ заканчивает комментарий. Комментарии могут быть помещены в любом месте внутри блока <? ... >.

Пример 3

void UnixTime(void);

Пример 3

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

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

Пример 3

<? if($age>50); echo "Hi $name, you are ancient!<p>"; elseif($age>30); echo "Hi $name, you are very old!<p>"; else; echo "Hi $name."; endif; >

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

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

PHP/FI также имеет возможность принимать файл, загружаемый из любого, отвечающего требованиям RFC-1867, web броузера. Эта возможность позволяет передавать как текстовые, так и двоичные файлы. С управлением доступом PHP/FI и его логическими функциями, у вас есть полный контроль над тем, кому позволено передавать файлы и что с этим файлом должно быть сделано , если он передан. См. раздел Передача Файлов.

PHP/FI имеет поддержку для пакета базы данных, называемого mSQL. Это позволяет Вам помещать информацию в базу данных или обращаться за этой информацией через простые, встроенные прямо в ваши .HTML файлы, SQL запросы. Обработка базы данных через web страницу никогда не была проще. См. раздел по Поддержке mSQL.

PHP/FI также имеет поддержку для пакета базы данных Postgres95. См. раздел по Поддержке Postgres95 для более подробной информации.

По умолчанию, если Вы компилировали

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

<?setshowinfo(0)>

Пример 4

http://my.machine/cgi-bin/php.cgi/~rasmus/file.html

то HTTPD устанавливает текущий каталог на /cgi-bin (или на тот, на который указывает директива ScriptAlias) и впоследствии, когда страница загружена, pic.gif файл будет ожидаеться, в каталоге: /cgi-bin/pic.gif, что обычно является не желательным эффектом.

Быстрый способ решения этой проблемы состоит в том, чтобы использовать абсолютный URL. Если в вышеупомянутом примере, тэг изображения был:

Пример 4

<SELECT NAME="var" MULTIPLE>

Каждая выбранная опция будет передана обработчику формы в виде:

var=option1
var=option2
var=option3

Каждая опция затрет предыдущее содержимое переменной $var. Решение состоит в том, чтобы использовать особенность PHP/FI - не-индексированные массивы. Так нужно использовать:

Пример 4

<?$a = 5>

Заставляет $ a стать переменной типа INTEGER.

Пример 4

{ "crypt",CRYPT,NULL },

Обратите внимание, что последний элемент - NULL, в этом случае обращение к функции обрабатывается прямо в parse.raw. Если Вы использовали INTFUNC грамматику, то Вы поместите имя вашей функции вместо NULL. Фактическая функция Crypt находится в crypt.c:

Пример 4

$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().

Пример:

то не было бы никакой

то не было бы никакой проблемы. Но дело в том что использование абсолютного URL не всегда желательно, так как это делает страницы менее переносимыми. Очевидный вопрос, который Вы можете сейчас задать: " Почему бы PHP просто не изменяет текущий каталог на правильный? ". Ответ - PHP фактически изменяет текущий каталог на каталог, в котором расположен отображаемый HTML файл. Любые пути файлов, используемые внутри скрипта PHP могут быть относительны. Проблема состоит в том, что тэги, находящиеся вне области действия PHP типа <img> и <href> не будут обрабатываться PHP. Когда они анализируются, PHP уже не активен, и текущий рабочий каталог установлен на каталог, определенный HTTPD.

Решение - состоит в компромиссе. PHP обеспечивает переменную, называемую PATH_DIR. Она всегда содержит часть каталога из имени текущего HTML файла. Если эта переменная PATH_DIR используется в <img> и <href> тэгах, то может быть достигнут эффект относительного URL , хотя для сервера при анализе они будут выглядеть как абсолютный URL. Для нашего вышеприведенного примера , единственое изменение, которое нужно сделать это изменить тэг img на:

Пример 5

<SELECT NAME="var[]" MULTIPLE>

Это сообщает PHP/FI, чтобы он обработывал переменную var как массив, каждое присвоение значения переменной var[] добавляет элемент к массиву. Первый элемент становится $var[0], следующий $var[1], и т.д. Для опеределения количества выбранных элементов может использоваться функция count(), и в случае необходимости функция sort() для сортировки массива.

Пример 5

<?$a = 5.0>

Заставляет $ a стать переменной типа DOUBLE.

Пример 5

/* * If mode is non-zero, a salt is expected. * If mode is zero, a pseudo-random salt will be selected. */ void Crypt(int mode) { #if HAVE_CRYPT Stack *s; char salt[8]; char *enc; salt[0] = '\0'; if(mode) { s = Pop(); if(!s) { Error("Stack error in crypt"); return; } if(s->strval) strncpy(salt,s->strval,2); } s = Pop(); if(!s) { Error("Stack error in crypt"); return; } if(!salt[0]) { salt[0] = 'A' + (time(NULL) % 26); salt[1] = 'a' + (time(NULL) % 26); salt[2] = '\0'; } enc = (char *)crypt(s->strval,salt); #if DEBUG Debug("Crypt returned [%s]\n",enc); #endif Push(enc,STRING); #else Error(" No crypt support compiled into this version"); #endif }

Наиболее важный аспект этой функции - это вызов s = Pop(). Параметры для функции должны быть вытолкнуты из стека выражений один за другим. Когда Вы пишите функцию, которая принимает несколько аргументов, не забывайте, что стек - это структура данных "последним пришел", "первым вышел" . Это означает это, параметры будут выталкиваться из стека в обратном порядке. Последний параметр выталкивается первым. В вышеупомянутом примере мы выясняем, вызвана ли функция с 2 параметрами. Если да, параметр выталкивается из стека и сохраняется. Затем из стека выталкивается следующий параметр. Pop() возвращает указатель на структуру Stack (s). Структура Stack похожа на (из php.h):

/* Expression Stack */ typedef struct Stack { short type; unsigned char *strval; long intval; double douval; VarTree *var; struct Stack *next; } Stack;

Тип type будет один из STRING, LNUMBER или DNUMBER. Strval, intval и douval компоненты - строки, integer и double представления значения соответственно. Если выражение - фактически определенная переменная, компонента var содержит указатель на переменную структуру, которая определяет эту переменную.

В нашей функции Crypt() нас интересует только строковое значение параметра, так что мы используем s->strval. Много функций PHP/FI могут делать различные вещи в зависимости от типа переменной просто проверяя s->type и используя s->strval, s->intval и/или s->douval соответственно.

После вызова реальной функции Crypt() и получения шифрованной строки, наша функции Crypt() вызывает Push(enc, STRING); помещая возвращаемое значение в стек выражений. Нужно отметить, что стек выражений очищается после каждой строки PHP/FI, так что, если Вы помещаете выражения в стек, которые никогда не выталкиваются чем-либо, это не будет иметь значения.

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

Пример 5

$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" синтаксис для обработки обьединения.Эту функцию возможно лучше всего рассмотреть на примере:

Используя вышеприведенную запись, Вы можете

Используя вышеприведенную запись, Вы можете перемещать файл, содержащий этот тэг куда угодно, и тэг всегда будет ссылаться на файл pic.gif в том же самом каталоге что и исходный HTML файл.

Другой способ решения состоит в том, чтобы использовать традиционный <BASE HREF= ... > тэг в HTML файле.

Пример 6

<input type=image src=image.gif name=sub>

Когда пользователь нажимает где-нибудь на изображение, сопровождающая форма будет передана серверу с двумя дополнительными переменными, sub_x и sub_y. Они содержат координаты точки внутри изображения, на которой пользователь щелкнул мышью. Опытный может обратить внимание, что фактические имена переменных , посланных броузером содержат точку вместо подчеркивания, но PHP автоматически преобразовывает точку в подчеркивание.

Пример 6

<?$a = "5">

Заставляет $a стать переменной типа STRING.

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

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

Пример 6

<? $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() может использоваться для определения количества таблиц в указателе результата. Пример:

Обратите внимание, что, если имя

Обратите внимание, что, если имя переменной используется, и как массив и как обычная переменная, то имя обычной переменной является синонимом элементу массива с индексом "0". То есть.

Пример 7

<? $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 []). Функция возвращает значение нового элемента. Эта функция может использоваться, чтобы переместить указатель, вперед, без необходимости явного обращения к массиву. Можно использовать ее, чтобы просмотреть ассоциативный массив и только выводить значения ключей массива а не фактическое содержимое.

Это тоже самое

Это тоже самое что:

Пример 8

<? 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(). Следующий пример перебирает ассоциативный массив:

массив генерирует собственный индекс, по

PHP/FI также поддерживает не-индексированные массивы. Не-индексированный массив генерирует собственный индекс, по мере добавления элементов к нему. Например:

Пример 9

<? 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(). ниже приводятся некоторые примеры:

вышеупомянутые элементы могут быть распечатаны

Первому элементу, вставляемому в не-индексированный массив, всегда присваивается индекс 0, второму 1 индекс, и т.д. Следовательно вышеупомянутые элементы могут быть распечатаны с помощью:

Пример 10

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 в программе, просто сделайте:

Еще одно свойство языка, это

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

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

Пример 11

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(). Напр.

Может вести себя двояко. Если

Может вести себя двояко. Если $b это число, то числовое значение $c добавляется к $b, и сумма сохраняется в $a. В этом случае тип $c не важен. Операция управляется типом первой переменной. Если $b строка, то значение строки $c сонкатенируется с $b, и результирующая строка помещается в $a. Это также приводит к некоторым недоразумениям. Вам нужно прочесть раздел по перегруженным операторам, чтобы получить лучше понимание этого факта.

Пример 12

<?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" Вы могли бы разбить эту строку на индивидуальные слова, используя пробел как маркер. Вы использовали бы следующую программу:

При использовании ссылки на переменную

При использовании ссылки на переменную берется значение переменной и обрабатывается как имя переменной. В вышеупомянутом примере, hello, может использоваться как имя переменной, используя два знака $. То есть.

Пример 13

<? $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>.

На этот момент определены две

На этот момент определены две переменных и сохранены в дереве символов PHP/FI:

Имя переменной Содержимое

Следовательно, оператор:

Произведет точно такой же вывод

Произведет точно такой же вывод как и:

То есть. Они выведут строку:

То есть. Они выведут строку: hello world

Этот пример может быть записан

Этот пример может быть записан в стандартном синтаксисе C:

Нет никакого различия между двумя

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

Важно обратить внимание, что управление не зависит от организации блоков скриптов внутри кода. Вы можете начать выражение if в одном блоке и закончить выражение в другом. Например: