To get UTF-8 charset you can specify that in the DSN.
$link = new PDO("mysql:host=localhost;dbname=DB;charset=UTF8");
PDO::__construct
(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.1.0)
PDO::__construct — データベースへの接続を表す PDO インスタンスを生成する
説明
public PDO::__construct(string
$dsn, string|null $username = null, string|null $password = null, array|null $options = null)指定されたデータベースへの接続を表す PDO インスタンスを生成します。
パラメータ
- dsn
-
データソース名(Data Source Name)またはDSN。データベースに接続するために 必要な情報が含まれます。
一般に、DSNはPDOドライバ名の後にコロンが続き、 各PDOドライバに固有の接続構文が続きます。より多くの情報は PDO driver-specific documentation にあります。
dsnパラメータは、データベースへの接続を生成する ために必要な引数を指定する方法として、3種類の方法をサポートします。- ドライバ呼び出し
-
dsnに完全な DSN を指定します。 - URI 呼び出し
-
dsnは、uri:の後に DSN 文字列を含むファイルの位置を定義する URI が続く形式となります。 この URI には、ローカルファイルまたはリモート URL を指定することができます。uri:file:///path/to/dsnfile - エイリアス
-
dsnは、DSN 文字列を定義する php.ini のpdo.dsn.nameへマップする名前nameからなります。注意:
エイリアスは、.htaccess や httpd.conf ではなく、 php.ini で定義する必要があります。
- username
-
DSN 文字列のユーザー名。このパラメータは、いくつかの PDO ドライバではオプションです。
- passwd
-
パスワード。DSN 文字列で必要とされる場合に指定。
- options
-
ドライバ固有の接続オプションを指定するキー=> 値の配列。
返り値
成功時に PDO オブジェクトを返します。
エラー / 例外
PDO::__construct() は、
指定されたデータベースへの接続に失敗した場合、
PDO::ATTR_ERRMODE が設定されているかどうかに関わらず、
PDOException を投げます。
例
例1 ドライバ呼び出しにより PDO インスタンスを生成する
<?php
/* ドライバ呼び出しを使用して MySQL データベースに接続する */
$dsn = 'mysql:dbname=testdb;host=127.0.0.1';
$user = 'dbuser';
$password = 'dbpass';
$dbh = new PDO($dsn, $user, $password);
?>
例2 URI 呼び出しにより PDO インスタンスを生成する
以下の例では、ファイル /usr/local/dbconnect が存在し、 PHP がこのファイルを読み込む権限を有していることを仮定します。 このファイルには、 PDO_ODBC により DB2 データベースに接続するための PDO DSN が含まれています。
odbc:DSN=SAMPLE;UID=john;PWD=mypass
これにより、PHP スクリプトでは、単に uri: パラメータを渡し、
ファイルの URI を示すだけでデータベース接続を作成することができるようになります。
<?php
/* ドライバ呼び出しを使用して ODBC データベースに接続する */
$dsn = 'uri:file:///usr/local/dbconnect';
$user = '';
$password = '';
$dbh = new PDO($dsn, $user, $password);
?>
例3 エイリアスにより PDO インスタンスを生成する
以下の例では、php.ini にエイリアス mydb のみで
MySQL データベースに接続できるようにするための以下のエントリが含まれることを
仮定します。
[PDO] pdo.dsn.mydb="mysql:dbname=testdb;host=localhost"
<?php
/* エイリアスを使用して ODBC データベースに接続する */
$dsn = 'mydb';
$user = '';
$password = '';
$dbh = new PDO($dsn, $user, $password);
?>
add a note
User Contributed Notes 12 notes
Kiipa at live dot com ¶
10 years ago
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);
piotrekkr at o2 dot pl ¶
13 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.
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';
?>
daviddlavier at gmail dot com ¶
8 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.
Aymeric S ¶
3 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
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\''));
?>
Anonymous ¶
10 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.
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();
}
?>
berk0081 at umn dot edu ¶
9 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");
?>
srycroft at excelsystems dot com ¶
7 years 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
olivernybroe at gmail dot com ¶
8 years 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)
