5154-PHP新手如何连接数据库并成功添加一条数据记录？

在动态网页开发中，PHP与数据库的交互是构建功能强大应用的核心，向数据库添加数据（即执行INSERT操作）是最基础且频繁的任务之一，本文将详细介绍如何使用PHP安全、高效地向MySQL数据库中添加数据，涵盖准备工作、连接数据库、执行添加操作以及关键的安全实践。

PHP新手如何连接数据库并成功添加一条数据记录？

准备工作：创建数据库与表

在编写PHP代码之前，您需要确保已经具备一个运行中的数据库环境（如MySQL），并创建好了目标数据库和数据表，以一个简单的用户表为例，您可以通过以下SQL语句在MySQL中创建一个名为my_website的数据库和一个users表。

-- 创建数据库
CREATE DATABASE IF NOT EXISTS my_website CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-- 使用数据库
USE my_website;
-- 创建用户表
CREATE TABLE IF NOT EXISTS users (
    id INT(11) AUTO_INCREMENT PRIMARY KEY,
    username VARCHAR(50) NOT NULL UNIQUE,
    email VARCHAR(100) NOT NULL UNIQUE,
    reg_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

这个users表包含了自增主键id、用户名username、邮箱email和注册时间reg_date，准备好这个基础结构后,我们就可以开始编写PHP代码来向其中添加数据了。

连接数据库

PHP提供了两种主流的方式来与MySQL数据库交互：MySQLi（MySQL Improved）和PDO（PHP Data Objects），PDO因其支持多种数据库系统和更强大的功能（尤其是预处理语句）而成为现代PHP开发的首选。

使用PDO连接数据库

PDO提供了一个数据访问抽象层，这意味着无论使用哪种数据库,其函数都是统一的。

<?php
$host = 'localhost';
$db   = 'my_website';
$user = 'root'; // 您的数据库用户名
$pass = '';     // 您的数据库密码
$charset = 'utf8mb4';
$dsn = "mysql:host=$host;dbname=$db;charset=$charset";
$options = [
    PDO::ATTR_ERRMODE            => PDO::ERRMODE_EXCEPTION, // 抛出异常
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,       // 默认获取关联数组
    PDO::ATTR_EMULATE_PREPARES   => false,                  // 禁用预处理模拟
];
try {
     $pdo = new PDO($dsn, $user, $pass, $options);
} catch (\PDOException $e) {
     throw new \PDOException($e->getMessage(), (int)$e->getCode());
}
?>

这段代码通过try...catch块来处理连接错误，如果连接失败，会抛出异常并显示错误信息,这在开发阶段非常有用。

核心步骤：向数据库添加数据

向数据库添加数据的核心是执行SQL的INSERT语句，为了防止SQL注入攻击，强烈推荐使用预处理语句。

PHP新手如何连接数据库并成功添加一条数据记录？

使用PDO预处理语句添加数据

预处理语句将SQL命令与数据分离开来，首先发送SQL模板到数据库服务器进行编译，然后再发送数据，这样,数据就永远不会被当作SQL代码的一部分来执行。

以下是完整的添加数据示例：

<?php
// ... (此处包含上面的PDO连接代码) ...
// 假设我们从表单或其它地方获取了用户数据
$username = 'testuser';
$email = 'test@example.com';
// 1. 准备SQL语句模板，使用命名占位符
$sql = "INSERT INTO users (username, email) VALUES (:username, :email)";
// 2. 准备预处理语句
$stmt = $pdo->prepare($sql);
// 3. 绑定参数并执行
try {
    // 绑定变量到命名占位符
    $stmt->bindParam(':username', $username, PDO::PARAM_STR);
    $stmt->bindParam(':email', $email, PDO::PARAM_STR);
    // 执行语句
    $stmt->execute();
    echo "新用户ID: " . $pdo->lastInsertId(); // 获取最后插入的记录ID
} catch (\PDOException $e) {
    // 如果用户名或邮箱已存在（因为设置了UNIQUE约束），会捕获到异常
    echo "添加失败: " . $e->getMessage();
}
// 关闭连接
$pdo = null;
?>

使用MySQLi预处理语句添加数据

如果您选择使用MySQLi,其面向对象的写法与PDO类似。

<?php
// MySQLi 连接信息
$host = 'localhost';
$db   = 'my_website';
$user = 'root';
$pass = '';
// 创建连接
$mysqli = new mysqli($host, $user, $pass, $db);
// 检查连接
if ($mysqli->connect_error) {
    die("连接失败: " . $mysqli->connect_error);
}
// 准备数据
$username = 'mysqli_user';
$email = 'mysqli@example.com';
// 1. 准备SQL语句，使用问号占位符
$sql = "INSERT INTO users (username, email) VALUES (?, ?)";
// 2. 准备预处理语句
$stmt = $mysqli->prepare($sql);
if ($stmt === false) {
    die("预处理失败: " . $mysqli->error);
}
// 3. 绑定参数并执行
// "ss" 表示两个参数都是字符串类型
$stmt->bind_param("ss", $username, $email);
if ($stmt->execute()) {
    echo "新用户ID: " . $stmt->insert_id;
} else {
    echo "添加失败: " . $stmt->error;
}
// 关闭语句和连接
$stmt->close();
$mysqli->close();
?>

PDO与MySQLi对比

为了帮助您做出选择,下表小编总结了PDO和MySQLi的主要区别：

特性	PDO (PHP Data Objects)	MySQLi (MySQL Improved)
数据库支持	支持12种及以上数据库（MySQL, PostgreSQL, SQLite等）	仅支持MySQL
API风格	面向对象	面向对象、过程化
命名参数	支持（如 `username`）	不支持，仅支持占位符
预处理语句	客户端和服务端都支持	仅服务端支持
错误处理	基于异常（`PDOException`）	基于返回值和`mysqli_error()`

从长远来看，学习和使用PDO是更具前瞻性的选择,它为未来可能的项目迁移提供了极大的便利。

安全注意事项

永远不要信任用户输入：在将数据存入数据库前，应进行验证和过滤，检查邮箱格式是否正确,用户名长度是否符合要求。
始终使用预处理语句：这是防止SQL注入最有效的方法,切勿直接将变量拼接到SQL字符串中。
隐藏详细错误信息：在生产环境中，应关闭PHP的错误显示，并将错误记录到日志文件中,避免向用户暴露数据库结构等敏感信息。

一	二	三	四	五	六	日
					1	2
3	4	5	6	7	8	9
10	11	12	13	14	15	16
17	18	19	20	21	22	23
24	25	26	27	28	29	30

5154

Good Luck To You!

PHP新手如何连接数据库并成功添加一条数据记录？2025-10-28 09:37:05