|
(PHP 4 >= 4.0.5)
udm_load_ispell_data - загружает ispell-данные.
Описание
int udm_load_ispell_data (int agent, int var, string val1, string val2, int flag)
Возвращает
TRUE
при успехе,
FALSE
при ошибке.
agent
- ссылка на идентификатор агента, полученная вызовом
udm_alloc_agent()
.
var
- параметр, указывающий источник ispell-данных. Может иметь значения, указанные далее.
После использования этой функции, чтобы освободить память, выделенную для ispell-данных,
используйте
udm_free_ispell_data()
, даже если вы применяете режим UDM_ISPELL_TYPE_SERVER.
Самым быстрым режимом является UDM_ISPELL_TYPE_SERVER. UDM_ISPELL_TYPE_TEXT
медленнее, а UDM_ISPELL_TYPE_DB - самый медленный. Вышеприведённый патэрн
TRUE
для
mnoGoSearch 3.1.10 - 3.1.11. Планируется ускорить режим DB в будущих
версиях, и он будет быстрее режима TEXT.
-
UDM_ISPELL_TYPE_DB - указывает, что ispell-данные должны быть загружены
из SQL. В этом случае параметры
val1
и
val2
игнорируются и должны быть оставлены пустыми.
flag
должен быть равен 1.
Примечание:
flag
указывает, что после загрузки ispell-данных из определённого ресурса они
должны быть отсортированы (это необходимо для корректной работы ispell).
При загрузке ispell-данных из файлов может быть несколько вызовов udm_load_ispell_data(), нет смысла сортировать данные после каждого вызова, и сортировка делается
только после последнего вызова. Поскольку в режиме db все данные загружаются одним вызовом,
этот параметр должен иметь значение 1. При ошибке в этом режиме, например, если ispell-таблицы отсутствуют, функция
возвратит
FALSE
, а код и сообщение об ошибке будут доступны через
udm_error()
м
udm_errno()
.
Пример:
if (! udm_load_ispell_data($udm,UDM_ISPELL_TYPE_DB,'','',1)) {
printf("Error #%d: '%s'\n", udm_errno($udm), udm_error($udm));
exit;
}
|
-
UDM_ISPELL_TYPE_AFFIX - указывает, что ispell-данные должны быть
загружены из файла, и инициирует загрузку файла аффиксов. В этом случае
val1
определяет двухбуквенный код языка для которого загружаются аффиксы,
а
val2
- путь к файлу. Пожалуйста, обратите внимание, что, если введён относительный
путь, модуль ищет файл не в UDM_CONF_DIR, а относительно текущего пути, т.е. пути, в котором выполняется скрипт.
В случае ошибки в этом режиме, например, если файл отсутствует, функция возвратит
FALSE
, и будет выведено сообщение об ошибке. Доступ к тексту сообщения об ошибке не
может быть получен через
udm_error()
и
udm_errno()
,
поскольку эти функции могут возвращать только сообщения, ассоциированные с SQL.
См. описание параметра
flag
в UDM_ISPELL_TYPE_DB.
Пример:
if ((! udm_load_ispell_data($udm,UDM_ISPELL_TYPE_AFFIX,'en','/opt/ispell/en.aff',0)) ||
(! udm_load_ispell_data($udm,UDM_ISPELL_TYPE_AFFIX,'ru','/opt/ispell/ru.aff',0)) ||
(! udm_load_ispell_data($udm,UDM_ISPELL_TYPE_SPELL,'en','/opt/ispell/en.dict',0)) ||
(! udm_load_ispell_data($udm,UDM_ISPELL_TYPE_SPELL,'ru','/opt/ispell/ru.dict',1))) {
exit;
}
|
Примечание:
flag
равен 1 только в последнем вызове.
-
UDM_ISPELL_TYPE_SPELL - указывает, что ispell-данные должны быть загружены из файла, и инициирует загрузку файла ispell-словаря. В этом
случае
val1
определяет двухбуквенный код языка для которого загружаются аффиксы,
а
val2
- путь к файлу. Пожалуйста, обратите внимание, что, если введён относительный
путь, модуль ищет файл не в UDM_CONF_DIR, а относительно текущего пути, т.е. пути, в котором выполняется скрипт.
В случае ошибки в этом режиме, например, если файл отсутствует, функция возвратит
FALSE
, и будет выведено сообщение об ошибке. Доступ к тексту сообщения об ошибке не
может быть получен через
udm_error()
и
udm_errno()
,
поскольку эти функции могут возвращать только сообщения, ассоциированные с SQL. См. описание параметра
flag
в UDM_ISPELL_TYPE_DB.
if ((! Udm_Load_Ispell_Data($udm,UDM_ISPELL_TYPE_AFFIX,'en','/opt/ispell/en.aff',0)) ||
(! Udm_Load_Ispell_Data($udm,UDM_ISPELL_TYPE_AFFIX,'ru','/opt/ispell/ru.aff',0)) ||
(! Udm_Load_Ispell_Data($udm,UDM_ISPELL_TYPE_SPELL,'en','/opt/ispell/en.dict',0)) ||
(! Udm_Load_Ispell_Data($udm,UDM_ISPELL_TYPE_SPELL,'ru','/opt/ispell/ru.dict',1))) {
exit;
}
|
Примечание: равен 1 только в последнем вызове.
-
UDM_ISPELL_TYPE_SERVER - включает поддержку spell-сервера. Параметр
val1
указывает адрес хоста host, на котором работает spell-сервер.
val2
` ещё не используется, но в будущих релизах будет указывать номер порта,
используемого spell-сервером. Параметр
flag
в этом случае не нужен, так как ispell-данные хранятся на spel-сервере уже
отсортированными.
Spelld-сервер читает spell-данные из отдельного файла конфигурации
(по умолчанию /usr/local/mnogosearch/etc/spelld.conf), сортирует их и
сохраняет в памяти. С клиентами сервер сообщается двумя способами: все
данные переносятся в индексатор (поэтому индексатор стартует быстрее), из search.cgi сервер получает слово для нормализации и затем передаёт
клиенту (search.cgi) список форм нормализованных слов. Это даёт более быструю, в сравнении с режимами db и text, обработку запросов поиска (опуская
загрузку и сортировку spell-данных).
udm_load_ispell_data() в режиме UDM_ISPELL_TYPE_SERVER фактически не загружает ispell-данные, а
только определяет адрес сервера. Фактически сервер автоматически используется функцией
udm_find()
при выполнении поиска. При ошибках, например, если spell-сервер не запущен или
указан неправильный хост, возвращаемых сообщений нет, и конвертация ispell не работает.
Примечание: эта функция доступна в mnoGoSearch 3.1.12 или новее.
Пример:
if (!udm_load_ispell_data($udm,UDM_ISPELL_TYPE_SERVER,'','',1)) {
printf("Error loading ispell data from server<br>\n");
exit;
}
|
|
|
