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,
    #[\SensitiveParameter] ?string $password = null,
    ?array $options = null
)

Метод создаёт экземпляр класса 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::__construct() выбрасывает исключение PDOException, если попытка подключения к запрашиваемой базе данных завершается с ошибкой, независимо от того, какой флаг PDO::ATTR_ERRMODE установили.

Примеры

Пример #1 Пример создания экземпляра класса PDO через вызов драйвера

<?php

$dsn = 'mysql:dbname=testdb;host=127.0.0.1';
$user = 'dbuser';
$password = 'dbpass';

$dbh = new PDO($dsn, $user, $password);

?>

Пример #2 Пример создания экземпляра класса PDO через вызов URI-идентификатора

В следующем примере предполагается, что файл /usr/local/dbconnect существует с правами доступа, которые разрешают PHP прочитать файл. Файл содержит PDO DSN для подключения к базе данных DB2 через драйвер PDO_ODBC:

odbc:DSN=SAMPLE;UID=john;PWD=mypass

PHP-скрипт создаёт подключение к базе данных путём простой передачи параметра uri:, который указывает на файл идентификатора URI:

<?php

$dsn = 'uri:file:///usr/local/dbconnect';
$user = '';
$password = '';

$dbh = new PDO($dsn, $user, $password);

?>

Пример #3 Пример создания экземпляра класса PDO через псевдоним

В следующем примере предполагается, что файл php.ini содержит следующую запись, которая разрешает подключиться к базе данных MySQL только через псевдоним mydb:

[PDO]
     pdo.dsn.mydb="mysql:dbname=testdb;host=localhost"

<?php

$dsn = 'mydb';
$user = '';
$password = '';

$dbh = new PDO($dsn, $user, $password);

?>

Улучшение страницы

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

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

down

127

Kiipa at live dot com ¶

11 years ago

To get UTF-8 charset you can specify that in the DSN.

$link = new PDO("mysql:host=localhost;dbname=DB;charset=UTF8");

down

subme at interia dot pl ¶

15 years ago

To specify a database connection port use the following DSN string

<?php
$dsn = 'mysql:dbname=testdb;host=127.0.0.1;port=3333';
?>

down

Aymeric S ¶

4 years ago

When trying to connect to a local database, it seems "uri:file:///" is no longer needed. Just write the PDO pilot name followed by the absolute path of the file.
Example : sqlite:C:\VirtualHosts\phpliteadmin\dbs\surveillance_logeas.s3DB

down

piotrekkr at o2 dot pl ¶

14 years ago

To connect throught unix socket you need to use 
<?php
$dsn = 'mysql:dbname=testdb;unix_socket=/path/to/socket';
?>

You musn't specify host when using socket.

down

daviddlavier at gmail dot com ¶

9 years ago

I'd like to point out that in PHP 7.0 in the dsn parameter you can't use 'host=localhost' to solve this you can use 'host=127.0.0.1' instead.

down

Michal Stefanak ¶

1 year ago

If you override PDO with own class and you want to implement alias from php.ini, you have to get it with `get_cfg_var` instead of `ini_get`.

<?php
class PDO extends \PDO
{
    public function __construct(string $dsn, ?string $username = null, ?string $password = null, ?array $options = null)
    {
        //alias
        if (!str_contains($dsn, ':')) {
            $dsn = get_cfg_var('pdo.dsn.' . $dsn);
            if (!$dsn) {
                throw new PDOException('Argument #1 ($dsn) must be a valid data source name');
            }
        }

        // your additional logic

        parent::__construct($dsn, $username, $password, $options);
    }
}
?>

down

theking2 at king dot ma ¶

1 year ago

A generic pattern to connect to a mariadb or mysql database using a settings file

<?php
$_SETTINGS = parse_ini_file('./settings.ini', true);

$db = new \PDO(
  "mysql:hostname={$_SETTINGS['db']['host']};dbname={$_SETTINGS['db']['name']}",
  $_SETTINGS['db']['user'],
  $_SETTINGS['db']['pass'],
  [
    \PDO::ATTR_DEFAULT_FETCH_MODE => \PDO::FETCH_ASSOC,
    \PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES 'utf8mb4'"
  ]
);
?>
You might not need the options depicted here but I find them convenient. 

