diff --git a/README.md b/README.md index 1ec63dacdd..c3aabeb685 100644 --- a/README.md +++ b/README.md @@ -234,13 +234,15 @@ arguments. `createClient()` returns a `RedisClient` object. Otherwise, __Tip:__ If the Redis server runs on the same machine as the client consider using unix sockets if possible to increase throughput. +__Note:__ Using `'rediss://...` for the protocol in a `redis_url` will enable a TLS socket connection. However, additional TLS options will need to be passed in `options`, if required. + #### `options` object properties | Property | Default | Description | |-----------|-----------|-------------| | host | 127.0.0.1 | IP address of the Redis server | | port | 6379 | Port of the Redis server | | path | null | The UNIX socket string of the Redis server | -| url | null | The URL of the Redis server. Format: `[redis:][rediss:]//[[user][:password@]][host][:port][/db-number][?db=db-number[&password=bar[&option=value]]]` (More info avaliable at [IANA](http://www.iana.org/assignments/uri-schemes/prov/redis)). | +| url | null | The URL of the Redis server. Format: `[redis[s]:]//[[user][:password@]][host][:port][/db-number][?db=db-number[&password=bar[&option=value]]]` (More info avaliable at [IANA](http://www.iana.org/assignments/uri-schemes/prov/redis)). | | parser | javascript | __Deprecated__ Use either the built-in JS parser [`javascript`]() or the native [`hiredis`]() parser. __Note__ `node_redis` < 2.6 uses hiredis as default if installed. This changed in v.2.6.0. | | string_numbers | null | Set to `true`, `node_redis` will return Redis number values as Strings instead of javascript Numbers. Useful if you need to handle big numbers (above `Number.MAX_SAFE_INTEGER === 2^53`). Hiredis is incapable of this behavior, so setting this option to `true` will result in the built-in javascript parser being used no matter the value of the `parser` option. | | return_buffers | false | If set to `true`, then all replies will be sent to callbacks as Buffers instead of Strings. | diff --git a/lib/createClient.js b/lib/createClient.js index 8c3a8508a2..133f0b758e 100644 --- a/lib/createClient.js +++ b/lib/createClient.js @@ -31,10 +31,10 @@ module.exports = function createClient (port_arg, host_arg, options) { if (parsed.auth) { options.password = parsed.auth.split(':')[1]; } - if (parsed.protocol && parsed.protocol !== 'redis:') { + if (parsed.protocol) { if (parsed.protocol === 'rediss:') { options.tls = options.tls || {}; - } else { + } else if (parsed.protocol !== 'redis:') { console.warn('node_redis: WARNING: You passed "' + parsed.protocol.substring(0, parsed.protocol.length - 1) + '" as protocol instead of the "redis" protocol!'); } } diff --git a/test/tls.spec.js b/test/tls.spec.js index 6a7e021e33..3b0e18197a 100644 --- a/test/tls.spec.js +++ b/test/tls.spec.js @@ -7,6 +7,7 @@ var helper = require('./helper'); var path = require('path'); var redis = config.redis; var utils = require('../lib/utils'); +var tls = require('tls'); var tls_options = { servername: 'redis.js.org', @@ -90,12 +91,12 @@ describe('TLS connection tests', function () { it('connect with host and port provided in the tls object', function (done) { if (skip) this.skip(); - var tls = utils.clone(tls_options); - tls.port = tls_port; - tls.host = 'localhost'; + var tls_opts = utils.clone(tls_options); + tls_opts.port = tls_port; + tls_opts.host = 'localhost'; client = redis.createClient({ connect_timeout: 1000, - tls: tls + tls: tls_opts }); // verify connection is using TCP, not UNIX socket @@ -109,17 +110,16 @@ describe('TLS connection tests', function () { }); describe('using rediss as url protocol', function (done) { - var tls = require('tls') - var tlsConnect = tls.connect + var tls_connect = tls.connect beforeEach(function () { tls.connect = function (options) { options = utils.clone(options) options.ca = tls_options.ca; - return tlsConnect.call(tls, options); + return tls_connect.call(tls, options); } }) afterEach(function () { - tls.connect = tlsConnect; + tls.connect = tls_connect; }) it('connect with tls when rediss is used as the protocol', function (done) { if (skip) this.skip();