To get UTF-8 charset you can specify that in the DSN.
$link = new PDO("mysql:host=localhost;dbname=DB;charset=UTF8");
(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.1.0)
PDO::__construct — Crea una instancia de PDO que representa una conexión a una base de datos
$dsn
,$username
= ?,$password
= ?,$options
= ?Crea una instancia de PDO para representar una conexión a la base de datos solicitada.
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:
dsn
contiene el DSN completo.
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
dsn
está formado por un nombre,
name
, que se corresponde con
pdo.dsn.
en php.ini,
definiendo el string del DSN.
name
Nota:
El alias debe estar definido en php.ini, y no en .htaccess o httpd.conf
El nombre de usuario para el string del DSN. Este parámetro es opcional para algunos controladores de PDO.
La contraseña para el string del DSN. Este parámetro es opcional para algunos controladores de PDO.
Un array de la forma clave=>valor con opciones de conexión específicas del controlador.
Devuelve un objeto PDO en caso de éxito.
PDO::__construct() lanza una PDOException si el intento de conexión a la base de datos requerida falla.
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.
To get UTF-8 charset you can specify that in the DSN.
$link = new PDO("mysql:host=localhost;dbname=DB;charset=UTF8");
To specify a database connection port use the following DSN string
<?php
$dsn = 'mysql:dbname=testdb;host=127.0.0.1;port=3333';
?>
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
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.
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.
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"
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);
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);
}
}
?>