PDO::__construct
(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.1.0)
PDO::__construct - Створює екземпляр PDO, що надає з'єднання з базою даних
Опис
public PDO::__construct
string$dsn,
?string$username null,
?string$password null,
?array$options null
) .
Створює екземпляр PDO, що надає підключення до необхідної бази даних.
Список параметрів
dsn
Ім'я джерела даних або 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::__construct() викидає виняток PDOExceptionякщо спроба підключення до запитуваної бази даних завершується з помилкою, незалежно від того, якою PDO::ATTR_ERRMODE встановлений на даний момент.
Приклади
Приклад #1 Створення екземпляра PDO через виклик драйвера
Приклад #2 Створення екземпляра PDO через виклик URI
У цьому прикладі передбачається, що файл /usr/local/dbconnect існує з правами доступу, які дозволяють PHP прочитати файл. Файл містить PDO DSN для підключення до бази даних DB2 через драйвер PDO_ODBC:
odbc:DSN=SAMPLE;UID=john;PWD=mypass
PHP-скрипт може створити підключення до бази даних шляхом простої передачі параметра uri:, що вказує на файл URI:
Приклад #3 Створення екземпляра PDO, використовуючи псевдонім
У наступному прикладі передбачається, що php.ini містить наступний запис, що дозволяє підключитися до бази даних MySQL, використовуючи лише псевдонім mydb :
[PDO] pdo.dsn.mydb="mysql:dbname=testdb;host=localhost"