Python 的 mysqldb 晦涩的文档

Question

Python 模块 mysqldb 中有许多转义函数，其文档我看不懂，我努力查找它们也没有发现任何问题。

>>> print _mysql.escape.__doc__
escape(obj, dict) -- escape any special characters in object obj
using mapping dict to provide quoting functions for each type.
Returns a SQL literal string.

This documentation page说同样的话。但是那个“映射字典”应该是什么？我尝试了一些(大部分是随机的)事情，但只返回错误。更令人沮丧的是，虽然 escape_string() 方法有效，但它的文档字符串是:

>>> print _mysql.escape_string.__doc__
escape_string(s) -- quote any SQL-interpreted characters in string s.

Use connection.escape_string(s), if you use it at all.
_mysql.escape_string(s) cannot handle character sets. You are
probably better off using connection.escape(o) instead, since
it will escape entire sequences as well as strings.

所以，我最好还是使用 _mysql.escape()，对吗？好吧，呃……好吧，但是怎么办？到底什么是“映射词典”？至少在这方面，PHP 不那么神秘。

Answer 1

我通过查看/usr/lib/pymodules/python2.6/MySQLdb/connections.py 了解到这一点查看它如何调用 connection.escape。稍微嗅一下会导致MySQLdb.converters.conversions。这是一个片段:

{0: <class 'decimal.Decimal'>,
 1: <type 'int'>,
...
 <type 'dict'>: <built-in function escape_dict>,
 <type 'NoneType'>: <function None2NULL at 0xae9717c>,
 <type 'set'>: <function Set2Str at 0xae9709c>,
 <type 'str'>: <function Thing2Literal at 0xae971b4>,
 <type 'tuple'>: <built-in function escape_sequence>,
 <type 'object'>: <function Instance2Str at 0xae971ec>,
 <type 'unicode'>: <function Unicode2Str at 0xae9710c>,
 <type 'array.array'>: <function array2Str at 0xae9725c>,
 <type 'bool'>: <function Bool2Str at 0xae97294>}

你可以这样使用它:

import MySQLdb
import MySQLdb.converters
import datetime

now=datetime.datetime.now()
connection=MySQLdb.connect(
    host=HOST,user=USER,passwd=PASS,db=MYDB)
print(connection.escape((1,2,now),MySQLdb.converters.conversions))
# ('1', '2', "'2010-07-24 19:33:59'")

附言。关于 Bobby 表:对于 MySQLdb 的正常使用，您不必手动转义参数。只需在调用 cursor.execute 时使用参数化参数，MySQLdb 就会自动为您引用参数。

例如:

sql='insert into students (name,grade,date) values (%s, %s, %s)'
args=("Robert'); DROP TABLE Students; --",60,now)   # no manual quotation necessary
cursor=connection.cursor()
cursor.execute(sql,args)