(PHP 8 >= 8.4.0)
PDO::connect — Подключается к базе данных и возвращает объект подкласса PDO для драйвера, который поддерживает заданную БД
$dsn
,$username
= null
,$password
= null
,$options
= null
Метод создаёт объект подкласса PDO для базы данных, с которой устанавливают соединение, если PDO-подкласс для такой БД определили, иначе возвращает универсальный экземпляр класса PDO.
dsn
Имя источника данных (англ. Data Source Name, DSN) с информацией, которая требуется для подключения к базе данных.
Часто DSN-строка подключения состоит из названия PDO-драйвера, за которым следует двоеточие и синтаксис соединения, характерный для PDO-драйвера. Дополнительную информацию даёт раздел «Документация к PDO-драйверам, характерным для баз данных».
Параметр dsn
поддерживает три метода
указания аргументов, которые требуются для установки соединения
с базой данных:
Аргумент dsn
с полной DSN-строкой подключения.
Аргумент dsn
, который состоит из префикса uri:
,
за которым идёт URI-идентификатор, который определяет расположение файла
с DSN-строкой. Идентификатор URI указывает на локальный файл или удалённый URL-адрес.
uri:file:///path/to/dsnfile
Аргумент dsn
состоит из имени
name
, которое соответствует параметру
pdo.dsn.
в файле php.ini,
который определяет DSN-строку подключения.
name
Замечание:
Псевдоним требуется определять в файле php.ini, но не в файлах .htaccess или httpd.conf
username
Имя пользователя для DSN-строки. Этот параметр необязателен для ряда PDO-драйверов.
password
Пароль для строки DSN. Этот параметр необязателен для ряда PDO-драйверов.
options
Массив параметров подключения, характерных для драйвера, в виде пар ключ=>значение.
Метод возвращает объект PDO-подкласса для PDO-драйвера конкретной БД, если такой PDO-подкласс определили, или стандартный экземпляр класса PDO.
Метод выбрасывает исключение PDOException, если попытка
подключения к базе данных не удалась, независимо от текущей стратегии обработки
ошибок, установленной в атрибуте PDO::ATTR_ERRMODE
.