PDO::__construct

(PHP 5 >= 5.1.0, PHP 7, PECL pdo >= 0.1.0)

PDO::__construct Создает экземпляр PDO, предоставляющий соединение с базой данных

Описание

public PDO::__construct ( string $dsn [, string $username [, string $password [, array $options ]]] )

Создает экземпляр 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 в случае успеха.

Ошибки

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

Примеры

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

<?php
/* Подключение к базе данных ODBC, используя вызов драйвера */
$dsn 'mysql:dbname=testdb;host=127.0.0.1';
$user 'dbuser';
$password 'dbpass';

try {
    
$dbh = new PDO($dsn$user$password);
} catch (
PDOException $e) {
    echo 
'Подключение не удалось: ' $e->getMessage();
}

?>

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

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

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

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

<?php
/* Подключение к базе данных ODBC, используя вызов драйвера */
$dsn 'uri:file:///usr/local/dbconnect';
$user '';
$password '';

try {
    
$dbh = new PDO($dsn$user$password);
} catch (
PDOException $e) {
    echo 
'Подключение не удалось: ' $e->getMessage();
}

?>

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

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

[PDO]
pdo.dsn.mydb="mysql:dbname=testdb;host=localhost"
<?php
/* Подключение к базе данных ODBC, используя псевдоним */
$dsn 'mydb';
$user '';
$password '';

try {
    
$dbh = new PDO($dsn$user$password);
} catch (
PDOException $e) {
    echo 
'Подключение не удалось: ' $e->getMessage();
}

?>

Замечание:

До PHP 5.3, класс, наследуемый от PDO и реализующий магический метод __call, всегда получал параметр $method в нижнем регистре.

Коментарии

To specify a database connection port use the following DSN string

<?php
$dsn 
'mysql:dbname=testdb;host=127.0.0.1;port=3333';
?>
2008-11-25 16:03:45
http://php5.kiev.ua/manual/ru/pdo.construct.html
Автор:
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\''));
?>
2010-02-20 11:34:41
http://php5.kiev.ua/manual/ru/pdo.construct.html
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.
2010-09-15 03:19:33
http://php5.kiev.ua/manual/ru/pdo.construct.html
Автор:
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.
2013-05-29 08:30:36
http://php5.kiev.ua/manual/ru/pdo.construct.html
To get UTF-8 charset you can specify that in the DSN.

$link = new PDO("mysql:host=localhost;dbname=DB;charset=UTF8");
2013-10-19 21:46:08
http://php5.kiev.ua/manual/ru/pdo.construct.html
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");
?>
2014-11-16 15:34:08
http://php5.kiev.ua/manual/ru/pdo.construct.html
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.
2015-11-09 02:43:41
http://php5.kiev.ua/manual/ru/pdo.construct.html
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();
    }   
?>
2015-11-23 07:37:57
http://php5.kiev.ua/manual/ru/pdo.construct.html
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);
2020-04-27 11:16:38
http://php5.kiev.ua/manual/ru/pdo.construct.html
Автор:
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
2020-08-20 16:34:31
http://php5.kiev.ua/manual/ru/pdo.construct.html
// 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();
    }
?>
2022-01-25 04:25:52
http://php5.kiev.ua/manual/ru/pdo.construct.html
Автор:
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);
    }
}
?>
2022-12-13 14:26:32
http://php5.kiev.ua/manual/ru/pdo.construct.html
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"
2023-01-30 12:27:02
http://php5.kiev.ua/manual/ru/pdo.construct.html
Автор:
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'nullnull$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.
2023-05-12 15:19:40
http://php5.kiev.ua/manual/ru/pdo.construct.html

    Поддержать сайт на родительском проекте КГБ