Persistent connections default in PHP extension?
I'm a little confused about the persistent connections part of the Couchbase PHP extension. In the documentation, it says in section 3.1.1.1.1 of the Couchbase SDK PHP 1.0 doc (http://www.couchbase.com/docs/couchbase-sdk-php-1.0.pdf) it says
In ext/couchbase connections are persistent by default and you can turn them off with the second optional parameter to __construct() and setting it to false.
This is echoed in the next section, 3.1.1.1.1.1, where it says
This is a relatively expensive call and that's the reason why we use persistent connections by default, so that this call doesn't have to be made more often then necessary, and most importantly not on every user-request.
However, later in the documentation, in Chapter 5 there's a section at the beginning of the chapter talking about the $object->new Couchbase() method. When explaining the parameters that are passed in to the new Couchbase() function, it says
The parameters you use include host:port, username, password, bucket name, and a boolean. The boolean set to true indicates that you want to create a persistent connection. By default connections are not persistent.
So in two different places it says persistent connections are true by defualt and in one section it says that persistent connections are false by default. I want to say that they're true by default, but I want to be sure.
Anyone have any insight into this?
Thanks for the insight on the documentation, this needs to be fixed!
I can tell you that connections are non-persistent by default. If you're curious, you can look at the code here (it's the master branch, but the behavior hasn't changed IIRC): https://github.com/couchbase/php-ext-couchbase/blob/master/couchbase.c#L...
Regards,
Michael
@Matt, can you make sure this will be fixed in the docs accordingly?