PyMySQL 安装和配置指南

1. 项目基础介绍和主要编程语言

项目介绍

PyMySQL 是一个纯 Python 编写的 MySQL 客户端库，基于 PEP 249 规范。它允许 Python 开发者通过简单的 API 与 MySQL 数据库进行交互。PyMySQL 适用于 Python 3.x 版本，是 Python 2.x 版本中使用的 mysqldb 的替代品。

主要编程语言

PyMySQL 主要使用 Python 语言编写。

2. 项目使用的关键技术和框架

关键技术

• PEP 249: PyMySQL 遵循 Python 数据库 API 规范 2.0 (PEP 249)，确保与其他数据库 API 的一致性。
• MySQL 客户端协议: PyMySQL 实现了 MySQL 客户端/服务器协议，支持与 MySQL 和 MariaDB 数据库的交互。

框架

• Python: PyMySQL 完全基于 Python 语言，不依赖于任何外部 C 库。

3. 项目安装和配置的准备工作和详细安装步骤

准备工作

在安装 PyMySQL 之前，请确保您的系统满足以下要求：

• Python 版本: 支持 Python 3.7 及以上版本。
• MySQL 服务器: 需要安装并运行 MySQL 或 MariaDB 服务器。

安装步骤

步骤 1: 安装 Python

确保您的系统上已安装 Python 3.7 或更高版本。您可以通过以下命令检查 Python 版本：

python3 --version

如果未安装 Python，请访问 Python 官方网站 下载并安装适合您操作系统的 Python 版本。

步骤 2: 安装 PyMySQL

使用 pip 安装 PyMySQL。打开终端或命令提示符，运行以下命令：

pip3 install PyMySQL

步骤 3: 验证安装

安装完成后，您可以通过以下 Python 代码验证 PyMySQL 是否安装成功：

import pymysql
print(pymysql.__version__)

如果成功打印出版本号，说明 PyMySQL 已正确安装。

步骤 4: 配置 MySQL 连接

在您的 Python 项目中，使用以下代码配置并连接到 MySQL 数据库：

import pymysql.cursors

# 连接到数据库
connection = pymysql.connect(
    host='localhost',
    user='your_username',
    password='your_password',
    database='your_database',
    cursorclass=pymysql.cursors.DictCursor
)

try:
    with connection.cursor() as cursor:
        # 创建一个新记录
        sql = "INSERT INTO `users` (`email`, `password`) VALUES (%s, %s)"
        cursor.execute(sql, ('[e-mail]', 'very-secret'))
    
    # 提交事务
    connection.commit()

    with connection.cursor() as cursor:
        # 读取一条记录
        sql = "SELECT `id`, `password` FROM `users` WHERE `email`=%s"
        cursor.execute(sql, ('[e-mail]',))
        result = cursor.fetchone()
        print(result)
finally:
    connection.close()

注意事项

• 确保 MySQL 服务器正在运行，并且您提供的用户名和密码是正确的。
• 如果需要使用特定的认证方法（如 sha256_password 或 caching_sha2_password），请安装额外的依赖：

  pip3 install PyMySQL[rsa]
  

• 如果使用 MariaDB 的 ed25519 认证方法，请安装额外的依赖：

  pip3 install PyMySQL[ed25519]
  

通过以上步骤，您应该能够成功安装并配置 PyMySQL，开始在 Python 项目中使用 MySQL 数据库。