Учебник РНР
НазадВперёд

ifx_free_result

(PHP 3>= 3.0.3, PHP 4)

ifx_free_result - освобождает ресурсы запроса.

Описание

int ifx_free_result (int result_id)

Освобождает ресурсы, выделенные запросу, ассоциированному с result_id. Возвращает FALSE при ошибке.


Назад Оглавление Вперёд
ifx_free_char Вверхifx_get_blob
Hosted by uCoz
8528 107187924 8528 107190934 bindtextdomain
Учебник РНР
Назад Вперёд

bindtextdomain

(PHP 3>= 3.0.7, PHP 4)

bindtextdomain - устанавливает путь домена.

Описание

string bindtextdomain (string domain, string directory)

Функция bindtextdomain() устанавливает путь к домену.


Назад Оглавление Вперёд
bind_textdomain_codeset Вверх dcgettext
Hosted by uCoz
8528 107179125 8528 107190934 Поддержка Файлов Инициализации
Учебник РНР
Назад Вперёд

Глава 40. Поддержка файлов инициализации

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

При создании раздела .ini в вашем собственном модуле используйте макрос PHP_INI_BEGIN() для маркировки начала такого раздела и макрос PHP_INI_END() - для маркировки его конца. Между ними вы можете использовать PHP_INI_ENTRY() для создания вхождений.
PHP_INI_BEGIN()
    PHP_INI_ENTRY("first_ini_entry",  "has_string_value", PHP_INI_ALL, NULL)
    PHP_INI_ENTRY("second_ini_entry", "2",                PHP_INI_SYSTEM, OnChangeSecond)
    PHP_INI_ENTRY("third_ini_entry",  "xyz",              PHP_INI_USER, NULL)
PHP_INI_END()

Макрос PHP_INI_ENTRY() принимает 4 параметра: имя вхождения/entry name, значение вхождения/entry value, изменение прав доступа и указатель на обработчик изменения уведомления. Имя и значение вхождения обязаны быть специфицированы как строки, независимо от того, являются они в действительности строками или целыми числами.

Права доступа сгруппированы в три раздела: PHP_INI_SYSTEM позволяет вносить изменения только непосредственно в файле php3.ini; PHP_INI_USER позволяет пользователю переопределять изменения на этапе прогона с использованием дополнительных файлов конфигурации, таких как .htaccess;
а PHP_INI_ALL позволяет делать изменения без ограничений.
Имеется также четвёртый уровень, PHP_INI_PERDIR, поведение которого ещё не проверено.

Четвёртый параметр состоит из указателя на обработчик change-notification/изменения уведомления. При изменении любого из этих вхождений вызывается этот обработчик. Такой обработчик может быть объявлен с использованием макроса PHP_INI_MH:
PHP_INI_MH(OnChangeSecond);             // обработчик для ini-entry "second_ini_entry"

// специфицируйте здесь ini-entries

PHP_INI_MH(OnChangeSecond)
{

    zend_printf("Message caught, our ini entry has been changed to %s<br>", new_value);

    return(SUCCESS);

}

Новое значение даётся обработчику изменения как строка в переменной new_value. Если посмотреть на определение PHP_INI_MH, вы увидите, что должны использовать небольшое количество параметров:

#define PHP_INI_MH(name) int name(php_ini_entry *entry, char *new_value,
                                  uint new_value_length, void *mh_arg1,
                                  void *mh_arg2, void *mh_arg3)

Все эти определения можно найти в php_ini.h. Ваш обработчик сообщений будет иметь доступ к структуре, которая содержит полное вхождение, новое значение, его длину и три необязательных аргумента. Эти необязательные аргументы можно специфицировать дополнительным макросом PHP_INI_ENTRY1 (допускающим один дополнительный аргумент), PHP_INI_ENTRY2 (допускающим два дополнительных аргумента) и PHP_INI_ENTRY3 (допускающим три дополнительных аргумента).

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

