PDO：插入示例

柔光的暖阳◎ 2023-09-27 10:04 110阅读 0赞

这是关于如何使用 PHP 的 PDO 对象将行插入 MySQL 数据库的初学者教程。请注意，我还写[了一篇关于如何使用 PDO 进行多插入的教程][PDO]。但是，对于本教程，我将坚持基础知识。

示例 MySQL 表：

CREATE TABLE IF NOT EXISTS `cars` (
      `id` int(10) unsigned NOT NULL AUTO_INCREMENT,
      `make` varchar(100) COLLATE utf8_unicode_ci NOT NULL,
      `model` varchar(100) COLLATE utf8_unicode_ci NOT NULL,
      PRIMARY KEY (`id`)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci AUTO_INCREMENT=1 ;

出于本示例的目的，我创建了一个名为**cars**的简单表。如果您打算使用 PDO 扩展，请务必将上述 SQL 导入您自己的数据库。

### PDO 插入示例。 ###

首先，我们需要[使用 PDO 对象连接到 MySQL][PDO _ MySQL]。

//MySQL connection details.
    $host = 'localhost';
    $user = 'root';
    $pass = '';
    $database = 'test';
    
    //Custom PDO options.
    $options = array(
        PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
        PDO::ATTR_EMULATE_PREPARES => false
    );
    
    //Connect to MySQL and instantiate our PDO object.
    $pdo = new PDO("mysql:host=$host;dbname=$database", $user, $pass, $options);

一旦我们连接到 MySQL 并选择了我们的数据库，我们就可以执行一个准备好的插入语句：

//Create our INSERT SQL query.
    $sql = "INSERT INTO `cars` (`make`, `model`) VALUES (:make, :model)";
    
    
    //Prepare our statement.
    $statement = $pdo->prepare($sql);
    
    
    //Bind our values to our parameters (we called them :make and :model).
    $statement->bindValue(':make', 'Nissan');
    $statement->bindValue(':model', 'Primera');
    
    
    //Execute the statement and insert our values.
    $inserted = $statement->execute();
    
    
    //Because PDOStatement::execute returns a TRUE or FALSE value,
    //we can easily check to see if our insert was successful.
    if($inserted){
        echo 'Row inserted!<br>';
    }

使用 PDO 对象向 MySQL 中插入一行的过程实际上非常简单：

1.  我们创建了 INSERT SQL 语句。请注意我们如何创建“占位符”，例如**:make**和**:model**。稍后，这些占位符将允许我们将数据“绑定”到语句。请记住，在准备好的语句中，与 MySQL 服务器进行了两轮通信。首先，我们通过“准备”告诉 MySQL 我们语句的结构。然后，我们通过“绑定”我们的数据并执行语句来发送数据。
2.  我们准备了我们的声明。
3.  我们将要插入的数据绑定到语句中。
4.  之后，我们执行语句（从而执行 SQL 查询）。
5.  最后，我们检查了**PDOStatement::execute**的结果是否为布尔 TRUE 值。如果为TRUE，则表示新行插入成功。如果它为 FALSE，则意味着 MySQL 无法插入该行。在这种情况下，您很可能会遇到 PDOException 错误。

### 使用 PDO 插入多行。 ###

请注意，您可以重复使用相同的语句来[插入多行][PDO]：

//Create our SQL query.
    $sql = "INSERT INTO `cars` (`make`, `model`) VALUES (:make, :model)";
    
    
    //Prepare our statement using the SQL query.
    $statement = $pdo->prepare($sql);
    
    
    //Bind our values to our parameters (we called them :make and :model).
    $statement->bindValue(':make', 'Nissan');
    $statement->bindValue(':model', 'Primera');
    
    
    //Execute the statement and insert our values.
    $inserted = $statement->execute();
    
    //Because PDOStatement::execute returns a TRUE or FALSE value,
    //we can easily check to see if our insert was successful.
    if($inserted){
        echo 'Row inserted!<br>';
    }
    
    //For our next row, we're going to insert a Honda Civic.
    //We will re-use the statement that we already prepared.
    $statement->bindValue(':make', 'Honda');
    $statement->bindValue(':model', 'Civic');
    
    
    //Execute the statement and insert our values.
    $statement->execute();

请注意我们如何两次执行相同的语句，而不必为每次插入准备一个新语句。

### 使用 PDO 的速记/快速插入。 ###

还有一个速记版本。

//Create our SQL query.
    $sql = "INSERT INTO `cars` (`make`, `model`) VALUES (?, ?)";
    
    //Prepare the statement.
    $statement = $pdo->prepare($sql);
    
    //Execute it
    $statement->execute(array('Honda', 'Civic'));

如您所见，这种方法要快得多。

PDO初学者的相关阅读：

*  [使用 PDO 连接到 MySQL。][PDO _ MySQL]
 *  [使用 PDO 插入多行。][PDO]
 *  [使用 PDO 对象从数据库中选择行。][PDO 1]
 *  [使用 PDO 对象更新行。][PDO 2]
 *  [使用 PDO 对象删除行。][PDO 3]

[PDO]: https://thisinterestsme.com/pdo-prepared-multi-inserts/
[PDO _ MySQL]: https://thisinterestsme.com/php-connect-mysql-database/
[PDO 1]: https://thisinterestsme.com/pdo-selecting-rows-from-mysql/
[PDO 2]: https://thisinterestsme.com/pdo-updating-mysql-prepared-statements/
[PDO 3]: https://thisinterestsme.com/deleting-rows-pdo/