PHP 8.4.1 Released!

    PDO::__construct

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

    PDO::__construct — Cria uma instância PDO representando uma conexão a um banco de dados

    Descrição

    public PDO::__construct(
        string $dsn,
        ?string $username = null,
        #[\SensitiveParameter] ?string $password = null,
        ?array $options = null
    )

    Cria uma instância PDO para representar uma conexão ao banco de dados requisitado.

    Parâmetros

    dsn

    O nome da fonte de dados, ou DSN, que contém a informação requerida para conexão ao banco de dados.

    Em geral, um DSN consiste no nome do driver PDO, seguido por dois-pontos, seguido pela sintaxe de conexão específica do driver PDO. Maiores informações estão disponíveis na documentação específica do driver PDO.

    O parâmetro dsn suporta três métodos diferentes para especificar os argumentos requeridos para criação de uma conexão de banco de dados:

    Invocação do driver

    dsn contém o DSN completo.

    Invocação de URI

    dsn consiste em uri: seguido por uma URI que define a localização de um arquivo contendo a string DSN. A URI pode especificar um arquivo local ou uma URL remota.

    uri:file:///caminho/para/arquivodsn

    Criação de apelido

    dsn consiste em um nome (name) que é mapeado para pdo.dsn.name no php.ini definindo a string DSN.

    Nota:

    O apelido deve ser definido no php.ini, e não no .htaccess ou no httpd.conf

    username

    O nome de usuário para a string DSN. Este parâmetro é opcional para alguns drivers PDO.

    password

    A senha para a srting DSN. Este parâmetro é opcional para alguns drivers PDO.

    options

    Um array de chave=>valor de opções de conexão específicas do driver.

    Erros/Exceções

    PDO::__construct() lança uma exceção PDOException se a tentativa de conexão ao banco de dados requisitado falhar, independente de qual PDO::ATTR_ERRMODE estiver definido.

    Exemplos

    Exemplo #1 Cria uma instância PDO através de invocação de driver

    <?php

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

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

    ?>

    Exemplo #2 Cria uma instância PDO através de invocação de URI

    O exemplo a seguir assume que o arquivo /usr/local/dbconnect existe com permissões de leitura pelo PHP. O arquivo contém o DSN PDO para conexão a um banco de dados DB2 através do driver PDO_ODBC: 

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

    O script PHP pode então criar uma conexão ao banco de dados simplesmente passando o parâmetro uri: e apontando para a URI do arquivo:

    <?php

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

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

    ?>

    Exemplo #3 Cria uma instância PDO usando um apelido

    O exemplo a seguir assume que o php.ini contém a seguinte entrada para habilitar uma conexão ao banco de dados MySQL usando somente o apelido mydb: 

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

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

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

    ?>

    Melhore Esta Página

    Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema
    ＋adicione uma nota

    Notas Enviadas por Usuários (em inglês) 14 notes

    up
    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");
    up
    41
    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';
    ?>
    up
    8
    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
    up
    29
    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.
    up
    20
    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.
    up
    3
    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);
    }
    }
    ?>
    up
    4
    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"
    up
    10
    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);
    up
    14
    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\''));
    ?>
    up
    1
    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();
    }
    ?>
    up
    0
    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.
    up
    -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();
    }
    ?>
    up
    -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");
    ?>
    up
    -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.
    ＋adicione uma nota
    To Top