Настройка соединения с базой данных в PHP: указание host в php.ini

Расширенные примеры настройки host в конфигурации PHP

Пример 1. Проверка текущих настроек из php.ini

С помощью небольшого PHP-скрипта можно вывести все значения директив, связанных с хостами:

<?php
$directives = [
    'pdo_mysql.default_host',
    'mysqli.default_host',
    'mysql.default_host',
    'pdo_mysql.default_port',
    'mysqli.default_port',
    'mysql.default_port'
];
foreach ($directives as $d) {
    $val = ini_get($d) ?: 'not set';
    echo "$d: $val\n";
}
?>

pdo_mysql.default_host: localhost
mysqli.default_host: not set
mysql.default_host: not set
pdo_mysql.default_port: 3306
mysqli.default_port: 3306
mysql.default_port: 3306

Пример 2. Использование ini_set() для временной смены хоста

Иногда требуется изменить хост в конфигурации только для текущего процесса. Это можно сделать с помощью ini_set(), но только для директив, поддерживающих изменение на этапе выполнения (обычно pdo_mysql.default_host не входит в их число, однако можно задать в коде подключения явно). Более практичный подход - использовать putenv() и подстановку в php.ini, если версия PHP 8.0+.

<?php
putenv('DB_HOST=192.168.1.100');
// При этом в php.ini должно быть: pdo_mysql.default_host = "${DB_HOST}"
$pdo = new PDO('mysql:dbname=test'); // используется хост из переменной окружения
?>

Результат: успешное подключение к хосту 192.168.1.100, если указан правильный порт.

Пример 3. Настройка host через .user.ini с проверкой

Создайте файл .user.ini в корневой директории со следующим содержимым:

; .user.ini
pdo_mysql.default_host = "db.internal"
pdo_mysql.default_port = 3307

Затем запросите страницу, которая выводит phpinfo() - в секции PDO должно появиться новое значение. Альтернативно:

<?php
$pdo = new PDO('mysql:dbname=test');
echo $pdo->getAttribute(PDO::ATTR_SERVER_INFO);
?>

Uptime: 123456 Threads: 1 Questions: 789

Если подключение провалилось, будет исключение.

Пример 4. Указание host с портом и сокетом

В директиве можно задать не только хост, но и порт, и даже путь к Unix-сокету:

; использование TCP через порт 3307
pdo_mysql.default_host = "127.0.0.1:3307"

; использование Unix-сокета (для локального подключения)
mysqli.default_host = "localhost:/var/run/mysqld/mysqld.sock"

Второй вариант требует, чтобы директива mysql.default_socket или pdo_mysql.default_socket также была правильно настроена, иначе может произойти ошибка.

Пример 5. Обработка ошибок при неверном хосте

<?php
try {
    $pdo = new PDO('mysql:host=wronghost;dbname=test', 'root', '');
} catch (PDOException $e) {
    echo "Ошибка подключения: " . $e->getMessage();
}
?>

Ошибка подключения: SQLSTATE[HY000] [2002] php_network_getaddresses: getaddrinfo for wronghost failed: Name or service not known

Эта ошибка возникает, если DNS не может разрешить имя wronghost. Рекомендуется использовать IP-адрес или проверять запись в /etc/hosts.

Пример 6. Множественные значения для разных расширений

Если в php.ini заданы несколько директив, каждое расширение использует свою:

; php.ini
pdo_mysql.default_host = "pdo-host"
mysqli.default_host = "mysqli-host"
mysql.default_host = "mysql-host"

Тестируем в скрипте:

<?php
echo 'PDO: ' . ini_get('pdo_mysql.default_host') . '
';
echo 'mysqli: ' . ini_get('mysqli.default_host') . '
';
echo 'mysql: ' . ini_get('mysql.default_host') . '
';
?>

PDO: pdo-host
mysqli: mysqli-host
mysql: mysql-host

Важно помнить, что расширение mysql уже не поддерживается.