PHP Conference Nagoya 2025

PDO::connect

(No version information available, might only be in Git)

PDO::connectConnect to a database and return a PDO subclass for drivers that support it

Описание

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

Creates an instance of a PDO subclass for the database being connection if it exists, otherwise return a generic PDO instance.

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

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

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

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

Returns an instance of a PDO subclass for the corresponding PDO driver if it exists, or a generic PDO instance.

Ошибки

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

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

  • Pdo\Dblib
  • Pdo\Firebird
  • Pdo\Mysql
  • Pdo\Odbc
  • Pdo\Pgsql
  • Pdo\Sqlite
  • PDO::__construct() - Создаёт объект PDO, который предоставляет соединение с базой данных
Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы
To Top