Edit Report a Bug

PDO::__construct

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

PDO::__construct — Crea una instancia de PDO que representa una conexión a una base de datos

Descripción

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

Crea una instancia de PDO para representar una conexión a la base de datos solicitada.

Parámetros

dsn

EL Nombre del Origen de Datos (DSN), contiene la información requerida para conectarse a la base de datos.

En general, un DSN consiste en el nombre del controlador de PDO, seguido por dos puntos, seguido por la sintaxis específica del controlador de PDO para la conexión. Hay más información disponible en la documentación de controladores específicos de PDO.

El parámetro dsn admite tres métodos diferentes de especificar los parámetros requeridos para crear la conexión a la base de datos:

Invocación del controlador

dsn contiene el DSN completo.

Invocación del URI

dsn está formado por uri: seguido por un URI que define la ubicación de un fichero que contiene el string del DSN. El URI puede especificar un fichero local o un URL remoto.

uri:file:///ruta/al/fichero_dsn

Mediante un alias

dsn está formado por un nombre, name, que se corresponde con pdo.dsn.name en php.ini, definiendo el string del DSN.

Nota:
El alias debe estar definido en php.ini, y no en .htaccess o httpd.conf

username

El nombre de usuario para el string del DSN. Este parámetro es opcional para algunos controladores de PDO.

password

La contraseña para el string del DSN. Este parámetro es opcional para algunos controladores de PDO.

options

Un array de la forma clave=>valor con opciones de conexión específicas del controlador.

Valores devueltos

Devuelve un objeto PDO en caso de éxito.

Errores/Excepciones

PDO::__construct() lanza una PDOException si el intento de conexión a la base de datos requerida falla.

Ejemplos

Ejemplo #1 Crear una instancia PDO a través de una invocación al controlador


<?php
/* Conectar a una base de datos de MySQL invocando al controlador */
$dsn = 'mysql:dbname=testdb;host=127.0.0.1';
$usuario = 'usuario_bd';
$contraseña = 'contraseña_bd';

try {
    $gbd = new PDO($dsn, $usuario, $contraseña);
} catch (PDOException $e) {
    echo 'Falló la conexión: ' . $e->getMessage();
}

?>

Ejemplo #2 Crear una instancia PDO a través de una invocación a la URI

En el siguiente ejemplo se asume que el fichero /usr/local/dbconnect existe, con los permisos necesarios para que PHP lo lea. El fichero contiene el DSN de PDO necesario para conectarse a una base de datos de DB2 a través del controlador PDO_ODBC:

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

El script de PHP puede crear una conexión a una base de datos simplemente pasando el parámetro uri: y apuntando al URI del fichero:


<?php
/* Conectar a una base de datos de ODBC invocando al controlador */
$dsn = 'uri:file:///usr/local/dbconnect';
$usuario = '';
$contraseña = '';

try {
    $gbd = new PDO($dsn, $usuario, $contraseña);
} catch (PDOException $e) {
    echo 'Falló la conexión: ' . $e->getMessage();
}

?>

Ejemplo #3 Crear una instancia de PDO usando un alias

En el siguiente ejemplo se asume que php.ini contiene la siguiente entrada para permitir la conexión a una base de datos de MySQL usando solamente el alias mydb:

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


<?php
/* Conectar auna base de datos de ODBC usando un alias */
$dsn = 'mydb';
$usuario = '';
$contraseña = '';

try {
    $gbd = new PDO($dsn, $usuario, $contraseña);
} catch (PDOException $e) {
    echo 'Falló la conexión: ' . $e->getMessage();
}

?>

Nota:
Antes de PHP 5.3, una clase que extiende a PDO e implementa el mágico __call siempre redibe un $method en minúsculas.

add a note

User Contributed Notes 13 notes

down

Kiipa at live dot com ¶

2 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

piotrekkr at o2 dot pl ¶

6 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

Victor T. ¶

6 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

subme at interia dot pl ¶

7 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

daviddlavier at gmail dot com ¶

10 months 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

Anonymous ¶

2 years 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;
    }
}

?>

down

berk0081 at umn dot edu ¶

1 year 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

Anonymous ¶

3 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

ohcc at 163 dot com ¶

10 months 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

srycroft at excelsystems dot com ¶

2 months ago


For IBM i / iSeries / AS400 DB2 connections, you can specify system naming and library lists for php_pdo modules > 1.3.3-sg2

<?php
   $pdo = new PDO(
     'ibm:' . $host,
     $user,
     $password,
     array(
       PDO::I5_ATTR_DBC_SYS_NAMING => true,
       PDO::I5_ATTR_DBC_LIBL => "QGPL QSYS"
     )
   );
?>

See http://yips.idevcloud.com/wiki/index.php/XMLSERVICE/PHPPDOChangeLog

down

-7

info at salientdigital dot com ¶

1 year 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.

down

-6

ohcc at 163 dot com ¶

10 months ago


<?php
    // PDO::__construct can end up with a fatal error rather than throw an exception even if you try ... catch ... .
    try{
        $db = new PDO(
            // a database to which connection may fail
            'mysql:host=www.wuxiancheng.cn; dbname=php; port=3306; charset=utf8',
            'root',
            'rx00t',
            array(
                PDO::ATTR_ERRMODE=>PDO::ERRMODE_EXCEPTION,
                PDO::ATTR_TIMEOUT=>1,
            )
        );
    }catch(PDOException $pe){
        
        // test the following lines of code respectively, and you will find the first line and the second line will end up with a fatal error.
        
        throw $pe; // Fatal error: in path\file.php on line n, script ends, no exception thrown        

        throw new PDOException($pe->getMessage()); //Fatal error: in path\file.php on line n, script ends, no exception thrown        
        
        throw new PDOException ('cannot connect to the database'); // an exception is thrown as expected
        
        throw new PDOException('error: '.$pe->getMessage()); //Fatal error: in path\file.php on line n, script ends, no exception thrown        

        throw new PDOException($pe->getLine()); // an exception is thrown as expected

        throw new PDOException($pe->getFile()); // an exception is thrown as expected

        throw new PDOException($pe->getCode()); // an exception is thrown as expected

        throw new PDOException($pe->getTraceAsString()); // an exception is thrown as expected
    }
?>

down

-3

olivernybroe at gmail dot com ¶

5 months ago


The PDO connection is case-sensitive, this means that you cannot write 
`$PDO = new PDO("MySQL:DBName=dbname;host=localhost");`
You would have to write it 
`$PDO = new PDO("mysql:dbname=dbname;host=localhost");`

The difference here is that `mysql` and `dbname` is with all lower-case.

Some IDE's like PHPStorm will show a `TYPO ERROR`, at `dbname` if it's written with lower-case only, this is just to be ignored and have been reported to PHPStorm for them to fix. (Currrent version 10.0.2)

add a note