Руководство по PHP3 в одном большом файле

Содержание:Предисловие Preface Об этом руководстве Описание языка Введение в PHP3 Что такое PHP3? Что может делать PHP3? Краткая История PHP Возможности PHP3 HTTP-аутификация средствами PHP Создание GIF-файлов с помощью PHP Поддержка file upload Поддержка HTTP cookie Поддержка баз данных Регулярные выражения Обработка ошибок PHP source viewer УстановкаУстановка из исходных кодов на UNIXРуководство по установке PHP3 для WindowsПроблемы?БезопасностьКонфигурация Файл php3.ini Apache CGI Виртуальные хосты Безопасность Синтаксис и грамматика Переход из HTML Разделение инструкций Типы переменных Инициализация переменной Область Переменной Изменяемые переменные Переменные вне PHP Изменение типа Манипуляции с массивом Элементы языка Константа Выражения IF ELSE ELSEIF WHILE DO..WHILE FOR BREAK CONTINUE SWITCH REQUIRE INCLUDE FUNCTION OLD_FUNCTION CLASS Выражения Function Reference Adabas D функцииСпецифичные функции ApacheФункции обработки массивовМатематические BC (произвольной точности) функцииКалендарные функцииФункции даты/времениФункции dBaseФункции dbmФункции для работы с каталогамиФункции динамической загрузкиФункции запуска программФункции работы с fileProФункции файловой системыФункции, связанные с HTTPФункции работы с HyperwaveФункции работы с изображениямиФункции IMAPPHP опции и информацияФункции работы с InformixФункции работы с InterBaseLDAP функцииПочтовые функцииМатематические функцииВозможности PHP3Функции mSQLФункции MySQLФункции для работы с SybaseСетевые функцииФункции ODBCФункции OracleФункции PDFФункции PostgreSQLФункции регулярных выраженийФункции семафоров и разделяемой памятиSolid (надёжные) функцииФункции SNMPСтроковые функцииФункции URLФункции переменныхФункции VmailmgrФункции Gz-файловXML Parser функцииПриложения Переход от PHP/FI 2.0 к PHP 3.0 Программирование на PHP Отладчик PHP Preface

PHP Версии 3.0 - язык написания сценариев, внедренный в HTML. Многое из синтаксиса заимствовано из C, Java и Perl, с добавлением специфичных для PHP возможностей. Задача языка состоит в том, чтобы дать возможность Web-разработчикам легко и быстро создавать динамично изменяемые html-страницы.

Об этом руководстве

Это руководство написано в SGML при помощи DocBook DTD, с использованием DSSSL (Стиль Документа и Язык Спецификаций Семантики) при форматировании. Инструментальные средства, используемые для форматирования HTML, TeX и RTF версий - Jade, написанный Джеймсом Кларком и The Modular DocBook Stylesheets, созданные Норманом Валшом. Структура документации PHP3 была разработана Стигом СЈзером Баккеном.

Назад, к содержанию Глава 1. Введение в PHP3 Что такое PHP3?

PHP версии 3.0 - язык описания сценариев, выполняемых на сервере, встроенный в HTML.

Что может делать PHP3?

Возможно самая сильная и значимая возможность в PHP3 - уровень интеграции с базами данных. Написание веб-страницы работающей с базой данных невероятно проста. В настоящее временя поддерживаются следующие базы данных:

Oracle Adabas D Sybase FilePro mSQL Velocis MySQL Informix Solid dBase ODBC Unix dbm PostgreSQL Краткая История PHP

PHP был задуман где-то в конце 1994 года Расмусом Ледорфом(Rasmus Lerdorf). Ранние невыпущенные версии использовались на его домашней странице для того, чтобы следить за тем кто просматривал его интерактивное резюме. Первая используемая версия cтала доступна где-то в начале 1995 и была известна как Personal Home Page Tools. Она состояла из очень упрощенного движка синтаксического анализатора, который понимал только несколько специальных макрокоманд и ряд утилит, которые затем были в общем использовании на домашних страницах. Гостевые книги, счетчики и некоторые другие дополнения.

Довольно трудно дать какую-либо жесткую статистику, но отмечено, что к 1996 г. PHP/FI был использован по крайней мере на 15,000 веб-сайтах во всем мире. В середине 1997г. эта цифра выросла до более чем 50,000. В середине 1997г. также наблюдалось изменение в разработке PHP. Из частного любимого проекта Расмуса, которому способствовала горстка людей , это превратилось в намного более организованную рабочую группу. Синтаксический анализатор был заново переписан Зевом Сураски(Zeev Suraski) и Анди Гутмансом(Andi Gutmans), и этот новый синтаксический анализатор стал основой для PHP Версии 3.

Сегодня ( в середине -1998г.) как PHP/FI так и PHP3 поставляется с рядом коммерческих продуктов типа C2's StrongHold web server и RedHat Linux и консервативной оценкой, основанной на экстрaполяции чисел, предоставленных NetCraft было бы то, что PHP используется на 150,000 cайтах во всем мире. В перспективе, их больше чем сайтов, запущенных на Netscape's flagship Enterprise server в Интернете.

Назад, к содержанию

Глава 3. УстановкаСодержание
Установка из исходных кодов на UNIXРуководство по установке PHP3 для WindowsПроблемы?Безопасность

Эта глава является руководством по конфигурации и установке PHP3. Требуемые знания и программное обеспечение:

базовые навыки работы с UNIX (на уровне выполнения команды "make" и компилятора С);

компилятор ANSI C;

web server (очевидно);

Установка из исходных кодов на UNIX:Загрузка исходных кодов:

Исходные коды последней версии можно найти по адресу: http://www.php.net.

Инструкции по быстрой установке (версия модуля Apache):

1. gunzip apache_1.3.x.tar.gz
2. tar xvf apache_1.3.x.tar
3. gunzip php-3.0.x.tar.gz
4. tar xvf php-3.0.x.tar
5. cd apache_1.3.x
6. ./configure --prefix=/www
7. cd ../php-3.0.x
8. ./configure --with-mysql --with-apache=../apache_1.3.x --enable-track-vars
9. make
10. make install
11. cd ../apache_1.3.x
12. ./configure --prefix=/www --activate-module=src/modules/php3/libphp3.a
13. make
14. make install

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

15. cd ../php-3.0.x
16. cp php3.ini-dist /usr/local/lib/php3.ini

Вы можете отредактировать файл /usr/local/lib/php3.ini для установления опций PHP.
Если Вы предпочитаете поместить этот файл в другое место,
то используйте --with-config-file=/path в шаге 8.

17. Отредактируйте Ваш файл httpd.conf или srm.conf и добавьте:

AddType application/x-httpd-php3 .php3

Вы можете выбрать здесь любое расширение по Вашему желанию.
В данном случае мы просто рекомендуем выбрать .php3.

18. Используйте Вашу обычную процедуру для запуска сервера Apache.
(Вы должны остановить и перезапустить сервер, а не просто перезагрузить сервер
с использованием сигнала HUP или USR1).

Конфигурация:

Имеется два пути конфигурирования PHP3.

используйте скрипт "setup", который поставляется с PHP3. Этот скрипт задает Вам ряд вопросов (практически совпадающих со сценарием "install" PHP/FI 2.0) и в конце запускает "configure". Для запуска этого скрипта наберите ./setup.

Этот сценарий также создает файл, называемый "do-conf", который содержит опции, установленные при конфигурации. Вы можете редактировать этот файл для изменения некоторых опций без перезапуска "setup". Тогда выполните ./do-conf и конфигурация запустится с новыми параметрами.

выполните конфигурацию вручную. Для просмотра параметров Вы можете выполнить ./configure --help.

Детали различных параметров конфигурации рассмотрены ниже.

Модуль Apache:

Для построения PHP3 в качестве модуля Apache ответьте "yes" в пункте "Build as an Apache module?" (параметр конфигурации --with-apache= DIR ) и определить базовый каталог дистрибутива Apache. Если Вы распаковали свой дистрибутив Apache в директорию /usr/local/www/apache_1.2.4 то она и будет Вашей базовой директорией дистрибутива Apache. Директория по умолчанию /usr/local/etc/httpd.

Модуль fhttpd:

При построении fhttpd в качестве модуля fhttpd ответьте "yes" в пункте "Build as an fhttpd module?" (параметр конфигурации --with-fhttpd= DIR ) и определить базовый каталог исходных кодов fhttpd. По умолчанию это /usr/local/src/fhttpd. Если Вы запускаете fhttpd, то построение PHP3 в качестве модуля даст лучшую производительность и возможность контроля за удаленным исполнением.

Версия CGI:

По умолчанию PHP3 формируется как программа CGI. Если Вы используете web server с поддержкой PHP3 в качестве модуля, то в своих решениях Вы должны исходить из производительности. Однако CGI версия дает возможность пользователям Apache исполнять страницы с поддержкой PHP под различными идентификаторами пользователя. Пожалуйста, прочитайте Security chapter если Вы собираетесь исполнять PHP как CGI.

Параметры поддержки базы данных:

PHP имеет собственную поддержку для нескольких баз данных (так же как ODBC):

Adabas D --with-adabas =DIR

Компиляция с поддержкой Adabas D. Параметр - установочная директория Adabas D, по умолчанию /usr/local/adabasd.

Adabas home page

dBase --with-dbase

Включает условный атрибут поддержки Dbase. Не требует внешних библиотек.

filePro --with-filepro

Включает условный атрибут поддержки filePro только для чтения. Не требует внешних библиотек.

mSQL --with-msql=DIR

Включает поддержку mSQL. Параметр этой опции - установочная директория mSQL, по умолчанию /usr/local/Hughes. Это директория по умолчанию дистрибутива mSQL 2.0 configure автоматически определяет, какую версию mSQL Вы используете, а PHP3 поддерживает как версию 1.0, так и 2.0, но если Вы компилируете PHP2 с версией mSQL1.0, то можете получить доступ только к базам данных mSQL1.0 и наоборот.

Посмотрите также директивы mSQL Configuration в configuration file.

mSQL home page

MySQL --with-mysql=DIR

Включает поддержку MySQL. Параметр в этой опции - установочная директория MySQL, по умолчанию /usr/local. Она является директорией по умолчанию в дистрибутиве MySQL.

Посмотрите также директивы MySQL Configuration в configuration file.

MySQL home page

iODBC --with-iodbc=DIR

Включает поддержку iODBC. Этот признак был разработан сначала для iODBC Driver Manager, перераспределяемого ODBC driver manager, который выполняется под множеством разновидностей UNIX. Параметром этой опции является установочная директория iODBC, по умолчанию /usr/local.

FreeODBC home page

OpenLink ODBC --with-openlink=DIR

Включает поддержку OpenLink ODBC. Параметром этой опции является установочная директория OpenLink ODBC, по умолчанию /usr/local/openlink.

OpenLink Software's home page

Oracle --with-oracle=DIR

Включает поддержку Oracle. Протестирован и должен работать на версиях Oracle от 7.0 до 7.3. Параметром является директория ORACLE_HOME Вы не должны определять этот параметр, если была установлена среда окружения Oracle.

Oracle home page

PostgreSQL --with-pgsql=DIR

Включает поддержку PostgreSQL. Параметром является базовая установочная директория PostgreSQL, по умолчанию /usr/local/pgsql.

Посмотрите также директивы Postgres Configuration в configuration file.

PostgreSQL home page

Solid --with-solid=DIR

Включает поддержку Solid. Параметром является установочная директория Solid, по умолчанию /usr/local/solid.

Solid home page

Sybase --with-sybase=DIR

Включает поддержку Sybase. Параметром является установочная директория Sybase, по умолчанию /home/sybase.

Посмотрите также директивы Sybase Configuration в configuration file.

Sybase home page

Sybase-CT --with-sybase-ct=DIR

Включает поддержку Sybase-CT. Параметром является установочная директория Sybase, по умолчанию /home/sybase.

Посмотрите также директивы Sybase-CT Configuration в configuration file.

Velocis --with-velocis=DIR

Включает поддержку Velocis. Параметром этой опции является установочная директория OpenLink ODBC, по умолчанию /usr/local/velocis.

Velocis home page

A custom ODBC library --with-custom-odbc=DIR

Включает поддержку для произвольной custom ODBC library. Параметром является базовая директория, по умолчанию /usr/local.

Эта опция подразумевает, что Вы определили CUSTOM_ODBC_LIBS, когда исполняется сценарий конфигурации. Вы также должны иметь правильный заголовочный файл odbc.h где-нибудь в путях включения. Если у Вас его нет, то создайте свой заголовочный файл и включите его отсюда. Он может также требовать несколько внешних определений, особенно когда это на нескольких платформах. Определите их в CFLAGS.

Например Вы можете использовать Sybase SQL Anywhere on QNX следующим образом: CFLAGS=-DODBC_QNX LDFLAGS=-lunix CUSTOM_ODBC_LIBS="-ldblib -lodbc" ./configure --with-custom-odbc=/usr/lib/sqlany50

Unified ODBC --disable-unified-odbc

Отключает Unified ODBC модуль, который является общим интерфейсом ко всем базам данных с интерфейсом, основанным на ODBC, таких как Solid и Adabas D. Это также работает для нормальных библиотек ODBC. Был проверен с iODBC, Solid, Adabas D и Sybase SQL Anywhere. Требуется, чтобы один (и только один) из этих модулей или модуль Velocis был включен или определена пользовательская библиотека ODBC. Этот параметр применим только если используется одна из следующих опций: --with-iodbc, --with-solid, --with-adabas, --with-velocis, или --with-custom-odbc,

Посмотрите также директивы Unified ODBC Configuration в configuration file.

LDAP --with-ldap=DIR

Включает поддержку LDAP (Lightweight Directory Access Protocol). ). Параметром является базовая установочная директория LDAP, по умолчанию /usr/local/ldap.

Более подробную информацию по LDAP можно найти в RFC1777 и RFC1778.

Другие параметры конфигурации:--enable-sysvsem --enable-sysvsem

Включает поддержку для семафоров Sys V (поддерживается большинством разновидностей UNIX). Для получения подробной информации смотрим Semaphore and Shared Memory documentation.

--enable-sysvshm --enable-sysvshm

Включает поддержку разделяемой памяти для Sys V (поддерживается большинством разновидностей UNIX). Для получения подробной информации смотрим Semaphore and Shared Memory documentation.

--with-xml --with-xml

Включает поддержку для непроверенных синтаксических анализаторов XML, используя библиотеку от James Clark's expat library. Для больших подробностей обратитесь к XML function reference.

--enable-maintainer-mode --enable-maintainer-mode

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

--with-system-regex --with-system-regex

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

--with-config-file-path --with-config-file-path=DIR

Маршрут, используемый для просмотра the php3.ini file при старте PHP.

--with-exec-dir --with-exec-dir=DIR

Разрешить только запуск исполнимых файлов в DIR при нахождении в защищенном режиме. По умолчанию это /usr/local/bin. Эта опция только устанавливает значение по умолчанию, которое потом можно изменить при помощи директивы safe_mode_exec_dir в configuration file.

--disable-debug --disable-debug

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

--enable-safe-mode --enable-safe-mode

Включает защищенный режим (safe mode) по умолчанию. Это накладывает некоторые ограничения на действия PHP, таких как открытие файлов только внутри корня документа. Для более подробной информации смотрите Security chapter Пользователи CGI всегда должны включать безопасный режим. Эта опция только устанавливает значение по умолчанию, которое потом можно включить или выключить при помощи директивы safe_mode configuration file.

--enable-track-vars --enable-track-vars

Указывает PHP3 отслеживать пришедшие переменные GET/POST/cookie в массивах HTTP_GET_VARS, HTTP_POST_VARS и HTTP_COOKIE_VARS. Эта опция только устанавливает значение по умолчанию, которое потом можно включить или выключить при помощи директивы track_vars в configuration file.

--enable-magic-quotes --enable-magic-quotes

Включает по умолчанию системные квоты. Эта опция только устанавливает значение по умолчанию, которое потом можно включить или выключить при помощи директивы magic_quotes_runtime в configuration file. Смотрим также директивы magic_quotes_gpc и magic_quotes_sybase.

--enable-debugger --enable-debugger

Включает внутреннюю поддержку PHP3 debugger. Это свойство находится в стадии испытания. Смотрим также директивы Debugger Configuration в configuration file.

--enable-discard-path --enable-discard-path

Если это включено, то бинарный PHP CGI может быть безопасно помещен вне дерева web и пользователи не смогут обойти защиту .htaccess. Читайте об этой опции section in the security chapter.

--enable-bcmath --enable-bcmath

Включает стиль bc произвольной точности математических функций. Смотрим также опцию bcmath.scale в configuration file.

--enable-force-cgi-redirect --enable-force-cgi-redirect

Включает проверку безопасности для внутренних переадресаций сервера (redirect). Вы должны использовать это, если запускаете CGI версию с Apache.

Когда PHP используется в качестве исполняемого CGI, PHP по умолчанию сначала всегда проверяет, что используется переадресацией (например под Apache, используя директивы Action). Это дает уверенность, что исполняемый PHP не может использоваться для того, чтобы обойти стандартные процедуры установления прав web сервера путем непосредственного вызова, как например http://my.host/cgi-bin/php/secret/doc.html. Этот пример, доступен на http://my.host/secret/doc.html но игнорирует все установленные httpd правила безопасности для директории /secret.

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

Читайте об этой опции в section in the security chapter.

--disable-short-tags --disable-short-tags

Отключает краткую форму <? ?>тегов PHP3. Вы должны отключить краткую форму, если хотите использовать PHP3 c XML. При отключенной краткой форме принимается только тег PHP3 <?php ?>. Эта опция только устанавливает значение по умолчанию, которое потом можно включить или выключить при помощи директивы short_open_tag в configuration file.

--enable-url-includes --enable-url-includes

Дает возможность выполнять код на других HTTP и FTP серверах непосредственно из PHP3 с include(). Смотрим также опцию include_path в configuration file.

--disable-syntax-hl --disable-syntax-hl

Выключает синтаксическое выделение.

CPPFLAGS и LDFLAGS

При сборке PHP3 установщик просматривает заголовочные и библиотечные файлы в различных директориях, измените соответственно переменные окружения CPPFLAGS и LDFLAGS. Если Вы используете нормальный shell, то вы должны написать LDFLAGS=-L/my/lib/dir CPPFLAGS=-I/my/include/dir ./configure

Построение:

Когда PHP3 сконфигурирован, Вы готовы к построению исполнимых CGI или библиотеку PHP3. Об этом заботится команда make. Если Вы потерпели неудачу и не можете понять почему, то смотрите раздел Problems section.

VPATH

Проверка:

Если Вы собрали PHP3 в качестве программы CGI, Вы можете проверить результат, выполнив команду make test. Это хорошая идея - проверить результат сборки. Этим способом Вы можете обнаружить проблему с Вашим PHP3 на ранней стадии, вместо того, чтобы бороться с этим позже.

Контрольное тестирование:

Если Вы собрали PHP3 в качестве программы CGI, Вы можете протестировать свою версию при помощи команды make bench. Обратите внимание, что если используется защищенный режим по умолчанию, то тест может не завершиться, если он требует больше, чем 30 секунд. Это происходит потому, что set_time_limit() () не может быть использована в защищенном режиме. Используйте max_execution_time для контроля этого времени в Ваших собственных сценариях. make bench игнорирует configuration file.

Назад, к содержанию Глава 4. Конфигурация Файл php3.ini

Файл php3.ini читается при запуске синтаксического анализатора PHP. Для версий серверного модуля PHP, это случается только один раз, когда запускается веб-сервер. Для версии CGI это случается на каждом вызове.

Только для каждой директивы указанной здесь, имеется соответствующая директива Apache в httpd.conf. Просто добавьте php3_ в начале имен директив, указанных здесь.

Вы можете посмотреть установочные параметры большинства значений конфигурации вызвав функцию phpinfo().

Основные директивы конфигурации

auto_append_file string

Определяет имя файла, который автоматически проверяется после основного файла. Файл включается так же, как если бы была вызвана функция include(), с использованием include_path.

Специальное значение none запрещает авто-добавление.

Примечание: Если сценарий обрывается функцией exit(), авто-добавление не произойдет.

auto_prepend_filestring

Определяет имя файла, который автоматически проверяется перед основным файлом. Файл включается так же, как если бы была вызвана функция include(), с использованием include_path.

Специальное значение none запрещает авто-добавление.

cgi_ext string

display_errors boolean

Это определяет, должны ли ошибки печататься на экране как часть HTML вывода или нет.

doc_root string

Главный каталог("root directory") PHP на сервере. Используется только когда он не пустой. Если PHP сконфигурирован при помощи safe mode, то никакие другие файлы за пределами этого каталога не обслуживаются.

engine boolean

Эта директива действительно полезна только в модуле PHP под Apache. Это используется на сайтах, где необходимо включать и выключать синтаксический анализ PHP на определенные каталоги и виртуальные серверы. Установкой php3_engine off в допустимом месте файла httpd.conf, PHP можно запрещать и разрешать.

error_log string

Имя файла, куда сохраняется журнал ошибок(log file) сценариев. Если используется специальное значение syslog, ошибки отправляются в системный журнал(system logger). В UNIX'е это syslog(3), а в Windows NT это журнал событий (event log). Системный журнал не поддерживается в Windows 95.

error_reporting integer

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

Таблица 4-1. Уровни сообщений об ошибках

bit valueдопустимые сообщения

1	нормальные ошибки
2	нормальные предупреждения
4	ошибки синтаксического анализатора
8	некритичные предупреждения стиля

Значение по умолчанию - 7 (показываются нормальные ошибки, нормальные предупреждения и синтаксические ошибки).

Ограничивает файлы, которые могут открываться PHP в определенном директории-дереве.

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

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

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

Устанавливает допустимость GET/POST/COOKIE в анализе. Установка по умолчанию этой директивы - "GPC". Установка ее в "GP", например, вынудит PHP полностью игнорировать cookies и перезапишет любые переменные метода GET переменными метода POST с одинаковыми именами.

Определяет список каталогов где будут располагаться файлы для функций require() , include() и fopen_with_path() . Формат подобен формату системной переменной окружения PATH : список каталогов разделяется двоеточием в UNIX или точкой с запятой в Windows.

Пример 4-1. UNIX include_path include_path=.:/home/httpd/php-lib

Пример 4-2. Windows include_path include_path=".;c:wwwphplib"

Значением по умолчанию этой директивы является . (только текущий каталог).

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

Устанавливает magic_quotes состояние для GPC (Get/Post/Cookie) операций. Когда magic_quotes включено (on), все ' (одиночные кавычки), " (двойные кавычки), (обратные слэши) и нулевые значения (NUL's) записываются с обратной косой чертой автоматически. Если также включено magic_quotes_sybase, одиночная кавычка записывается с дополнительной одиночной кавычкой вместо обратной косой черты.

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

Если magic_quotes_sybase также разрешено, одиночная кавычка записывается с дополнительной одиночной кавычкой вместо обратной косой черты, если magic_quotes_gpc или magic_quotes_runtime разрешены.

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

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

