Edit Report a Bug

    PDO::__construct

    (PHP 5 >= 5.1.0, 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 $driver_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.

    driver_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 ODBC 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 fichero URI:

    <?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();
    }

    ?>

    add a note add a note

    User Contributed Notes 6 notes

    up
    12
    Kiipa at live dot com
    4 months ago
    To get UTF-8 charset you can specify that in the DSN.

    $link = new PDO("mysql:host=localhost;dbname=DB;charset=UTF8");
    up
    14
    Victor T.
    4 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
    10
    subme at interia dot pl
    5 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
    3
    Anonymous
    9 months 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
    2
    piotrekkr at o2 dot pl
    3 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
    -4
    Mitsuaki Ishimoto
    3 years ago
    You have to use the following option "MYSQL_ATTR_READ_DEFAULT_FILE" to prevent someone from attacking your system by SQL Injection.

    <?php
    $dsn     = 'mysql:host=' . DB_HOST . ';dbname=' . DB_NAME;
    $dbh = new PDO(
            $dsn,
            DB_USER,
            DB_PASS,
        array(
                PDO::MYSQL_ATTR_READ_DEFAULT_FILE => '/etc/my.cnf'
            )
    );
    $dbh->setAttribute(PDO::ATTR_EMULATE_PREPARES, false);
    ?>
    add a note add a note
    To Top