@@ -67,29 +67,28 @@ Installation is done using the
6767[ ` npm install ` command] ( https://docs.npmjs.com/getting-started/installing-npm-packages-locally ) :
6868
6969``` sh
70- $ npm install mysql
70+ $ npm install @vlasky/ mysql
7171```
7272
73- For information about the previous 0.9.x releases, visit the [ v0.9 branch] [ ] .
74-
75- Sometimes I may also ask you to install the latest version from Github to check
76- if a bugfix is working. In this case, please do:
73+ Sometimes you may be asked to install the latest version from Github to check
74+ if a bugfix is working. In this case, please run:
7775
7876``` sh
79- $ npm install mysqljs /mysql
77+ $ npm install vlasky /mysql
8078```
8179
82- [ v0.9 branch ] : https://github.com/mysqljs/mysql/tree/v0.9
83-
8480## Introduction
8581
86- This is a node.js driver for mysql. It is written in JavaScript, does not
87- require compiling, and is 100% MIT licensed.
82+ This is a Node.js driver for mysql. It is a fork of [ mysqljs/mysql] ( https://github.com/mysqljs/mysql/ )
83+ with partial support for the MySQL compressed protocol (reads compressed data sent by server)
84+ and authentication using the caching_sha2_password plugin, the default authentication method in MySQL 8.
85+
86+ It is written in JavaScript, does not require compiling, and is 100% MIT licensed.
8887
8988Here is an example on how to use it:
9089
9190``` js
92- var mysql = require (' mysql' );
91+ var mysql = require (' @vlasky/ mysql' );
9392var connection = mysql .createConnection ({
9493 host : ' localhost' ,
9594 user : ' me' ,
@@ -118,20 +117,19 @@ From this example, you can learn the following:
118117Thanks goes to the people who have contributed code to this module, see the
119118[ GitHub Contributors page] [ ] .
120119
121- [ GitHub Contributors page ] : https://github.com/mysqljs /mysql/graphs/contributors
120+ [ GitHub Contributors page ] : https://github.com/vlasky /mysql/graphs/contributors
122121
123- Additionally I'd like to thank the following people:
122+ Thanks also go to the following people:
124123
125- * [ Andrey Hristov] [ ] (Oracle) - for helping me with protocol questions.
126- * [ Ulf Wendel] [ ] (Oracle) - for helping me with protocol questions.
124+ * [ Andrey Hristov] [ ] (Oracle) - for helping with protocol questions.
125+ * [ Ulf Wendel] [ ] (Oracle) - for helping with protocol questions.
127126
128127[ Ulf Wendel ] : http://blog.ulf-wendel.de/
129128[ Andrey Hristov ] : http://andrey.hristov.com/
130129
131130## Sponsors
132131
133- The following companies have supported this project financially, allowing me to
134- spend more time on it (ordered by time of contribution):
132+ The following companies have supported this project financially:
135133
136134* [ Transloadit] ( http://transloadit.com ) (my startup, we do file uploading &
137135 video encoding as a service, check it out)
@@ -154,7 +152,7 @@ of the following:
154152The recommended way to establish a connection is this:
155153
156154``` js
157- var mysql = require (' mysql' );
155+ var mysql = require (' @vlasky/ mysql' );
158156var connection = mysql .createConnection ({
159157 host : ' example.org' ,
160158 user : ' bob' ,
@@ -174,7 +172,7 @@ connection.connect(function(err) {
174172However, a connection can also be implicitly established by invoking a query:
175173
176174``` js
177- var mysql = require (' mysql' );
175+ var mysql = require (' @vlasky/ mysql' );
178176var connection = mysql .createConnection (... );
179177
180178connection .query (' SELECT 1' , function (error , results , fields ) {
@@ -398,7 +396,7 @@ provides built-in connection pooling using `mysql.createPool(config)`.
398396Create a pool and use it directly:
399397
400398``` js
401- var mysql = require (' mysql' );
399+ var mysql = require (' @vlasky/ mysql' );
402400var pool = mysql .createPool ({
403401 connectionLimit : 10 ,
404402 host : ' example.org' ,
@@ -420,7 +418,7 @@ share connection state for subsequent queries. This is because two calls to
420418the basic structure:
421419
422420``` js
423- var mysql = require (' mysql' );
421+ var mysql = require (' @vlasky/ mysql' );
424422var pool = mysql .createPool (... );
425423
426424pool .getConnection (function (err , connection ) {
@@ -1255,7 +1253,7 @@ fatal error is triggered by trying to connect to an invalid port. Therefore the
12551253error object is propagated to both pending callbacks:
12561254
12571255``` js
1258- var connection = require (' mysql' ).createConnection ({
1256+ var connection = require (' @vlasky/ mysql' ).createConnection ({
12591257 port: 84943 , // WRONG PORT
12601258});
12611259
@@ -1369,7 +1367,7 @@ It is not recommended (and may go away / change in the future) to disable type
13691367casting, but you can currently do so on either the connection:
13701368
13711369``` js
1372- var connection = require (' mysql' ).createConnection ({typeCast: false });
1370+ var connection = require (' @vlasky/ mysql' ).createConnection ({typeCast: false });
13731371```
13741372
13751373Or on the query level:
0 commit comments