Задает допустимость короткой формы ( <? ?> тегов PHP . Если вы хотите использовать PHP совместно с XML, эту опцию необходимо отключить. Если опция отключена, вы должны использовать длинную форму тегов ( <?php ?> ).

Если опция разрешена, последнее сообщение об ошибке всегда будет представлена в глобальной переменной $php_errormsg.

Если опция разрешена, входящая информация GET, POST и cookie может быть найдена в глобальных ассоциативных массивах $HTTP_GET_VARS , $HTTP_POST_VARS и $HTTP_COOKIE_VARS , соответственно.

Временный каталог, используемый для хранения файлов при их загрузке на сервер. Должен допускать запись, независимо от того, каким пользователем PHP используется.

Основное имя каталога, используемого в домашнем каталоге пользователей для файлов PHP, например public_html .

Если разрешено, эта опция выдает при выводе PHP сообщение когда оператор плюс( + ) используется в строке. Это должно облегчить поиск сценариев, которые должны быть перезаписаны с заменой на ( . ) - string concatenator.

Имя DNS или IP адрес сервера SMTP, который должен использоваться PHP под Windows для отправки сообщения функцией mail() .

Определяет "From:" - почтовый адрес, который используется в сообщении, отправленном PHP под Windows.

Указывает где может быть найдена программа sendmail , обычно это /usr/sbin/sendmail или /usr/lib/sendmail
configure делает честную попытку определить это за вас и устанавливает значение по умолчанию, но в случае неудачи вы можете установить это здесь.

Системы не использующие sendmail должны установить оболочку/замену sendmail их предлагаемой системой почты, если имеется. Например, Qmail пользователи могут указать /var/qmail/bin/sendmail .

Устанавливает допустимость PHP safe mode. Читайте главу Безопасность (Security) для большей информации

Если PHP используется в safe mode, system() и другие функции, выполняющие системные программы, отказываются запускать программы, которые находятся не в этом каталоге.

DNS-имя или IP-адрес хоста используемого отладчиком.

Номер порта используемого отладчиком.

Задает допустимость использования отладчика.

Эта директива действительно полезна только в модуле PHP под Apache. Вы можете разрешать/запрещать динамическую загрузку расширений PHP функцией dl() раздельно по каталогам и/или по виртуальным серверам.

Основная причина для выключения динамической загрузки - безопасность. С динамической загрузкой, можно игнорировать все ограничения safe_mode и open_basedir.

По умолчанию динамическая загрузка должна допускаться, за исключением случаев, когда используется safe-mode. В safe-mode всегда недопустимо использование dl() .

В каком каталоге PHP должен искать динамически загружаемые расширения.

Какие динамически загружаемые расширения загрузить, при запуске PHP.

Допустить постоянные/устойчивые MySQL соединения.

Максимальное число постоянных MySQL соединений за один процесс.

Максимальное число MySQL соединений за процесс, включая постоянные соединения.

Допустить постоянные mSQL соединения.

The maximum number of persistent mSQL connections per process.

Максимальное число постоянных mSQL соединений за один процесс.

Допустить постоянные/устойчивые соединения Postgres.

Максимальное число постоянных соединений Postgres за процесс.

Максимальное число Postgres соединений за процесс, включая постоянные соединения.

Допустить постоянные Sybase соединения.

Максимальное число постоянных Sybase соединений за процесс.

Максимальное число Sybase соединений за процесс, включая постоянные соединения.

Допустить постоянные Sybase-CT соединения. По умолчанию включено.

Максимальное число постоянных Sybase-CT соединений за процесс. По умолчанию значение -1 означающее неограниченное количество.

Максимальное число Sybase-CT соединений за процесс, включая постоянные соединения. По умолчанию значение -1 означающее неограниченное количество.

Сообщения Сервера со степенью более чем или равной sybct.min_server_severity будут сообщены как предупреждения. Эта величина может также устанавливаться из сценария вызовом sybase_min_server_severity() . Значение по умолчанию - 10 , которое сообщает ошибки строгости информации, или выше.

Сообщения библиотеки Клиента со строгостью более чем или равной sybct.min_client_severity будут сообщены как предупреждениях. Эта величина может также устанавливаться из сценария вызовом sybase_min_client_severity() . По умолчанию - 10, что эффективно запрещает вывод.

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

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

Имя хоста, с которым вы хотите соединиться, для показа sp_who. По умолчанию - none.

Количество десятичных цифр для всех функций bcmath.

имя файла возможностей браузера.

ИСТОЧНИК ДАННЫХ ODBC, для использования, если ничего не определено в odbc_connect() или odbc_pconnect() .

Имя пользователя, используемое если нет определений в odbc_connect() или odbc_pconnect() .

Пароль, используемый, если не определено в odbc_connect() или odbc_pconnect() .

Допустить постоянные/устойчивые ODBC соединения.

Максимальное число постоянных ODBC соединений за процесс.

Максимальное число ODBC соединений за процесс, включая постоянные соединения.

PHP - мощный язык и интерпретатор, независимо от того, включен ли он в веб-сервер как модуль или выполняется как разделение исполнимых файлов(binary) CGI, он может иметь доступ к файлам, выполнять команды и открывать сетевые соединения на сервере. Эти свойства дают возможность выполнять что-нибудь на веб-сервере небезопасное по умолчанию. PHP разработан специально для того чтобы быть более безопасным языком для написания программ CGI, чем Perl или C.
С правильным выбором compile-time и runtime опций конфигурации он дает вам как раз ту комбинацию свободы и безопасности, которая вам нужна.

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

Использование PHP как исполнимых файлов CGI - выбор для установок, которые по некоторой причине не хотят внедрить PHP как модуль в программное обеспечение сервера (подобно Apache), или PHP будет использоваться с другими типами оболочек CGI, чтобы создать надежное окружение chroot и setuid для сценариев. Эта установка обычно включает установку выполняемого(binary) PHP в каталог cgi-bin на веб-сервере. Бюллетень CERT CA-96.11 рекомендует кроме того, устанавливать любые интерпретаторы в cgi-bin. Даже если исполнимый PHP может быть использован в качестве автономного интерпретатора, PHP разработан для того чтобы предохранить от атаки, которую эта установка делает возможной:

Доступ к системным файлам: http://my.host/cgi-bin/php?/etc/passwd

Информация запроса в url после знака вопроса (?) проходит как аргументы командной строки интерпретатору через интерфейс CGI. Обычно переводчики открывают и выполняют файл указанный как первый аргумент в командной строке.

Вызванный как исполняемый CGI-файл, PHP отказывается интерпретировать командные аргументы строки.

Доступ к любым веб-документам на сервере: http://my.host/cgi-bin/php/secret/doc.html

Часть URL с информацией о пути, стоящая после имени PHP-файла, /secret/doc.html обычно используется, чтобы определить имя файла, который должен открываться и интерпретироваться CGI программой. Обычно некоторые директивы конфигурации веб-сервера(Apache: Action) используются, чтобы перенаправить запросы к документам подобно http://my.host/secret/script.php3 на PHP интерпретатор. С такой установкой веб-сервер сначала проверяет разрешения доступа в каталоге /secret , и потом создает запрос перенаправления http://my.host/cgi-bin/php/secret/script.php3 . К несчастью, если запрос не дается изначально в этой форме, веб-сервер не проверяет доступ к файлу /secret/script.php3 , но только для файла /cgi-bin/php . Таким образом любой пользователь, имеющий доступ к /cgi-bin/php , получает доступ к любым защищенным документам на сервере.

В PHP, опция compile-time конфигурации --enable-force-cgi-redirect и директивы runtime-конфигурации doc_root и user_dir может использоваться для того чтобы отразить эту атаку, если дерево документов сервера имеет любые директории с ограничениями доступа. Смотрите ниже для полного объяснения других комбинаций.

Если ваш сервер не имеет какой-либо информации, которая не ограничивается паролем или управлением доступом на основе ip, нет потребности в этих опциях конфигурации. Если ваш веб-сервер не позволяет вам производить перенаправление, или сервер не имеет пути, чтобы связаться с исполнимым PHP, который запрашивает благополучно перенаправленный запрос, вы можете указать опцию --disable-force-cgi-redirect для конфигурирования сценария.
Вы все еще должны убедиться, что ваши сценарии PHP не полагаются на этот или другой путь вызова сценария, ни непосредственно http://my.host/cgi-bin/php/dir/script.php3, ни переадресацией http://my.host/dir/script.php3.

Перенаправление может быть сконфигурировано, например в Apache, директивами AddHandler и Action (см. ниже).

Эта compile-time опция предохраняет от вызова PHP напрямую с URL подобно http://my.host/cgi-bin/php/secretdir/script.php3. Вместо того чтобы выполнить запрос, PHP выполняет только грамматический разбор в этом способе если он выполнил правила перенаправления вебсервера.

Обычно переадресация в конфигурации Apache сделана со следующими директивами:

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

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

Также, если недоступен метод перенаправления неуверенных запросов, как описано в предыдущем разделе, необходимо установить корневой каталог(doc_root) сценариев, который отличается от корневого каталога веб-документов.

Вы можете установить корневой каталог для скриптов директивой конфигурации doc_root в файле php3.ini , или вы можете установить переменную окружения PHP_DOCUMENT_ROOT. Если это установлено, CGI-версия PHP всегда будет добавлять doc_root и путь к файлу в запросах, так что вы всегда будете уверенны что за пределами этого каталога скрипты выполняться не будут (кроме user_dir //см.ниже).

Другая используемая опция - user_dir. Когда user_dir - не установлена, открытием файла управляет только doc_root. Открытие URL подобно http://my.host/~user/doc.php3 не даст результата при открытии файла из каталога пользователя, но вызывается файл ~user/doc.php3 из каталога doc_root (да,имя каталога начинается с тильды [~]).

Если user_dir установлена, например как public_php, запрос, подобный http://my.host/~user/doc.php3 откроет файл doc.php3 в каталоге public_php домашнего каталога пользователя. Если это /home/user, то выполняется /home/user/public_php/doc.php3.

user_dir задается независимо от doc_root, так что вы можете контролировать доступ к document root и user directory отдельно.

Очень безопасная опция должна установить синтаксический анализатор PHP где-нибудь вне дерева файлов web. В /usr/local/bin, например. Обратная сторона этой опции заключается в том что вы должны вставлять строку подобно:

Чтобы PHP получил возможность корректно оперировать с PATH_INFO и PATH_TRANSLATEDпри такой установке, php анализатордолжен быть скомпилирован с опцией конфигурации --enable-discard-path

Когда PHP используется как Apache модуль, не наследуются права пользователя Apache (обычно таковые - "nobody").

Синтаксис PHP заимствован непосредствено из C.   Java и Perl также повлияли на синтаксис данного языка.

Есть три способа выхода из HTML и перехода в "режим PHP кода":

Инструкции (утверждения) разделяются также как в C или Perl - точкой с запятой.

Закрывающий тэг (?>) тоже подразумевает конец утверждения, поэтому следующие записи эквивалентны:

PHP поддерживает переменные следующих типов: integer - целое double  - число с дробной частью string  - строковая переменная array  - массив object - объектная переменная pdfdoc - PDF-документ (только при наличии поддержки PDF) pdfinfo - PDF-инфо (только при наличии поддержки PDF)

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

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

Учтите, что переменная может вести себя по разному  в определенных ситуациях, в зависимости от того, какой тип определен для нее в данное время. Более подробно это описано в разделе Изменение типа.

Для инициализации переменной в PHP  вы просто присваиваите ей значение. Для большинства переменных это именно так; для массивов и объектных переменных, однако, может использоваться несколько иной механизм.

Массив может инициализироваться одним из двух способов: последовательным присвоением значений, или посредством конструкции array() (которая описана в разделе Функции Массивов).

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

Как в C и Perl, элементы массива нумеруются начиная с 0, а не с 1.

Для инициализации объектной переменной используйте новое предписание для сопоставления данного объекта объектной переменной.

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

Этот скрипт не выдаст что-либо на выходе, поскольку инструкция echo относится к локальной версии переменной $a, значение которой присваивается не внутри этой области. Вы можете заметить, что здесь имеется некоторое отличие от языка C, в том что глобальные переменные в C автоматически действуют и внутри функций,   если только они не переписываются локальными определениями. Это может вызвать некоторые проблемы, т.к. по неосторожности можно изменить глобальную переменную. В PHP глобальные переменные должны быть продекларированы глобально внутри функции, если предполагается их использование в данной функции.  Например:

Вышеописанный скрипт выдаст значение "3". Поскольку $a и $b декларируются глобально внутри функции, ссылки на данные переменные трактуются как ссылки на их глобальные версии. Нет ограничений на количество глобальных переменных, которыми можно манипулировать внутри функции.

Вторым способом доступа к переменным из глобальной области является использование специального опеределяемого PHP массива $GLOBALS. При этом предыдущий пример может быть записан как:

Массив $GLOBALS является ассоциативным массивом, в котором имя глобальной переменной является ключом, а значение этой переменной является значением элемента массива.

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

Эта функция совершенно бесполезна практически, поскольку каждый раз при ее вызове она устанавливает $a в 0 и выводит "0".   Выражение $a++ , которое увеличивает значение переменной, так же бесполезно, поскольку при выходе из функции переменная $a исчезает. Для придания дееспособности функции подсчета, которая не теряла бы нить текущего счета, переменная $a декларируется как статическая:

Теперь, каждый раз при вызове функции Test() она будет выводить значение $a и увеличивать его.

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

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

Изменяемая переменная берет некое значение и обрабатывает его как имя переменной. В приведенном выше примере значение hello может быть использовано как имя переменной, посредством применения двух записанных подряд знаков доллара, т.е.:

С этой точки зрения, две переменных определены и сохранены в символьном дереве PHP: $a с содержимым "hello" и $hello с содержимым "world". Так, инструкция:

осуществляет то же самое, что и инструкция:

а именно, обе они выводят: hello world.

Чтобы использовать изменяемые переменные с массивами, необходимо решить проблему неоднозначности. Это означает, что если вы пишете $$a[1], то синтаксическому анализатору необходимо знать, имеете ли вы в виду использовать $a[1] как переменую, или вы предполагаете $$a  как переменную а [1] как индекс этой переменной. Синтаксис для разрешения подобной неоднозначности такой: ${$a[1]} для первого случая и ${$a}[1] для второго.

Когда программой-обработчиком формы является PHP-скрипт, переменные этой формы автоматически доступны для данного скрипта PHP. Например, рассмотрим следующую форму:

При активизации формы PHP создаст переменную $name, значением которой будет то содержимое, которое было введено в поле Name: данной формы.

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

Если PHP-атрибут track_vars включен, через установку конфигурации track_vars или директивой <?php_track_vars?>, тогда переменные, активизированные посредством методов POST или GET, будут также находиться в глобальных ассоциативных массивах $HTTP_POST_VARS и $HTTP_GET_VARS соответственно.

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

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

PHP очевидным образом поддерживает HTTP кукисы, как это определено в Netscape's Spec. Кукисы являются механизмом хранения данных в удаленном браузере, используемым для поддержки процедуры обмена или идентификации ответа   пользователя. Кукисы можно устанавливать используя функцию SetCookie(). Кукисы являются частью заголовка HTTP, поэтому функция SetCookie() должна вызываться прежде чем какие-либо передаваемые данные посылаются браузеру. Это такое же ограничение, как и для функции Header(). Любые кукисы, посылаемые вам клиентом, автоматически преобразовываются в переменные PHP, также как данные методов GET и POST.

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

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

PHP автоматически создает переменные окружения, как и обычные переменные.

Хотя при поступлении информации механизмы GET, POST и Cookie также атоматически создают переменные PHP, иногда лучше явным образом прочитать переменную окружения, для того чтобы быть уверенным в получении ее правильной версии. Для этого может использоваться функция getenv(). Для установки значения переменной окружения пользуйтесь функцией putenv().

PHP не требует явного определения типа при объявлении переменной, тип переменной определяется по контексту в котором она используется. То есть, если вы присваиваете строковое значение переменной var, var становится строкой. Если затем присвоить переменной var значение целого (числа), то она станет целым.

Примером автоматического преобразования типа в PHP может служить оператор сложения '+'. Если какой-либо из оперендов является числом с дробной частью (тип double), то затем все операнды оцениваются как double и результат будет иметь тип double. Иначе, эти операнды будут интерпретированы как целые (integers) и результат будет так же иметь тип integer. Отметим, что при этом НЕ меняются типы самих операндов, меняется только оценка этих операндов.

Если последние два примера выше кажутся неясными, смотрите Преобразование строк.

Если вы хотите чтобы переменная принудительно оценивалась как имеющая определенный тип, смотрите раздел Приведение типа. Если вы желаете изменить тип переменной, смотрите settype().

Поскольку PHP определяет типы переменных и преобразует их (в общем) по мере необходимости, не всегда очевидно какой тип данная переменная имеет в какой-то отдельный момент. Поэтому PHP включает несколько функций, которые позволяют определить текущий тип переменной. Это функции gettype(), is_long(), is_double(), is_string(), is_array(), и is_object().

Приведение типа работает в PHP во многом так же как в C: название требуемого типа записывается в круглых скобках перед переменной, которая должна быть приведена к данному типу.

Допускается следующее приведение типов: (int), (integer) - приведение к целому (real), (double), (float) - приведение к типу double (string) - приведение к строке (array) - приведение к массиву (object) - приведение к объектной переменной

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

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

Переменная string будет оценена как double, если она содержит любой из символов '.', 'e', или 'E'. Иначе она будет оценена как integer.

Данное значение задается начальной частью строковой переменной. Если строка начинается с допустимых цифровых данных, то это значение и будет использоваться. Иначе, будет значение 0 (ноль). Допустимые цифровые данные - это конструкция из факультативного символа, следующего за одной или несколькими цифрами (содержащими факультативно десятичную точку), обозначающего экспоненту. Экспонента может обозначаться символом 'e' или 'E', который может следовать за одной или несколькими цифрами.

Дополнительную информацию смотрите в руководстве Unix страница для strtod(3).

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

Можно также создать массив просто добавляя в него значения.

Массив может сортироваться функциями asort(), arsort(), ksort(), rsort(), sort(), uasort(), usort(), и uksort() в зависимости от типа желаемой сортировки.

Подсчет количества элементов массива осуществляется функцией count().

Перемещаться по массиву позволяют функции next() и prev(). Другим типовым способом перемещения по массиву является использование функции each().

Любой скрипт PHP состоит из последовательности операторов. Оператор может быть присваиванием, вызовом функции, циклом, условным выражением или пустым выражением (ничего не делающим). Операторы обычно заканчиваются точкой с запятой. Также операторы могут быть объединены в группу заключением группы операторов в фигурные скобки. Группа операторов также является оператором. В этой части описаны различные типы операторов.

PHP определяет несколько констант и предоставляет механизм для определения Ваших констант. Константы похожи на переменные, но они имеют слегка изменЈнный синтаксис.

ПредопределЈнные константы - это __FILE__ and __LINE__, которые соответствуют имени файла и номеру строки, которая выполняется в настоящий момент.

Вы можете определить дополнительные константы с помощью функций define() и undefine() .

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

Простейший пример, приходящий на ум это константы и переменные. Когда вы печатаете "$a = 5", вы присваиваете значение '5' переменной $a. '5', очевидно, имеет значение 5, иными словами'5' это выражение со значением5 (в данном случае'5' это целочисленная константа).

После этого присваивания вы считаете значением $a 5, также, если вы напишете $b = $a, вы будете ожидать того же как, если бы вы написали $b = 5. Другими словами, $a это также выражение со значением 5. Если всЈ написано правильно, то именно так оно и случиться.

Несколько более сложные примеры выражений - это функции. К примеру, подумайте на следующей функцией :

Подразумевая, что вы знакомы с концепциями функции (если нет, взгляните на часть, посвящЈнную функциям), вы считаете, что $c = foo() это практически то же самое, что написать $c = 5 и вы правы. Функции - это выражения с тем значением, которое они возвращают. Так как foo() возвращает 5, значение выражение 'foo()' - 5. Обычно функции подсчитывают возвращаемое значение,а не возвращают постоянное значение.

Конечно, значения в PHP не обязаны быть целыми и зачастую они не являются таковыми. PHP поддерживает 3 скалярных типа значений : целое, число с плавающей точкой и строки ( скалярные выражения вы не можете "разбить" на более маленькие части, как, к примеру, массивы). PHP поддерживает 2 составных (нескалярных) типа : массивы и объекты. Каждое из таких значений может быть присвоено переменной или возвращено функцией.

Итак, пользователи PHP/FI 2 не должны почувствовать каких-то перемен. PHP это язык, ориентированный на выражения, практически всЈ является выражениями.Обратимся к примеру, с которым мы уже разобрались, '$a = 5'. Легко заметить, что тут задействованы два значения - значение целой константы 5 и значение $a, которое также становиться равным 5.На самом деле здесь присутствует ещЈ одно значение, значение самого присваивания. Само присваивание становиться равным присваиваемому значению, в данном случае - 5.На практике это означает, что '$a = 5', не обращая внимания на то, что оно равно выражению со значением 5. То есть, запись типа '$b = ($a = 5)' похожа на запись'$a = 5; $b = 5;' (точка с запятой отмечает конец выражения). Так как присваивания рассматриваются справа налево, вы также можете написать '$b = $a = 5'.

Другой хороший пример направления выражения это прежварительное и последующее увеличение и уменьшение. Рользователи PHP/FI 2 и многих других языков могут быть знакомы с записями variable++ and variable--. Это операторы увеличения и уменьшения. В PHP/FI 2, оператор '$a++' не имеет значения(не является выражением), поэтому вы не можете его присвоить или использовать как-либо иначе. PHP расширяет возможность увеличения/уменьшения делая его выражением, как и в C. В PHP, подобно C, есть 2 типа инкремента - предварительный и последующий. И предыдущий и последующий инкремент увеличивает значение переменной и воздействие на переменную идентично.Разница в значении выражения инкремента. Предыдущее увеличение, которое записывается как '++$variable', приравнивается увеличенной переменной (PHP увеличивает переменную до того, как прочитать еЈ значение). Post-increment, which is written '$variable++' evaluates to the original value of $variable, before it was incremented (PHP increments the variable after reading its value, thus the name 'post-increment').

Очень распространЈнный тип выражений это выражения сравнения. Эти выражения имеют значение 0 или 1 (означает ложь или истину соответственно). PHP поддерживает > (больше, чем), >= ( больше или равно), = (равно), < (меньше,чем) и <= (меньше или равно). Эти выражения в основном используются внутри условий, например оператора IF.

Последний пример выражений, с которыми мы разберЈмся, это совмещЈнные выражения оператор-присваивание. Вы уже знаете, что для того, чтобы увеличить значение $a на еденицу, вы можете написать '$a++' или '++$a'. Но если следует увеличить значение больше, чем на еденицу, к примеру - на 3? Вы можете написать '$a++' несколько раз, но это не очень удобно и эффективно. Намного больше распространено написание '$a = $a + 3'. '$a + 3' вычисляется, как значение $a плюс 3, а затем присваивается переменной $a, в результате чего значение $a увеличивается на 3. В PHP, также как и в ряде других языков типа C, вы можете записать это короче, что со временем бывает проще и быстрее также и для понимания. Добавление 3 к текущему значению $a может быть записано как '$a+=3'. Это значит следующее : 'возьми значение $a, добавь к нему 3 и присвой это обратно $a. Кроме того, что это быстрее и понятнее, такой тип выражений быстрее исполняется. Значение '$a+=3' как и значение обычного присваивания это присвоенное значение. Заметьте, что оно не равно 3, а является общим значением $a и 3. Любой бинарный (имеющий 2 операнда - прим. пер.) оператор может быть записан таким методом, например : '$a-=5' (вычесть 5 из значения $a), '$b*=7' (умножиить значение $a на 7) и так далее.

Есть ещЈ такое выражение, которое может показаться незнакомым, если вы не встречались с ним в других языках - условный оператор с тремя операндами :

$first ? $second : $third

Если значение первого выражения истинно (не равно 0), то испольняется второе выражение и это является результатом данного условного выражения. Иначе исполняется третий оператор.

Этот пример должен помочь Вам лучше понять предварительное и последующее увеличение и вообще выражения ?

function double($i)    /* функция удваивания переменной */
{
  return $i*2;
}
$b = $a = 5;    /* присваиваем значения переменым $a и $b */
$c = $a++;    /* последующее увеличение, присваиваем $c начальное значение $a (5)*/
$e = $d = ++$b;    /* предварительное увеличение, присваиваем $d и $e увеличенное значение$b (6) */
   /* тут и $d и$e равны6 */
$f = double($d++);    /* присвоить удвоенное значение $d до его увеличения, то есть 2*6 = 12, переменной $f*/
$g = double(++$e);    /* присвоить удвоенное значение $e после его увеличения, то есть 2*7 = 14, переменной g */
$h = $g += 10;    /* сначала увеличить значение $g на 10, что даЈт в результате 24, а затем присвоить это значение переменной $h, что также даЈт 24 */

В начале главы мы сказали, что объясним различные типы операторов и, как и было обещано выражения могут быть операторами. Впрочем, не каждое выражения является оператором. В данном случае оператор имеет форму 'выражение' ';', то есть выражение, за которым следует точка с запятой. В '$b=$a=5;' $a=5 это правильное выражение, но само по себе оно не является оператором. А вот '$b=$a=5;' является правильным оператором.

ЕщЈ одна вещь, которую нужно упомянуть - это логические значения выражений. Во многих случаях, в основном в условных операторах и операторах циклов, вы не заинтересованы в конкретных значениях выражений, а только являются ли их значения TRUE или FALSE (в PHP нет специального типа boolean). Логические значения вычисляются примерно так же, как я в языке Perl. Любое не нулевое целое значение - это TRUE, ноль - это FALSE. Обратите внимание на то, что отрицательные значения - это не ноль и поэтому они считаются равными TRUE. Пустая строка и строка '0' это FALSE; все остальные строки - TRUE. И насчЈт составных типов (массивы и объекты) - если значение такого типа не содержит элементов, то оно считается равным FALSE; иначе подразумевается TRUE.

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

Структура IF это одна из важнейших возможностей многих языков, включая PHP. Она позволяет организовать выполнение фрагментов кода по условию. Возможности PHP по использованию выражения IF похожи на C:

if (expr) statement

Как объяснялось в части про выражения, вычисляется логический результат "expr" . Если expr равно TRUE, то PHP выполнит "statement", а если FALSE - проигнорирует.

Следующий пример выведет фразу 'a is bigger than b' если $a больше $b:

Зачастую Вам требуется исполнить больше чем одно выражение по условию. Конечно, не надо окружать каждое выражение конструкцией IF. Вместо этого вы можете сгруппировать несколько выражений в блок выражений. К примеру, слежующий код не только выведет фразу, но и присвоит значение $a переменной $b:

if ($a > $b) { print "a is bigger than b"; $b = $a; }

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

Зачастую Вам требуется исполнить одно выражение, если соблюдается какое-либо условие и другое выражение в противном случае. Вот для этого применияется ELSE. ELSE расширяет возможности IF по части обработки вариантов выражения, когда оно равно FALSE. Данный пример выведет фразу 'a is bigger than b' если $a больше $b, и 'a is NOT bigger than b' в противном случае:

Выражение ELSE выполняется только если выражение IF равно FALSE, а если есть конструкции ELSEIF - то если и они также равны FALSE (см. ниже).

ELSEIF, как и следует из его названия, является комбинацией IF и ELSE. ELSEIF как и ELSE позволяет выполнить выражение, если значение IF равно FALSE, но в отличие от ELSE оно выполнится только если выражение ELSEIF равно TRUE.К примеру, следующий код выведет 'a is bigger than b' если$a>$b, 'a is equal to b' если $a==$b, и 'a is smaller than b' если$a<$b:

Внутри одного выражения IF может быть несколько ELSEIF. Первое выражение ELSEIF (если таковые есть), которое будет равно TRUE, будет выполнено. В PHP3 вы можете написать 'else if' (два слова), что будет значить то же самое, что и 'elseif' (одно слово).

Выражение ELSEIF будет выполнено только если выражение IF и все предыдущие ELSEIF равно FALSE, а данный ELSEIF равен TRUE.

PHP3 предлагает иной путь для группирования операторов с оператором IF. Наиболее часто это используется когда вы внедряете блоки HTML внутрь оператора IF, но вообще может использоваться где угодно. Вместо использования фигурных скобок за "IF(выражение)" должно следовать двоеточие, одно или несколько выражений и завершающий ENDIF. Рассмотрите слежующий пример :

<?php if ($a==5): ?> A = 5 <?php endif; ?>

В этом примере блок "A = 5" внедрЈн внутрь выражения IF, используемого альтернативным способом. Блок HTML будет виден только если $a равно 5.statement written in the alternative syntax.

Этот альтернативный синтаксис применим и к ELSE и ELSEIF (expr) .Вот пример подобной структуры :

Цикл WHILE - простейший тип цикла в PHP3. Он действует как и его аналог в C. Основная форма оператора WHILE :

WHILE(expr) statement

Смысл оператора WHILE прост. Он предписывает PHP выполнять вложенный(е) оператор(ы) до тех пор пока expr равно TRUE. Значение выражения проверяется каждый раз при начале цикла, так что если значение выражения изменится внутри цикла, то он не прервЈтся до конца текущей итерации (выполнение всего блока вложенных операторов - это одна итерация). Иногда, если значение expr равно FALSE с самого начала, цикл не выполняется ни разу.

Как и в IF, вы можете сгруппировать несколько операторов внутри фигурных скобок или использовать альтернативный синтаксис :

WHILE(expr): выражения ... ENDWHILE;

Следующие примеры идентичны - оба выводят номера с 1 по 10:

Цикл DO..WHILE очень похож на WHILE за исключением того, что значение логического выражения проверяется не до, а после окончания итерации. Основное отличие в том, что DO..WHILE гарантировано выполнится хотя бы один раз, что в случае WHILE не обязательно.

Для циклов DO..WHILE существует только один вид синтаксиса:

Этот цикл выполнится один раз, так как после окончания итерации будет проверено значение логического выражения, а оно равно FALSE ($i не больше 0), и выполнение цикла завершится.

Опытные программисты на C может быть знакомы с иным использованием DO..WHILE, позволяющем прекратить исполнение блока операторов в середине путЈм внедрения его в цикл DO..WHILE(0) и использования оператора BREAK. Следующий код демонстрирует такую возможность :

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

Циклы FOR - наиболее мощные циклы в PHP. Они работают подобно их аналогам в C. Синтаксис цикла FOR :

FOR (expr1; expr2; expr3) statement

Первое выражение (expr1) безусловно вычисляется(выполняется) в начале цикла.

В начале каждой итерации вычисляется expr2. Если оно равно TRUE, то цикл продолжается и выполняются вложенный(е) оператор(ы). Если оно равно FALSE, то цикл заканчивается.

В конце каждой итерации вычисляется(исполняется) expr3.

Каждое из этих выражений может быть пустым. Если expr2 пусто, то цикл продолжается бесконечно (PHP по умолчанию считает его равным TRUE, как и С). Это не так бесполезно, как могло бы показаться, так как зачастую вам требуется закончить выполнение цикла используя оператор BREAK в сочетании с логическим условием вместо использования логического выражения в FOR.

Рассмотрим следующие примеры. Все они выводят номера с 1 по 10 :

Конечно, первый вариант кажется лучшим (или четвЈртый), но оказывавется возможность использования пустых выражений в цикле FOR зачастую оказывается полезной.

PHP также поддерживает альтернативный синтаксис FOR :

FOR (expr1; expr2; expr3): выражение; ...; endfor;

Другие языки используют оператор foreach для того, чтобы обрабатывает массивы или списки. PHP использует для этого оператор while и функции list() и each() . Для примера смотрите документацию по этим функциям.

VREAK прерывает выполнение текущего цикла.

CONTINUE переходит на начало ближайшего цикла.

Оператор SWITCH похож на группу операторов IF с одинаковым выражением. Во многих случаях вам нужно сравнить переменную (или выражение) со многими различными значениями и выполнить различные фрагменты кода в зависимости от того, чему будет равно значение выражения. Это как раз то, для чего предназначается оператор SWITCH.

Следующие 2 примера это 2 разлчиных пути для достижения одной вещи, но один использует серию операторов IF, а другой - оператор SWITCH.

Важно понять как работает оператор SWITCH чтобы избежать ошибок. SWITCH выполняет последовательно оператор за оператором. В начале код не исполняется. Только когда встречается оператор CASE с подходящим значением, PHP начинает выполнять программу. PHP продолжает выполнять операторы до конца блока SWITCH или пока не встретит оператор BREAK. Если вы не напишете BREAK в конце цикла операторов, то PHP продолжит выполнять операторы и следующего SWITCH'а. К примеру :

В этом случае, если $i равно 0, то PHP выполнит все операторы print! Если $i равно 1, то PHP выполнит последние два print. И только если $i равно 2, вы получите ожидаемый результат и выведено будет только 'i equals 2'. Так что важно не забывать ставить BREAK (разве что в некоторых случаях вы специально не захотите их ставить для достижения определЈнной цели).

Специальный случай - это 'default case'. Этот оператор соответствует всем значениям, которые не удовлетворяют другим case'ам. К примеру :

Другой заслуживающий упоминания факт - это то, что выражения в CASE могут быть любого скалярного типа, то есть целые числа или числа с плавающей запятой, а так же строки. Массивы и объекты не будут ошибкой, но в данном случае они не имеют значимости.

Оператор REQUIRE заменяет себя содержимым указанного файла, похоже на то,как в препроцессоре C работает #include.

Это означает, что вы не можете поместить require() внутрь цикла и ожидать, что он включит содержимое дугого файла несколько раз в процессе каждой итерации. Для это используйте INCLUDE.

require ('header.inc');

Оператор INCLUDE вставляет и выполняет содержимое указанного файла.

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

include() отличается от require() тем, что оператор include выполняется каждый раз при его встрече, а require() заменяется на содержимое указанного файла безотносительно будет ли выполнено его содержимое или нет

Так как include() это специальный оператор, требуется заключать его в фигурные скобки при использовании внутри условного оператора.

Когда файл исполняется, парсер пребывает в "режиме HTML", то есть будет выводить содержимое файла, пока не встретит первый стартовый тег PHP (<?).

Также смотрите readfile(), virtual().

Функция может быть объявлена следующим образом:

Внутри функции может быть любой верный код PHP3, даже объявление другой функции или класса .

Функции должны быть определены перед тем, как на них ссылаться.

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

Множественные результаты не могут быть возврашены в качестве результата, но вы можете реализовать это путЈм возврата списка :

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

PHP3 поддерживает передачу аргументов по значению (по умолчанию), по ссылке, и значения по умолчанию. Списки аргументов переменной длины не поддерживаются, но того же можно достичь, передавая массивы.

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

Если вы хотите, чтобы аргумент всегда передавался по ссылке, то следует поставить амперсенд (&) перед именем аргумента в объявлении функции :

Если вы хотите передать аргумент по ссылке в случае, когда по умолчанию такого не делается, то добавьте амперсенд перед именем аргумента в вызове функции :

Функции могут определять значения по умолчанию для скалярных аргументов в стиле C++ как показано :

Этот пример выведет следующее :

Значение по умолчанию должно быть константой, а не переменной или, к примеру, членом класса.

Учтите, что когда вы объявляете аргументы по умолчанию, они должны быть справа от всех "неумолчальных" аргументов, в противном случае это не будет работать, как задумано. К примеру :

Этот пример выведет следующее :

А теперь сравните с этим :

И выводит следующее :

Оператор OLD_FUNCTION позволяет вам определяить функцию использую синтаксис PHP/FI2 (за исключением того, что вы должны заменить 'function' на 'old_function').

Это свойство только для совместимости и должно использоваться лишь конверторами PHP/FI2 -> PHP3.

Описанные таким образом функции не могут быть вызваны из служебного кода PHP. Это к тому же значит, что вы не можете использовать их в функциях типа usort(), array_walk() и register_shutdown_function(). Вы можете обойти это путЈм введения специальной функции в терминах PHP3, которая будет вызывать OLD_FUNCTION.

Класс - это набор переменных и функций, работающих с этими переменными. Класс определяется следующим образом :

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

Классы это типы, то есть, заготовки для реальных переменных. Вы должны создавать переменные желаемого типа, используя оператор new :

Таким образом, мы создали объект $cart класса Cart. Функция add_item() этого объекта вызывается для добавления 1 товара номер 10 к корзине.

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

Это определяет класс Named_Cart, который имеет все переменные и функции класса Cart плюс дополнительную переменную $owner и дополнительную функцию set_owner(). Вы можете создать поименованую корзину обычным образом и установить или получить владельца корзины. Также вы можете использовать и нормальные функции корзины в поименованой корзине :

Внутри функций класса переменная $this означает сам объект. Вы должны использовать $this->нечто для доступа к переменной или функции с именем 'нечто' внутри объекта.

Конструкторы это функции в классе, которые автоматически вызываются, когда вы создаЈте новую переменную данного класса. Функция становится классом, когда она имеет такое же имя, как и сам класс.

Мы определили класс Auto_Cart который является тем же классом Cart плюс имеет конструктор, который инициализирует корзину при создании, наполняя еЈ одним товаром типа "10". Конструкторы также могут иметь аргументы, и эти аргументы могут быть необязательными, что делает конструктор более полезным :

Помните основную арифметику из школы? Эти операторы работают подобным образом

Таблица 7-1. Арифметические операторы

Оператор деления("/") возвращает целую величину(результат целочисленного деления) если оба оператора - целые (или строка преобразованная в целое). Если каждый операнд является величиной с плавающей запятой, выполнится деление с плавающей запятой.

B действительности есть только один оператор -- оператор конкатенации (".").

Основным оператором присваивания является "=". Вы могли подумать что это "равно"("equal to"). Но это не так. В действительности это означает что левый операнд получает значение выражения в правых (собирательное присваивание).

Значением выражения присваивания является присваиваемая величина. Так что если "$a = 3", то это 3. Это позволит Вам делать некоторые мудреные вещи:

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

Бинарные Операторы позволяют вам изменять биты в целых числах.

Table 7-2.Бинарные Операторы

Таблица 7-3. Логические операторы

Разница в двух различных вариантах операторов "and" и "or" - в различии приоритетов операций. (см. ниже)

Операторы Сравнения, как и подразумевается в их имени, позволяют Вам сравнивать две величины.

Таблица 7-4. Операторы Сравнения

Назад, к содержанию

Поскольку Adabas D функции малоупотребимы, вы, вероятно, захотите использовать вместо них  Унифицированные ODBC функции.

ada_afetch -- загрузка строки результата исполнения скрипта в массив

See odbc_fetch_into()

ada_autocommit -- чтение и переключение флага режима автоисполнения соединения

See odbc_autocommit().

ada_close -- завершение соединения с сервером

See odbc_close().

ada_commit -- совершение Adabas D транзакции

See odbc_commit()

ada_connect -- соединение с источником данных Adabas D

See odbc_connect().

ada_exec -- подготовка и исполнение SQL инструкции

See odbc_exec() or odbc_do().

ada_fetchrow -- выборка строки из результата исполнения скрипта

See odbc_fetch_row().

ada_fieldname -- получение имени поля (столбца)

See odbc_field_name().

ada_fieldnum -- получение номера поля

See odbc_field_num().

ada_fieldtype -- получение типа данных поля

See odbc_field_type().

ada_freeresult -- освобождение ресурсов, отводимых под содержимое результата

See odbc_free_result().

ada_numfields -- получение количества полей (столбцов) в содержимом результата

See odbc_num_fields().

ada_numrows -- количество строк (рядов) в содержимом результата

See odbc_num_rows().

ada_result -- получение данных из содержимого результата

See odbc_result().

ada_resultall -- распечатка результата в виде HTML таблицы

See odbc_result_all().

ada_rollback -- откат транзакции

See odbc_rollback().

Назад, к содержанию

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

apache_note() это специальная функция Apache которая получает и устанавливает значения в таблице нотаций(примечаний) запроса. При вызове с одним аргументом она возвращает текущее значение note_name. При вызове с двумя аргументами она устанавливает значение нотации(примечания) note_name в note_value и возвращает предыдущее значение нотации(примечания) note_name.

Эта функция возвращает ассоциативный массив из всех HTTP заголовков в текущем запросе.

Пример 1. GetAllHeaders() $headers = getallheaders(); while (list($header, $value) = each($headers)) { echo "$header: $value<br>n"; }

Этот пример покажет все заголовки текущего запроса

Примечание: GetAllHeaders() на данный момент это поддерживается только если PHP запущен как модуль Apache.

virtual() является спец.функцией Apache, которая эквивалентна <!--#include virtual...--> в mod_include. Она выполняет подзапрос Apache. Применима для включения CGI скриптов или .shtml файлов, или чего-нибудь еще, на чем вы должны выполнить парсинг(анализ текста) через Apache. Помните, что для CGI скриптов, скрипт должен выдавать правильнывые заголовки. Т.е. должне быть как минимуцм Content-type заголовок. Для PHP файлов, вы должны использовать include() или require().

Назад, к содержанию

Возвращает массив параметров. Параметры могут быть даныпо индексу при использовании опрератора =>.

Помните что array() - это языковая конструкция, и не является регулярным выражением.

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

Пример 1. array() $fruits = array( "fruits" => array("a"=>"orange","b"=>"banana","c"=>"apple"), "numbers" => array(1, 2, 3, 4, 5, 6) "holes" => array("first", 5 => "second", "third") );

См. также: list().

Применяет функцию с именем func для каждого элемента массива arr. Элементы проходят как первый аргумент функции func; если func требует больше чем один аргумент, будет сгенерировано предупреждение всякий раз, когда array_walk() вызывает func. Эти предупреждения могут подавляться добавлением знака '@' при вызове array_walk(), или при использовании error_reporting().

Помните, что func будет работать с елементами массива arr, так что все изменения сделанные над элементами массива будут изменениями для самого массива.

Пример 1. array_walk() $fruits = array("d"=>"lemon","a"=>"orange","b"=>"banana","c"=>"apple"); function test_alter( $item1 ) { $item1 = 'bogus'; } function test_print( $item2 ) { echo "$item2<br>n"; } array_walk( $fruits, 'test_print' ); array_walk( $fruits, 'test_alter' ); array_walk( $fruits, 'test_print' );

См. также: each() и list().

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

Пример 1. arsort() $fruits = array("d"=>"lemon","a"=>"orange","b"=>"banana","c"=>"apple"); arsort($fruits); for(reset($fruits); $key = key($fruits); next($fruits)) { echo "fruits[$key] = ".$fruits[$key]."n"; }

Пример нам покажет: fruits[a] = orange fruits[d] = lemon fruits[b] = banana fruits[c] = apple Фрукты показаны в обратном алфавитном порядке, и поддерживаются связанные с ними индексы.

См. также: asort(), rsort(), ksort(), и sort().

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

Пример 1. asort() $fruits = array("d"=>"lemon","a"=>"orange","b"=>"banana","c"=>"apple"); asort($fruits); for(reset($fruits); $key = key($fruits); next($fruits)) { echo "fruits[$key] = ".$fruits[$key]."n"; }

Этот пример покажет: fruits[c] = apple fruits[b] = banana fruits[d] = lemon fruits[a] = orange Фрукты показаны в алфавитном порядке, и поддерживаются индексы связанные с каждым элементом массива.

См. также: arsort(), rsort(), ksort(), и sort().

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

возвращает 0 если переменная не укстановлена.

возвражает 1 если переменная не является массивом.

См. также: sizeof(), isset(), и is_array().

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

Функция current()просто возвращает элемент массива, на который в данный момент указывает внутренний указатель. Он никак не перемещает указатель. Если внутренний указатель указывает на конец списка элементов, current() возвращает false(ложно).

Внимание: если массив содержит пустые элементы (0 или "", пустую строку), то функция возвратит "false" для каждого из них. Это показывает, что текущий элемент является нулевым значением или вы дошли до конца массива. Для того, чтобы правильно просматривать массив, используйте функцию each().

См. также: end(), next(), prev() и reset().

Возвращает следующую пару ключ/значение из массива array и предоставляет курсор массива. Эта пара возвращается в четырех-элементный массив, с ключами 0, 1, key, и value. Элементы 0 и key - каждое содержит ключевое имя элемента массива, а 1 и value содержат данные.

Пример 1. each() $foo = array( "bob", "fred", "jussi", "jouni" ); $bar = each( $foo ); $bar теперь содержит следующие пары ключ/значение: 0 => 0 1 => 'bob' key => 0 value => 'bob' $foo = array( "Robert" => "Bob", "Seppo" => "Sepi" ); $bar = each( $foo ); $bar теперь содержит следующие пары ключ/значение: 0 => 'Robert' 1 => 'Bob' key => 'Robert' value => 'Bob'

each(), как правило, используется вместе с list() чтобы просмотреть массив; например, $HTTP_POST_VARS:

Пример 2. Просмотр $HTTP_POST_VARS с помощью each() echo "Values submitted via POST method:<br>"; while ( list( $key, $val ) = each( $HTTP_POST_VARS ) ) { echo "$key => $val<br>"; }

См. также key(), list(), current(), reset(), next(), и prev().

end() перемещает array's внутренний указатель на последний элемент массива.

См. также: current(), each(), end() next() и reset()

key() Возвращает индекс элемента в текущей позиции массива

См. также: current(), next()

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

Пример 1. ksort() $fruits = array("d"=>"lemon","a"=>"orange","b"=>"banana","c"=>"apple"); ksort($fruits); for(reset($fruits); $key = key($fruits); next($fruits)) { echo "fruits[$key] = ".$fruits[$key]."n"; }

Этот пример должен показать: fruits[a] = orange fruits[b] = banana fruits[c] = apple fruits[d] = lemon

См. также asort(), arsort(), sort(), и rsort().

Подобно array(), функция list в действительностью является языковой конструкцией а не функцией list() используется для связи списка переменных одной операцией.

Пример 1. list() <table> <tr> <th>Employee name</th> <th>Salary</th> </tr> <?php $result = mysql($conn, "SELECT id, name, salary FROM employees"); while (list($id, $name, $salary) = mysql_fetch_row($result)) { print(" <tr>n". " <td><a href="info.php3?id=$id">$name</a></td>n". " <td>$salary</td>n". " </tr>n"); } ?></table>

См. также: each(), array().

Возвращает следующий элемент массива, от текущей позиции внутреннего указателя массива, или "ложь"(false) если нет больше элементов. Внимание: если массив содержит пустые элементы, тогда эта функция возвратит "ложь"(false) и для этих элементов. Чтобы правильно просмотреть массив, который может содержать пустые элементы, смотрите функцию each().

next() ведет себя подобно current(), с одной лишь разницей. Он передвигает внутренний указатель массива на один элемент вперед прежде, чем возвратить элемент. Это означает что он возвращает значение следующего элемента и передвигает на него внутренний указатель массива. Если при обращении к следующему элементу обнаружен конец массива - next() возвращает "ложь"(false).

См. также: current(), end() prev() и reset()

Это - псевдоним для current().

См. также: end(), next(), prev() и reset().

Возвращает предыдущий элемент массива, или "ложь"(false), если перед текущим нет больше элементов. Внимание: если массив содержит пустые элементы, то функция возвратит "ложь" и на этих элементах. Чтобы правильно просмотреть массив, который может содержать пустые элементы, смотрите функцию each().

prev() ведет себя подобно next(), за исключением того что он переводит внутренний указатель массива на одну позицию назад, а не вперед.

См. также: current(), end() next() и reset()

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

reset() возвращает первыйэлемент массива.

См. также: current(), each(), next() prev() и reset()

Сортирует массив в обратном порядке (по убыванию).

Пример 1. rsort() $fruits = array("lemon","orange","banana","apple"); rsort($fruits); for(reset($fruits); ($key,$value) = each($fruits); ) { echo "fruits[$key] = ".$value."n"; }

Этот пример покажет: fruits[0] = orange fruits[1] = lemon fruits[2] = banana fruits[3] = apple Фрукты отсортированы в обратном алфавитном порядке.

См. также arsort(), asort(), ksort(), sort() и usort().

Возвращает число элементов списка.

См. также: count()

Эта функция сортирует масси - все элементы по окончании ее работы будут расположены по возрастанию.

Пример 1. sort() $fruits = array("lemon","orange","banana","apple"); sort($fruits); for(reset($fruits); $key = key($fruits); next($fruits)) { echo "fruits[$key] = ".$fruits[$key]."n"; }

Этот пример покажет: fruits[0] = apple fruits[1] = banana fruits[2] = lemon fruits[3] = orange Фрукты будут отсортированы повозрастанию в алфавитном порядке.

См. также arsort(), asort(), ksort(), rsort(), и usort().

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

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

Пример 1. uksort() function mycompare($a, $b) { if ($a == $b) return 0; return ($a > $b) ? -1 : 1; } $a = array(4 => "four", 3 => "three", 20 => "twenty", 10 => "ten"); uksort($a, mycompare); while(list($key, $value) = each($a)) { echo "$key: $valuen"; }

Пример покажет: 20: twenty 10: ten 4: four 3: three

См. также arsort(), asort(), uasort(), ksort(), rsort() и sort().

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

Пример 1. usort() function cmp($a,$b) { if ($a == $b) return 0; return ($a > $b) ? -1 : 1; } $a = array(3,2,5,6,1); usort($a, cmp); while(list($key,$value) = each($a)) { echo "$key: $valuen"; }

Пример покажет: 0: 6 1: 5 2: 3 3: 2 4: 1 Очевидно, что в этом тривиальном случае функция rsort() было бы более соответствующей.

См. также arsort(), asort(), ksort(), rsort() и sort().

Назад, к содержанию

Календарные функции - доступны только если Вы скомпилировали календарное расширение в dl/calendar. Смотрите dl/README для получения инструкций.

Календарное расширение в PHP представляет серию функций, которая упрощает преобразование между разными календарными форматами. Посредником прообразования является дневной Юлианский счет. Дневной Юлианский счет это самый старый счет дней (около 4000 д.э.). Чтобы менять числа между разными календарными системами, Вы должны сначала преобразовать вашу дату в дневной Юлианский счет, а только затем в календарную систему по вашему выбору. Дневной Юлианский счет отличается от Юлианского Календаря! Более подробно о календарной систем смотрите на сайте: http://genealogy.org/~scottlee/cal-overview.html. Отрывки с этой страницы включаются в данной инструкцие. JDToGregorian JDToGregorian -- Преобразование дневного Юлианcкого счета в Грегорианскую дату Описание string jdtogregorian(int julianday);

Преобразование дневного Юлианcкого счета в Грегорианскую в формате "месяц/день/год" GregorianToJD GregorianToJD -- Преобразовывает Грегорианскую дату на Дневный Юлианский cчет Описание int gregoriantojd(int month, int day, int year);

Правильный дипазон для Грегорианского календаря 4714 д.э. до 9999 н.э.

Хотя это программное обеспечение может оперировать даты в обратном порядке до 4714 д.э., такое использование может быть бесполезно и не значительно. Грегорианский календарь не был учрежден до Октября 15, 1582 (или Октябрь 5, 1582 в Юлианском календаре). Некоторые страны еще очень долго не принимали его. Например, Великобритания преобразовалась в 1752, СССР в 1918 и Греции в 1923. Наиболее Европейские страны использовали Юлианский Календарь До Грегорианского.

Пример 1. Календарные функции <?php $jd = GregorianToJD(10,11,1970); echo("$jdn"); $gregorian = JDToGregorian($jd); echo("$gregoriann"); ?> JDToJulian JDToJulian -- преобразовывает дату Юлианского календаря на дневный Юлианский счет Описание string jdtojulian(int julianday);

Преобразование дневного Юлианского счета в строку, содержащую дату Юлианского Календаря в формате "месяц/день/год". JulianToJD JulianToJD -- преобразовывает дату Юлианского Календаря на дневной Юлианский счет Описание int juliantojd(int month, int day, int year);

Правильный дипазон для Юлианского календаря 4713 д.э. до 9999 н.э.

Хотя это программное обеспечение может оперировать даты в обратном порядке до 4713 д.э. такое использование может быть бесполезно и не значительно. Календарь был создан в 46 д.э., но подробные не стабилизировался до по крайней мере 8 н.э., и возможно познее в 4-ом столетии. Также, начало года различно от одной культуры к другой - не все соглашаются, что Январь это первый месяц. JDToJewish JDToJewish -- преобразовывает дневной Юлианский счет в Еврейский календарь Описание string jdtojewish(int julianday);

Преобразование дневного Юлианского счета в Еврейский календарь JewishToJD JewishToJD -- преобразовывает дату в Еврейском Календаре на дневной Юлианский счет Описание int jewishtojd(int month, int day, int year);

Еврейский календарь использовался в течение нескольких тысячалетий, но в течение начального периода не было никакой формулы, чтобы определить начало месяца. Новый месяц начинался когда замечено полнолуние. JDToFrench JDToFrench -- преобразовывает дневной Юлианский счет в Французский Республиканский календарь Описание string jdtofrench(int month, int day, int year);

преобразовывает дневной Юлианский счет в Французский Республиканский календарь FrenchToJD FrenchToJD -- преобразовывает дату и Французского Республиканского календаря в дневной Юлианский счет Описание int frenchtojd(int month, int day, int year);

преобразовывает дату и Французского Республиканского календаря в дневной Юлианский счет

Эта программа преобразовывают даты в начиная с 1 до 14 (Грегорианские даты 22 Сентября 1792 до 22 1806 Сентября). Это покрывает тот период когда календарь использовался. JDMonthName JDMonthName -- возвращает название месяца Описание string jdmonthname(int julianday, int mode);

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

Стол 1. Календарные способы СпособЗначение

0	Грегорианский - apreviated
1	Грегорианский
2	Юлианский - apreviated
3	Юлианский
4	Еврейский
5	Французский Республиканский

JDDayOfWeek JDDayOfWeek -- Возвращает день недели Описание mixed jddayofweek(int julianday, int mode);

Возвращает день недели. Может возвратить строку(string) или int в зависимости от способа(mode).

Стол 1. Календарные недельные пути СпособЗначение

0	возвращает дневной номер как int (0=воскресенье, 1=понедельник, и т.п.)
1	возврат string содержание дня недели (английское-грегорианское)
2	возвращает string содержа abreviated дени недели (английский-грегорианский)

Назад, к содержанию

Возвращает true если данная дата правильна, иначе false. Проверяет правильность даты, заданной аргументами. Дата считается правильной, если:

год между 1900 и 32767 включительно

месяц между 1 и 12 включительно

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

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

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

a - "am" или "pm"

A - "AM" или "PM"

d - день месяца, цифровой, 2 цифры (на первом месте ноль)

D - день недели, текстовый, 3 буквы; т.е. "Fri"

F - месяц, текстовый, длинный; т.е. "January"

h - час, цифровой, 12-часовой формат

H - час, цифровой, 24-часовой формат

i - минуты, цифровой

j - день месяца, цифровой, без начальных нулей

l (строчная 'L') - день недели, текстовый, длинный; т.е. "Friday"

m - месяц, цифровой

M - месяц, текстовый, 3 буквы; т.е. "Jan"

s - секунды, цифровой

S - английский порядковый суффикс, текстовый, 2 символа; т.е. "th", "nd"

U - секунды с начала века

Y - год, цифровой, 4 цифры

w - день недели, цифровой, 0 означает воскресенье

y - год, цифровой, 2 цифры

z - день года, цифровой; т.е. "299"

Функции date() и mktime() возможно использовать вместе для того, чтобы найти даты в будущем или прошлом.

Пример 2.Пример функций date() и mktime() $tomorrow = mktime(0,0,0,date("m") ,date("d")+1,date("Y")); $lastmonth = mktime(0,0,0,date("m")-1,date("d"), date("Y")); $nextyear = mktime(0,0,0,date("m"), date("d", date("Y")+1);

Для того, чтобы отформатировать даты на других языках, Вы должны использовать функции setlocale() и strftime()

См.также gmdate() and mktime() .

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

В форматной строке следует использовать следующие спецификаторы преобразований:

%a - сокращенное название дня недели согласно текущему locale

%A - полное название дня недели согласно текущему locale

%b - сокращенное название месяца согласно текущему locale

%B - полное название месяца согласно текущему locale

%c - предпочтительное представление даты и времени для текущего locale

%d - день месяца как десятичное число (в диапазоне от 0 до 31)

%H - час как десятичное число в 24-часовом формате (в диапазоне от 00 до 23)

%I - час как десятичное число в 12-часовом формате (в диапазоне от 01 до 12)

%j - день года как десятичное число (в диапазоне от 001 до 366)

%m - месяц как десятичное число (в диапазоне от 1 до 12)

%M - минуты как десятичное число

%p - `am' или `pm' согласно текущему времени, или соответствующие строки для текущего locale

%S - секунды как десятичное число

%U - номер недели текущего года как десятичное число, начиная с первого Воскресенья в качестве первого дня первой недели

%W - номер недели текущего года как десятичное число, ночиная с первого Понедельника в качестве первого дня первой недели

%w - день недели как целое число, Воскресенье - 0-й день

%x - предпочитаемое представление даты для текущего locale не включающее время

%X - предпочитаемое представление времени для текущего locale не включающее дату

%y - год как десятичное число без столетия (в диапазоне от 00 до 99)

%Y - год как десятичное число, включая столетие

%Z - временная зона или название или сокращение

%% - символ `%'

См.также setlocale() и mktime() .

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

"seconds" - секунды

"minutes" - минуты

"hours" - часы

"mday" - день месяца

"wday" - день недели, цифровой

"mon" - месяц, цифровой

"year" - год, цифровой

"yday" - день года, цифровой; т.е. "299"

"weekday" - день недели, текстовый, полный; т.е. "Friday"

"month" - месяц, текстовый, полный; т.е. "January"

Аналогична функции date() за исключением того, что время возвращается в Гринвичском формате Greenwich Mean Time (GMT). Например, при запуске в Финляндии (GMT +0200), первая строка ниже напечатает "Jan 01 1998 00:00:00", в то время как вторая строка напечатает "Dec 31 1997 22:00:00".

Пример 1. пример gmdate() echo date( "M d Y H:i:s",mktime(0,0,0,1,1,1998) ); echo gmdate( "M d Y H:i:s",mktime(0,0,0,1,1,1998) );

См.также date() , mktime() и gmmktime() .

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

Возвращает временную метку Unix согласно данным аргументам. Эта временная метка является целым числом, равным количеству секунд между эпохой Unix (1 Января 1970) и указанным временем.

Аргументы могут быть опущены с права налево; каждый опущенный таким образом аргумент будет установлен в текущую величину согласно локальной дате и времени.

MkTime is useful for doing date arithmetic and validation, as it MkTime полезена при арифметических дейтсвиях с датой и ее проверкой, она будет автоматически вычислять корректную величину для вешедших за границы параметров. Например, каждая из следующих строк возвращает строку "Jan-01-1998".

Пример 1. Пример mktime() echo date( "M-d-Y", mktime(0,0,0,12,32,1997) ); echo date( "M-d-Y", mktime(0,0,0,13,1,1997) ); echo date( "M-d-Y", mktime(0,0,0,1,1,1998) );

См.также date() и time() .

Идентична mktime() за исключением передаваемых параметров, представляющих дату в GMT.

Возвращает текущее время, измеренное в числе секунд с эпохи Unix (1 Января 1970 00:00:00 GMT).

См.также date() .

Возвращает строку "msec sec" где sec текущее время, измеренное в числе секунд с эпохи Unix (0:00:00 1 Января, 1970 GMT), а msec - это часть в микросекундах. Эти функции доступны только в операционных системах, поддерживающих системный вызов gettimeofday().

См.также time() .

Назад, к содержанию

Не поддерживаются индексы и мемо(записи) поля. Также не поддерживается блокировка. Два webсервер процесса, одновременно изменяющие файлы dBase вполне возможно повредят вашу базу данных.

В отличие от баз данных SQL, в dBase нельзя изменять определение полей после их создания. Если только файл создан, то поля базы данных фиксировано определены. Не имеется никаких индексов, которые ускоряют поиск или иначе организовывает ваши данные. dBase файлы - это простые последовательные файлы с записями фиксированного размера. Записи добавляются в конец файла и удаленные записи будут присутствовать в вашей базе до тех пор, пока вы не вызовете dbase_pack() функцию.

Мы рекомендуем вы не использовать dBase файлы для профессионального использования фаз данных. Выберете взамен какой-нибудь реальный SQL сервер; MySQL или Postgres лучший выбор для работы вместе с PHP. Поддержка dBase введена для импорта и экспорта ваших данных из и в вашу web базу данных, так как этот формат обычно понимают многие программы, например электронные таблицы, в Windows. Поддержка dBase для любого экспорта или импорта данных хорошо выполняет эти условия. dbase_create dbase_create -- создать dBase базу данных Описание int dbase_create(string filename, array fields); Параметр fields - это массив из массивов, каждый массив определяет формат одного поля в базе данных. Каждое поле состоит из имени, символа , указывающего тип поля, длины, и точность.

Доступные типы полей:  

L	Логическое. Не требует длину или точность.
M	Мемо. (Помните, что они не поддерживаются в PHP.) Не требует длину или точность.
D	дата (сохраненная как ГГГГММДД). Не требует длину или точность.
N	Числовое. Это поле имеет и длину и точность(количество цифр после десятичной точки).
C	Строка. Имеет длину и не требует точность.

Возвращает dbase_identifier(идентификатор базы данных) для открытой базы данных, или false(ложь) если база данных не была открыта. dbase_close dbase_close -- закрыть dBase базу данных Описание bool dbase_close(int dbase_identifier); Закрыть базу данных, связанную с dbase_identifier. dbase_pack dbase_pack -- упаковывает dBase базу данных Описание bool dbase_pack(int dbase_identifier); Упаковывает определенную базу данных (удаляет все записи, помеченные для удаления с помощью dbase_delete_record(). dbase_add_record dbase_add_record -- добавляет запись в dBase базу данных Описание bool dbase_add_record(int dbase_identifier, array record); Добавляет данные из record в базу данных. Если количество полей в заданном record не идентично количеству полей в базе данных, то операция будет прервана и будет возвращено false(ложь). dbase_delete_record dbase_delete_record -- удалить запись из dBase базы данных Описание bool dbase_delete_record(int dbase_identifier, int record); Помечает запись record to на удаление из базы данных. Чтобы физически удалить запись из базы данных, вы должны вызвать dbase_pack(). dbase_get_record dbase_get_record -- получить запись из dBase базы данных Описание array dbase_get_record(int dbase_identifier, int record); Возвращает данные из записи record в массив. Массив индексирован начиная с 1, и включает в себя поле 'deleted', которое установлено в 1 если запись помечена на удаление (смотри  dbase_delete_record().)

Все поля преобразовываются в соответствующий PHP тип. (Даты остаются строками.) dbase_numfields dbase_numfields -- Выясняет, какое количество полей находится в dBase базе данных Описание int dbase_numfields(int dbase_identifier); Возвращает количество полей в определенной базе данных. Номера полей находятся в промежутке с 0 и до dbase_numfields($db)-1, в то время как номера записей начинаются с 1 и до dbase_numrecords($db).

Пример 1. Использование dbase_numfields() $rec = dbase_get_record($db, $recno); $nf  = dbase_numfields($db); for ($i=0; $i < $nf; $i++) {     print $rec[$i]."<br>n"; }

dbase_numrecords dbase_numrecords -- Выясняет, какое количество записей находится в dBase базе данных Описание int dbase_numrecords(int dbase_identifier); Возвращает количество записей в определенной базе данных. Номера записей начинаются с 1 и до dbase_numrecords($db) , в то время как номера полей находятся в промежутке с 0 и до dbase_numfields($db)-1.

Назад, к содержанию

Назад, к содержанию

Назад, к содержанию

Если параметр array установлен, то указанный массив будет заполнен выводом из программы. Помните, если массив уже содержит данные, то exec() добавляет свои данные. Если вы не хотите, что бы функция добавляла данные, вызывайте unset() для массива перед использованием exec().

Если параметр return_var установлен наряду с параметром array, то в него записывается результат выполнения команды.

Обратите внимание, что если ваша функция будет использовать данные из ввода пользователей, то надо использовать EscapeShellCmd() для того, что бы пользователи не смогли запустить произвольные программы.

См. также system(), PassThru(), popen() и EscapeShellCmd(). system system -- Запуск внешней программы с выводом результата Описание string system(string command, int [ return_var ]); System() такая же, как и C версия этой функции для запуска command и  вывода результата. Если используется второй параметр, то в него записывается результат выполнения команды.

Обратите внимание, что если ваша функция будет использовать данные из ввода пользователей, то надо использовать EscapeShellCmd() для того, что бы пользователи не смогли запустить произвольные программы.

Вызов System() также пробует автоматически вставить в буфер вывода web сервера после каждой строки вывода, если PHP запущен как модель сервера.

Если вы хотите запустить команду и использовать все данные непосредственно без всякого вмешательства других программ, то используйте функцию PassThru(). См. также exec() и popen() функции. passthru passthru -- Запускает внешнюю программу и выводит данные напрямую Описание string passthru(string command, int [ return_var ]); Функция passthru() похожа на функцию Exec() для запуска command. Если параметр return_var установлен, то результат Unix команды помещается здесь. Эта функция должна использоваться вместо Exec() или System() тогда, когда вывод из Unix команды является двоичными данными, которые должны быть переданы непосредственно обратно в окно просмотра(browser). Это можно использовать, например, для запуска утилиты pbmplus для вывода непосредственно потока изображения. Установка типа image/gif и вызов программы pbmplus, чтобы вывести gif-рисунок, вы можете создавать PHP скрипты, которые выводят изображения непосредственно.

См. также exec() и fpassthru().

Назад, к содержанию

Эти функии предоставляют доступ "только для чтения" к данным в базе данных filePro.

filePro зарегистрированная торговая марка Fiserv, Inc. Более подробную информацию о filePro вы можете наяти на http://www.fileproplus.com/.

Возвращает имя поля по соответствующему номеру field_number.

Возвращет тип поля, соответствующего номеру field_number.

Возвращает ширину поля по номеру поля field_number.

Возвращает данные из указанной ячейки базы данных.

Возвращает количество полей (колонок) в открытой базе filePro.

Смотри также filepro().

Возвращает количество строк в открытой базе filePro.

Смотри также filepro().

Назад, к содержанию

Эти функции позволяют вам управлять ывводом на удаленный браузер на уровне протокола HTTP.

Функция Header() используется в начале HTML-файла для отправки строки HTTP заголовка. Смотри HTTP 1.1 Specification для более подробной информации о заголовках HTTP.
Замечание: Помните, что функция Header() должна быть вызвана перед любыми другими операциями вывода, описанными стандартными тэгами HTML или PHP. Наиболее общие ошибки в коде - применение include() с auto_prepend и пробелами или пустыми строками, которые инициируеют вывод до вызова header().

Header("Location: http://www.php.net"); /* Редирект браузера на сайт PHP */ exit; /* Код, следующий ниже, не будет исполняться после редиректа. */

PHP-скрипты часто генерируют динамический HTML, который не следует кешировать на клиентском браузере или прокси-сервере. Многие прокси и клиенты можно заставить отключить кеш:
header("Expires: Mon, 26 Jul 1997 05:00:00 GMT"); // Прошедшая дата
header("Last-Modified: " . gmdate("D, d M Y H:i:s") . "GMT"); // всегда модифицировать
header("Cache-Control: no-cache, must-revalidate"); // HTTP/1.1
header("Pragma: no-cache"); // HTTP/1.0

SetCookie() определяет кук, который будет послан вместе с остальной информацией из заголовка. Все аргументы, исключая name опциональны. Если присутствует только аргумент name, кук с указанным именем будет удален с клиента. Вы также можете представить любой из аргументов пустой строкой, с целью пропуска оного (""). Параметры expire и secure являются целочисленными и ен могут быть заменены пустыми строками. Для этой цели используют (0). Аргумент expire - это стандартное время Unix, возвращаемое функциями time() или mktime(). secure показывает, что кук следует передавать только по защищенному соединению HTTPS. Некоторые примеры:

Пример 1. SetCookie SetCookie("TestCookie","Test Value"); SetCookie("TestCookie",$value,time()+3600); /* истекает через час */ SetCookie("TestCookie",$value,time()+3600,"/~rasmus/",".utoronto.ca",1);

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

Для получения более подробной информации о куках, смотрите спецификацию Netscape по http://www.netscape.com/newsref/std/cookie_spec.html.

Microsoft Internet Explorer 4 с Service Pack 1 могут некорректно работать с куками, где установлен параметр path.

Назад, к содержанию

Назад, к содержанию

Не возвращает информацию конфигурации, установленную при компиляции PHP, или прочитанную из файла конфигурации Apache (использование php3_configuration_option директив).

Что бы проверить, использует ли система php3.ini файл, попробуйте получить значение cfg_file_path. Если оно установлено, то php3.ini файл используется. get_current_user get_current_user -- Получить имя владельца текущего PHP скрипта. Описание string get_current_user(void); Возвращает имя владельца текущего PHP скрипта.

См. также getmyuid(), getmypid(), getmyinode(), и getlastmod(). get_magic_quotes_gpc get_magic_quotes_gpc -- Получить текущие активные установки magic_quotes_gpc. Описание long get_magic_quotes_gpc(void); Возвращает текущие активные установки magic_quotes_gpc. (0 для выключенных(off), 1 для включенных(on))

См. также get_magic_quotes_runtime(), set_magic_quotes_runtime(). get_magic_quotes_runtime get_magic_quotes_runtime -- Получить текущие активные установки magic_quotes_runtime. Описание long get_magic_quotes_runtime(void); Возвращает текущие активные установки magic_quotes_runtime. (0 для выключенных(off), 1 для включенных(on))

См. также get_magic_quotes_gpc(), set_magic_quotes_runtime(). getlastmod getlastmod -- Получить время последней модификации страницы. Описание int getlastmod(void); Возвращает время последней модификации текущей страницы. Возвращаемое значение - Unix timestamp, подходящее для использование в функции date(). Возвращает false(ложь) при ошибке.

Пример 1. getlastmod() пример // выводит что-то вроде этого 'Последнее изменение: March 04 1998 20:43:59.' echo "Последнее изменение: ".date( "F d Y H:i:s.", getlastmod() );

См. также date(), getmyuid(), get_current_user(), getmyinode(), и getmypid(). getmyinode getmyinode -- Получить inode текущего скрипта. Описание int getmyinode(void); Возвращает inode текущего скрипта, или false(ложь) при ошибке.

См. также getmyuid(), get_current_user(), getmypid(), и getlastmod(). getmypid getmypid -- Получить ID процесса PHP. Описание int getmypid(void); Возвращает текущий ID процесса PHP, или false(ложь) при ошибке.

Обратите внимание, что при работе PHP как модуля сервера, вы не получите точный IP процесса.

См. также getmyuid(), get_current_user(), getmyinode(), и getlastmod(). getmyuid getmyuid -- Получить UID владельца скрипта PHP. Описание int getmyuid(void); Возвращает UID текущего скрипта, или false(ложь) при ошибке.

См. также getmypid(), get_current_user(), getmyinode(), и getlastmod(). phpinfo phpinfo -- Вывод большого количества информации о PHP. Описание int phpinfo(void); Вывод большого количества информации о текущем состоянии PHP. Это включает информацию относительно опций компиляции и расширений PHP, версию PHP, информации сервера и среды окружения (если скомпилировано как модуль), среда окружения PHP, информация о версии операционной системы, пути, основных и локальных опций конфигурации, HTTP заголовок и GNU Public License.

См. также phpversion(). phpversion phpversion -- Получить текущую версию PHP. Описание string phpversion(void); Возвращает строку, содержащую версию запущенного в данный момент PHP.

Пример 1. phpversion() пример // Печатает что-то вроде этого 'Текущая версия PHP: 3.0rel-dev' echo "Текущая версия PHP: ".phpversion();

См. также phpinfo(). putenv putenv -- Устанавливает значение переменной среды окружения. Описание void putenv(string setting); Добавляет setting в среду окружения.

Пример 1. Устанавливает значение переменной среды окружения putenv("UNIQID=$uniqid");

set_magic_quotes_runtime set_magic_quotes_runtime -- Устанавливает в текущих активных установках конфигурации установки для magic_quotes_runtime. Описание long get_magic_quotes_runtime(int new_setting); Устанавливает в текущих активных установках конфигурации установки для magic_quotes_runtime. (0 для выключенных(off), 1 для включенных(on))

См. также get_magic_quotes_gpc(), get_magic_quotes_runtime(). set_time_limit set_time_limit -- Установка лимита на максимальное время работы скрипта Описание void set_time_limit(int seconds); Устанавливает длительность в секундах, во время которого скрипт должен быть выполнен. Если период превышен, то скрипт возвращает фатальную ошибку. По умолчанию лимит составляет 30 секунд или, если этот параметр установлен, значение max_execution_time в php3.ini. Если значение установлено в ноль(0), то лимит выключен.

При вызова, set_time_limit() перезапускает счетчик времени исполнения с нуля. Другими словами, если установлен лимит по умолчанию 30 секунд, и прошло 25 секунд со времени запуска, то после вызова set_time_limit( 20 ) общее время будет составлять 45 секунд после с начала запуска скрипта.

Назад, к содержанию

Драйверы Informix для Online (ODS) 7.x, SE 7.x и Universal Server (IUS) 9.x выполнены в "functions/ifx.ec" и "functions/php3_ifx.h". В данный момент написание поддержки ODS 7.2 в известной степени завершено, с полной поддержкой BLOB. Поддержка IUS 9.1 завершена частично: новые типы данных уже есть, но поддержка SLOBS все еще в стадии разработки.

Замечания по конфигурации:

Перед тем, как вы запустите скрипт "configure", убедитесь, что переменная "INFORMIXDIR" установлена.

Конфигурационный скрипт автоопределяет библиотеки и включаемые (include) директории, если вы запустите "configure --with_informix=yes". Вы можете переопределить эти директории, специфицировав переменные окружения "IFX_LIBDIR", "IFX_LIBS" и "IFX_INCDIR". Скрипт также патается автоопределить версию сервера Informix. Он установит переменную условного завершения "HAVE_IFX_IUS", если у вас Informix версии >= 9.00.

Несколько замечаний по использованию BLOB:

Текущая версия (18 Сентября 1998) полностью поддерживает select/insert/update для BLOB.

BLOBы в общем случае адрексуются целочисленными идентификаторами BLOB. Запрос Select возвращает "blob id" для каждой колонки BYTE и TEXT. Вы можете получить содержание путем "string_var = ifx_get_blob($blob_id);" если была выбрана передача BLOBов в память ("ifx_blobinfile(0);"). Если вы предпочитаете получать содержимое колонки BLOB в файл, используйте "ifx_blobinfile(1);", и "ifx_get_blob($blob_id);" возвратит вам имя файла. Для получения содержания используйте стандартные операции файлового ввода/вывода

Для запросов insert/update вам неоходимо создать "blob id's" своими силами, используя "ifx_create_blob(..);". Затем включите идентификатор BLOB в массив и замените колонку BLOB знаком вопроса (?) в строке запроса. Для updates/inserts вы определяете содержание BLOB, используя ifx_update_blob(...).

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

конфигурационная переменная : ifx.textasvarchar

конфигурационная переменная : ifx.byteasvarchar

функция времени выполнения :

ifx_textasvarchar(0) : использовать идентификатор BLOB для запросов select для колонок TEXT.

ifx_byteasvarchar(0) : использовать идентификатор BLOB для запросов select для колонок BYTE.

ifx_textasvarchar(1) : возвращать колонку TEXT так, как будто это VARCHAR, без использования идентификатора BLOB для запросов select.

ifx_byteasvarchar(1) : возвращать колонку BYTE так, как будто это VARCHAR, без использования идентификатора BLOB для запросов select.

Конфигурационная переменная : ifx.blobinfile

функция времени выполнения :

ifx_blobinfile_mode(0) : возвращать колонку BYTE в память, идентификатор BLOB позволяет получить содержание.

ifx_blobinfile_mode(1) : возвращать колонку BBYTE в файл, по идентификатору BLOB - имя файла

Если вы устанавливаете ifx_text/byteasvarchar в 1, то можете использовать колонки TEXT и BYTE в запросах select как обычные (но довольно длинные) поля VARCHAR. С тех пор, как все строки в PHP3 "счетные", это напоминает "бинарную безопасность". Возвращаемые данные могут содержать все, что угодно, вы отвечаете за содержимое.

Если вы устанавливаете ifx_blobinfile в 1, используйте имя файла, возвращаемое ifx_get_blob(..) для получения бинарного содержания. Заметим, что в этом случае ВЫ ОТВЕТСТВЕННЫ ЗА УДАЛЕНИЕ ВРЕМЕННЫХ ФАЙЛОВ, СОЗДАННЫХ INFORMIX при выборке ряда. Каждый новый выбранный ряд создает новые временные файлы для каждой колонки типа BYTE.

Местоположение временных файлов указывается в переменной окружения "blobdir", по умолчанию - "." (текущая директория). Что-то вроде putenv(blobdir="tmpblob"); облегчит удаление случайно оставленных временных файлов (имена всех таких файлов начинаются с "blb").

Автоудаление пробелов для данных "char" (SQLCHAR и SQLNCHAR):

Может быть устанвлено в конфигурационной переменной :

ifx.charasvarchar : если установлена в 1 , то концевые пробелы будут удаляться автоматически.

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

Смотри также ifx_pconnect(), и ifx_close().

Примет 1. Соединение с базой данных Informix $conn_id = ifx_pconnect (mydb@ol_srv1, "imyself", "mypassword");

ifx_pconnect() работает очень похоже с ifx_connect(), но с двумя основными отличиями.

Эта функция ведет себя точно так же, как ifx_connect(), когда PHP не запкщено как модуль Апача. Во-первых, при соединении функция перво-наперво пытается найти устойчивую ссылку, которая была открыта ранее к тому же хосту с теми же параметрами (пользователь, пароль). Если поиски увенчались успехом, будет возвращен идентификатор ранее установленного соединения.

Во-вторых, соеденение с SQL-сервером не закроется по окончании выполнения скрипта. Вместо этого, ссылка останется открытой для дальнейшего использования (ifx_close() не закроет ссылку, установленную CLASS="FUNCTION">ifx_pconnect()).

Ссылкт такого типа обычно называют устойчивыми (persistent).

Смотри также: ifx_connect().

ifx_close() не закрое устойчивое соединение, сгенерированное ifx_pconnect().

Смотри также: ifx_connect(), и ifx_pconnect().

Пример 1. закрытие соединения с Informix $conn_id = ifx_connect (mydb@ol_srv, "itsme", "mypassword"); ... несколько запросов и др. ... ifx_close($conn_id);

Целочисленный "result_id" используется другими функциями для выборки результата запроса. Устанавливайте "affected_rows" для выборки, используя функцию ifx_affected_rows().

ifx_query() посылает запрос к текущей активной базе данных на сервере, который указан в link_identifier. Если идентификатор ссылки не специфицирован, подразумевается последнее открытое соединение. Если до этого не было установлено никакое соединение, функция пытается установить ссылку (как при вызове функции ifx_connect()), и использовать ее.

Выполняется query на соединении conn_id. Для запросов типа Select курсор объявлен и открыт. опциональный параметр cursor_type позволяет вам сделать курсор "scroll" и/или "hold". Это маска и может принимать одно из значаний IFX_SCROLL, IFX_HOLD, или обы вместе. Не-select запросы "выполняются немедленно".

Для любого типа запроса количество (предполагаемое или действительное) обрабатываемых рыдов сохраняется для выборки в ifx_affected_rows().

Если у вас есть колонки BLOB (BYTE или TEXT) в запросе update, вы может добавить параметрblobidarray, содержащий соответствующие идентификаторы BLOB; тогда следует заменить эти колонки на знак вопроса (?) в тексте запроса.

Если содержание колонки TEXT/BYTE позволяет, то вы можете также использовать "ifx_textasvarchar(1)" и "ifx_byteasvarchar(1)". Это позволит вам обращаться с колонками TEXT/BYTE так же, как с обычными (но довольно длинными) колонками VARCHAR в запросах select, и нет необходимости морочиться с идентификаторами BLOB.

С ifx_textasvarchar(0) или ifx_byteasvarchar(0) (ситувация по умолчанию) запрос select возвратит колонки BLOB как идентификаторы BLOB (целые значения). Вы можете получитьзначения этих идентификаторов как стори или файлы путем использования специтальных функций для BLOB (см. ниже).

Смотри также: ifx_connect().

Пример 1. показ всех рядов таблицы "orders" как таблицы html ifx_textasvarchar(1); // использовать режим "text mode" для BLOBов $res_id = ifx_query("select * from orders", $conn_id); if (! $res_id) { printf("Can't select orders : %sn<br>%s<br>n", ifx_error(); ifx_errormsg(); die; } ifx_htmltbl_result($res_id, "border="1"); ifx_free_result($res_id);

Пример 2. Вставка нескольких значений в таблицу "catalog" // создание идентификаторов BLOB для колонок byte и text $textid = ifx_create_blob(0, 0, "Text column in memory"); $byteid = ifx_create_blob(1, 0, "Byte column in memory"); // сохранение идентификаторов BLOB в масиве $blobidarray[] = $textid; $blobidarray[] = $byteid; // запуск запроса $query = "insert into catalog (stock_num, manu_code, " . "cat_descr,cat_picture) values(1,'HRO',?,?)"; $res_id = ifx_query($query, $conn_id, $blobidarray); if (! $res_id) { ... ошибка ... } // освобождение идентификатора результата ifx_free_result($res_id);

Возвращает целое result_id для использования в ifx_do(). Устанавливает affected_rows для извлечения данных функцией ifx_affected_rows().

Подготавливает query на соединении conn_id. Для запросов типа Select курсор объявлен и открыт. опциональный параметр cursor_type позволяет вам сделать курсор "scroll" и/или "hold". Это маска и может принимать одно из значаний IFX_SCROLL, IFX_HOLD, или обы вместе. Не-select запросы "выполняются немедленно".

Для любого типа запроса количество (предполагаемое или действительное) обрабатываемых рыдов сохраняется для выборки в ifx_affected_rows().

Если у вас есть колонки BLOB (BYTE или TEXT) в запросе update, вы может добавить параметрblobidarray, содержащий соответствующие идентификаторы BLOB; тогда следует заменить эти колонки на знак вопроса (?) в тексте запроса.

Если содержание колонки TEXT/BYTE позволяет, то вы можете также использовать "ifx_textasvarchar(1)" и "ifx_byteasvarchar(1)". Это позволит вам обращаться с колонками TEXT/BYTE так же, как с обычными (но довольно длинными) колонками VARCHAR в запросах select, и нет необходимости морочиться с идентификаторами BLOB.

С ifx_textasvarchar(0) или ifx_byteasvarchar(0) (ситувация по умолчанию) запрос select возвратит колонки BLOB как идентификаторы BLOB (целые значения). Вы можете получитьзначения этих идентификаторов как стори или файлы путем использования специтальных функций для BLOB (см. ниже).

Смотри также: ifx_do().

ТАкже устанавливает реальное значение ifx_affected_rows() для не-select выражений для выборки данных в ifx_affected_rows().

Смотри также: ifx_prepare().

Смотри также: ifx_errormsg()

Смотри также: ifx_error()

result_id is a valid result id returned by ifx_query() или ifx_prepare().

Возвращает число рядов, обработанных запросом, ассоциорванным с result_id.

Для вставок, обновлений и удалений - это реальное количество (sqlerrd[2]) обработанных рядов. Для выборок - ожидаемое количество (sqlerrd[0]). Не полагайтесь на него.

Часто используется после ifx_prepare() для ограничения запроса до приемлимого уровня.

Смотри также: ifx_num_rows()

Колонки BLOB возвращаются как целые идентификторы BLOB для использоваиня в ifx_get_blob(), если только вы не используете ifx_textasvarchar(1) или ifx_byteasvarchar(1), в этом случае BLOBы возвратятся как строкоыве значения. При ошибке возвращается false.

result_id - это действительный идентификатор результата, возвращенный ifx_query() или ifx_prepare() (только для запросов типа select).

[position] - опциональный параметр для операций выборки только при подвижном курсоре (scroll cursor): "NEXT", "PREVIOUS", "CURRENT", "FIRST", "LAST" или номер. Если указан номер, выполняется "абсолютная" выборка ряда.

ifx_fetch_row() выбирает один ряд данных из результата, ассоциирующегося с указанным идентификатором результата. Ряд возвращается как массив. аждая колонка результата сохраняется в смещении массива, начиная со смещения 0.

Последующий вызов ifx_fetch_row() возвртит следующий ряд результата, или false, если нет больше рядов.

Дает количество строк, выбранных до сих пор для запроса с result_id после ifx_query() или ifx_do().

Назад, к содержанию

Назад, к содержанию

LDAP (Lightweight Directory Access Protocol) - Протокол Доступа к Директориям (каталогам), является протоколом, используемым для доступа к "Серверам Каталогов". Директория является специальной разновидностью базы данных, которая хранит информацию используя древовидную структуру.

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

Для ссылки на файл в подкаталоге на жестком диске используется нечто подобное

    /usr/local/myapp/docs

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

Эквивалентом полностью определенной ссылки в LDAP является "distinguished name" (различаемое имя), обозначаемое просто как "dn". Примером dn может быть:

    cn=John Smith,ou=Accounts,o=My Company,c=US

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

    country = US
    organization = My Company
    organizationalUnit = Accounts
    commonName = John Smith

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

Поиск информации для всех записей, где фамилия начинается с "S", в сервере директории, вывод на дисплей и извлечение с именем и email-адресом.

Вам потребуется установить и скомпилировать библиотеки LDAP-клиента или из пакета University of Michigan ldap-3.3, или из Netscape Directory SDK. Вам также потребуется перекомпилировать PHP с поддержкой LDAP для того чтобы применение PHP LDAP вызовов стало доступным.

Прежде чем использовать LDAP вызовы, необходимо знать .. Имя или адрес сервера директории, который вы будете использовать "Базовый dn" сервера (часть "мирового" каталога на данном сервере, которая может быть "o=My Company,c=US") Нужен ли пароль для доступа к данному серверу (многие серверы обеспечивают доступ для чтения для "anonymous связей" но требуют пароля для чего-либо еще)

Типичная последовательность LDAP-вызовов, которую вы можете применять в приложениях, представлена в следующем щаблоне:

  ldap_connect()    // установка соединения с сервером
     |
  ldap_bind()       // анонимный или идентифицируемый "вход"
     |
 действия подобные поиску или обновлению каталога
с выводом результата 

     |
  ldap_close()      // "выход"

Большое количество информации по LDAP может быть найдено: Netscape University of Michigan OpenLDAP Project LDAP World

Netscape SDK одержит полезное Руководство Программиста в .html формате.

ldap_add -- добавляет записи в  LDAP каталог

int ldap_add(целочисленный link_identifier, строковое dn, массив записи);

возвращает true при успехе и false при ошибке.

Функция ldap_add() используется для добавления записей в LDAP каталог. DN добавляемой записи выражается посредством dn. Массив записи определяет информацию о записи. Значения записей индексируются посредством индивидуальных атрибутов. В случае множественных значений для атрибута, они индексируются целыми числами начиная с 0.

    запись["атрибут1"] = значение
    запись["атрибут2"][0] = значение1
    запись["атрибут2"][1] = значение2

ldap_bind -- связь с LDAP каталогом

int ldap_bind(целое link_identifier, строковое bind_rdn, строковое bind_password);

Связь с LDAP каталогом с определенным RDN и паролем. Возвращает true при успехе и false при ошибке.

ldap_bind() осуществляет операцию связи с каталогом. bind_rdn и bind_password используются факультативно. Если не определено, применяется связь anonymous.

ldap_close -- закрывает связь с LDAP сервером

int ldap_close(целое link_identifier);

Возвращает true при успехе, false при ошибке.

ldap_close() закрывает связь с LDAP сервером,  которая ассоциировалась с определенным link_identifier.

Этот вызов внутренне идентичен ldap_unbind(). LDAP API использует вызов ldap_unbind(), поэтому возможно он предпочтительнее вызова ldap_close().

ldap_connect -- соединение с LDAP сервером

int ldap_connect(строковое hostname, целое port);

Возвращает положительный LDAP идентификатор связи при успехе, false при ошибке.

ldap_connect() устанавливает соединение с LDAP сервером по определенным hostname и port. Оба аргумента факультативные. Если аргументы не определены, то будет возвращен идентефикатор  уже открытого соединения. Если определено только hostname, то по умолчанию используется порт 389.

ldap_count_entries -- подсчет количества записей при поиске

int ldap_count_entries(целое link_identifier, целое result_identifier);

Возвращает количество записей в результате или false при ошибке.

ldap_count_entries() возвращает количество записей хранимых в результате от предыдущей операции поиска. result_identifier идентифицирует внутренний ldap результат.

ldap_delete -- удаляет запись из каталога

int ldap_delete(целое link_identifier, строковое dn);

Возвращает true при успехе и false при ошибке.

ldap_delete() удаляет отдельную запись из LDAP каталога, определенную по dn.

ldap_dn2ufn -- конвертирует DN в User Friendly Naming формат

string ldap_dn2ufn(строковое dn);

ldap_dn2ufn() преобразует DN в более дружественную для пользователя форму, удаляя имена типа.

ldap_explode_dn -- разбивает DN на составные части

array ldap_explode_dn(строковое dn, целое with_attrib);

ldap_explode_dn() разбивает DN возвращаемое по ldap_get_dn() на составные части. Каждая часть известна как Relative Distinguished Name, или RDN. ldap_explode_dn() возвращает массив всех компонентов. with_attrib используется для запроса, возвращать ли RDN толъко со значениями или также с их атрибутами. Чтобы получить RDN-части с атрибутами (т.е. в формате атрибут=значение) установите with_attrib в 1,  чтобы получить только значения установите его в 0.

ldap_first_attribute -- возвращает первый атрибут

string ldap_first_attribute(целое link_identifier, целое result_entry_identifier, целое ber_identifier);

Возвращает первый атрибут в записи при успехе и false при ошибке.

Подобно чтению записей, атрибуты также читаются один за другим из отдельной записи. ldap_first_attribute() возвращает первый атрибут в записи, отмеченной идентификатором записи. Оставшиеся атрибуты ищутся последовательными вызовами ldap_next_attribute(). ber_identifier является идентификатором указателя положения внутренней памяти. Он передается по ссылке. Аналогичный ber_identifier передается ldap_next_attribute() функции, которая изменяет этот указатель.

См. также ldap_get_attributes()

ldap_first_entry -- возвращает первый идентификатор (id) результата

int ldap_first_entry(целое link_identifier, целое result_identifier);

Возвращает идентификатор записи для первой записи результата при успехе и  false при ошибке.

Записи в LDAP-результате считываются последовательно с использованием функций ldap_first_entry() и ldap_next_entry(). ldap_first_entry() возвращает идентификатор записи для первой записи в результате. Этот идентификатор записи передается затем в процедуру lap_next_entry() для получения последовательных записей из результата.

См. также ldap_get_entries().

ldap_free_result -- освобождает память результата

int ldap_free_result(целое result_identifier);

Возвращает true при успехе и false при ошибке.

ldap_free_result() освобождает внутреннюю память, предназначенную для хранения результата и отмечаемую посредством result_identifier. Вся память результата автоматически освобождается когда скрипт завершается.

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

ldap_get_attributes -- получает атрибуты записи в результате от поиска

array ldap_get_attributes(целое link_identifier, целое result_entry_identifier);

Возвращает полную информацию о записи в многоразмерном массиве при успехе и false при ошибке.

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

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

return_value["count"] = количество атрибутов в записи
return_value[0] = первый атрибут
return_value[n] = n-ый атрибут

return_value["attribute"]["count"] = количество значений атрибута
return_value["attribute"][0] = первое значение атрибута
return_value["attribute"][i] = i-тое значение атрибута

См. также ldap_first_attribute() и ldap_next_attribute()

ldap_get_dn -- получает DN записи результата

string ldap_get_dn(целое link_identifier, целое result_entry_identifier);

Возвращает DN записи результата или false при ошибке.

ldap_get_dn() используется для нахождения DN записи в результате.

ldap_get_entries -- получает все записи результата

array ldap_get_entries(целое link_identifier, целое result_identifier);

Возвращает полную информацию о результате в многомерном массиве при успехе и false при ошибке.

ldap_get_entries() используется для упрощения чтения множества записей из результата и затем чтения атрибутов и множественных значений. Информация о записи возвращается по одиночному вызову функции в многомерном массиве. Структура массива представлена ниже.

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

return_value["count"] = количество записей в результате
return_value[0] : ссылается на детали первой записи

return_value[i]["dn"] =  DN i-той записи в результате

return_value[i]["count"] = количество атрибутов i-той записи
return_value[i][j] = j-тый атрибут i-той записи результата

return_value[i]["attribute"]["count"] = количество значений атрибута в i-той записи
return_value[i]["attribute"][j] = j-тое значение атрибута в i-той записи

См. также ldap_first_entry() и ldap_next_entry()

ldap_get_values -- получение всех значений из записи результата

array ldap_get_values(целое link_identifier, целое result_entry_identifier, строковое attribute);

Возвращает массив значений атрибута при успехе и false при ошибке.

ldap_get_values() используется для чтения всех значений атрибута в записи в данном результате. Запись определяется по result_entry_identifier. Количество значений может быть получено при индексации "счетчика" в результирующем массиве. Отдельные значения доступны по целочисленному индексу в массиве. Первый индекс начинается с 0.

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

Ваше приложение или может быть жестко настроено на поиск определенных атрибутов (таких как "фамилия" или "почта") или вы должны использовать вызов ldap_get_attributes() для получения информации о том, какие атрибуты существуют для данной записи.

В LDAP может быть более одной записи для атрибута, поэтому можно, например, хранить несколько адресов email в записи каталога для одной персоны, при этом все записи будут отмечены с атрибутом "mail"

return_value["count"] = количество значений для атрибута
return_value[0] = первое значение атрибута
return_value[i] = i-тое значение атрибута

ldap_list -- одноуровневый поиск

int ldap_list(целое link_identifier, строковое base_dn, строковое filter);

Возвращает идентификатор результата поиска или false при ошибке.

ldap_list() выполняет поиск с определенным фильтром по каталогу с областью LDAP_SCOPE_ONELEVEL.

LDAP_SCOPE_ONELEVEL означает что такой поиск может вернуть только информацию, находящуюся на уровне непосредственно ниже базового dn, заданного в вызове. (Эквивалентно вводу "ls" и получению списка файлов и папок в текущем рабочем каталоге).

Этот вызов берет факультативно четвертый параметр который является массивом требуемых атрибутов. См. примечание к ldap_search().

ldap_modify -- изменение записи LDAP

int ldap_modify(целое link_identifier, строковое dn, массив entry);

Возвращает true при успехе и  false при ошибке.

ldap_modify() используется для изменения существующих записей в каталоге LDAP. Структура записи такая же как и в ldap_add().

ldap_next_attribute -- получает следующий атрибут в результате

string ldap_next_attribute(целое link_identifier, целое result_entry_identifier, целое ber_identifier);

Возвращает следующий атрибут в записи или false при ошибке.

ldap_next_attribute() вызывается для поиска атрибутов в записи. Внутреннее положение указателя устанавливается по ber_identifier. Он посылается в данную функцию по ссылке. Первый вызов ldap_next_attribute() осуществляется с result_entry_identifier получаемым от ldap_first_attribute().

См. также ldap_get_attributes()

ldap_next_entry -- получает следующую запись в результате

int ldap_next_entry(целое link_identifier, целое result_entry_identifier);

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

ldap_next_entry() используется для поиска записей, хранящихся в результате. Последовательные вызовы ldap_next_entry() возвращают записи одну за другой пока не закончатся все записи. Первое обращение к ldap_next_entry() осуществляется после вызова ldap_first_entry() с параметром result_identifier,   который возвращается от ldap_first_entry().

См. также ldap_get_entries()

ldap_read -- чтение записи

int ldap_read(целое link_identifier, строка base_dn, строка filter, массив [attributes]);

Возвращает идентификатор результата поиска или false при ошибке.

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

Пустой фильтр не допустим. Если вы хотите получить абсолютно всю информацию для данной записи, используйте фильтр "objectClass=*". Если вы знаете какие типы записей используются в сервере каталога, вы можете применить подходящий фильтр, такой как "objectClass=inetOrgPerson".

Этот вызов берет факультативно четвертый параметр который является массивом требуемых атрибутов. См. примечание ldap_search().

ldap_search -- поиск по дереву LDAP

int ldap_search(целое link_identifier, строковое base_dn, строковое filter, массив [attributes]);

Возвращает идентификатор результата поиска или false при ошибке.

ldap_search() осуществляет поиск для определенного фильтра по каталогу с областью   LDAP_SCOPE_SUBTREE. Это эквивалентно поиску по всему каталогу. base_dn определяет базовый DN для данного каталога.

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

Четвертый параметр является стандартным строковым массивом PHP с требуемыми атрибутами, т.е. array("mail","sn","cn"). Заметим, что "dn" требуется всегда, независимо от того, какие типы атрибутов запрашиваются.

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

Поисковый фильтр может быть простым или расширенным, использующим булевы операторы в формате описанном в документации LDAP (См. Netscape Directory SDK для дополнения информации по фильтрам).

Приведенный ниже пример отыскивает the отдел организации, фамилию, данное имя и адрес email для всех людей в "My Company" где фамилия или данное имя содержат подстроку $person. Этот пример использует логический фильтр для указания серверу на поиск информации более чем в одном атрибуте.

Когда вы выполняете поиск, и слишком много данных возвращается (много записей) вы получите предупреждение, и ldap_get_entries() выдаст сбой. Рассматриваемый здесь прием должен выключить это предупреждение, потом проверить полученную запись.

$normerr = error_reporting ();
error_reporting (0);  // выключает предупреждение!
$sr = ldap_search ($ds, $dn, $searchfor);
$normerr = error_reporting ($normerr);
if (!$sr) {
    print "слишком много записей!";
} else .....
      

Вы можете попробовать сузить эту область, добавив особый фильтр,  т.е. (cn=a*), но было бы лучше иметь возможность захватить результаты в битах (т.е. 1-100, 101-200...).

ldap_unbind -- прекращение связи из каталога LDAP

int ldap_unbind(целое link_identifier);

Возвращает true при успехе и false при ошибке.

ldap_unbind() прекращает связь из каталога LDAP.

Назад, к содержанию

Функция mail() позволяет отсылать почту.
Mail() автоматически посылает сообщение, содержащееся в message адресату, указанному в to.
Несколько получателей могут быть указаны в поле to в виде строки с адресами, разделенными пробелами.

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

Назад, к содержанию

Эти математические функции работают только с диапазоном чисел типа long и double. Если Вы хотите использовать большие числа, взгляните на математические функции произвольной точности. .

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

Таблица 1. Математические константы

Возвращает абсолютную величину числа. Если число с плавающей запятой, то также возвращает число с плавающей запятой.

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

См.также asin() и atan().

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

См.также acos() и atan().

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

См.также acos() и atan().

Эта функция вычисляет арктангенс от двух переменных x и y. Аналогично вычислению арктангенса y / x, за исключением того, что знаки обоих аргументов используются для определения сектора результата.

Функция возвращает результат в радианах, находящихся между -PI и PI (включительно).

См.также acos() и atan().

Возвращает строку, содержащую number, представленное по основанию tobase. Основание, в котором дается число which number указывается в frombase. Основания frombase и tobase должны находиться в диапазоне от 2 до 36 включительно. Цифры в числах с основанием выше, чем 10 будут представлены буквами a-z, со значениями a - 10, b - 11 и z - 36.

Пример 1. base_convert() $binary = base_convert($hexadecimal, 16, 2);

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

OctDec конвертирует двоичное число в десятичное. Наибольшее число, которое может быть сконвертировано равно 31 битам или 2147483647 в десятичном виде.

См.также функцию decbin().

Возвращает следующее наивысшее целое значение number. Использование ceil() на целых числах - абсолютная трата времени.

ЗАМЕЧАНИЕ: Функция ceil() в PHP/FI 2 возвращаля число типа float. Используйте: $new = (double)ceil($number); для того, чтобы сэмулировать старое поведение функции.

См.также floor() и round().

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

См.также sin() и tan().

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

См.также функцию bindec().

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

См. также функцию hexdec().

Возвращает строку, содержащую восьмеричное представление аргумента number. Наибольшее число, которое может быть сконвертировано равно 2147483647 в десятичном виде или "17777777777" в восьмеричном. См.также octdec().

Возвращает число e, возведенное в степень arg.

См.также pow().

Возвращает следующее нижележащее значение после number. Использование floor() на целых числах - абсолютная потеря времени.

ЗАМЕЧАНИЕ: Функция floor() в PHP/FI 2 возвращала число типа float. Используйте: $new = (double)floor($number); для эмулирования старого поведения этой функции.

См.также ceil() и round().

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

См.также rand(), srand() mt_rand(), mt_srand() и mt_getrandmax().

Возвращает десятичный эквивалент числа, представленного аргументом hex_string. HexDec конвертирует шестнадцатиричную сстроку в десятичное число. Наибольшее число, которое может быть сконверьтировано равно 7fffffff в шестнадцатиричном виде или 2147483647 в десятичном.

См. также функцию dechex().

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

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

max() возвращает наибольшее число из перечисленных в параметрах.

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

Если одна или более величин типа double, все остальные величины будут обращены double, и, соответственно, возвратится число типа double. Если ни одно из чисел не является double, то все будут обращены в целые и возвратится целое число.

min() возвращает наименьшее значение из указанных в аргументах.

Если первый параметр - массив, min() возвратит наименьшую величину массива. Если первый параметр - целое число, строка или double, следует указать минимум два парметра и min() возвратит наименьшую из них величину. Вы можете сравнивать неограниченно количество величин.

Если одна или более величин типа double, все остальные величины будут обращены double, и, соответственно, возвратится число типа double. Если ни одно из чисел не является double, то все будут обращены в целые и возвратится целое число.

Множество генераторов случайных чисел, написанных на старой библиотеке libcs, имеют неясные или неизвестные характеристики, и к тому же, медленны. По умолчанию с функцией rand() PHP использует генератор случайных чисел, написанный на libc. Функция mt_rand() является его полной заменой. Она использует генератор случайных чисел с известными характеристиками (Mersenne Twister), который производит случайные числа, пригодные для использования в криптографии и работает в четыре раза быстрее, чем средняя скорость, которую обеспечивает libc. Домашняя страница Mersenne Twister'а Вы можете найти по адресу http://www.math.keio.ac.jp/~matumoto/emt.html, а оптимизированную версию исходных текстов на http://www.scp.syr.edu/~marc/hawk/twister.html.

Если функция вызывается без необязательных аргументов min и max, mt_rand() возвращает псевдо-случайное число между 0 и RAND_MAX. Если Вы хотите получить случайное число между 5 и 15 (включительно), то можно использовать следующий вызов функции: mt_rand(5,15).

Не забудьте инициализировать генератор случайных чисел перед использованием функции mt_srand().

См.также mt_srand(), mt_getrandmax(), srand(), rand() и getrandmax().

Инициализирует генератор случайных чисел значением seed.

См.также mt_rand(), mt_getrandmax(), srand(), rand() и getrandmax().

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

См.также mt_rand(), mt_srand() rand(), srand() и getrandmax().

number_format() возвращает форматированную версию числа number. Эта функция принимает один, два или четыре параметра (не три):

Если дан только один параметр, число number будет отформатировано без десятичных цифр, но с запятой (",") между каждой группой тысяч.

Если дано два параметра, число number will будет отформатировано с десятичным знаком decimals с точкой (".") впереди и запятой (",") между каждой группой тысяч.

Если даны все четыре параметра, то число number будет отформатировано с десятичным знаком decimals, dec_point вместо точки (".") перед десятичным знаком и thousands_sep вместо запятой (",") между каждой группой тысяч.

Возвращает десятичный эквивалент восьмеричного числа, представленного аргументом octal_string. OctDec конвертирует восьмеричное число в десятичное. Максимальное число, которое может быть сконвертировано равно 17777777777 или 2147483647 в десятичном виде.

См.также decoct().

Вохвращает аппроксимированное значение pi.

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

См.также exp().

Если функция вызывается без необязательных параметров min и max, rand() возвращает псевдо-случайную величину между 0 и RAND_MAX. При желании получить случайное число между 5 и 15 (включительно), используйте rand(5,15).

Не забудьте проинициализировать генератор случайных чисел перед использованием srand().

См.также srand(), getrandmax(), mt_rand(), mt_srand() и mt_getrandmax().

Возвращает округленную величину val.

См.также ceil() and floor().

Возврашает синус аргумента.

См.также cos() и tan().

Возвращает квадратный корень аргумента.

Инициализирует генератор случайных чисел значением seed.

См.также rand(), getrandmax(), mt_rand(), mt_srand() и mt_getrandmax().

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

См.также sin() и cos().

Назад, к содержанию

Имеются некоторые условия, которые надо иметь в виду при использовании eval(). Не забудьте, что переданная строка должна иметь допустимый PHP код, при включении чего-нибудь подобного завершению кода с точкой с запятой дальнейшее выполнение  не прервется  на строке после eval(), поэтому пропускайте это в code_str.

Также не забудьте, что при изменении переменных значений в eval() эти переменные будут изменены и в основных данных.
 

Пример 1. eval()  - простое объединение текста <?php $string = 'cup'; $name = 'coffee'; $str = 'This is a $string with my $name in it.<br>'; echo $str; eval( "$str = "$str";" ); echo $str; ?>

При выполнении вышеприведенного примера будет выведено следующее: This is a $string with my $name in it. This is a cup with my coffee in it. die die -- Вывод сообщения и завершение текущего скрипта Описание void die(string message);
  Эта функция выводит сообщение и прекращает выполнение текущего скрипта. Не возвращает значение.
 

Пример 1. die  <?php $filename = '/path/to/data-file'; $file = fopen($filename, 'r')   or die "unable to open file ($filename)"; ?>

exit exit -- Завершает текущий скрипт Описание void exit(void);
  Эта функция завершает текущий скрипт.  Не возвращает значение. iptcparse iptcparse -- Анализирует двоичный IPTC http://www.xe.net/iptc/ блок на одиночные тэги. Описание array iptcparse(string iptcblock);
  Эта функция анализирует двоичный блок IPTC на одиночные теги.  Возвращает массив, использующий tagmarker как индекс и значение как значение. Возвращает false при ошибке или если никаких IPTC данных не было найдено. См. GetImageSize() для примера. leak leak -- Отсечение куска памяти Описание void leak(int bytes);
  Leak() отсекает определенный объем памяти.

Это полезно при отладке диспетчера памяти, который автоматически очищает "отсеченную" память при выполнении запроса. pack pack -- упаковывает данные в двоичную строку Описание string pack(string format, mixed [ args ]...);
  Упаковывает данные в двоичную строку согласно формату. Возвращает двоичную строку, содержащую данные.

Идея на эту функцию принималась из Perl и всей работы кодов форматирования также как там. Строка формата состоит из кодов формата, сопровождаемые факультативным параметром ретранслятора. Параметр ретранслятора может быть или целочисленное значение или * для повторение до конца входных данных. Для a, A, h, H количество повторов определяет, сколько принимается символов одного параметра данных, для @ это безусловная позиция, где поместить следующие данные, для всего остального количество повторов определяет сколько данных будет использовано и упаковано в возникающую в результате двоичную строку. В настоящее время выполнено:
  a строка NUL-заполнений

A строка SPACE-заполнений

h Hex строка, младший полубайт вначале

H Hex строка, старший полубайт вначале

c signed char

C unsigned char

s signed short (всегда 16 бит, machine byte order)

S unsigned short (всегда 16 бит, machine byte order)

n unsigned short (всегда 16 бит, big endian byte order)

v unsigned short (всегда 16 бит, little endian byte order)

i signed integer (machine dependant размер и byte order)

I unsigned integer (machine dependant размер и byte order)

l signed long (всегда 32 бит, machine byte order)

L unsigned long (всегда 32 бит, machine byte order)

N unsigned long (всегда 32 бит, big endian byte order)

V unsigned long (всегда 32 бит, little endian byte order)

f float (machine dependent размер и representation)

d double (machine dependent размер и representation)

x NUL байт

X Копирует один байт

@ NUL-Заполнение до конкретной позиции

Пример 1. pack форматируем строку $binarydata = pack(" nvc* ", 0x1234, 0x5678, 65, 66); Возникающая в результате двоичная строка будет длиной 6 байтов и содержать последовательность байтов 0x12, 0x34, 0x78, 0x56, 0x41, 0x42.

Обратите внимание, что различие между знаковыми и без знаковыми значениями эффективно только для функции unpack(), так как  функция pack() дает тот же самый результат для знаковых и без знаковых кодов форматирования.

Также обратите внимание, что PHP хранит интегральные значения как значения со знаком и имеет machine dependant размер. Если вы делаете без знака, то интегральное значение будет сохранено и сконвертировано, при этом конечный результат будет неизвестен. register_shutdown_function register_shutdown_function -- Устанавливает функцию, которая будет выполнена при завершении. Описание int register_shutdown_function(string func);
  Устанавливает функцию с именем func, которая будет выполнена при завершении. serialize serialize -- Генерирует удобохраниемое представление значения Описание string serialize(mixed value);
  serialize() возвращает строку состоящую из потока байтов при представлениизначения value, которое может где-нибудь сохранено.

Это полезно для сохранения или передачи значений PHP  без потери их типа и структуры..

Чтобы преобразовать строку обратно в PHP значение, используйте unserialize(). serialize() обрабатывает следующие типы:  integer ,  double ,  string ,  array (многомерный) и  object (объект будет преобразован в последовательную форму, но методы при этом будут утеряны).
 

Пример 1. serialize  // $session_data содержит многомерный массив с информацией о сессии  // текущего пользователя.  Мы используем serialize() для сохранения // этого в базе данных в конце запроса. $conn = odbc_connect("webdb", "php", "chicken"); $stmt = odbc_prepare($conn,                      "UPDATE sessions SET data = ? WHERE id = ?"); $sqldata = array(serialize($session_data), $PHP_AUTH_USER); if (!odbc_execute($stmt, &$sqldata)) {     $stmt = odbc_prepare($conn,                          "INSERT INTO sessions (id, data) VALUES(?, ?)");     if (!odbc_execute($stmt, &$sqldata)) {         /* Что-то сделано неправильно. */     } }

sleep sleep -- Задержка выполнения Описание void sleep(int seconds);
  Sleep фукция выполняет задержку выполненя программы в секундах (seconds).

См. также usleep(). unpack unpack -- Распаковывает данные из двоичной строки Описание array unpack(string format, string data);
  Распаковывает данные из двоичной строки в массив согласно формату. Возвращает массив, содержащий распакованные элементы.

Unpack работает не так как в Perl поскольку распакованные данные сохранены в ассоциативном массиве. Чтобы сделать это, Вы должны установить различные коды формата, и отделить их наклонной чертой вправо /.
 

Пример 1. Распаковываем строку $array = unpack("c2chars/nint", $binarydata); Возникающий в результате массив будет содержать "chars1", "chars2" и "int".

Для объяснения кодов формата см. также: pack()

Помните, что PHP хранит интегральные значения со знаком. Даже если вы сохраните с указанием что это без знака, и будете извлекать, то все равно непредсказуем результат и может возникнуть ошибка. unserialize unserialize -- создает PHP значение из сохраненного представления Описание mixed unserialize(string str);
  unserialize() берет одно сохраненное значение  (см. serialize()) и преобразует обратно в PHP значение. Возвращает преобразованное значение, и может иметь тип:  integer ,  double ,  string ,  array или  object . Если был преобразован object, то методы не востановятся.
 

Пример 1. unserialize  // Здесь мы используем unserialize() для загрузки данных о сессии из базы данных // в $session_data.  Этот пример дополняет описанный в месте // с serialize(). $conn = odbc_connect("webdb", "php", "chicken"); $stmt = odbc_prepare($conn, "SELECT data FROM sessions WHERE id = ?"); $sqldata = array($PHP_AUTH_USER); if (!odbc_execute($stmt, &$sqldata) || !odbc_fetch_into($stmt, &$tmp)) {     // Если сбой запуска или выборки , то инициализируем массив     $session_data = array(); } else {     // Мы должны иметь представление в $tmp[0].     $session_data = unserialize($tmp[0]);     if (!is_array($session_data)) {         // Что-то неправильно, инициализируем массив         $session_data = array();     } }

uniqid uniqid -- генерирует уникальный идентификатор Описание int uniqid(string prefix);
  uniqid() возвращает уникальный идентификатор, основанный на текущем времени в микросекундах. Префикс может быть полезен, например, если Вы генерируете идентификаторы одновременно на отдельных хостах, которые, могли бы случилось,  генерировали идентификатор в одной и той же микросекунде. Префикс может быть длиной до 114 символов.

Если Вы нуждаетесь в уникальном идентификаторе или лексеме(маркере), и Вы предполагаете раздавать эту лексему(маркер) пользователю через сеть (то есть сеанс cookies), то рекомендуется, чтобы Вы использовали что - нибудь со строками $token = md5(uniqid("")); // Не произвольно $better_token = md5(uniqid(random())); // Намного лучше, труднее подобрать Это создаст 32 символьный идентификатор (128 бит hex число) который чрезвычайно трудно предсказать. usleep usleep -- Задержка выполнения в микросекундах Описание void usleep(int micro_seconds);
  Задержка выполнения программы в микросекундах(micro_seconds).

См. также sleep(). Назад, к содержанию Функции mSQL

Возвращает положительный идентификатор результата mSQL-запроса или false в случае ошибки.

msql() выбирает базу данных и выполняет на ней запрос. Если не указан необязательный идентификатор связи, функция будет пытаться найти открытую связь с mSQL-сервером и если ни одной связи найдено не будет, функция попытается создать ее, как если бы вызывалась функция msql_connect() без аргументов (см. msql_connect() ).

Возвращает количество строк результата запроса (т.е. количество строк, возвращаемых SELECT, количество строк, модифицированных UPDATE или количество строк, удаленных DELETE).

См.также: msql_query()

Возвращает true в случае успеха и false в случае ошибки.

msql_close() закрывает связь с базой данных mSQL, которая ассоциирована с указанным идентификатором связи. Если идентификатор связи не указан, закрывается последняя открытая связь.

Заметьте, что обычно нет необходимости это делать, т.к. непостоянные связи автоматически закрываются после исполнения скрипта.

msql_close() не закрывает постоянную связь, открытую с помощью msql_pconnect() .

См.также: msql_connect() и msql_pconnect() .

В случае успеха возвращает положительный идентификатор связи или false в случае ошибки.

msql_connect() устанавливает соединение с mSQL сервером. Аргумент hostname - необязателен, и если он пропущен, подразумевается localhost.

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

Связь серверои будет закрыта сразу же, как только прекратится выполнение скрипта или ранее она не будет закрыта вызовом функции msql_close() .

См.также msql_pconnect() , msql_close() .

msql_create_db() пытается создать новую базу данных на сервере, ассоциированном с указанным идентификатором связи.

См.также: msql_drop_db() .

Идентична msql_create_db() .

Возвращает true в случае успеха и false в случае ошибки.

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

См.также: msql_fetch_row() .

msql_dbname() возвращает название базы данных записанной в положении i указателя, возвращаемого функцией msql_listdbs() . Для определения количества доступных баз данных может быть использована функция msql_numrows() .

Возвращает true в случае успеха и false в случае ошибки.

msql_drop_db() пытается полностью удалить с сервера базу данных, ассоциированную с указанным идентификатором связи.

См.также: msql_create_db() .

См. msql_drop_db() .

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

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

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

Будьте осторожны при извлечении данных из запроса, который может возвратить запись, содержащую одно поле со значением 0 (или пустую строку, или NULL).

Важно заметить, что использование msql_fetch_array() работает совсем НЕ медленнее, чем msql_fetch_row() , причем обеспечивает при этом важные дополнения.

За дополнительной информацией обратитесь к msql_fetch_row()

Возвращает объект, содержащий информацию о поле

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

Свойствами объекта являются:

name - название колонки

table - название таблицы, которой принадлежит колонка to

not_null - 1, если колонка не может быть равна null

primary_key - 1, если колонка является первичным ключом

unique - 1, если колонка является уникальным ключом

type - тип колонки

См.также msql_field_seek() .

Возвращает объект со свойствами, соответствующими извлеченной строке. Если больше нет строк, возвращается false.

msql_fetch_object() эквивалентно msql_fetch_array() , с одним исключением - вместо массива возвращается объект. Это значит, что доступ у данным может производиться только по названию поля, а не по их смещению (числа - неправильные названия полей).

По скорости работы функция иденитична msql_fetch_array() и msql_fetch_row() (разница очень маленькая).

См.также: msql_fetch_array() and msql_fetch_row() .

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

msql_fetch_row() извлекает одну строку данных из результата, асслциированного с указанным идентификатором. Строка возвращается как массив. Каждая колонка результата записывается в массив со смещение, начиная со смещения 0.

Следующий вызов msql_fetch_row() возвратит следубщую строку из результата. Если строк больше нет, возвратится false.

См.также: msql_fetch_array() , msql_fetch_object() , msql_data_seek() , и msql_result() .

msql_fieldname() возвращает название указанного поля. query_identifier - идентификатор запроса, и field - индекс поля. msql_fieldname($result, 2); возвратит название второго поля результата, ассоциированного с идентификатором результата.

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

См.также: msql_fetch_field() .

Возвращает название таблицы, откуда было извлечено поле field .

msql_fieldtype() эквивалентно msql_fieldname() . Аргументы идентичны, но возвращается тип поля. Тип может быть следующим: "int", "string" или "real".

msql_fieldflags() возвращает флаги указанного поля. В текущий момент они могут быть следующими: "not null", "primary key", их комбинацией или "" (пустая строка).

msql_fieldlen() возвращает длину указанного поля.

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

См. msql_free_result()

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

См.также msql_error() .

See msql_list_fields() .

msql_list_dbs() возвратит указатель на результат, содержащий базы данных, доступные с текущего msql демона. Используйте функцию msql_dbname() для извлечения имен таблиц.

См. msql_list_dbs() .

msql_list_tables() в качестве параметра использует название базы данных, и возвращает у казатель на результат, примерно, как и функция msql() . Для извлечения настоящих названий таблиц должна быть использована функция msql_tablename() , параметром в которую передается указатель на результат.

См. msql_list_tables() .

msql_num_fields() возвращает количество полей в данных резултата.

См.также: msql() , msql_query() , msql_fetch_field() , и msql_num_rows() .

msql_num_rows() возвращает количество строк данных результата.

См.также: msql() , msql_query() , и msql_fetch_row() .

Идентична msql_num_fields() .

Идентична msql_num_rows() .

Возвращает положительный идентификатор соединения в случае успеха или false в случае ошибки.

msql_pconnect() ведет себя во многом также как msql_connect() с двумя главными отличиями:

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

Во-вторых, соединение с SQl-сервером не закроется, когда завершится исполнение скрипты. Вместо этого, соединение останется открытым для будущего использования ( msql_close() не закроет соединение, установленно с помощью msql_pconnect()).

Такой тип связи, поэтому, называется 'постоянным'.

msql_query() посылает запрос к текущей активной базе данных на сервере, которая задается идентификатором связи. Если идентификатор связи не указан, то будет использоваться последняя открытая связь. Если связи вообще не открыто, то функция пытается установить связь как если бы вызывалась функция msql_connect() .

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

См.также: msql() , msql_select_db() , and msql_connect() .

См. sql_regcase() .

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

msql_result() возвращает содержимое одной ячейки из результата. Аргумент field может быть смещением поля или его названием или же названием таблицы, точка, названием поля (fieldname.tablename). Если название колонки является псевдонимом ('select foo as bar from...'), используйте псевдоним вместо названия колонки.

При работе с большими результатами запросов, Вы должны рассмотреть возможность использования одной из функций, которые извлекают колонку целиком. Т.к. эти функции извлекают содержимое нескольких ячеек за один вызов, то они работают НАМНОГО быстрее, чем msql_result(). Также заметьте, что при указании числового смещения поля функция работает гораздо быстрее, чем при указании названия поля или аргумента название_таблицы.название_поля.

В качестве высокоскоростной альтернативы рекомендуем: msql_fetch_row() , msql_fetch_array() , и msql_fetch_object() .

Возвращает true в случае успеха и false в случае ошибки.

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

Каждый последующий вызов msql_query() будет сделан на активную базу данных.

См.также: msql_connect() , msql_pconnect() , и msql_query() .

См. msql_select_db() .

msql_tablename() использует в качестве аргументов указатель на рузультат, возвращаемый функцией msql_list_tables() и целый индекс и возвращает название таблицы. Функция msql_numrows() может быть использована для определения количества таблиц в результате запроса.

Пример 1. Использование msql_tablename() <?php msql_connect ("localhost"); $result = msql_list_tables("wisconsin"); $i = 0; while ($i < msql_numrows($result)) { $tb_names[$i] = msql_tablename($result, $i); echo $tb_names[$i] . "<BR>"; $i++; } ?>

Эти функции обеспечивают доступ к серверам баз данных MySQL.

Больше информации о MySQL можно найти на сайте http://www.mysql.com/.

mysql_affected_rows() возвращает количество столбцов, использованных запросами INSERT, UPDATE или DELETE на сервере, связываемом с определенным идентификатором связи(link_identifier). Если идентификатор связи не определен, используется последняя открытая связь.

Если последний запрос был запрос DELETE без условия WHERE, ВСЕ записи будут удалены из таблицы, но эта функция возвратит нуль.

Эта команда не действует при запросе SELECT, она действует только при запросах, изменяющих записи. Чтобы получить количество колонок возвращенных на запрос SELECT, используйте mysql_num_rows().

Возвращает: true при успешном завершении, false при ошибке

mysql_close() закрывает связь с базой данных MySQL, ассоциированной с определенным идентификатором связи(link identifier. Если идентификатор связи не определен, используется последняя открытая связь.

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

mysql_close() не закроет устойчивые связи сгенерированные функцией mysql_pconnect().

См. также: mysql_connect(), и mysql_pconnect().

Возвращает: Правильный идентификатор связи MySQL при успешном выполнении, или false при ошибке.

mysql_connect() устанавливает соединение с MySQL сервером. Все аргументы дополнительны(опциональны), и если они пропущены, то устанавливаются по умолчанию -('localhost', имя пользователя, который владеет процессом, пустой пароль). Строка "имя сервера"("hostname") также может содержать номер порта( подобно "hostname:port").

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

Как только выполнение сценария закончится, связь с сервером закроется, если оно не было явно закрыто более ранний вызовом mysql_close().

См. также mysql_pconnect(), и mysql_close().

mysql_create_db() пытается создавать новую базу данных на сервере связанном с определенным идентификатором связи.

См. также: mysql_drop_db(). Для совместимости с более ранними версиями может также быть использована функция mysql_createdb() .

Возвращает: true при успешном выполнении , false при ошибке.

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

Возвращает: Правильный идентификатор результата MySQL в результате запроса, или false при ошибке .

mysql_db_query() выбирает базу данных и выполняет запрос на нее. Если дополнительный идентификатор связи не определен, функция попытается найти открытую связь с MySQL сервером и если такая связь не обнаружена, то она попытается создать ее, как если бы функция mysql_connect() была вызвана без аргументов.

См. также mysql_connect(). Для обратной совместимости может быть также использована функция mysql().

Возвращает: true при успешном выполнении , false при неудачном завершении.

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

См. также: mysql_create_db(). Для обратной совместимости может быть также использована функция mysql_dropdb().

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

См. также: mysql_error()

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

См. также: mysql_errno()

Возвращает результат строки запроса как массив, или false при отсутствии результата.

mysql_fetch_array() является расширенной версией функции mysql_fetch_row(). Кроме того, что она сохраняет данные в пронумерованных элементах, результатного массива, она также сохраняет ассоциативную связь, используя имена полей как ключи.

Если два или более столбцов имеют одинаковые имена, то связку ключ/значение получает последний из них. Чтобы получить доступ к другому столбцу(-цам) с таким же именем, вы должны использовать индексы или задать псевдонимы(alias) для этих столбцов.

Важно заметить, что использование mysql_fetch_array() НЕСУЩЕСТВЕННО медленнее, чем использование mysql_fetch_row(), пока это обеспечивает необходимую задачу.

Более подробно см. mysql_fetch_row()

Возвращает объект, содержащий информацию о поле.

mysql_fetch_field() Может быть использована для получения информации о поле в определенном результате запроса. Если параметры поля не указаны, то будет запрошено поле, которое еще не было запрошено функцией mysql_fetch_field().

Свойствами объекта являются:

name - имя столбца

table - имя таблицы, содержащей столбец

max_length - максимальная длинна столбца

not_null - 1, если столбец не может принимать нулевые значения

primary_key - 1, если столбец является первичным ключом.

unique_key - 1 если столбец является уникальным ключом

multiple_key - 1 если столбец является не-уникальным ключом

numeric - 1 если столбец числовой

blob - 1 это столбец является BLOB

type - тип столбца

unsigned - 1 если столбец не назван

zerofill - 1 если столбец заполнен нулем

См. также mysql_field_seek()

Возвращает: Массив, который соответствует длинам каждого поля в последней строке, выбранной mysql_fetch_row(), или false при ошибке .

mysql_fetch_lengths() хранит длины каждого столбца в последней колонке результата возвращенного функцией mysql_fetch_row() в массиве, нумеруемом с нуля.

См. также: mysql_fetch_row().

Возвращает объект с свойствами, который соответствует полученной строке, или false если нет результата.

mysql_fetch_object() подобна mysql_fetch_array(), с одним различием - вместо массива возвращается объект. Это означает, что Вы можете иметь доступ к данным только по именам полей, а не по их параметрам (индексные числа в данном случае являются неверным обращением).

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

Пример 1. mysql fetch object <?php mysql_connect($host,$user,$password); $result = mysql_db_query("database","select * from table"); while($row = mysql_fetch_object($result)) { echo $row->user_id; echo $row->fullname; } mysql_free_result($result); ?>

См. также: mysql_fetch_array() и mysql_fetch_row().

Возвращает: Массив, который соответствует выбранным колонкам, или false если нет результата.

mysql_fetch_row() выбирает столбец данных из результата, и связывает его с определенным идентификатором результата(индексом элемента массива). Запрос возвращается как массив. Каждый столбец результата хранится в элементах массива, пронумерованного с нуля.

Последующий вызов функции mysql_fetch_row() должен возвратить следующую строку, или false если нет больше колонок.

См. также: mysql_fetch_array(), mysql_fetch_object(), mysql_data_seek(), mysql_fetch_lengths(), и mysql_result().

mysql_field_name() возвращает имя указанного поля. Аргументами функции являются идентификатор результата и индекс поля, т.е. mysql_field_name($result,2);

Возвратит имя второй области в результат, связанный с идентификатором результата($result).

Для обратной совместимости также может быть использована функция mysql_fieldname().

Поиск в определенном поле. Если следующий вызов mysql_fetch_field() не содержит указания поля, то должно быть возвращено именно это поле.

См. также: mysql_fetch_field().

Получает имя таблицы поля. Для обратной совместимости также может быть использована mysql_fieldtable() .

mysql_field_type() подобна функции mysql_field_name() . Аргументы идентичны, но возвращается тип поля. Это будет что-то из "int", "real", "string", "blob", или другие типы, которые подробно описываются в документации MySQL.

Пример 1. mysql field types <?php mysql_connect("localhost:3306"); mysql_select_db("wisconsin"); $result = mysql_query("SELECT * FROM onek"); $fields = mysql_num_fields($result); $rows = mysql_num_rows($result); $i = 0; $table = mysql_field_table($result, $i); echo "Your '".$table."' table has ".$fields." fields and ".$rows." records <BR>"; echo "The table has the following fields <BR>"; while ($i < $fields) { $type = mysql_field_type ($result, $i); $name = mysql_field_name ($result, $i); $len = mysql_field_len ($result, $i); $flags = mysql_field_flags ($result, $i); echo $type." ".$name." ".$len." ".$flags."<BR>"; $i++; } mysql_close(); ?>

Для обратной совместимости mysql_fieldtype() также может быть использована.

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

Если ваша текущая версия MySQL их поддерживает, могут быть получены следующие флаги : : "not_null", "primary_key", "unique_key", "multiple_key", "blob", "unsigned", "zerofill", "binary", "enum", "auto_increment", "timestamp".

Для обратной совместимости mysql_fieldflags() также может быть использована.

mysql_field_len() возвращает длину указанного поля. Для обратной совместимости mysql_fieldlen() также может быть использована.

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

Для обратной совместимости mysql_freeresult() также может быть использована.

mysql_insert_id() возвращает ID сгенерированнуые для поля с автоинкрементом(AUTO_INCREMENTED). Эта функция не использует аргументов. Она возвратит автоматически сгенерированный номер ID возвращенный последним запросом INSERT.

mysql_list_fields() извлекает информацию о заданной tablename таблице. Аргументы - имя базы данных и имя таблицы. После выполнения возвращается указатель результата, который может использоваться функциями mysql_field_flags(), mysql_field_len(), mysql_field_name(), и mysql_field_type().

Идентификатор результата является положительным целым. Функция возвращает -1 если происходит ошибка. Строка описсания ошибки будет помещена в переменную $phperrmsg, и если функция не была вызвана как @mysql() то затем также будет выведено это описание ошибки.

Для обратной совместимости mysql_listfields() также может быть использована.

mysql_list_dbs() возвратит указатель результата, содержащий базы данных доступные текущему процессу mysql. Используйте функцию mysql_tablename(), чтобы просмотреть этот указатель результата.

Для обратной совместимости mysql_listdbs() также может быть использована.

mysql_list_tables() берет имя базы данных и указатель результата очень подобно функции mysql_db_query(). Функция mysql_tablename() должна использоваться, чтобы извлечь фактические имена таблиц с указателя результата.

Для обратной совместимости mysql_listtables() также может быть использована.

mysql_num_fields() получает количество полей в установленном результате.

См. также: mysql_db_query(), mysql_query(), mysql_fetch_field(), mysql_num_rows().

Для обратной совместимости mysql_numfields() также может быть использована.

mysql_num_rows() получает количество столбцов в установленном результате

См. также: mysql_db_query(), mysql_query() и, mysql_fetch_row().

Для обратной совместимости mysql_numrows() также может быть использована.

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

mysql_pconnect() действует очень похоже на mysql_connect() с двумя важными различиями.

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

Во-вторых, соединение с сервером SQL не закроется, когда закончится выполнение сценария. Вместо этого, связь останется открытой для последующего использования (mysql_close() не закроет связи установленные функцией mysql_pconnect()).

Потому этот тип связей назван 'устойчивый'.

mysql_query() посылает запрос в базу данных, к настоящему времени активную на сервере, который связан с определенным идентификатором связи. Если link_identifier не указан, используется последняя открытая связь. Если связь не открыта, функция пытается установить связь, как если бы была вызвана функция mysql_connect() и использует ее.

Эта функция возвращает TRUE или FALSE чтобы показать успешность выполнения запросов UPDATE, INSERT, и DELETE. При запросе SELECT она возвращает новый идентификатор результата. Ресурсы, использованные запросом затем могут быть освобождены вызовом функции mysql_free_result().

См. также: mysql_db_query(), mysql_select_db(), и mysql_connect().

mysql_result() возвращает содержимое одной ячейки из установленного результата MySQL. Аргументом поля может быть номер или имя поля, или параметр типа имя_таблицы-точка-имя_поля(fieldname.tablename). Если имя столбца заменено псевдонимом('select foo as bar from...'), используйте псевдоним вместо имени столбца.

Работая с больших результатами, Вы должны предусматривать использование одной из функций, которые выбирают целую строку(указано ниже) За счет того, что эти функции возвращают содержимое большого числа ячеек за один вызов функции, они ЗНАЧИТЕЛЬНО более быстрые чем mysql_result(). Также, имейте в виду, что определение аргумента поля числовым параметром, значительно более быстрое чем определение имени поля(fieldname) или использование аргумента tablename.fieldname.

Вызов mysql_result() не должен смешиваться с вызовами других функций, которые имеют дело с установленным результатом.

Рекомендуемые быстродействующие альтернативы: mysql_fetch_row(), mysql_fetch_array(), и mysql_fetch_object().

Возвращает: true при успешном выполнении , false при ошибке

mysql_select_db() устанавливает текущую активную базу данных в сервере, которая связывается с определенным идентификатором связи. Если не определен идентификатор связи, принимается последняя открытая связь. Если связь не открыта, функция попытается установить связь, как если бы была вызвана функция mysql_connect().

Каждый последующий вызов mysql_query() будет произведен в активной базе данных.

См. также: mysql_connect(), mysql_pconnect(), и mysql_query()

Для обратной совместимости mysql_selectdb() также может быть использована.

mysql_tablename() берет указатель результата возвращенный функцией mysql_list_tables() а также целочисленный индекс и возвращает имя таблицы. Функция mysql_num_rows() может использоваться для того, чтобы определить количество таблиц на данном указателе результата.

Пример 1. mysql_tablename() example <?php mysql_connect ("localhost:3306"); $result = mysql_listtables ("wisconsin"); $i = 0; while ($i < mysql_num_rows ($result)) { $tb_names[$i] = mysql_tablename ($result, $i); echo $tb_names[$i] . "<BR>"; $i++; } ?>

sybase_affected_rows -- возвращает число строк, измененных последним запросом

int sybase_affected_rows(int [link_identifier] );

Возвращает: Число строк,измененных последним запросом.

Функция sybase_affected_rows() возвращает число строк, участвовавших в запросе вида INSERT, UPDATE или DELETE к серверу, указанному с помощью идентификтора соединения (link_identifier). Если идентификатор не задан, используется соединение, открытое последним.

Эта команда работает только с операторами, изменяющими записи. Для получения числа записей, возвращаемых оператором SELECT следует использовать функцию sybase_num_rows().

sybase_close -- завершает соединение с Sybase

int sybase_close(int link_identifier);

возвращет: true - в случае успеха, false - в случае ошибки

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

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

Функция sybase_close() не завершает постоянные соединения, открытые с помощью sybase_pconnect().

Смотри также: sybase_connect(), sybase_pconnect().

sybase_connect -- устанавливает соединение с Sybase - сервером

int sybase_connect(string servername, string username, string password);

Возвращает: В случае успеха: идентификатор соединения (положительное число), в противном случае - false.

Функция sybase_connect() устанавливает соединение с Sybase-сервером. Параметр 'servername' должен содержать существующее имя сервера, определенное в файле 'interfaces'.

Если функция sybase_connect() будет вызвана повторно с теми же параметрами, то новое соединение не установится, а будет возвращен идентификатор уже открытого соединения.

Соединение с сервером будет закрыто после завершения скрипта или раньше, посредством явного вызова функции sybase_close().

Смотри также: sybase_pconnect(), sybase_close().

sybase_data_seek -- перемещает внутренний указатель записей

int sybase_data_seek(int result_identifier, int row_number);

Возвращает: true -в случае успеха, иначе - false

Функция sybase_data_seek() перемещает внутренний указатель в результирующем наборе записей, заданном с помощью идентификатора result_identifier, на строку с номером row_number. При последующем вызове функции sybase_fetch_row() будет извлечена эта строка.

Смотри также: sybase_data_seek().

sybase_fetch_array -- извлекает строку в виде массива

int sybase_fetch_array(int result);

Возвращает: Массив, содержащий извлеченную из набора данных строку или false - если строк больше нет.

Функция sybase_fetch_array() является расширенной версией функции sybase_fetch_row(). Доступ к элементам массива возможен не только по номерам , но и по именам столбцов таблицы.

Необходимо отметить, что функция sybase_fetch_array() работат НЕ намного МЕДЛЕННЕЕ, чем sybase_fetch_row(), и предоставляет дополнительные возможности по сравнению с последней.

Подробнее смотри также sybase_fetch_row()

sybase_fetch_field --получает информацию о столбце из набора данных

object sybase_fetch_field(int result, int field_offset);

Возвращает объект, содержащий информацию о столбце

Функцию sybase_fetch_field() можно использовать для получения данных о столбцах результирующего набора result. Если смещение (номер) столбца в таблице (field_offset) не указано, то при каждом вызове sybase_fetch_field() будет извлекаться информация о следующем по порядку столбце.

Свойства объекта:

Смотри также sybase_field_seek()

sybase_fetch_object --извлекает строку в виде объекта

int sybase_fetch_object(int result);

Возвращает: Объект, свойства которого соответствуют извлеченной из набора данных строке, или false - если сторк больше нет.

Функция sybase_fetch_object() аналогична sybase_fetch_array() за одним исключением - она возвращает объект, а не массив. Фактически это означает, что доступ к данным осществляется по именам столбцов, а не по их смещению в строке (числовые значения не могут быть именами свойств).

С точки зрения скорости выполнения эта функция идентична sybase_fetch_array(), и работает практически также быстро, как и sybase_fetch_row() (разница в скорости незначительна).

Смотри также: sybase_fetch-array() и sybase_fetch-row().

sybase_fetch_row -- получает строку в виде пронумерованного массива

array sybase_fetch_row(int result);

Возвращает: Массив, соответствующий извлеченной строку, или false - если строк больше нет.

Функция sybase_fetch_row() извлекает строку данных из результирующего набора, заданного идентификатором result .Строка возвращается в виде массива. Каждый столбец хранится в виде элемента массива. Нумерация элементов начинается с 0.

Последующий вызов функции sybase_fetch_rows() вернет следующую строку запроса, или false, если строк больше нет.

Смотри также: sybase_fetch_array(), sybase_fetch_object(), sybase_data_seek(), sybase_fetch_lengths() и sybase_result().

sybase_field_seek -- указывает смещение (номер) столбца в строке

int sybase_field_seek(int result, int field_offset);

Переходит к указанному столбцу. Если при следующем вызове sybase_fetch_field() не будет указан конкретный номер столбца, то будет возвращен этот столбец.

Смотри также: sybase_fetch_field().

sybase_free_result --освобождает память, занятую результирующим набором данных

int sybase_free_result(int result);

Функцию sybase_free_result() следует вызывать, только если вы хотите уменьшить объем используемой памяти во время выполнения скрипта. Все занимаемая память будет автоматически освобождена после завершения скрипта. Вы можете вызвать sybase_free_result() с идентификатором result в качестве параметра, и содержащая результаты выполнения этого запроса память будет освобождена.

sybase_num_fields -- получает число столбцов в результирующем наборе данных

int sybase_num_fields(int result);

sybase_num_fields() возвращает число столбцов в результирующем наборе

Смотри также: sybase_db_query(), sybase_query(), sybase_fetch_field(), sybase_num_rows().

sybase_num_rows -- получает число столбцов в результирующем наборе данных

int sybase_num_rows(string result);

sybase_num_rows() rвозвращает число строк в результирующем наборе

Смотри также: sybase_db_query(), sybase_query() и sybase_fetch_row().

sybase_pconnect -- открывает постоянное соединение с Sybase-сервером

int sybase_pconnect(string servername, string username, string password);

Возвращает: Идентификатор соединения с Sybase-сервером (положительное число) или false в случае ошибки

Функция sybase_pconnect() выполняется практически аналогично sybase_connect() с двумя главными отличиями:

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

Во-вторых, соединение с SQL-сервером не завершается после выполнения скрипта. Вместо этого, оно остается открытым для последующего использования. (Функция sybase_close() не закрывает соединения, установленные с помощью sybase_pconnect()).

Поэтому этот тип соединений называется 'постоянным'.

sybase_query -- посылает запрос на Sybase-сервер

int sybase_query(string query, int link_identifier);

Возвращает: в случае успеха- идентификатор результирующего набора данных (положительное число), или false- в случае ошибки.

Функция sybase_query() посылает запрос к текущей открытой базе данных на сервере, заданном иденитификатором link_identifier. Если этот идентификатор не указан, то используется соединение, открытое последним. Если нет ни одного соединения, то функция пытается установить новое ( как если бы была вызвана sybase_connect()), и затем его использовать.

Смотри также: sybase_db_query(), sybase_select_db() и sybase_connect().

sybase_result --получает результирующие данные

int sybase_result(int result, int i, mixed field);

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

Функция sybase_result() возвращает содержимое одной ячейки данных из результирующего набора Sybase. В качестве параметра field может быть указано смещение (номер) столбца, его имя или имя столбца и имя таблицы, указанные через точку. (имя_столбца.имя_таблицы). Если для столбца был указан псевдоним ('select foo as bar from...'), то вместо имени столбца следует использовать этот псевдоним.

При работе с большими наборами данных следует использовать функции (перечисленные ниже), которые извлекают из таблицы всю строку целиком. Поскольку эти функции за один вызов возвращают несколько ячеек данных, они работают ГОРАЗДО быстрее, чем sybase_result(). Кроме того, надо отметить, что скорость выполнения будет гораздо выше, если указывать числовое смещение столбца, а не параметр вида имя_столбца.имя_таблицы.

Рекомендуемые высокопроизводительные альтернативные функции: sybase_fetch_row(), sybase_fetch_array() и sybase_fetch_object().

sybase_select_db -- выбирает базу данных Sybase

int sybase_select_db(string database_name, int link_identifier);

Возвращает: true - в случае успеха, false - в случае ошибки

Функция sybase_select_db() устаналивает активную базу данных на сервере, заданном идентификатором link_identifier. Если это идентификатор не указан, то используется соединение, открытое последним. Если нет открытых соединений, то функция попытается установить новое (как если бы была вызвана sybase_connect()) и затем его использовать.

Все последующие вызовы sybase_query() будут работать с данной активной базой данных.

Смотри также: sybase_connect(), sybase_pconnect() и sybase_query()

Открывает сокетное соединение с доменом Internet по адресу hostname на порт port и возвращает файловый указатель, который может использоваться функциями fgets(), fgetss() , fputs() , и fclose() . Если вызов завершается неудачей, он возвращает FALSE и если указаны дополнительные аргументы errno и errstr , то они будут использованы, чтобы указать фактическую системную ошибку, которая случилась на системном уровне при вызове connect(). Если возвращенное errno - 0, но функция вернула FALSE, это - признак того, что ошибка произошла перед вызовом connect(). Это наиболее вероятно, из-за проблемы инициализации сокета. Имейте в виду, что аргументы errno и errstr необязательно должны упоминаться.

Если port - 0 и ОС поддерживает доменные сокеты Unix (domain sockets), hostname будет использован для подключения в качестве filename доменного сокета Unix.

По умолчанию сокет откроется в режиме blocking mode. Вы можете переключить его в non-blocking mode используя set_socket_blocking().

Пример 1. fsockopen example $fp = fsockopen("www.php.net", 80, &$errno, &$errstr); if(!$fp) { echo "$errstr ($errno)<br>n"; } else { fputs($fp,"GET / HTTP/1.0nn"); while(!feof($fp)) { echo fgets($fp,128); } fclose($fp); }

Если mode отсутствует, данный дескриптор сокета переключится на non-blocking режим, а если присутствует, то переключится на blocking режим. Это влияет на вызовы типа fgets(), который читает из сокета. В non-blocking режиме fgets() вызов всегда будет возвращаться немедленно, в то время как в blocking режиме он ждет данные, чтобы стать доступным на сокете.

Возвращает имя хоста Internet определенного аргументом ip_address . Если происходит ошибка, возвращается ip_address .

См. также gethostbyname() .

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

См. также gethostbyaddr() .

Возвращает список IP-адресов на которых разрешен хост Internet, указанный аргументом hostname.

См. также gethostbyname() , gethostbyaddr() , checkdnsrr() , getmxrr()

Ищет в DNS записи типа type, соответствующие аргументу host. Возвращает true, если обнаруживаются какие-либо записи ; Возвращает false, если не обнаружены никакие записи или если произошла ошибка.

type может быть любым из значений: A, MX, NS, SOA, PTR, CNAME, или ANY. По умолчанию - MX.

host может или быть адресом IP или именем хоста.

См. также getmxrr() , gethostbyaddr() , gethostbyname() , gethostbynamel()

Ищет в DNS MX-записи, соответствующие hostname. Возвращает true если записи найдены; возвращает false если записей не найдено или произошла ошибка.

Список MX-записей может размещаться в массиве mxhosts. Если задано weight массива, то он может быть заполнен собранной информацией.

См. также checkdnsrr() , gethostbyname() , gethostbynamel() , gethostbyaddr()

openlog() открывает для программы соединение c system logger . Строка ident добавляется к каждому сообщению. Значение для option и facility даются в следующем разделе. Использование openlog() не обязательно; Это может быть автоматически вызвано вызовом syslog() если необходимо, в этом случае ident по умолчанию будет false. См. также syslog() и closelog() .

syslog() генерирует регистрационное сообщение, для system logger. priority - комбинация легкости и уровня, значения для которых даются в следующем разделе. А другой аргумент является отсылаемым сообщением, кроме того, два символа %m заменятся строкой сообщения ошибки (strerror) соответствующей значению errno.

Больше информации о средствах syslog можно обнаружить на man-страницах для syslog в Unix-системах.

В WindowsNT, сервис syslog эмулируется использованием Event Log.

closelog() закрывает дескриптор, используемый для записи в system logger. Использование closelog() необязательно.

Разрешает внутренний PHP отладчик, соединяя его на address . Отладчик находится в стадии разработки.

Запрещает внутренний PHP отладчик. Отладчик находится в стадии разработки.

Без параметра OnOff эта функция возвращает статус автофиксирования для connection_id . True возвращается, если автофиксирование включено, false если оно выключено или если произошли ошибки.

Если параметр OnOff установлен в true, то автофиксирование включено, если параметр установлен в ложь, то автофиксирование отключено. True возвращается при успешном завершении, false - при ошибке.

По умолчанию автофиксирование включено для соединения. Отключение автофиксирования эквивалентно началу транзакции.

См. также odbc_commit() и odbc_rollback() .

(ODBC SQL types affected: BINARY, VARBINARY, LONGVARBINARY)

ODBC_BINMODE_PASSTHRU: Передает двоичные данные

ODBC_BINMODE_RETURN: Возвращает как есть

ODBC_BINMODE_CONVERT: Конвертирует в символьный вид и возвращает значение

Когда двоичные данные SQL конвертируются в символьные данные C, каждый байт (8 битов) исходных данных представляется как два ASCII символа. Эти символы являются ASCII-представлением числа в шестнадцатиричной форме. Например, двоичное 00000001 конвертируется в "01" и двоичное 11111111 конвертируется в "FF" .

Таблица 1. Обработка данных типа LONGVARBINARY

Если была использована функция odbc_fetch_into() , то передача означает, что для этих полей будет возвращена пустая строка.

Если result_id равен 0 , то установки принимаются по умолчанию для новых результатов.

Замечание: По умолчанию для longreadlen установлено 4096 и binmode по умолчанию - ODBC_BINMODE_RETURN . Обработка двоичных данных типа LONG также осуществляется odbc_longreadlen()

odbc_close() закрывает соединение с сервером баз данных, связанное с указанным идентификатором соединения.

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

odbc_close_all() закрывает все соединения с сервером(серверами) баз данных.

Замечание: Эта функция выдаст ошибку, если у этих соединений есть незавершенные транзакции. В этом случае соединения останутся открытыми.

Возвращает: true при успехе, false при ошибке. Все незаконченные транзакции на connection_id фиксируются.

возвращает идентификатор ODBC-соединения или 0 ( false ) при ошибке.

Идентификатор соединения, возвращаемый этой функцией, запрашивается другими ODBC функциями. Вы можете иметь несколько соединений открытых одновременно. Для постоянных соединений см. odbc_pconnect() .

odbc_cursor возвращает имя курсора для указанного result_id.

odbc_do запускает запрос на указанном соединении

Возвращает false при ошибке. Возвращает ODBC-идентификатор результата, если SQL команда была запущена успешно.

odbc_exec() посылает SQL-запрос серверу баз данных, определенному параметром connection_id . Этот параметр должен быть правильным идентификатором, возвращенным функцией odbc_connect() or odbc_pconnect() .

См. также: odbc_prepare() and odbc_execute() для многократных запусков SQL-запросов.

Запускает SQL-запрос, подготовленный функцией odbc_prepare() . Возвращает true при успешном запуске, false о обратном случае. Массив arameters_array необходим только если вы действительно имеете параметры в вашем SQL-запросе.

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

Если odbc_fetch_row() прошла успешно (строка существовала), то будет возвращено true . Если больше строк нет, то будет возвращеноfalse.

odbc_fetch_row() Извлекает строку из данных, возвращенных функцией odbc_do() / odbc_exec() . После вызова odbc_fetch_row() , доступ к полям той строки может быть осуществлен с помощью функции odbc_result() .

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

Для использования результата более одного раза, вы можете вызвать odbc_fetch_row() с row_number 1, и затем продолжить выполнять odbc_fetch_row() без row_number для просмотра результата. Если драйвер не поддерживает извлечение строк по номеру, то параметр row_number игонорируется.

odbc_field_name() возвращает имя поля в соответствии с указанным номером столбца в указанном ODBC-идентификаторе результата. Номера полей начинаются с 1. false возвращается при ошибке.

odbc_field_type() возвращает SQL тип поля в соответствии с номером в указанном ODBC-идентификаторе результата. Номера полей начинаются с 1.

odbc_field_type() возвращает длину поля в соответствии с номером в указанном ODBC-идентификаторе результата. Номера строк начинаются с 1.

Всегда возвращает true.

odbc_free_result() необходимо вызывать только если вы беспокоитесь об использовании большого количества памяти во время запуска вашего скрипта. Вся память результата будет автоматически освобождена при завершении скрипта. Но, если вы уверены, что больше нигде в скрипте не будете использовать данные результата, то вы можете вызвать odbc_free_result() , и память, связанная с параметром result_id будет освобождена.

Замечание: Если автофиксирование отключено (см. odbc_autocommit() ) вы можете вызвать odbc_free_result() и перед фиксированием все незавершенные транзакции будут откатаны назад.

(Обрабатываемые ODBC SQL типы : LONG, LONGVARBINARY) Число байтов, возвращенных PHP, контролируется длиной параметра. Если она установлена в 0, то данные типа Long передаются клиенту.

Замечание: Обработка полей типа LONGVARBINARY также осуществляется odbc_binmode()

odbc_num_fields() возвращает число полей (столбцов) в результате ODBC. Эта функция вернет -1 при ошибке. Аргумент является правильным результирующим идентификатором, возвращенным odbc_exec() .

Возвращает идентификатор ODBC соединения или 0 ( false ) при ошибке. Эта функция очень похожа на odbc_connect() , кроме того, что соединение в действительности не закрывается после завершения скрипта. Будующие запросы на соединение с той же комбинацией параметров dsn , user , password (через odbc_connect() и odbc_pconnect() ) могут повторно использовать постоянное соединение.

Замечание: Постоянные соединения не действуют, если PHP используется как CGI программа.

Для подробной информации о постоянных соединениях см. PHP3 FAQ.

Возвращает false при ошибке.

Возвращает ODBC-идентификатор результата, если SQL команда была подготовлена успешно. Идентификатор результата может быть использован для последеющего запуска запроса с помощью odbc_execute() .

odbc_num_rows() возвращает число строк в ODBC результате. Эта функция вернет -1 при ошибке. Для команд INSERT, UPDATE и DELETE odbc_num_rows() вернет число обработанных строк. Для случая SELECT это может быть число доступных строк.

Замечание: Использование odbc_num_rows() для определения числа строк, доступных после SELECT вернет -1 у многих драйверов.

Возвращает содержимое поля.

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

Первый вызов odbc_result() вернет значение третьего поля в текущей записи результата запроса. Второй вызов функции odbc_result() возвратит значение поля, имя которого "val" в текущей записи результата запроса. Ошибка возникнет, если параметр номера столбца для поля меньше, чем один или более номеров столбцов (или полей) в текущей записи. Так же ошибка возникнет, если запрашивается поле с именем, не совпадающем с именами полей в запрашиваемой таблице (таблицах).

Номера полей начинаются с 1. Field indices start from 1. Относительно способа возврата двоичных данных и данных типа LONG см. функции odbc_binmode () and odbc_longreadlen() .

Возвращает число строк в результате или false при ошибке.

odbc_result_all() выдает все строки из идентификатора результата, полученного от odbc_exec() . Результат выдается в формате HTML таблицы. С дополнительным строковым аргументом format , может быть осуществлено дополнительное форматирование таблицы.

Откатавает все незаконченные запросы на connection_id . Возвращает true при успехе, false при ошибке.

Вы можете использовать функции PDF для создания pdf файлов, если вы имеете библиотеку PDF (доступную на http://www.ifconnection.de/~tm/ ) Томаса Мерза. Пожалуйста, используйте документацию для библиотеки pdflib, поставляемой с исходным кодом или доступной на http://www.ifconnection.de/~tm/software/pdflib/PDFlib-0.6.pdf . Так как эта документация является не полной, документация библиотека pdflib должна быть просмотрена в первую очередь. Функции в бибилотеке pdflib и в php3 имеют одинаковые имена. Параметры также идентичны. Вам следует также понимать некоторые концепции pdf для еффективного применения этого модуля. Модуль pdf использует два новых типа переменных. Они называются pdfdoc и pdfinfo .

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

Пример 1. PDF_get_info <?php $info = PDF_get_info(); PDF_set_info_creator($info, "Name of Author") ?>

См. также PDF_set_info_creator() , PDF_set_info_subject() .

Функция PDF_set_info_creator() устанавливает создателя pdf документа. Она должна вызываться после PDF_get_info() и перед PDF_open() . Вызов функции после PDF_open() на даст никакого эффекта в документе.

Замечание: Эта функция не является частью библиотеки pdf.

См. также PDF_get_info() , PDF_set_info_subject() .

Функция PDF_set_info_title() устанавливает заголовок pdf документа. Она должна вызываться после PDF_get_info() и перед PDF_open() . Вызов функции после PDF_open() не даст никакого эффекта в документе.

Примечание: Эта функция не является частью библиотеки pdf.

См. также PDF_get_info() , PDF_set_info_xxxxx() .

Функция PDF_set_info_subject() устанавливает тему pdf документа. Она должна вызываться после PDF_get_info() и перед PDF_open() . Вызов функции после PDF_open() не даст никакого эффекта в документе.

Замечание: Эта функция не является частью библиотеки pdf.

См. также PDF_get_info() , PDF_set_info_xxxxx() .

Функция PDF_set_info_keywords() устанавливает ключевые слова pdf документа. Она должна вызываться после PDF_get_info() и перед PDF_open() . Вызов функции после PDF_open() не даст никакого эффекта в документе.

Замечание: Эта функция не является частью библиотеки pdf.

См. также PDF_get_info() , PDF_set_info_xxxxx() .

Функция PDF_set_info_author() устанавливает автора pdf документа. Она должна вызываться после PDF_get_info() и перед PDF_open() . Вызов функции после PDF_open() не даст никакого эффекта в документе.

Замечание: Эта функция не является частью библиотеки pdf.

См. также PDF_get_info() , PDF_set_info_xxxxx() .

Функция PDF_set_info_author() открывает новый pdf документ. Соответствующий файл должен быть открыт функцией fopen() и дескриптор файла использоваться как аргумент file . info является информационной структурой, которая должна быть создана функцией pdf_get_info() .

Замечание: Возвращаемое значение необходимо как первый параметр у всех функций записи в pdf документ.

См. также fopen() , PDF_get_info() .

Функция PDF_close() закрывает pdf документ int .

Замечание: Функция не закроет файл. Вам неоходимо вызвать отдельно функцию fclose() после pdf_close() .

См. также PDF_open() , fclose().

Функция PDF_begin_page() начинает новую страницу высотой height и шириной width .

См. также PDF_end_page().

Функция PDF_end_page() завершает страницу.

См. также PDF_end_page() .

Функция PDF_show() выводит строку text в текущей позиции.

См. также PDF_show_xy() , PDF_set_text_pos() .

Функция PDF_show_xy() выводит строку text в позиции с координатами ( x-koor , y-koor ).

См. также PDF_show() .

Функция PDF_set_font() устанавливает текущий шрифт, его размер и кодировку. Вам потребуется указать Adobe Font Metrics (afm-файлы) для шрифта в пути шрифта (по умолчанию ./fonts).

См. также PDF_info() .

Функция PDF_set_leading() устанавливает промежуток между строками текста. Он будет использоваться при выводе текста функцией PDF_continue_text() .

См. также PDF_continue_text() .

Функция PDF_set_text_rendering() определяет, как текст отрисовывается. Возможные значения для параметра mode это 0=заливка текста, 1=контурный текст, 2=контурный текст с заливкой, 3=невидимый текст, 4=заливка текста и добавление его в контур обреза, 5=контурный текст с добалением в контур обреза, 6=контурный текст с заливкой и с добавлением к контур обреза, 7=добавление текста в контур обреза.

Функция PDF_set_horiz_scaling() устанавливает горизонтальное масштабирование в scale процентов.

Функция PDF_set_text_rise() устанавливает увеличение текста на value едениц.

Функция PDF_set_text_matrix() уставливает матрицу, которая описывает изменения, применяемые к текущему шрифту текста.

Функция PDF_set_text_pos() устанавливает позицию текста для следующего вызова функции pdf_show() .

См. также PDF_show() , PDF_show_xy() .

Функция PDF_set_char_spacing() устанавливает промежутки между символами.

См. также PDF_set_word_spacing() , PDF_set_text_leading() .

Функция PDF_set_word_spacing() устанавливает промежутки между словами.

См. также PDF_set_char_spacing() , PDF_set_text_leading() .

Функция PDF_continue_text() выводит строку из text на следующей строке.

См. также PDF_show_xy() , PDF_set_text_leading() , PDF_set_text_pos() .

Функция PDF_stringwidth() возвращает ширину строки в text . Этой функции необходим заранее установленный шрифт.

См. также PDF_set_font() .

Функция PDF_save() сохраняет текущее окружение. Она работает как postscript-команда gsave. Функция очень полезна при переводе или вращении объекта без затрагивания других объектов.

См. также PDF_restore() .

Функция PDF_restore() восстанавливает окружение сохраненное функцией PDF_save() . Она работает postscript-команда grestore. Функция очень полезна при переводе или вращении объекта без затрагивания других объектов.

Example 1. PDF_get_info <?php PDF_save($pdf); // делает все виды вращений, трансформаций... PDF_restore($pdf) ?>

См. также PDF_save() .

Функция PDF_translate() устанавливает начало системы координат в точке ( x-koor , y-koor ).

Функция PDF_scale() устанавливает масштабный коэффициент для обоих осей.

Функция PDF_rotate() Устанавливает вращение в процентах на угол angle .

Функция PDF_setflat() устанавливает плоскость на величину от 0 до 100.

Функция PDF_setlinejoin() устанавливает параметр слияния линий между от 0 до 2.

Функция PDF_setlinecap() устанавливает параметр формата строки от 0 до 2.

Функция PDF_setmiterlimit() устанавливает минимальную границу больше или равную 1.

Функция PDF_setlinewidth() устанавливает ширину width линии.

Функция PDF_setdash() устанавливает шаблон тире, где white - еденицы белого и black - еденицы черного. Если они оба равны 0, то устанавливается сплошная линия.

Функция PDF_moveto() устаналивает текущую точку в координатах x-koor и y-koor .

Функция PDF_curveto() рисует кривую Безье с текущей тоски до точки с координатами ( x3 , y3 ) используя ( x1 , y1 ) и ( x2 , y2 ) как управляющие точки.

См. также PDF_moveto() , PDF_lineto() .

Функция PDF_lineto() рисует линию с текущей точки до точки с координатами ( x-koor , y-koor ).

См. также PDF_moveto() , PDF_curveto() .

Функция PDF_circle() рисует круг с центром в точке ( x-koor , y-koor ) и радиусом radius .

См. также PDF_arc() .

Функция PDF_arc() рисует дугу с центром в точке с координатами ( x-koor , y-koor ) и радиусом radius , начинает с угла start и заканчивает углом end .

См. также PDF_circle() .

Функция PDF_rect() Рисует прямоугольник с нижним левым углом в точке ( x-koor , y-koor ). Ширина определяется параметром widgth . Высота определяется параметром height .

Функция PDF_closepath() закрывает текущий контур.

Функция PDF_stroke() рисует линию вдоль текущего контура.

См. также PDF_closepath() , PDF_closepath_stroke() .

Функция PDF_closepath_stroke() является сочетанием функций PDF_closepath() и PDF_stroke() . Затем контур сбрасывается.

См. также PDF_closepath() , PDF_stroke() .

Функция PDF_fill() заполняет область текущего контура текущим цветом заполнения.

См. также PDF_closepath() , PDF_stroke() , PDF_setgray_fill() , PDF_setgray() , PDF_setrgbcolor_fill() , PDF_setrgbcolor() .

Функция PDF_fill_stroke() заполняет область текущего контура текущим цветом заполнения и рисует текущий контур.

См. также PDF_closepath() , PDF_stroke() , PDF_fill() , PDF_setgray_fill() , PDF_setgray() , PDF_setrgbcolor_fill() , PDF_setrgbcolor() .

Функция PDF_closepath_fill_stroke() закрывает, заполняет область текущего контура текущим цветом заполнения и рисует текущий контур.

См. также PDF_closepath() , PDF_stroke() , PDF_fill() , PDF_setgray_fill() , PDF_setgray() , PDF_setrgbcolor_fill() , PDF_setrgbcolor() .

Функция PDF_endpath() заканчивает текущий контур, но не закрывает его.

См. также PDF_closepath() .

Функция PDF_clip() прекращает рисование в текущем контуре.

Функция PDF_setgray_fill() делает текущим серый цвет для заполнения контура.

См. также PDF_setrgbcolor_fill() .

Функция PDF_setgray_stroke() далает текущий цвет рисования серым.

См. также PDF_setrgbcolor_stroke() .

Функция PDF_setgray_stroke() делает текущие цвет рисования и заполнения серым.

См. также PDF_setrgbcolor_stroke() , PDF_setrgbcolor_fill() .

Функция PDF_setrgbcolor_fill() делает текущим RGB цвет для заполнения контура.

См. также PDF_setrgbcolor_fill() .

Функция PDF_setrgbcolor_stroke() делает текущим RGB цвет рисования.

См. также PDF_setrgbcolor_stroke() .

Функция PDF_setrgbcolor_stroke() делает текущим RGB цвет рисования и заполнения.

См. также PDF_setrgbcolor_stroke() , PDF_setrgbcolor_fill() .

Функция PDF_add_outline() добавляет закладку с текстом text , которая указывает на текущую страницу.

Функция PDF_set_transition() устанавливает переход между указанными следующими страницами. Значения параметра transition могут быть 0 для никакого перехода, 1 для двух линий, проходящих через экран, открывая страницу, 2 для нескольких линий, проходящих через экран, открывая страницу, 3 для прямоугльника, открывающего страницу, 4 для одной линии, проходящей через экран, открывая страницу, 5 для растворения старой страницы, открывая новую, 6 для эффекта растворения, перемещяющегося от одного края экрана, к другому, 7 для простой смены старой страницы новой (по умолчанию).

Функция PDF_set_duration() устанавливает паузу между следующими страницами в секундах.

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

Поддержка разделяемой памяти также включена. Она совместима с System V - совместимыми системами.

Возвращает положительный индентификатор семафора при успехе или false при ошибке.

sem_get() возвращает идентификатор, который может быть использован для доступа к семафору System V с указанным ключом. Семафор создается, если необходимо, используя биты доступа, указанные в perm (по умолчанию 0666). Число процессов, которое может быть зафиксировано семафором одновременно устанавливается в max_acquire (по-умолчанию 1). В действительности это значение устанавливается только если процесс обнаруживает, что он является единственным, присоединенным к семафору.

Повторный вызов функции sem_get() с тем же ключем вернет другой идентификатор семафора, но оба идентификатора указывают на один и тот же семафор.

См. также: sem_acquire() and sem_release() .

Возвращает true при успехе, false при ошибке.

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

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

См. также: sem_get() and sem_release() .

Возвращает true при успехе и false при ошибке.

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

После освобождения семафора функция sem_acquire() может быть вызвана для ре-фиксации его.

См. также: sem_get() and sem_acquire() .

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

Отсоединяет от разделяемой памяти с указанным id , созданным с помощью функции shm_attach() . Помните, что разделяемая память все еще существует в Unix-системе и данные все еще присутствуют.

Вставляет или обновляет переменную с указанным variable_key. Все типы переменных (double, long, string, array) поддерживаются. Функция serialize() может быть использована для хранения данных.

Считывает переменную с указанным variable_key . Переменная все еще присутствует в разделяемой памяти. Функция unserialize() может быть использована для декодирования данных.

Удаляет переменную с указанным variable_key из разделяемой памяти.

Удаляет разделяемую память из Unix-системы. Все данные будут уничтожены.

Solid (надежные) функции являются предопределенными, поэтому вместо них вы вероятно захотите использовать Универсальные ODBC функции.

См. odbc_close().

См. odbc_connect().

См. odbc_exec().

См. odbc_fetch_row()

См. odbc_field_name().

См. odbc_field_num().

См. odbc_free_result().

См. odbc_num_fields().

См. odbc_num_rows().

См. odbc_result().

Для использование функций SNMP в системе UNIX вам необходимо установить набор ucd-snmp. Ссылка на последнюю версию есть в PHP FAQ. В системе Windows эти функции доступны только в NT и не доступны в Win95/98.

Возвращает значание SNMP объекта при успехе и false при ошибке.

Функция snmpget() используется для чтения значения SNMP объекта, указанного в object_id. SNMP агент определяется именем хоста hostname и группа чтения определяется параметром community.

snmpget("127.0.0.1", "public", "system.SysContact.0")

Возвращает массив значений SNMP объектов начиная с object_id и false при ошибке.

Функция snmpwalk() используется для чтения всех значений у SNMP агента, определяемого параметром hostname. Community определяет группу чтения для агента. Нулевой object_id берется как корень дерева SNMP объектов и все объекты под этим деревом возвращаются как массив. Если object_id указан, то возвращаются все SNMP объекты ниже этого объекта.

Указанный выше вызов функции вернет все SNMP объекты из SNMP агента, напущенного на локальном хосте. По всем значениям можно пройти с помощью цикла

Эти функции требуют пакетов QMAIL (www.qmail.org) и vmailmgr Bruce Guenter http://www.qcc.sk.ca/~bguenter/distrib/vmailmgr/

Для всех функций следующие две переменные определяются как: строка vdomain - имя домена вашего виртуального домена (vdomain.com) , строка basepwd - пароль для 'real' пользователя, который поддерживает виртуальных пользователей.

Только до 8 символов распознаются в пароле для виртуальных пользователей

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

Известные проблемы: vm_deluser() не удаляет директорию пользователя, хотя должена это делать. vm_addalias() в настоящее время не работает правильно.

Добавляет нового виртуального пользователя с паролем. newusername - это имя почтового login-а и newuserpassword - это пароль для это пользователя.

Добавляет псевдоним виртуальному пользователю. username - это имя почтового login-а и alias - это псевдоним для этого пользователя.

Изменяет пароль виртуальных пользователей. username - это имя почтового login-а, password - старый пароль пользователя, и newpassword - новый пароль.

Удаляет псевдоним.

Удаляет виртуального пользователя.

Этот модуль использует функции библиотеки zlib >= 1.0.9 (http://www.cdrom.com/pub/infozip/zlib/) авторов Jean-loup Gailly и Mark Adler для прозрачного чтения и записи в gzip (.gz) сжатые файлы.

Закрывает gz-файл, указанный в переменной gz.

Возвращает true при успехе и false при ошибке.

Указатель gz-файла должен быть правильным, и должен указывать на файл, успешно открытый функцией gzopen().

Возвращает true, если указатель gz-файла на метке EOF или произошла ошибка, в обратном случае возвращает false.

Указатель gz-файла должен быть правильным, и должен указывать на файл, успешно открытый функцией gzopen().

Функция идентична readgzfile(), кроме того, что gzfile() возвращает файл в массив.

См. также readgzfile(), и gzopen().

Возвращает строку, содержащую один (несжатый) символ, читаемый из файла, определяемого переменной zp. Возвращает FALSE при достижении EOF (как это делает gzeof()).

Указатель gz-файла должен быть правильным, и должен указывать на файл, успешно открытый функцией gzopen().

См. также gzopen(), и gzgets().

Возвращает строку (не сжатую) длиной от начала файла до length-1 из файла , определяемого zp. Чтение заканчивается при достижении длины length-1, при начале новой строки или при EOF (что произойдет раньше).

При ошибке возвращает false.

Указатель gz-файла должен быть правильным, и должен указывать на файл, успешно открытый функцией gzopen().

См. также gzopen(), и gzgetc().

Идентична gzgets(), кроме того, что gzgetss пытается обрезать любые HTML и PHP теги из считываемого текста.

См. также gzgets(), и gzopen().

Открывает gzip (.gz) файл для чтения или записи. Параметр режима такой же как и у fopen() ("rb" или "wb"), но также может включать степень сжатия ("wb9"), или стратегию: 'f' для фильтрованных данных как в "wb6f", 'h' для компрессии только по Хаффману как в "wb1h" (См. описание deflateInit2 в zlib.h для более подробной информации и параметрах стратегии).

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

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

При ошибке в открытии файла функция вернет false.

Пример 1. gzopen() $fp = gzopen("/tmp/file.gz", "r");

См. также gzclose().

Считывает все до EOF указателя gz-файла и выводит прочитанные данные (несжатые) в стандартный вывод.

Если произойдет ошибка, то функция вернет false.

Указатель gz-файла должен быть правильным, и должен указывать на файл, успешно открытый функцией gzopen().

gz-файл будет закрыт, когда gzpassthru() закончит его считывать (оставляя zp возможным для использования).

gzputs() является псевдонимом для функции gzwrite(), и полностью ей идентична.

gzread() читает length байтов из указателя gz-файла, определяемого zp. Чтение прекращается когда length байтов (несжатых) считываются или достигается EOF (что произойдет раньше).

// считывание содержимого gz-файла в строку $filename = "/usr/local/something.txt.gz"; $zd = gzopen( $filename, "r" ); $contents = gzread( $zd, 10000 ); gzclose( $zd );

См. также gzwrite(), gzopen(), gzgets(), gzgetss(), gzfile(), и gzpassthru().

Устанавливает индикатор позиции файла для zp на начало файлового потока.

При ошибке функция вернет 0.

Указатель gz-файла должен быть правильным, и должен указывать на файл, успешно открытый функцией gzopen().

См. также gzseek() and gztell().

Сдвигает индикатор позиции файла, определяемого параметром zp, на offset в файловом потоке. Еквивалентна вызову (в С) функции gzseek( zp, offset, SEEK_SET ).

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

В случае успеха функция возвращает 0, в обратном случае - 1. Следует отметить, что достижение EOF не рассматривается как ошибка.

См. также gztell() and gzrewind().

Возвращает позицию указателя файла, определяемого параметром zp, т.е. его положение в файловом потоке.

При ошибке возвращается false.

Указатель gz-файла должен быть правильным, и должен указывать на файл, успешно открытый функцией gzopen().

См. также gzopen(), gzseek() and gzrewind().

Считывает файл, распаковывает его и выводит в стандартный поток вывода.

Readgzfile() может использоваться для чтения файла, который не в формате gzip. В этом случае readgzfile() будет сразу считывать файл, без докомпрессии.

Функция возвращает число байтов (несжатых), считанных из файла. При ошибке возвращается false и, если функция не вызывалась как @readgzfile, будет выведено сообщение об ошибке.

Файл с именем filename будет открыт в файловой системе и его содержимое будет выведено в стандартный поток вывода.

См. также gzpassthru(), gzfile(), и gzopen().

gzwrite() записывает содержимое строки string в поток gz-файла, определяемый параметром zp. Если параметр length указан, то запись будет прекращена после того, как length байтов (несжатых) будет записано или будет достигнут конец строки string, что раньше произойдет.

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

См. также gzread(), gzopen(), and gzputs().