Интеграция веб-сервера с базами данных: Nginx, PHP и PostgreSQL

Расширенные примеры конфигурации и кода

Пример 1. Настройка PgBouncer в режиме transaction pooling с детальной конфигурацией

Конфигурация PgBouncer с ограничением времени простоя и логированием:

[databases]
mydb = host=127.0.0.1 port=5432 dbname=mydb pool_size=50 reserve_pool=10

[pgbouncer]
listen_addr = 0.0.0.0
listen_port = 6432
auth_type = md5
auth_file = /etc/pgbouncer/userlist.txt
logfile = /var/log/pgbouncer/pgbouncer.log
pidfile = /var/run/pgbouncer/pgbouncer.pid
admin_users = admin
pool_mode = transaction
default_pool_size = 25
reserve_pool_size = 5
reserve_pool_timeout = 5.0
max_client_conn = 200
max_db_connections = 100
idle_transaction_timeout = 300
disable_pqexec = 0

Команда для генерации userlist.txt из PostgreSQL:

# Получение MD5-паролей
sudo -u postgres psql -c "SELECT concat('\"', usename, '\" \"', passwd, '\"') FROM pg_shadow WHERE usename NOT LIKE 'pg_%';" > /etc/pgbouncer/userlist.txt

Результат (userlist.txt):

"myuser" "md5abcdef1234567890"
"app_user" "md5fedcba0987654321"

Пример 2. Кеширование в Nginx с использованием ключа на основе URI и переменной

Расширенная конфигурация с исключением кеша для административной панели:

http {
    proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=fastcache:10m max_size=1g inactive=60m use_temp_path=off;
    server {
        location /api/ {
            include snippets/fastcgi-php.conf;
            fastcgi_pass unix:/run/php/php8.1-fpm.sock;
            fastcgi_cache fastcache;
            fastcgi_cache_key "$scheme$request_method$host$request_uri";
            fastcgi_cache_valid 200 301 302 1h;
            fastcgi_cache_use_stale error timeout updating http_500 http_503;
            # Не кешировать для авторизованных пользователей
            if ($http_cookie ~* "PHPSESSID") {
                set $no_cache 1;
            }
            fastcgi_no_cache $no_cache;
            fastcgi_ignore_headers Cache-Control Expires Set-Cookie;
            add_header X-Nginx-Cache $upstream_cache_status;
        }
    }
}

Проверка кеша - ответ содержит заголовок X-Nginx-Cache: HIT или MISS.

Пример 3. Использование PDO с PostgreSQL и обработка ошибок

<?php
$dsn = 'pgsql:host=127.0.0.1;port=5432;dbname=mydb;user=myuser;password=mypass';
$options = [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
    PDO::ATTR_EMULATE_PREPARES => false,
];
try {
    $pdo = new PDO($dsn, null, null, $options);
    $stmt = $pdo->prepare("SELECT id, username, email FROM users WHERE active = :active");
    $stmt->execute([':active' => true]);
    echo "<table>";
    while ($row = $stmt->fetch()) {
        echo "<tr><td>{$row['id']}</td><td>{$row['username']}</td><td>{$row['email']}</td></tr>";
    }
    echo "</table>";
} catch (PDOException $e) {
    error_log("PDO Error: " . $e->getMessage());
    http_response_code(500);
    echo "Внутренняя ошибка сервера";
}
?>

Результат - HTML-таблица с данными из PostgreSQL. Если возникает ошибка подключения, в лог записывается детальное сообщение, а пользователю возвращается 500.

Пример 4. Тонкая настройка пула PHP-FPM для работы с PostgreSQL

Оптимальные значения параметров в файле /etc/php/8.1/fpm/pool.d/www.conf:

pm = dynamic
pm.max_children = 50
pm.start_servers = 5
pm.min_spare_servers = 3
pm.max_spare_servers = 8
pm.process_idle_timeout = 10s
pm.max_requests = 500

Пояснение параметров:

• pm.max_children - максимальное количество дочерних процессов PHP-FPM. Должно быть меньше либо равно max_connections в PostgreSQL (с учётом других потребителей).
• pm.max_requests - число запросов, после которого процесс завершается, чтобы избежать утечек памяти.
• Если используется постоянные соединения pg_pconnect, то pm.max_children не должно превышать max_connections, иначе часть процессов не сможет подключиться.

Пример 5. Использование несколько upstream для PHP-FPM с разными сокетами

upstream php_pool {
    least_conn;
    server unix:/run/php/php8.1-fpm.sock;
    server unix:/run/php/php8.2-fpm.sock;
}
server {
    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass php_pool;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

Результат - запросы равномерно распределяются между двумя пулами PHP разных версий. Однако приложения должны быть совместимы.