Works with a settings.ini file containing for instance:
[db]
host = "localhost"
name = "dbname"
user = "dbuser"
pass = "dbpassword"

down

Francesco Montanari ¶

4 years ago

Most of the information in the comment here is outdated or wrong.

You do can use host=localhost to connect via socket, which is faster than TCP, so setting 127.0.0.1 is a performance loss.

To use proper utf you should use utf8mb4, for example:

$db = new PDO('mysql:host=' . DATABASE_HOST . ';dbname='. DATABASE_NAME .';charset=utf8mb4', DATABASE_USER, DATABASE_PASSWORD);

down

Victor T. ¶

14 years ago

If you use the UTF-8 encoding, you have to use the fourth parameter :



<?php

$db = new PDO('mysql:host=myhost;dbname=mydb', 'login', 'password', array(PDO::MYSQL_ATTR_INIT_COMMAND => 'SET NAMES \'UTF8\''));

?>

down

453034559 at qq dot com ¶

2 years ago

// set DEFAULT_FETCH_MODE
<?php
    try {
        $p = new PDO("mysql:host=$db_host;port=$db_port;dbname=$db_dbname", $db_user, $db_pass,array(
            PDO::ATTR_DEFAULT_FETCH_MODE =>PDO::FETCH_ASSOC,
            PDO::MYSQL_ATTR_INIT_COMMAND => 'SET NAMES utf8', //after php5.3.6
        ));
        //$p->exec('SET NAMES utf8');
    } catch (PDOException $e) {
        print "Error!: " . $e->getMessage() . "<br/>";
        die();
    }
?>

down

Anonymous ¶

11 years ago

Sqlite:

<?php
try{     
    $pdo = new PDO('sqlite:example.db');
}catch (PDOException $e){
     die ('DB Error');
}
?>

If 'example.db' does not exist, no exception is thrown but the file 'example.db' is created.

down

-3

ohcc at 163 dot com ¶

8 years ago

You will get a fatal error if you don't catch the exception threw by PDO when it fails to connect to the database server like this.

Fatal error: in xxx.php on line xx

This error neither can be handled by error handlers nor can it be erased by the @ sign, which can make your script uncontrollable.

<?php
    $db = new pdo('mysql:host=127.0.0.1;port=3306;dbname=mysql;charset=utf8','user','password',array(
        PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    ));
?>

You should always try ... catch ... 

<?php
    try{
    $db = new pdo('mysql:host=127.0.0.1;port=3306;dbname=mysql;charset=utf8','user','password',array(
        PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    ));
    }catch(PDOException $pe){
        echo $pe->getMessage();
    }    
?>

down

-4

berk0081 at umn dot edu ¶

10 years ago

Although not explicitly stated, parameters in the PDO $dsn string may be case-sensitive on some platforms or drivers. 



<?php

// The dbname will not be parsed with incorrect casing:

$pdo = new PDO("mysql:host=hostname;DBName=database", "user", "password");



// The correct dbname is lowercase, as displayed in the manual:

$pdo = new PDO("mysql:host=hostname;dbname=database", "user", "password");

?>

down

-2

max1josef ¶

1 year ago

SQLite3: by default, the database file is created on opening if it does not exist (PDO::SQLITE_OPEN_CREATE).

<?php
$dsn = 'sqlite:D:\Databases\non_existing.db';   // file does not exist

try {
    $dbh = new PDO($dsn);
}
catch(PDOException $e) {
    print $e->getMessage();
}
?> 

No Exception is thrown, instead file "non_existing.db" will be created. To avoid this, use:

<?php
$dsn = 'sqlite:D:\Databases\non_existing.db';
$options = [
    PDO::SQLITE_ATTR_OPEN_FLAGS => PDO::SQLITE_OPEN_READWRITE,  
];

try {
    $dbh = new PDO('sqlite:D:\Databases\non_existing.db', null, null, $options);
}
catch(PDOException $e) {
    print $e->getMessage();
}
?> 
This will ouput:
SQLSTATE[HY000] [14] unable to open database file

If you want to open the database read-only, use PDO::SQLITE_OPEN_READONLY.

＋Добавить