PDO connection setup in PHP

Introduction

PDO helps you connect to databases safely and easily. It makes talking to databases simple and secure.

When you want to connect your PHP code to a MySQL database.

When you need to run database queries safely without risking security problems.

When you want to switch between different database types without changing much code.

When you want to handle errors in database connections clearly.

When you want to prepare database commands to avoid mistakes or attacks.

Syntax

PHP

<?php
$dsn = 'mysql:host=your_host;dbname=your_dbname;charset=utf8';
$username = 'your_username';
$password = 'your_password';

try {
    $pdo = new PDO($dsn, $username, $password);
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    echo "Connected successfully.";
} catch (PDOException $e) {
    echo "Connection failed: " . $e->getMessage();
}
?>

The $dsn string tells PDO where the database is and which one to use.

Setting PDO::ATTR_ERRMODE to PDO::ERRMODE_EXCEPTION helps catch errors clearly.

Examples

Basic connection to a MySQL database on your local computer.

PHP

<?php
$dsn = 'mysql:host=localhost;dbname=testdb;charset=utf8';
$username = 'root';
$password = '';
$pdo = new PDO($dsn, $username, $password);
?>

Connecting to a PostgreSQL database using PDO.

PHP

<?php
$dsn = 'pgsql:host=localhost;port=5432;dbname=testdb';
$username = 'postgres';
$password = 'secret';
$pdo = new PDO($dsn, $username, $password);
?>

Connecting to a SQLite database file without username or password.

PHP

<?php
$dsn = 'sqlite:/path/to/database.db';
$pdo = new PDO($dsn);
?>

Sample Program

This program tries to connect to a MySQL database named mydatabase on the local machine. It prints a success message if it connects or an error message if it fails.

PHP

<?php
$dsn = 'mysql:host=localhost;dbname=mydatabase;charset=utf8';
$username = 'user123';
$password = 'pass123';

try {
    $pdo = new PDO($dsn, $username, $password);
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    echo "Connected successfully.";
} catch (PDOException $e) {
    echo "Connection failed: " . $e->getMessage();
}
?>

Important Notes

Always use try-catch to handle connection errors gracefully.

Use UTF-8 charset in DSN to avoid character problems.

Keep your database username and password safe and never share them publicly.

Summary

PDO lets you connect to databases in a safe and easy way.

Use DSN, username, and password to set up the connection.

Handle errors with try-catch and set error mode to exceptions.

Practice

1. What is the main purpose of using PDO in PHP?

easy

A. To connect to databases securely and easily

B. To create HTML pages

C. To handle user sessions

D. To send emails

Solution

1. Step 1: Understand PDO's role

   PDO is a PHP extension designed to connect to databases in a secure and consistent way.

2. Step 2: Compare other options

   Other options like creating HTML, handling sessions, or sending emails are unrelated to PDO.

3. Final Answer:

   To connect to databases securely and easily -> Option A

4. Quick Check:

   PDO = Secure database connection [OK]

Hint: PDO is for database connections only [OK]

Common Mistakes:

• Confusing PDO with HTML or session functions
• Thinking PDO sends emails
• Assuming PDO is for file handling

2. Which of the following is the correct way to create a new PDO connection to a MySQL database named 'testdb' on localhost with username 'user' and password 'pass'?

easy

A. $pdo = new PDO('host=localhost;dbname=testdb', 'user', 'pass');

B. $pdo = new PDO('mysql:localhost;dbname=testdb', 'user', 'pass');

C. $pdo = new PDO('mysql://localhost/testdb', 'user', 'pass');

D. $pdo = new PDO('mysql:host=localhost;dbname=testdb', 'user', 'pass');

Solution

1. Step 1: Check DSN format for MySQL

   The correct DSN format is 'mysql:host=hostname;dbname=database_name'.

2. Step 2: Verify options

   $pdo = new PDO('mysql:host=localhost;dbname=testdb', 'user', 'pass'); uses the correct DSN format with host and dbname separated by semicolon and includes username and password.

3. Final Answer:

   $pdo = new PDO('mysql:host=localhost;dbname=testdb', 'user', 'pass'); -> Option D

4. Quick Check:

   DSN format = 'mysql:host=...;dbname=...' [OK]

Hint: DSN must start with 'mysql:' and use semicolons [OK]

Common Mistakes:

