array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'pdo.connect.php', 1 => 'PDO::connect', 2 => 'Подключается к базе данных и возвращает объект подкласса PDO для драйвера, который поддерживает заданную БД', ), 'up' => array ( 0 => 'class.pdo.php', 1 => 'PDO', ), 'prev' => array ( 0 => 'pdo.commit.php', 1 => 'PDO::commit', ), 'next' => array ( 0 => 'pdo.construct.php', 1 => 'PDO::__construct', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/pdo/pdo/connect.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

PDO::connect

(PHP 8 >= 8.4.0)

PDO::connect — Подключается к базе данных и возвращает объект подкласса PDO для драйвера, который поддерживает заданную БД

Описание

public static PDO::connect(
    string $dsn,
    ?string $username = null,
    #[\SensitiveParameter] ?string $password = null,
    ?array $options = null
): static

Метод создаёт объект подкласса PDO для базы данных, с которой устанавливают соединение, если PDO-подкласс для такой БД определили, иначе возвращает универсальный экземпляр класса PDO.

Список параметров

dsn

Имя источника данных (англ. Data Source Name, DSN) с информацией, которая требуется для подключения к базе данных.

Часто DSN-строка подключения состоит из названия PDO-драйвера, за которым следует двоеточие и синтаксис соединения, характерный для PDO-драйвера. Дополнительную информацию даёт раздел «Документация к PDO-драйверам, характерным для баз данных».

Параметр dsn поддерживает три метода указания аргументов, которые требуются для установки соединения с базой данных:

Вызов драйвера

Аргумент dsn с полной DSN-строкой подключения.

Вызов URI-идентификатора

Аргумент dsn, который состоит из префикса uri:, за которым идёт URI-идентификатор, который определяет расположение файла с DSN-строкой. Идентификатор URI указывает на локальный файл или удалённый URL-адрес.

uri:file:///path/to/dsnfile

Совмещение имён

Аргумент dsn состоит из имени name, которое соответствует параметру pdo.dsn.name в файле php.ini, который определяет DSN-строку подключения.

Замечание:

Псевдоним требуется определять в файле php.ini, но не в файлах .htaccess или httpd.conf

username

Имя пользователя для DSN-строки. Этот параметр необязателен для ряда PDO-драйверов.

password

Пароль для строки DSN. Этот параметр необязателен для ряда PDO-драйверов.

options

Массив параметров подключения, характерных для драйвера, в виде пар ключ=>значение.

Возвращаемые значения

Метод возвращает объект PDO-подкласса для PDO-драйвера конкретной БД, если такой PDO-подкласс определили, или стандартный экземпляр класса PDO.

Ошибки

Метод выбрасывает исключение PDOException, если попытка подключения к базе данных не удалась, независимо от текущей стратегии обработки ошибок, установленной в атрибуте PDO::ATTR_ERRMODE.

Смотрите также