Доступ к вхождениям инициализации может также обрабатываться макросами из Таблицы 9.17.

Рисунок 40-1. Таблица 9.17. Макросы для доступа
к вхождениям инициализации в PHP.
МакросОписание
INI_INT(name) Возвращает текущее значение вхождения name как integer (long).
INI_FLT(name)Возвращает текущее значение вхождения name как float (double).
INI_STR(name) Возвращает текущее значение вхождения name как строку. Примечание: Эта строка не дублируется, а указывает на внутренние данные. Последующий доступ требует дублирования в локальную память.
INI_BOOL(name) Возвращает текущее значение вхождения name как Boolean (определённое как zend_bool, что в настоящее время означает unsigned char).
INI_ORIG_INT(name)Возвращает оригинальное значение вхождения name как integer (long).
INI_ORIG_FLT(name) Возвращает оригинальное значение вхождения name как float (double).
INI_ORIG_STR(name)Возвращает оригинальное значение вхождения name как строку. Примечание: Эта строка не дублируется, а указывает на внутренние данные. Последующий доступ требует дублирования в локальную память.
INI_ORIG_BOOL(name)Возвращает оригинальное значение вхождения name как Boolean (определённое как zend_bool, что в настоящее время означает unsigned char).

Наконец, вы должны ввести ваши вхождения инициализации в PHP. Это можно сделать в startup и shutdown-функциях модуля, используя макросы REGISTER_INI_ENTRIES() и UNREGISTER_INI_ENTRIES():
ZEND_MINIT_FUNCTION(mymodule)
{

    REGISTER_INI_ENTRIES();

}

ZEND_MSHUTDOWN_FUNCTION(mymodule)
{

    UNREGISTER_INI_ENTRIES();

}


Назад Оглавление Вперёд
Вызов пользовательских функций ВверхЧто дальше?
Hosted by uCoz
8528 107119000 8528 107190934 8528 107184347 8528 107190934 extends
Учебник РНР
Назад Глава 13. Классы и Объекты Вперёд

extends

Часто бывает нужно использовать классы с аналогичными переменными и функциями в другом существующем классе. На практике было бы удобно определять общий/generic класс, который можно было бы использовать во всех ваших проектах и адаптировать этот класс для нужд каждого конкретного проекта. Для облегчения этого процесса классы могут быть расширениями других классов. Расширяющий класс имеет все переменные и функции базового класса (это называется 'наследование/inheritance', хотя никто не умер...) и то, что вы добавили в расширенном определении. Из наследуемого класса невозможно ничего изъять, то есть разопределить любую существующую функцию или переменную. Расширяющий класс всегда зависит от единственного базового класса, то есть множественное наследование не поддерживается. Классы расширяются при помощи ключевого слова 'extends'.

class Named_Cart extends Cart
{
    var $owner;
  
    function set_owner ($name)
    {
        $this->owner = $name;
    }
}

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

$ncart = new Named_Cart;    // создаём named cart
$ncart->set_owner("kris");  // именуем cart
print $ncart->owner;        // печатаем имя владельца cart
$ncart->add_item("10", 1);  // (функциональность, унаследованная от cart)

Это также называется отношениями "parent-child/родитель-потомок". Вы создаёте класс-родитель и используете extends для создания нового класса-потомка на базе класса-предка. Вы можете затем использовать этот новый класс-потомок как базовый для создания ещё одного нового класса.

Примечание: классы обязаны быть определены перед их использованием! Если вы хотите, чтобы класс Named_Cart расширял класс Cart, вы сначала должны определить класс Cart. Если вы хотите создать новый класс Yellow_named_cart на базе класса Named_Cart, вы должны сначала определить Named_Cart. Короче говоря: важен порядок определения классов.


Назад Оглавление Вперёд
Классы и Объекты Вверх Конструкторы
Hosted by uCoz
8528 107187150