• Omitting 'mysql:' prefix
• Using slashes instead of semicolons
• Missing 'host=' keyword

3. What will be the output of this PHP code snippet?

$dsn = 'mysql:host=localhost;dbname=testdb';
try {
    $pdo = new PDO($dsn, 'user', 'wrongpass');
    echo 'Connected';
} catch (PDOException $e) {
    echo 'Connection failed: ' . $e->getMessage();
}

medium

A. Connected

B. Connection failed: SQLSTATE[HY000] [1045] Access denied for user 'user'@'localhost' (using password: YES)

C. Syntax error

D. No output

Solution

1. Step 1: Analyze connection attempt

   The code tries to connect with username 'user' but a wrong password 'wrongpass'.

2. Step 2: Understand error handling

   PDO throws a PDOException on failure, caught by catch block, which prints the error message.

3. Final Answer:

   Connection failed: SQLSTATE[HY000] [1045] Access denied for user 'user'@'localhost' (using password: YES) -> Option B

4. Quick Check:

   Wrong password triggers exception message [OK]

Hint: Wrong password triggers exception message [OK]

Common Mistakes:

• Expecting 'Connected' despite wrong password
• Ignoring try-catch block
• Assuming no output on failure

4. Identify the error in this PDO connection code:

try {
    $pdo = new PDO('mysql:host=localhost;dbname=testdb', 'user', 'pass');
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
} catch (PDOException $e) {
    echo 'Error: ' . $e->getMessage();
}

medium

A. Missing DSN string

B. Incorrect error mode constant

C. No error, code is correct

D. Missing semicolon after setAttribute

Solution

1. Step 1: Review DSN and credentials

   The DSN string is correct and includes host and dbname properly.

2. Step 2: Check error mode setting

   PDO::ATTR_ERRMODE and PDO::ERRMODE_EXCEPTION are valid constants to enable exceptions on errors.

3. Step 3: Verify syntax

   All lines end with semicolons and try-catch is properly structured.

4. Final Answer:

   No error, code is correct -> Option C

5. Quick Check:

   Correct DSN and error mode = no error [OK]

Hint: Check constants and syntax carefully [OK]

Common Mistakes:

• Using wrong error mode constants
• Forgetting semicolons
• Miswriting DSN string

5. You want to connect to a MySQL database using PDO and ensure that any connection error throws an exception. Which code snippet correctly sets up the connection and error handling?

hard

A. try {
$pdo = new PDO('mysql:host=localhost;dbname=testdb', 'user', 'pass');
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
} catch (PDOException $e) {
echo 'Connection failed: ' . $e->getMessage();
}

B. try {
$pdo = new PDO('mysql:host=localhost;dbname=testdb', 'user', 'pass');
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_SILENT);
} catch (Exception $e) {
echo 'Error';
}

C. $pdo = new PDO('mysql:host=localhost;dbname=testdb', 'user', 'pass');
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_WARNING);

D. try {
$pdo = new PDO('mysql:host=localhost;dbname=testdb', 'user', 'pass');
} catch (PDOException $e) {
echo 'Error: ' . $e->getMessage();
}
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

Solution

1. Step 1: Check error mode setting

   Setting PDO::ATTR_ERRMODE to PDO::ERRMODE_EXCEPTION ensures exceptions on errors.

2. Step 2: Verify try-catch placement

   The error mode must be set inside the try block before any database operations, so exceptions are caught properly.

3. Step 3: Analyze options

   try { $pdo = new PDO('mysql:host=localhost;dbname=testdb', 'user', 'pass'); $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); } catch (PDOException $e) { echo 'Connection failed: ' . $e->getMessage(); } correctly sets error mode inside try and catches PDOException with detailed message.

4. Final Answer:

   try { $pdo = new PDO('mysql:host=localhost;dbname=testdb', 'user', 'pass'); $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); } catch (PDOException $e) { echo 'Connection failed: ' . $e->getMessage(); } -> Option A

5. Quick Check:

   Error mode exception + try-catch = try { $pdo = new PDO('mysql:host=localhost;dbname=testdb', 'user', 'pass'); $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); } catch (PDOException $e) { echo 'Connection failed: ' . $e->getMessage(); } [OK]

Hint: Set error mode to exception inside try block [OK]

Common Mistakes:

• Setting error mode outside try block
• Using wrong error mode constants
• Catching wrong exception type