Модуль Apache mod_dbd

Краткое описание

mod_dbd управляет подключениями к базам данных SQL с помощью APR. Он предоставляет подключения к базам данных по запросу модулей, которым требуются функции работы с базами данных SQL, и управляет базами данных с оптимальной эффективностью и масштабируемостью как для многопоточных, так и для однопоточных MPM. Подробности см. на веб-сайте APR и в этом обзоре инфраструктуры Apache DBD, подготовленном её первоначальным разработчиком.

Пул подключений

Этот модуль управляет подключениями к базам данных способом, оптимизированным для платформы. На однопоточных платформах он предоставляет постоянное подключение по классической схеме LAMP (Linux, Apache, Mysql, Perl/PHP/Python). На многопоточных платформах он предоставляет более масштабируемый и эффективный пул подключений, описанный в этой статье на ApacheTutor. Обратите внимание, что mod_dbd заменяет модули, представленные в этой статье.

Подключение

Чтобы подключиться к базе данных, необходимо указать драйвер и параметры подключения. Они различаются в зависимости от используемой системы управления базами данных. Например, чтобы подключиться к mysql, выполните следующее:

DBDriver mysql
DBDParams host=localhost,dbname=pony,user=shetland,pass=appaloosa

Затем это подключение можно использовать в различных других модулях, включая mod_rewrite, mod_authn_dbd и mod_lua. Дополнительные примеры использования приведены в документации каждого из этих модулей.

Сведения о строках подключения для каждого из поддерживаемых драйверов баз данных см. в DBDParams.

API Apache DBD

mod_dbd экспортирует пять функций для использования другими модулями. API выглядит следующим образом:

typedef struct {
    apr_dbd_t *handle;
    apr_dbd_driver_t *driver;
    apr_hash_t *prepared;
} ap_dbd_t;

/* Export functions to access the database */

/* acquire a connection that MUST be explicitly closed.
 * Returns NULL on error
 */
AP_DECLARE(ap_dbd_t*) ap_dbd_open(apr_pool_t*, server_rec*);

/* release a connection acquired with ap_dbd_open */
AP_DECLARE(void) ap_dbd_close(server_rec*, ap_dbd_t*);

/* acquire a connection that will have the lifetime of a request
 * and MUST NOT be explicitly closed.  Return NULL on error.
 * This is the preferred function for most applications.
 */
AP_DECLARE(ap_dbd_t*) ap_dbd_acquire(request_rec*);

/* acquire a connection that will have the lifetime of a connection
 * and MUST NOT be explicitly closed.  Return NULL on error.
 */
AP_DECLARE(ap_dbd_t*) ap_dbd_cacquire(conn_rec*);

/* Prepare a statement for use by a client module */
AP_DECLARE(void) ap_dbd_prepare(server_rec*, const char*, const char*);

/* Also export them as optional functions for modules that prefer it */
APR_DECLARE_OPTIONAL_FN(ap_dbd_t*, ap_dbd_open, (apr_pool_t*, server_rec*));
APR_DECLARE_OPTIONAL_FN(void, ap_dbd_close, (server_rec*, ap_dbd_t*));
APR_DECLARE_OPTIONAL_FN(ap_dbd_t*, ap_dbd_acquire, (request_rec*));
APR_DECLARE_OPTIONAL_FN(ap_dbd_t*, ap_dbd_cacquire, (conn_rec*));
APR_DECLARE_OPTIONAL_FN(void, ap_dbd_prepare, (server_rec*, const char*, const char*));

Подготовленные операторы SQL

mod_dbd поддерживает подготовленные операторы SQL для модулей, которым они могут потребоваться. Каждому подготовленному оператору необходимо назначить имя (метку); они хранятся в хеше — поле prepared структуры ap_dbd_t. Элементы хеша имеют тип apr_dbd_prepared_t и могут использоваться в любой из команд apr_dbd для выполнения подготовленных SQL-запросов или выборок.

Модули, использующие dbd, должны самостоятельно использовать подготовленные операторы и документировать, какие операторы можно указывать в httpd.conf, либо предоставлять собственные директивы и использовать ap_dbd_prepare.

ПРЕДУПРЕЖДЕНИЕ О БЕЗОПАСНОСТИ

Любое веб-приложение, работающее с базой данных, должно быть защищено от атак с внедрением SQL-кода. В большинстве случаев Apache DBD безопасен, поскольку приложения используют подготовленные операторы, а недоверенные данные применяются только как данные. Разумеется, если вы используете его через сторонние модули, следует выяснить, какие меры предосторожности могут потребоваться.

Однако драйвер FreeTDS по своей природе небезопасен. Базовая библиотека не поддерживает подготовленные операторы, поэтому драйвер эмулирует их, подставляя недоверенные данные непосредственно в SQL-оператор.

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

$untrusted =~ /([a-z]+)/; $trusted = $1;

Для этого регулярные выражения очистки необходимо включить в настроенные подготовленные операторы. Регулярное выражение указывается сразу после символа % в подготовленном операторе и заключается в фигурные скобки {}. Например, если приложение ожидает буквенно-цифровые данные, можно использовать:

"SELECT foo FROM bar WHERE input = %s"

Для других драйверов это приведёт лишь к неудачному запросу, но не к более серьёзным последствиям. Однако для FreeTDS потребуется:

"SELECT foo FROM bar WHERE input = %{([A-Za-z0-9]+)}s"

Теперь все данные, не соответствующие совпадению $1 регулярного выражения, отбрасываются, поэтому оператор безопасен.

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

DBDExptime time-in-seconds

DBDExptime 300

DBDInitSQL "SQL statement"

DBDKeep number

DBDKeep 2

DBDMax number

DBDMax 10

DBDMin number

DBDMin 1

DBDParams param1=value1[,param2=value2]

DBDPersist On|Off

DBDPrepareSQL "SQL statement" label

DBDriver name