mysql://user:password@host[:port][,host[:port]]|[/unix/socket]/database?
charset=значение&[значением может быть название кодировки для MySQL 4.1+] ClientCharset=кодировка& [3.1.2] timeout=3&
compress=0&
named_pipe=1&
autocommit=1&
local_infile=0& [3.4.2]
multi_statements=0& [3.3.0] config_file=~/.my.cnf& [3.4.6] config_group=parser [3.4.6]
Как правило, для подключения не нужно указывать дополнительных параметров:
mysql://user:password@localhost/database
Можно вместо имени_хоста и номера_порта передать путь к UNIX сокету в квадратных скобках (UNIX socket - это некий магический набор символов (путь), который вам расскажет администратор MySQL, если он - это не вы. Через этот сокет может идти общение с сервером):
mysql://user:password@[/unix/socket]/database
charset - сразу после соединения выполняет команду «SET NAMES значение»; ClientCharset - задает кодировку, в которой необходимо общаться с SQL-сервером, перекодированием занимается драйвер;
timeout - задает значение параметра Connect timeout в секундах;
compress - режим сжатия трафика между сервером и клиентом;
named_pipe - использование именованных каналов для соединения с сервером MySQL, работающим под управлением Windows NT;
autocommit - если установлен в 0, то после соединения выполняет команду «SET AUTOCOMMIT=0» (в документации по MySQL следует прочитать, как работает autocommit, в том числе какие команды вызывают COMMIT);
local_infile - если установлен в 1, то разрешается выполнение команды LOAD DATA [LOCAL] INFILE (подробности); multi_statements - если установлен в 1, то текст SQL запроса может содержать несколько инструкций, разделённых символом ';' (символ ";" необходимо предварять символом "^"); config_file - использовать указанный файл с настройками (например там может быть указан сертификат для безопасного соединения);
config_group - читать указанную группу настроек из файла с настройками.
Пример: перекодирование средствами SQL сервера (рекомендуется, требуется MySQL 4.1 или выше)
MySQL сервер версии 4.1 и выше имеет богатые возможности по перекодированию данных, поэтому в случае его использования рекомендуется задействовать именно их, используя опцию charset, а не заниматься перекодированием средствами драйвера с помощью опции ClientCharset. В случае, если вы используете версию MySQL 4.1 и выше, вы даже можете в разных таблицах хранить данные в разных кодировках, хотя мы считаем, что в этом случае лучше всего хранить данные в кодировке UTF-8.
Допустим, данные в вашей базе хранятся в кодировке UTF-8, а сайт работает в кодировке windows-1251, в этом случае нужно использовать следующую строку подключения:
mysql://user:password@host/database?charset=cp1251
В этом случае сразу после соединения SQL серверу будет выдана команда «SET NAMES cp1251» и сервер сам будет перекодировать принимаемые данные из кодировки cp1251 в кодировку, в которой данных хранятся у него в таблице и обратно.
Внимание: в данном случае вы должны указать кодировку, в которой работает сайт. Внимание: данная опция выполняет команду MySQL, поэтому необходимо использовать названия кодировок MySQL сервера, которые отличаются от названий кодировок Parser, определяемых вами в конфигурационном файле.
Пример: база в windows-1251, страницы в koi8-r, перекодирование драйвером (работает со всеми версиями MySQL сервера)
В некоторых редких случаях бывает, что невозможно использовать функции перекодирования, предоставляемые MySQL сервером. Тогда можно задействовать механизмы перекодирования драйвера, используя опцию ClientCharset.
Допустим, данные в вашей базе хранятся в кодировке windows-1251, а сайт работает в кодировке koi8-r, в этом случае можно использовать такую строку подключения:
mysql://user:password@host/database?ClientCharset=windows-1251
В этом случае отправляемые SQL серверу данные будут перекодироваться драйвером из кодировки $request:charset (в данном примере koi8-r) в кодировку windows-1251, а принимаемые от SQL сервера данные - обратно.
Внимание: в данном случае вы должны указать кодировку, в которой данные хранятся в базе данных.
Внимание: в данной опции вы должны указывать названия кодировок Parser, которые определяются вами в конфигурационном файле.
Пример: подключение к кластеру MySQL mysql://user:password@node1,node2,node3/?timeout=1
Сперва произойдет попытка подключения к серверу node1. Если соединение не будет установленно в течении секунды (а обычно это занимает тысячные доли секунды), то произойдет переключение на сервер node2, если и с ним не получится установить соединение в течении секунды, произойдет переключение на сервер node3.
Пример: подключение к SphinxQL mysql://@localhost:9306/?ClientCharset=utf-8