PHPConf.Asia 2015
    Edit Report a Bug

    PDO::__construct

    (PHP 5 >= 5.1.0, 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 в нижнем регистре.

    add a note add a note

    User Contributed Notes 8 notes

    up
    53
    Kiipa at live dot com
    1 year ago
    To get UTF-8 charset you can specify that in the DSN.

    $link = new PDO("mysql:host=localhost;dbname=DB;charset=UTF8");
    up
    21
    piotrekkr at o2 dot pl
    4 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.
    up
    17
    Victor T.
    5 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\''));
    ?>
    up
    3
    berk0081 at umn dot edu
    9 months 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");
    ?>
    up
    10
    subme at interia dot pl
    6 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';
    ?>
    up
    9
    Anonymous
    1 year ago
    To connect to the database via a function use this and call the getConnection function in the class constructor.

    <?php
    class Connection{

        protected     $db;

        public function     Connection(){

            $conn = NULL;

            try{
                    $conn = new PDO("mysql:host=localhost;dbname=dbname", "dbuser", "dbpass");
                    $conn->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
                } catch(    PDOException $e){
                    echo     'ERROR: ' . $e->getMessage();
                    }   
                    $this->db = $conn;
        }
       
        public function     getConnection(){
            return     $this->db;
        }
    }

    ?>
    up
    4
    Anonymous
    2 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.
    up
    -1
    info at salientdigital dot com
    4 months ago
    If you happen to create a dsn like this...

    <?php
            //wrong dsn
            $db = new PDO('mysql:database=yourdb;host=127.0.0.1', 'user', 'password');
            $stmt = $db->prepare('SELECT * FROM tbl WHERE id = :id');
            $stmt->bindParam(':id', $user_id, PDO::PARAM_INT);
            $result = $stmt->execute();
    ?>

    ... your result will be bool(false) and your $db->errorInfo() will be "0000" which isn't very helpful.

    You have to look to the $stmt->errorInfo() to see "No database selected" which is even more confusing until you realize that it's not 'database' but 'dbname' in your DSN! You would think the error about a bad DSN would be in the $db errorInfo but it is not, it's not until you try the $stmt that the error is generated.

    <?php
            //correct dsn
            $db = new PDO('mysql:dbname=yourdb;host=127.0.0.1', 'user', 'password');
    ?>

    I wasted a half hour on that one.
    add a note add a note
    To Top