f6bbe21997-03-06Henrik Grubbström (Grubba) /* * Glue for the Mysql-module */
a6d6bd2011-03-05Martin Stjernholm //! This class encapsulates a connection to a MySQL server, and //! implements the glue needed to access the Mysql module from the //! generic SQL module. //! //! @section Typed mode //! //! When query results are returned in typed mode, the MySQL data //! types are represented like this: //! //! @dl
5ae2462011-03-07Martin Stjernholm //! @item The NULL value
a6d6bd2011-03-05Martin Stjernholm //! Returned as @[Val.null]. //!
5ae2462011-03-07Martin Stjernholm //! @item BIT, TINYINT, BOOL, SMALLINT, MEDIUMINT, INT, BIGINT
a6d6bd2011-03-05Martin Stjernholm //! Returned as pike integers. //!
5ae2462011-03-07Martin Stjernholm //! @item FLOAT, DOUBLE
a6d6bd2011-03-05Martin Stjernholm //! Returned as pike floats. //! //! @item DECIMAL //! Returned as pike integers for fields that are declared to //! contain zero decimals, otherwise returned as @[Gmp.mpq] objects. //!
5ae2462011-03-07Martin Stjernholm //! @item DATE, DATETIME, TIME, YEAR
a6d6bd2011-03-05Martin Stjernholm //! Returned as strings in their display representation (see the //! MySQL manual). //! //! @[Calendar] objects are not used partly because they always //! represent a specific point or range in time, which these MySQL //! types do not. //! //! @item TIMESTAMP //! Also returned as strings in the display representation. //! //! The reason is that it's both more efficient and more robust (wrt //! time zone interpretations) to convert these to unix timestamps //! on the MySQL side rather than in the client glue. I.e. use the //! @tt{UNIX_TIMESTAMP@} function in the queries to retrieve them as //! unix timestamps on integer form. //!
5ae2462011-03-07Martin Stjernholm //! @item String types
a6d6bd2011-03-05Martin Stjernholm //! All string types are returned as pike strings. The MySQL glue //! can handle charset conversions for text strings - see //! @[set_charset] and @[set_unicode_decode_mode]. //! //! @enddl //!
31b2302011-03-06Henrik Grubbström (Grubba) //! @endsection
71562c2017-03-10Henrik Grubbström (Grubba) //! //! @seealso //! @[Sql.Connection], @[Sql.Sql()]
4182211998-03-20Henrik Grubbström (Grubba) 
a580e12000-09-27Fredrik Hübinette (Hubbe) #pike __REAL_VERSION__
e1fb092014-02-14Martin Nilsson #require constant(Mysql.mysql)
a20af62000-09-26Fredrik Hübinette (Hubbe) 
e1fb092014-02-14Martin Nilsson // Cannot dump this since the #require check may depend on the // presence of system libs at runtime.
7094252017-03-31Henrik Grubbström (Grubba) optional constant dont_dump_program = 1;
a59c792010-11-02Martin Stjernholm 
71562c2017-03-10Henrik Grubbström (Grubba) //!
f6bbe21997-03-06Henrik Grubbström (Grubba) inherit Mysql.mysql;
2f9cc31998-03-19Henrik Grubbström (Grubba) 
aa16eb2006-08-12Martin Stjernholm #define UNICODE_DECODE_MODE 1 // Unicode decode mode #define LATIN1_UNICODE_ENCODE_MODE 2 // Unicode encode mode with latin1 charset #define UTF8_UNICODE_ENCODE_MODE 4 // Unicode encode mode with utf8 charset
a9db912006-08-22Henrik Grubbström (Grubba)  #ifdef MYSQL_CHARSET_DEBUG
92b88f2012-01-07Martin Stjernholm #define CH_DEBUG(X...) \ werror(replace (sprintf ("%O", this), "%", "%%") + ": " + X)
a9db912006-08-22Henrik Grubbström (Grubba) #else #define CH_DEBUG(X...) #endif
30a56b2006-08-10Henrik Grubbström (Grubba) 
bd49a62007-05-03Martin Stjernholm #if !constant (Mysql.mysql.HAVE_MYSQL_FIELD_CHARSETNR)
9bcbd22007-05-03Martin Stjernholm // Recognition constant to tell that the unicode decode mode would use // the buggy MySQLBrokenUnicodeWrapper if it would be enabled through // any of the undocumented methods. constant unicode_decode_mode_is_broken = 1; #endif
e7bdd02006-09-15Martin Stjernholm // Set to the above if the connection is requested to be in one of the // unicode modes. latin1 unicode encode mode is enabled by default; it // should be compatible with earlier pike versions.
9eaf1d2008-06-28Martin Nilsson protected int utf8_mode;
30a56b2006-08-10Henrik Grubbström (Grubba) 
aa16eb2006-08-12Martin Stjernholm // The charset, either "latin1" or "utf8", currently assigned to
e7bdd02006-09-15Martin Stjernholm // character_set_client when unicode encode mode is enabled. Zero when // the connection charset has been set to something else than "latin1" // or "unicode".
9eaf1d2008-06-28Martin Nilsson protected string send_charset;
b3d1362006-08-10Martin Stjernholm 
9eaf1d2008-06-28Martin Nilsson protected void update_unicode_encode_mode_from_charset (string charset)
aa16eb2006-08-12Martin Stjernholm { switch (charset) { // Lowercase assumed. case "latin1": utf8_mode |= LATIN1_UNICODE_ENCODE_MODE; utf8_mode &= ~UTF8_UNICODE_ENCODE_MODE; send_charset = "latin1";
e7bdd02006-09-15Martin Stjernholm  CH_DEBUG ("Entering latin1 encode mode.\n");
aa16eb2006-08-12Martin Stjernholm  break; case "unicode": utf8_mode |= UTF8_UNICODE_ENCODE_MODE; utf8_mode &= ~LATIN1_UNICODE_ENCODE_MODE; send_charset = "utf8";
e7bdd02006-09-15Martin Stjernholm  CH_DEBUG ("Entering unicode encode mode.\n");
aa16eb2006-08-12Martin Stjernholm  break; default: // Wrong charset - the mode can't be used. utf8_mode |= LATIN1_UNICODE_ENCODE_MODE|UTF8_UNICODE_ENCODE_MODE; send_charset = 0;
e7bdd02006-09-15Martin Stjernholm  CH_DEBUG ("Not entering latin1/unicode encode mode " "due to incompatible charset %O.\n", charset);
aa16eb2006-08-12Martin Stjernholm  break; } } int(0..1) set_unicode_encode_mode (int enable) //! Enables or disables unicode encode mode.
30a56b2006-08-10Henrik Grubbström (Grubba) //!
aa16eb2006-08-12Martin Stjernholm //! In this mode, if the server supports UTF-8 and the connection //! charset is @expr{latin1@} (the default) or @expr{unicode@} then //! @[big_query] handles wide unicode queries. Enabled by default.
30a56b2006-08-10Henrik Grubbström (Grubba) //!
aa16eb2006-08-12Martin Stjernholm //! Unicode encode mode works as follows: Eight bit strings are sent //! as @expr{latin1@} and wide strings are sent using @expr{utf8@}.
e7bdd02006-09-15Martin Stjernholm //! @[big_query] sends @expr{SET character_set_client@} statements as //! necessary to update the charset on the server side. If the server //! doesn't support that then it fails, but the wide string query //! would fail anyway.
b3d1362006-08-10Martin Stjernholm //!
aa16eb2006-08-12Martin Stjernholm //! To make this transparent, string literals with introducers (e.g. //! @expr{_binary 'foo'@}) are excluded from the UTF-8 encoding. This //! means that @[big_query] needs to do some superficial parsing of //! the query when it is a wide string.
b3d1362006-08-10Martin Stjernholm //!
30a56b2006-08-10Henrik Grubbström (Grubba) //! @returns
aa16eb2006-08-12Martin Stjernholm //! @int //! @value 1 //! Unicode encode mode is enabled. //! @value 0 //! Unicode encode mode couldn't be enabled because an //! incompatible connection charset is set. You need to do //! @expr{@[set_charset]("latin1")@} or //! @expr{@[set_charset]("unicode")@} to enable it. //! @endint
b3d1362006-08-10Martin Stjernholm //! //! @note
aa16eb2006-08-12Martin Stjernholm //! Note that this mode doesn't affect the MySQL system variable //! @expr{character_set_connection@}, i.e. it will still be set to //! @expr{latin1@} by default which means server functions like //! @expr{UPPER()@} won't handle non-@expr{latin1@} characters //! correctly in all cases. //! //! To fix that, do @expr{@[set_charset]("unicode")@}. That will //! allow unicode encode mode to work while @expr{utf8@} is fully //! enabled at the server side. //! //! Tip: If you enable @expr{utf8@} on the server side, you need to //! send raw binary strings as @expr{_binary'...'@}. Otherwise they //! will get UTF-8 encoded by the server.
30a56b2006-08-10Henrik Grubbström (Grubba) //! //! @note
aa16eb2006-08-12Martin Stjernholm //! When unicode encode mode is enabled and the connection charset //! is @expr{latin1@}, the charset accepted by @[big_query] is not //! quite Unicode since @expr{latin1@} is based on @expr{cp1252@}. //! The differences are in the range @expr{0x80..0x9f@} where
9bcbd22007-05-03Martin Stjernholm //! Unicode has control chars.
aa16eb2006-08-12Martin Stjernholm //! //! This small discrepancy is not present when the connection //! charset is @expr{unicode@}.
30a56b2006-08-10Henrik Grubbström (Grubba) //! //! @seealso
aa16eb2006-08-12Martin Stjernholm //! @[set_unicode_decode_mode], @[set_charset]
30a56b2006-08-10Henrik Grubbström (Grubba) {
e7bdd02006-09-15Martin Stjernholm  if (enable)
aa16eb2006-08-12Martin Stjernholm  update_unicode_encode_mode_from_charset (lower_case (get_charset()));
e7bdd02006-09-15Martin Stjernholm  else {
aa16eb2006-08-12Martin Stjernholm  utf8_mode &= ~(LATIN1_UNICODE_ENCODE_MODE|UTF8_UNICODE_ENCODE_MODE); send_charset = 0;
a9db912006-08-22Henrik Grubbström (Grubba)  CH_DEBUG("Disabling unicode encode mode.\n");
30a56b2006-08-10Henrik Grubbström (Grubba)  }
aa16eb2006-08-12Martin Stjernholm  return !!send_charset;
30a56b2006-08-10Henrik Grubbström (Grubba) }
aa16eb2006-08-12Martin Stjernholm int get_unicode_encode_mode() //! Returns nonzero if unicode encode mode is enabled, zero otherwise.
30a56b2006-08-10Henrik Grubbström (Grubba) //!
aa16eb2006-08-12Martin Stjernholm //! @seealso //! @[set_unicode_encode_mode] { return !!send_charset; } void set_unicode_decode_mode (int enable) //! Enable or disable unicode decode mode.
b3d1362006-08-10Martin Stjernholm //!
aa16eb2006-08-12Martin Stjernholm //! In this mode, if the server supports UTF-8 then non-binary text
8877692006-11-17Martin Stjernholm //! strings in results are automatically decoded to (possibly wide) //! unicode strings. Not enabled by default.
b3d1362006-08-10Martin Stjernholm //!
aa16eb2006-08-12Martin Stjernholm //! The statement "@expr{SET character_set_results = utf8@}" is sent //! to the server to enable the mode. When the mode is disabled, //! "@expr{SET character_set_results = xxx@}" is sent, where //! @expr{xxx@} is the connection charset that @[get_charset] returns.
30a56b2006-08-10Henrik Grubbström (Grubba) //!
aa16eb2006-08-12Martin Stjernholm //! @param enable //! Nonzero enables this feature, zero disables it.
30a56b2006-08-10Henrik Grubbström (Grubba) //!
aa16eb2006-08-12Martin Stjernholm //! @throws //! Throws an exception if the server doesn't support this, i.e. if //! the statement above fails. The MySQL system variable //! @expr{character_set_results@} was added in MySQL 4.1.1.
b3d1362006-08-10Martin Stjernholm //!
9bcbd22007-05-03Martin Stjernholm //! An error is also thrown if Pike has been compiled with a MySQL //! client library older than 4.1.0, which lack the necessary //! support for this.
b3d1362006-08-10Martin Stjernholm //!
30a56b2006-08-10Henrik Grubbström (Grubba) //! @seealso
aa16eb2006-08-12Martin Stjernholm //! @[set_unicode_encode_mode]
30a56b2006-08-10Henrik Grubbström (Grubba) {
fd97122006-12-05Henrik Grubbström (Grubba) #if !constant (Mysql.mysql.HAVE_MYSQL_FIELD_CHARSETNR)
9bcbd22007-05-03Martin Stjernholm  // Undocumented feature for old mysql libs. See // MySQLBrokenUnicodeWrapper for details. if (!(<0, -1>)[enable] && !getenv("PIKE_BROKEN_MYSQL_UNICODE_MODE")) { predef::error ("Unicode decode mode not supported - " "compiled with MySQL client library < 4.1.0.\n");
fd97122006-12-05Henrik Grubbström (Grubba)  } #endif
9bcbd22007-05-03Martin Stjernholm 
aa16eb2006-08-12Martin Stjernholm  if (enable) {
a9db912006-08-22Henrik Grubbström (Grubba)  CH_DEBUG("Enabling unicode decode mode.\n");
aa16eb2006-08-12Martin Stjernholm  ::big_query ("SET character_set_results = utf8"); utf8_mode |= UNICODE_DECODE_MODE; } else {
a9db912006-08-22Henrik Grubbström (Grubba)  CH_DEBUG("Disabling unicode decode mode.\n");
47cc6d2008-11-26Martin Stjernholm  ::big_query ("SET character_set_results = " + ::get_charset());
aa16eb2006-08-12Martin Stjernholm  utf8_mode &= ~UNICODE_DECODE_MODE;
b3d1362006-08-10Martin Stjernholm  } }
77ac702006-11-27Martin Stjernholm 
b3d1362006-08-10Martin Stjernholm 
aa16eb2006-08-12Martin Stjernholm int get_unicode_decode_mode() //! Returns nonzero if unicode decode mode is enabled, zero otherwise.
b3d1362006-08-10Martin Stjernholm //!
aa16eb2006-08-12Martin Stjernholm //! @seealso //! @[set_unicode_decode_mode] { return utf8_mode & UNICODE_DECODE_MODE; } void set_charset (string charset) //! Changes the connection charset. Works similar to sending the query //! @expr{SET NAMES @[charset]@} but also records the charset on the //! client side so that various client functions work correctly.
b3d1362006-08-10Martin Stjernholm //!
aa16eb2006-08-12Martin Stjernholm //! @[charset] is a MySQL charset name or the special value //! @expr{"unicode"@} (see below). You can use @expr{SHOW CHARACTER //! SET@} to get a list of valid charsets.
b3d1362006-08-10Martin Stjernholm //!
aa16eb2006-08-12Martin Stjernholm //! Specifying @expr{"unicode"@} as charset is the same as //! @expr{"utf8"@} except that unicode encode and decode modes are //! enabled too. Briefly, this means that you can send queries as //! unencoded unicode strings and will get back non-binary text //! results as unencoded unicode strings. See //! @[set_unicode_encode_mode] and @[set_unicode_decode_mode] for //! further details.
b3d1362006-08-10Martin Stjernholm //!
aa16eb2006-08-12Martin Stjernholm //! @throws //! Throws an exception if the server doesn't support this, i.e. if //! the statement @expr{SET NAMES@} fails. Support for it was added //! in MySQL 4.1.0. //! //! @note //! If @[charset] is @expr{"latin1"@} and unicode encode mode is //! enabled (the default) then @[big_query] can send wide unicode //! queries transparently if the server supports UTF-8. See //! @[set_unicode_encode_mode].
b3d1362006-08-10Martin Stjernholm //! //! @note
aa16eb2006-08-12Martin Stjernholm //! If unicode decode mode is already enabled (see //! @[set_unicode_decode_mode]) then this function won't affect the //! result charset (i.e. the MySQL system variable //! @expr{character_set_results@}). //! //! Actually, a query @expr{SET character_set_results = utf8@} will //! be sent immediately after setting the charset as above if //! unicode decode mode is enabled and @[charset] isn't //! @expr{"utf8"@}. //! //! @note //! You should always use either this function or the //! @expr{"mysql_charset_name"@} option to @[create] to set the //! connection charset, or more specifically the charset that the //! server expects queries to have (i.e. the MySQL system variable //! @expr{character_set_client@}). Otherwise @[big_query] might not //! work correctly. //! //! Afterwards you may change the system variable //! @expr{character_set_connection@}, and also //! @expr{character_set_results@} if unicode decode mode isn't //! enabled. //! //! @note //! The MySQL @expr{latin1@} charset is close to Windows //! @expr{cp1252@}. The difference from ISO-8859-1 is a bunch of //! printable chars in the range @expr{0x80..0x9f@} (which contains //! control chars in ISO-8859-1). For instance, the euro currency //! sign is @expr{0x80@}. //!
0b8d2f2013-06-17Martin Nilsson //! You can use the @expr{mysql-latin1@} encoding in the @[Charset] //! module to do conversions, or just use the special //! @expr{"unicode"@} charset instead.
b3d1362006-08-10Martin Stjernholm //! //! @seealso
aa16eb2006-08-12Martin Stjernholm //! @[get_charset], @[set_unicode_encode_mode], @[set_unicode_decode_mode]
b3d1362006-08-10Martin Stjernholm {
aa16eb2006-08-12Martin Stjernholm  charset = lower_case (charset);
a9db912006-08-22Henrik Grubbström (Grubba)  CH_DEBUG("Setting charset to %O.\n", charset);
9bcbd22007-05-03Martin Stjernholm  int broken_unicode = charset == "broken-unicode"; if (broken_unicode) charset = "unicode";
aa16eb2006-08-12Martin Stjernholm  ::set_charset (charset == "unicode" ? "utf8" : charset); if (charset == "unicode" || utf8_mode & (LATIN1_UNICODE_ENCODE_MODE|UTF8_UNICODE_ENCODE_MODE)) update_unicode_encode_mode_from_charset (charset);
8877692006-11-17Martin Stjernholm  if (charset == "unicode") { #if constant (Mysql.mysql.HAVE_MYSQL_FIELD_CHARSETNR)
aa16eb2006-08-12Martin Stjernholm  utf8_mode |= UNICODE_DECODE_MODE;
8877692006-11-17Martin Stjernholm #else
9bcbd22007-05-03Martin Stjernholm  if (broken_unicode || getenv ("PIKE_BROKEN_MYSQL_UNICODE_MODE")) // Undocumented feature for old mysql libs. See // MySQLBrokenUnicodeWrapper for details.
77ac702006-11-27Martin Stjernholm  utf8_mode |= UNICODE_DECODE_MODE; else predef::error ("Unicode decode mode not supported - " "compiled with MySQL client library < 4.1.0.\n");
8877692006-11-17Martin Stjernholm #endif }
aa16eb2006-08-12Martin Stjernholm  else if (utf8_mode & UNICODE_DECODE_MODE && charset != "utf8") // This setting has been overridden by ::set_charset, so we need // to reinstate it. ::big_query ("SET character_set_results = utf8");
30a56b2006-08-10Henrik Grubbström (Grubba) }
aa16eb2006-08-12Martin Stjernholm string get_charset() //! Returns the MySQL name for the current connection charset.
b3d1362006-08-10Martin Stjernholm //!
aa16eb2006-08-12Martin Stjernholm //! Returns @expr{"unicode"@} if unicode encode mode is enabled and //! UTF-8 is used on the server side (i.e. in //! @expr{character_set_connection@}). //! //! @note //! In servers with full charset support (i.e. MySQL 4.1.0 or //! later), this corresponds to the MySQL system variable //! @expr{character_set_client@} (with one exception - see next //! note) and thus controls the charset in which queries are sent. //! The charset used for text strings in results might be something //! else (and typically is if unicode decode mode is enabled; see //! @[set_unicode_decode_mode]). //! //! @note //! If the returned charset is @expr{latin1@} or @expr{unicode@} and //! unicode encode mode is enabled (the default) then //! @expr{character_set_client@} in the server might be either //! @expr{latin1@} or @expr{utf8@}, depending on the last sent //! query. See @[set_unicode_encode_mode] for more info. //! //! @seealso //! @[set_charset]
b3d1362006-08-10Martin Stjernholm {
aa16eb2006-08-12Martin Stjernholm  if (utf8_mode & UTF8_UNICODE_ENCODE_MODE && send_charset)
9bcbd22007-05-03Martin Stjernholm  // We don't try to be symmetric with set_charset when the // broken-unicode kludge is in use. That since this reflects the // setting on the encode side only.
aa16eb2006-08-12Martin Stjernholm  return "unicode"; return ::get_charset();
b3d1362006-08-10Martin Stjernholm }
16efb42006-08-09Henrik Grubbström (Grubba) 
4c14422002-01-02Per Hedbor #if constant( Mysql.mysql.MYSQL_NO_ADD_DROP_DB ) // Documented in the C-file. void create_db( string db ) { ::big_query( "CREATE DATABASE "+db ); } void drop_db( string db ) { ::big_query( "DROP DATABASE "+db ); } #endif
36d2b82001-09-06Martin Nilsson //! Quote a string so that it can safely be put in a query. //! //! @param s //! String to quote.
6279f61998-03-19Henrik Grubbström (Grubba) string quote(string s)
2f9cc31998-03-19Henrik Grubbström (Grubba) {
18096f2003-08-22Martin Nilsson  return replace(s,
2f9cc31998-03-19Henrik Grubbström (Grubba)  ({ "\\", "\"", "\0", "\'", "\n", "\r" }),
18096f2003-08-22Martin Nilsson  ({ "\\\\", "\\\"", "\\0", "\\\'", "\\n", "\\r" }));
2f9cc31998-03-19Henrik Grubbström (Grubba) }
93f5441998-07-03Martin Stjernholm 
44556a2018-05-25Martin Karlgren string latin1_to_utf8 (string s, int extended)
aa16eb2006-08-12Martin Stjernholm //! Converts a string in MySQL @expr{latin1@} format to UTF-8.
30a56b2006-08-10Henrik Grubbström (Grubba) {
aa16eb2006-08-12Martin Stjernholm  return string_to_utf8 (replace (s, ([ "\x80": "\u20AC", /*"\x81": "\u0081",*/ "\x82": "\u201A", "\x83": "\u0192", "\x84": "\u201E", "\x85": "\u2026", "\x86": "\u2020", "\x87": "\u2021", "\x88": "\u02C6", "\x89": "\u2030", "\x8a": "\u0160", "\x8b": "\u2039", "\x8c": "\u0152", /*"\x8d": "\u008D",*/ "\x8e": "\u017D", /*"\x8f": "\u008F",*/ /*"\x90": "\u0090",*/ "\x91": "\u2018", "\x92": "\u2019", "\x93": "\u201C", "\x94": "\u201D", "\x95": "\u2022", "\x96": "\u2013", "\x97": "\u2014", "\x98": "\u02DC", "\x99": "\u2122", "\x9a": "\u0161", "\x9b": "\u203A", "\x9c": "\u0153", /*"\x9d": "\u009D",*/ "\x9e": "\u017E", "\x9f": "\u0178",
44556a2018-05-25Martin Karlgren  ])), extended);
aa16eb2006-08-12Martin Stjernholm }
30a56b2006-08-10Henrik Grubbström (Grubba) 
9c9a912018-05-24Henrik Grubbström (Grubba) string utf8_encode_query (string q,
88e5992022-11-07Martin Nilsson  function(string, mixed...:string) encode_fn,
9c9a912018-05-24Henrik Grubbström (Grubba)  mixed ... extras)
aa16eb2006-08-12Martin Stjernholm //! Encodes the appropriate sections of the query with @[encode_fn]. //! Everything except strings prefixed by an introducer (i.e. //! @expr{_something@} or @expr{N@}) is encoded. {
30a56b2006-08-10Henrik Grubbström (Grubba)  // We need to find the segments that shouldn't be encoded. string e = "";
aa16eb2006-08-12Martin Stjernholm  while (1) { sscanf(q, "%[^\'\"]%s", string prefix, string suffix);
9c9a912018-05-24Henrik Grubbström (Grubba)  e += encode_fn (prefix, @extras);
aa16eb2006-08-12Martin Stjernholm  if (suffix == "") break;
30a56b2006-08-10Henrik Grubbström (Grubba)  string quote = suffix[..0]; int start = 1; int end; while ((end = search(suffix, quote, start)) >= 0) { if (suffix[end-1] == '\\') {
b3d1362006-08-10Martin Stjernholm  // Count the number of preceding back-slashes.
30a56b2006-08-10Henrik Grubbström (Grubba)  // if odd, continue searching after the quote. int i; for (i = 2; i < end; i++) { if (suffix[end - i] != '\\') break; } if (!(i & 1)) { start = end+1; continue; } } if (sizeof(suffix) == end+1) break; if (suffix[end+1] == quote[0]) { // Quote quoted by doubling. start = end+2; continue; } break; }
d5cd862010-01-04Martin Stjernholm  if (end < 0) // The query ends in a quoted string. We pretend it continues to // the end and let MySQL complain later. end = sizeof (suffix);
aa16eb2006-08-12Martin Stjernholm #define IS_IDENTIFIER_CHAR(chr) (Unicode.is_wordchar (chr) || \ (<'_', '$'>)[chr]) int intpos = -1; // Optimize the use of _binary. if (has_suffix (prefix, "_binary")) intpos = sizeof (prefix) - sizeof ("_binary"); else if (has_suffix (prefix, "_binary ")) intpos = sizeof (prefix) - sizeof ("_binary "); else {
30a56b2006-08-10Henrik Grubbström (Grubba)  // Find the white-space suffix of the prefix.
aa16eb2006-08-12Martin Stjernholm  int i = sizeof(prefix);
30a56b2006-08-10Henrik Grubbström (Grubba)  while (i--) {
aa16eb2006-08-12Martin Stjernholm  if (!(< ' ', '\n', '\r', '\t' >)[prefix[i]]) break; } if (i >= 0) { if ((<'n', 'N'>)[prefix[i]]) // Probably got a national charset string. intpos = i; else { // The following assumes all possible charset names contain // only [a-zA-Z0-9_$] and are max 32 chars (from // MY_CS_NAME_SIZE in m_ctype.h). sscanf (reverse (prefix[i - 33..i]), "%[a-zA-Z0-9_$]%s", string rev_intro, string rest); if (sizeof (rev_intro) && rev_intro[-1] == '_' && sizeof (rest)) intpos = i - sizeof (rev_intro) + 1; }
30a56b2006-08-10Henrik Grubbström (Grubba)  } }
aa16eb2006-08-12Martin Stjernholm  int got_introducer; if (intpos == 0) // The prefix begins with the introducer. got_introducer = 1; else if (intpos > 0) { // Check that the introducer sequence we found isn't a suffix of // some longer keyword or identifier. int prechar = prefix[intpos - 1]; if (!IS_IDENTIFIER_CHAR (prechar)) got_introducer = 1; } if (got_introducer) { string s = suffix[..end]; if (String.width (s) > 8) { string encoding = prefix[intpos..]; if (has_prefix (encoding, "_")) sscanf (encoding[1..], "%[a-zA-Z0-9]", encoding); else encoding = "utf8"; // Gotta be "N".
8a531a2006-11-04Martin Nilsson  s = s[1..<1];
aa16eb2006-08-12Martin Stjernholm  if (sizeof (s) > 40) s = sprintf ("%O...", s[..37]); else s = sprintf ("%O", s); predef::error ("A string in the query should be %s encoded " "but it is wide: %s\n", encoding, s); } e += s;
30a56b2006-08-10Henrik Grubbström (Grubba)  } else {
9c9a912018-05-24Henrik Grubbström (Grubba)  e += encode_fn (suffix[..end], @extras);
30a56b2006-08-10Henrik Grubbström (Grubba)  }
aa16eb2006-08-12Martin Stjernholm 
30a56b2006-08-10Henrik Grubbström (Grubba)  q = suffix[end+1..]; } return e; }
36d2b82001-09-06Martin Nilsson //! Converts a system time value to an appropriately formatted time //! spec for the database. //! //! @param time //! Time to encode. //! //! @param date //! If nonzero then time is taken as a "full" unix time spec //! (where the date part is ignored), otherwise it's converted as a //! seconds-since-midnight value.
93f5441998-07-03Martin Stjernholm string encode_time (int time, void|int date) {
59c3ce2017-03-12Henrik Grubbström (Grubba)  return ::encode_time(time, date) - ":";
93f5441998-07-03Martin Stjernholm }
36d2b82001-09-06Martin Nilsson //! Converts a system time value to an appropriately formatted //! date-only spec for the database. //! //! @param time //! Time to encode.
93f5441998-07-03Martin Stjernholm string encode_date (int time) {
59c3ce2017-03-12Henrik Grubbström (Grubba)  return ::encode_date(time) - "-";
93f5441998-07-03Martin Stjernholm }
36d2b82001-09-06Martin Nilsson //! Converts a system time value to an appropriately formatted //! date and time spec for the database. //! //! @param time //! Time to encode.
93f5441998-07-03Martin Stjernholm string encode_datetime (int time) {
59c3ce2017-03-12Henrik Grubbström (Grubba)  return replace(::encode_datetime(time), "-:T"/"", ({"", "", ""}));
93f5441998-07-03Martin Stjernholm }
53675a1998-10-17Henrik Grubbström (Grubba) 
8877692006-11-17Martin Stjernholm #if constant (Mysql.mysql.HAVE_MYSQL_FIELD_CHARSETNR)
77ac702006-11-27Martin Stjernholm #define HAVE_MYSQL_FIELD_CHARSETNR_IFELSE(TRUE, FALSE) TRUE
8877692006-11-17Martin Stjernholm #else
77ac702006-11-27Martin Stjernholm #define HAVE_MYSQL_FIELD_CHARSETNR_IFELSE(TRUE, FALSE) FALSE
8877692006-11-17Martin Stjernholm #endif
d6ccc72022-01-26Henrik Grubbström (Grubba) protected array(string(8bit)|zero) fix_query_charset(string query, string|void charset) { if (charset) { string current_charset = send_charset || get_charset(); if (charset != current_charset) { CH_DEBUG ("Switching charset from %O to %O (due to charset arg).\n", current_charset, charset); ::big_query ("SET character_set_client=" + charset); /* Can't be changed automatically - has side effects. /mast */ /* ::big_query("SET character_set_connection=" + charset); */ return ({ query, current_charset }); } return ({ query, 0 }); } if (!send_charset) return ({ query, 0 }); string new_send_charset = send_charset; if (utf8_mode & LATIN1_UNICODE_ENCODE_MODE) { if (String.width (query) == 8) new_send_charset = "latin1"; else { CH_DEBUG ("Converting (mysql-)latin1 query to utf8.\n"); query = utf8_encode_query (query, latin1_to_utf8, 2); new_send_charset = "utf8"; } } else { /* utf8_mode & UTF8_UNICODE_ENCODE_MODE */ /* NB: The send_charset may only be upgraded from * "latin1" to "utf8", not the other way around. * This is to avoid extraneous charset changes * where the charset is changed from query to query. */ if ((send_charset == "utf8") || !_can_send_as_latin1(query)) { CH_DEBUG ("Converting query to utf8.\n"); query = utf8_encode_query (query, string_to_utf8, 2); new_send_charset = "utf8"; } } if (new_send_charset != send_charset) { CH_DEBUG ("Switching charset from %O to %O.\n", send_charset, new_send_charset); if (mixed err = catch { ::big_query ("SET character_set_client=" + new_send_charset); /* Can't be changed automatically - has side effects. /mast */ /* ::big_query("SET character_set_connection=" + new_send_charset); */ }) { if (new_send_charset == "utf8") predef::error ("The query is a wide string " "and the MySQL server doesn't support UTF-8: %s\n", describe_error (err)); else throw (err); } send_charset = new_send_charset; } return ({ query, 0 }); } protected array|object|mapping|string|int fix_result_charset(array|object|mapping|string|int res) { if (!res) return UNDEFINED; if (!(utf8_mode & UNICODE_DECODE_MODE)) return res; if (objectp(res)) { CH_DEBUG ("Using unicode wrapper for result.\n"); return HAVE_MYSQL_FIELD_CHARSETNR_IFELSE ( .sql_util.MySQLUnicodeWrapper(res), .sql_util.MySQLBrokenUnicodeWrapper(res)); } if (arrayp(res)) { return map(res, fix_result_charset); } if (mappingp(res)) { return mkmapping(fix_result_charset(indices(res)), fix_result_charset(values(res))); } if (stringp(res)) { return utf8_to_string(res); } return res; }
aa16eb2006-08-12Martin Stjernholm #define QUERY_BODY(do_query) \ if (bindings) \ query = .sql_util.emulate_bindings(query,bindings,this); \ \
d6ccc72022-01-26Henrik Grubbström (Grubba)  [query, string restore_charset] = fix_query_charset(query, charset); \
aa16eb2006-08-12Martin Stjernholm  \
92b88f2012-01-07Martin Stjernholm  CH_DEBUG ("Sending query with charset %O: %s.\n", \ charset || send_charset, \ (sizeof (query) > 200 ? \ sprintf ("%O...", query[..200]) : \ sprintf ("%O", query))); \
a9db912006-08-22Henrik Grubbström (Grubba)  \
d6ccc72022-01-26Henrik Grubbström (Grubba)  int|object res = fix_result_charset(::do_query(query)); \
aa16eb2006-08-12Martin Stjernholm  \ if (restore_charset) { \ if (send_charset && (<"latin1", "utf8">)[charset]) \ send_charset = charset; \
a9db912006-08-22Henrik Grubbström (Grubba)  else { \
e7bdd02006-09-15Martin Stjernholm  CH_DEBUG ("Restoring charset %O.\n", restore_charset); \ ::big_query ("SET character_set_client=" + restore_charset); \ /* Can't be changed automatically - has side effects. /mast */ \ /* ::big_query("SET character_set_connection=" + restore_charset); */ \
a9db912006-08-22Henrik Grubbström (Grubba)  } \
aa16eb2006-08-12Martin Stjernholm  } \ \ return res;
ad3b1d2017-11-24Henrik Grubbström (Grubba) variant Result big_query (string query, mapping(string|int:mixed)|void bindings, void|string charset)
aa16eb2006-08-12Martin Stjernholm //! Sends a query to the server. //! //! @param query //! The SQL query. //! //! @param bindings //! An optional bindings mapping. See @[Sql.query] for details about //! this. //! //! @param charset //! An optional charset that will be used temporarily while sending //! @[query] to the server. If necessary, a query //! @code //! SET character_set_client=@[charset] //! @endcode //! is sent to the server first, then @[query] is sent as-is, and then //! the connection charset is restored again (if necessary). //! //! Primarily useful with @[charset] set to @expr{"latin1"@} if //! unicode encode mode (see @[set_unicode_encode_mode]) is enabled //! (the default) and you have some large queries (typically blob //! inserts) where you want to avoid the query parsing overhead. //! //! @returns
8d456a2016-03-27Henrik Grubbström (Grubba) //! A @[Result] object is returned if the query is of a
aa16eb2006-08-12Martin Stjernholm //! kind that returns a result. Zero is returned otherwise.
36d2b82001-09-06Martin Nilsson //!
15a2672009-11-11Henrik Grubbström (Grubba) //! The individual fields are returned as strings except for @tt{NULL@}, //! which is returned as @[UNDEFINED]. //!
aa16eb2006-08-12Martin Stjernholm //! @seealso
b31ddf2009-11-10Henrik Grubbström (Grubba) //! @[Sql.big_query()], @[big_typed_query()], @[streaming_query()]
6458a72000-04-29Francesco Chemolli {
aa16eb2006-08-12Martin Stjernholm  QUERY_BODY (big_query);
6458a72000-04-29Francesco Chemolli }
ad3b1d2017-11-24Henrik Grubbström (Grubba) variant Result streaming_query (string query, mapping(string|int:mixed)|void bindings, void|string charset)
aa16eb2006-08-12Martin Stjernholm //! Makes a streaming SQL query. //! //! This function sends the SQL query @[query] to the Mysql-server. //! The result of the query is streamed through the returned
8d456a2016-03-27Henrik Grubbström (Grubba) //! @[Result] object. Note that the involved database
aa16eb2006-08-12Martin Stjernholm //! tables are locked until all the results has been read. //! //! In all other respects, it behaves like @[big_query].
b31ddf2009-11-10Henrik Grubbström (Grubba) //! //! @seealso //! @[big_query()], @[streaming_typed_query()]
aa16eb2006-08-12Martin Stjernholm { QUERY_BODY (streaming_query); }
d7bd0e2003-12-31Martin Nilsson 
ad3b1d2017-11-24Henrik Grubbström (Grubba) variant Result big_typed_query (string query, mapping(string|int:mixed)|void bindings, void|string charset)
b31ddf2009-11-10Henrik Grubbström (Grubba) //! Makes a typed SQL query. //!
3e77e22011-03-05Martin Stjernholm //! This function sends the SQL query @[query] to the MySQL server and //! returns a result object in typed mode, which means that the types //! of the result fields depend on the corresponding SQL types. See //! the class docs for details.
b31ddf2009-11-10Henrik Grubbström (Grubba) //! //! In all other respects, it behaves like @[big_query]. //! //! @seealso //! @[big_query()], @[streaming_typed_query()] { QUERY_BODY (big_typed_query); }
ad3b1d2017-11-24Henrik Grubbström (Grubba) variant Result streaming_typed_query (string query, mapping(string|int:mixed)|void bindings, void|string charset)
b31ddf2009-11-10Henrik Grubbström (Grubba) //! Makes a streaming typed SQL query. //! //! This function acts as the combination of @[streaming_query()] //! and @[big_typed_query()]. //! //! @seealso //! @[big_typed_query()], @[streaming_typed_query()] { QUERY_BODY (streaming_typed_query); }
984d372017-04-03Henrik Grubbström (Grubba) array(string) list_dbs(string|void wild) {
d6ccc72022-01-26Henrik Grubbström (Grubba)  Result res = fix_result_charset(::list_dbs(wild && fix_query_charset(wild)[0]));
984d372017-04-03Henrik Grubbström (Grubba)  array(string) ret = ({}); array(string) row; while((row = res->fetch_row()) && sizeof(row)) { ret += ({ row[0] }); } return ret; } array(string) list_tables(string|void wild) {
d6ccc72022-01-26Henrik Grubbström (Grubba)  Result res = fix_result_charset(::list_tables(wild && fix_query_charset(wild)[0]));
984d372017-04-03Henrik Grubbström (Grubba)  array(string) ret = ({}); array(string) row; while((row = res->fetch_row()) && sizeof(row)) { ret += ({ row[0] }); } return ret; }
d6ccc72022-01-26Henrik Grubbström (Grubba) array(mapping(string:mixed)) list_fields(string table, string|void wild) { if (!wild) { // Very common case. return fix_result_charset(::list_fields(fix_query_charset(table)[0])); } string table_and_wild = table + "\0\0PIKE\0\0" + wild; table_and_wild = fix_query_charset(table_and_wild)[0]; array(string) a = table_and_wild / "\0\0PIKE\0\0"; if (sizeof(a) == 2) { // Common case. return fix_result_charset(::list_fields(@a)); }
09b80d2022-01-27Henrik Grubbström (Grubba)  // Very uncommon cases, but... if (sizeof(a) == 1) { // The split marker has been recoded. // Assume that fix_query_charset() is stable. return fix_result_charset(::list_fields(fix_query_charset(table)[0], fix_query_charset(wild)[0])); }
d6ccc72022-01-26Henrik Grubbström (Grubba)  // Assume that the table name can not contain NUL characters. return fix_result_charset(::list_fields(a[0], a[1..] * "\0\0PIKE\0\0")); }
0e5be12002-01-17Martin Nilsson int(0..1) is_keyword( string name )
ba2a262007-05-26Martin Stjernholm //! Return 1 if the argument @[name] is a mysql keyword that needs to //! be quoted in a query. The list is currently up-to-date with MySQL //! 5.1.
0e5be12002-01-17Martin Nilsson {
ba2a262007-05-26Martin Stjernholm  return ([ "accessible": 1, "add": 1, "all": 1, "alter": 1, "analyze": 1, "and": 1, "as": 1, "asc": 1, "asensitive": 1, "before": 1, "between": 1, "bigint": 1, "binary": 1, "blob": 1, "both": 1, "by": 1, "call": 1, "cascade": 1, "case": 1, "change": 1, "char": 1, "character": 1, "check": 1, "collate": 1, "column": 1, "condition": 1, "constraint": 1, "continue": 1, "convert": 1, "create": 1, "cross": 1, "current_date": 1, "current_time": 1, "current_timestamp": 1, "current_user": 1, "cursor": 1, "database": 1, "databases": 1, "day_hour": 1, "day_microsecond": 1, "day_minute": 1, "day_second": 1, "dec": 1, "decimal": 1, "declare": 1, "default": 1, "delayed": 1, "delete": 1, "desc": 1, "describe": 1, "deterministic": 1, "distinct": 1, "distinctrow": 1, "div": 1, "double": 1, "drop": 1, "dual": 1, "each": 1, "else": 1, "elseif": 1, "enclosed": 1, "escaped": 1, "exists": 1, "exit": 1, "explain": 1, "false": 1, "fetch": 1, "float": 1, "float4": 1, "float8": 1, "for": 1, "force": 1, "foreign": 1, "from": 1, "fulltext": 1, "grant": 1, "group": 1, "having": 1, "high_priority": 1, "hour_microsecond": 1, "hour_minute": 1, "hour_second": 1, "if": 1, "ignore": 1, "in": 1, "index": 1, "infile": 1, "inner": 1, "inout": 1, "insensitive": 1, "insert": 1, "int": 1, "int1": 1, "int2": 1, "int3": 1, "int4": 1, "int8": 1, "integer": 1, "interval": 1, "into": 1, "is": 1, "iterate": 1, "join": 1, "key": 1, "keys": 1, "kill": 1, "leading": 1, "leave": 1, "left": 1, "like": 1, "limit": 1, "linear": 1, "lines": 1, "load": 1, "localtime": 1, "localtimestamp": 1, "lock": 1, "long": 1, "longblob": 1, "longtext": 1, "loop": 1, "low_priority": 1, "master_ssl_verify_server_cert": 1, "match": 1, "mediumblob": 1, "mediumint": 1, "mediumtext": 1, "middleint": 1, "minute_microsecond": 1, "minute_second": 1, "mod": 1, "modifies": 1, "natural": 1, "not": 1, "no_write_to_binlog": 1, "null": 1, "numeric": 1, "on": 1, "optimize": 1, "option": 1, "optionally": 1, "or": 1, "order": 1, "out": 1, "outer": 1, "outfile": 1, "precision": 1, "primary": 1, "procedure": 1, "purge": 1, "range": 1, "read": 1, "reads": 1, "read_only": 1, "read_write": 1, "real": 1, "references": 1, "regexp": 1, "release": 1, "rename": 1, "repeat": 1, "replace": 1, "require": 1, "restrict": 1, "return": 1, "revoke": 1, "right": 1, "rlike": 1, "schema": 1, "schemas": 1, "second_microsecond": 1, "select": 1, "sensitive": 1, "separator": 1, "set": 1, "show": 1, "smallint": 1, "spatial": 1, "specific": 1, "sql": 1, "sqlexception": 1, "sqlstate": 1, "sqlwarning": 1, "sql_big_result": 1, "sql_calc_found_rows": 1, "sql_small_result": 1, "ssl": 1, "starting": 1, "straight_join": 1, "table": 1, "terminated": 1, "then": 1, "tinyblob": 1, "tinyint": 1, "tinytext": 1, "to": 1, "trailing": 1, "trigger": 1, "true": 1, "undo": 1, "union": 1, "unique": 1, "unlock": 1, "unsigned": 1, "update": 1, "usage": 1, "use": 1, "using": 1, "utc_date": 1, "utc_time": 1, "utc_timestamp": 1, "values": 1, "varbinary": 1, "varchar": 1, "varcharacter": 1, "varying": 1, "when": 1, "where": 1, "while": 1, "with": 1, "write": 1, "x509": 1, "xor": 1, "year_month": 1, "zerofill": 1, // The following keywords were in the old list, but according to MySQL // docs they don't need to be quoted: // "action", "after", "aggregate", "auto_increment", "avg", // "avg_row_length", "bit", "bool", "change", "checksum", "columns", // "comment", "data", "date", "datetime", "day", "dayofmonth", "dayofweek", // "dayofyear", "delay_key_write", "end", "enum", "escape", "escaped", // "explain", "fields", "file", "first", "flush", "for", "full", "function", // "global", "grants", "heap", "hosts", "hour", "identified", "if", // "insert_id", "integer", "interval", "isam", "last_insert_id", "length", // "lines", "local", "logs", "max", "max_rows", "mediumtext", "min_rows", // "minute", "modify", "month", "monthname", "myisam", "no", "numeric", // "pack_keys", "partial", "password", "privileges", "process", // "processlist", "reload", "returns", "row", "rows", "second", "shutdown", // "soname", "sql_big_selects", "sql_big_tables", "sql_log_off", // "sql_log_update", "sql_low_priority_updates", "sql_select_limit", // "sql_small_result", "sql_warnings", "status", "straight_join", "string", // "tables", "temporary", "text", "time", "timestamp", "tinytext", // "trailing", "type", "use", "using", "varbinary", "variables", "with", // "write", "year" ])[ lower_case(name) ];
0e5be12002-01-17Martin Nilsson }
9eaf1d2008-06-28Martin Nilsson protected void create(string|void host, string|void database,
47cc6d2008-11-26Martin Stjernholm  string|void user, string|void _password, mapping(string:string|int)|void options)
16efb42006-08-09Henrik Grubbström (Grubba) {
1dc3fb2008-01-09Martin Stjernholm  string password = _password; _password = "CENSORED";
16efb42006-08-09Henrik Grubbström (Grubba)  if (options) {
9bcbd22007-05-03Martin Stjernholm  string charset = options->mysql_charset_name ? lower_case (options->mysql_charset_name) : "latin1"; int broken_unicode = charset == "broken-unicode"; if (broken_unicode) charset = "unicode";
aa16eb2006-08-12Martin Stjernholm  if (charset == "unicode") options->mysql_charset_name = "utf8";
16efb42006-08-09Henrik Grubbström (Grubba)  ::create(host||"", database||"", user||"", password||"", options);
aa16eb2006-08-12Martin Stjernholm  update_unicode_encode_mode_from_charset (lower_case (charset));
77ac702006-11-27Martin Stjernholm #if !constant (Mysql.mysql.HAVE_MYSQL_FIELD_CHARSETNR)
9bcbd22007-05-03Martin Stjernholm  // Undocumented feature for old mysql libs. See // MySQLBrokenUnicodeWrapper for details. if (broken_unicode || getenv ("PIKE_BROKEN_MYSQL_UNICODE_MODE")) {
77ac702006-11-27Martin Stjernholm #endif if (charset == "unicode") utf8_mode |= UNICODE_DECODE_MODE; else if (options->unicode_decode_mode) set_unicode_decode_mode (1); #if !constant (Mysql.mysql.HAVE_MYSQL_FIELD_CHARSETNR) } else if (charset == "unicode" || options->unicode_decode_mode) predef::error ("Unicode decode mode not supported - " "compiled with MySQL client library < 4.1.0.\n");
8877692006-11-17Martin Stjernholm #endif
aa16eb2006-08-12Martin Stjernholm 
16efb42006-08-09Henrik Grubbström (Grubba)  } else { ::create(host||"", database||"", user||"", password||"");
aa16eb2006-08-12Martin Stjernholm  update_unicode_encode_mode_from_charset ("latin1");
16efb42006-08-09Henrik Grubbström (Grubba)  } }