Couchbase

[PCBC-180] PHP Warning: Couchbase::get() could not decompress value (bad content)

Tue, 16 Apr 2013 02:56:42 -0500

Forum thread with bug history
http://www.couchbase.com/forums/thread/php-warning-couchbaseget-could-not-decompress-value-bad-content

[PCBC-164] Streamline tests

Sat, 11 May 2013 13:31:59 -0500

Tests right now are much slower than they should be, which also means that running them is turning into a much bigger hassle than it should be. Here are some things to do in order to make them quicker

1) Remove OO vs non-OO tests unless behavior is known to differ:

Right now all our OO functions and non-OO functions traverse exactly the same code paths (not as previously when there would be different code paths for each).

2) Move slow tests into their own categories: Simple mutation functions should not be intermixed with long things like key durability ops. These should be in separate files -- thus also allowing us to exclude them somehow (either via make test, or through runwrap/phpunit)

3) Tests which are expected to fail or are inconclusive should be marked as such.

[PCBC-224] Document installation instructions for Windows with Apache instead of IIS

Mon, 22 Apr 2013 05:46:27 -0500

Document installation instructions for Windows with Apache instead of IIS

[PCBC-221] PHP Couchbase persistent connections shares more than expected

Mon, 22 Apr 2013 03:10:16 -0500

PHP Couchbase persistent connection shares all option settings (serializer, compression, prefix_key) and keeps that settings across multiple requests. This is not an expected behaviour.

Code:

<?php
$cb1 = new Couchbase("http://192.168.0.180/default");
$cb2 = new Couchbase("http://192.168.0.180/default");

$cb1->setOption(COUCHBASE_OPT_PREFIX_KEY,'cb1');
$cb2->setOption(COUCHBASE_OPT_PREFIX_KEY,'cb2');

$cb1->set('val1','v1', 60);
$cb2->set('val2','v2', 60);
?>

will store following keys:

cb2_val1
cb2_val2

Moreover if you execute right after previous request following code (in another script):

<?php
$cb = new Couchbase("http://192.168.0.180/default");
$cb->set('val3','v3', 60);
?>

the code stores key:

cb2_val3

If you turn off the persistent connections, you will get more consistent results:

cb1_val1
cb2_val2
val3

The problem is that whole _php_couchbase_res structure is shared when using persistent connection. Possible change is to duplicate this structure in php_couchbase_create_impl. But resource destructors should be modified according to this change.

[PCBC-220] error with "default" bucket. named bucket work OK: CouchbaseLibcouchbaseException Failed to get a value from server: Network error.

Mon, 22 Apr 2013 21:35:29 -0500

php-ext-couchbase version: https://github.com/couchbase/php-ext-couchbase/commit/ff2ed89c6255a2f364640b62d9930732ce597075

duplicates to #~~PCBC-169~~, but with php 5.4

I use php-fpm 5.4.13-1.el6.remi.x86_64 ( with nginx-1.3.15-1.el6.ngx.x86_64).
It work OK yesterday. But today: CouchbaseLibcouchbaseException Failed to get a value from server: Network error.

  $bk = isset($_GET['bk'])? $_GET['bk'] : 'default';
  $cb = new Couchbase("$host:8091", 'user', 'password', $bk);
  $a = $cb->get('aaa'); //-> error here

Error with /test.php (& /test.php?bk=default). But OK with /test.php?bk=mybk

After: # service php-fpm restart
Then all (with 'default' & with named bucket) test OK.

I can not reproduce this error now.

[PCBC-207] Support to Spatial Views in PHP SDK

Fri, 1 Mar 2013 12:38:46 -0600

The release 1.1.2 does not allow developer to call Spatial Views.

We need to implement it for future release

[PCBC-201] Docs: Reference installation

Mon, 11 Feb 2013 05:36:19 -0600

Customers have lots of choices at their fingertips, and many of those choices will result in a non-functioning installation, or at least a lot of time spent figuring out what the right pieces are.

Can we please provide as much details as possible about a reference installation that we can be sure will work for a customer who is just getting started? This is outside of our support for any one operatin system, but more about telling the customer "if you install with these versions and packages, this code will work"

-OS
-"language" version (PHP 5.x, etc)
-other packages/modules required and/or tested with

[PCBC-199] Docs: Add link to more code examples

Mon, 11 Feb 2013 05:26:55 -0600

https://github.com/couchbaselabs/DeveloperDay/tree/master/PHP

[PCBC-197] different parameter order for incremement

Tue, 16 Apr 2013 03:50:21 -0500

From IRC:

lachlan: can the latest php sdk (couchbase.so) still to be a drop in replacement for php memcached?
[2:39pm] trondn: lachlan: it is supposed to be compatible, but the constructor/factory methods are named differently etc..
[2:39pm] lachlan: reason I ask is the different order of parameters for increment() between memcached and couchbase sdk
[2:39pm] lachlan: Memcached::increment ( string $key [, int $offset = 1 [, int $initial_value = 0 [, int $expiry = 0 ]]] )
[2:39pm] lachlan: Couchbase - $object->increment($key [, $offset ] [, $create ] [, $expiry ] [, $initial ])
[2:39pm] trondn: hmm.. I guess that's a bug...
[2:40pm] trondn: let me file that one...
[2:40pm]

[PCBC-196] Error handling documentation

Tue, 5 Feb 2013 02:39:21 -0600

Please create some documentation specifying possible error/failures to operations, what they "look" like in the logs/exceptions/stack traces and what our recommendation is on how to handle them.

i.e. tmp_oom, timeouts (connection/operation/java-internal/etc), "get miss" (it's technically a failure, let's make it overly obvious what it means), CAS failure, add() failure, replace() failure,

Some of this should be covered in the API reference, but this bug is specifically for a single page where this information is aggregated that a customer/user could read about how to handle errors.

[PCBC-195] Write the Getting Started with PHP on Linux section of the essentials guide

Mon, 4 Feb 2013 11:23:00 -0600

Write the Getting started with PHP on Linux (Redhat and Debian) section of the Essentials Guide

Needs to cover:

Installation of the PHP Couchbase extensions and pre-requisites
Writing your first (small) app using Couchbase and PHP

Submissions should be to MC, either through the couchbase/docs repo, or direct to MC in whatever format suits. Must include both the text and images.

[PCBC-190] Need documentation on timeouts available for PHP

Tue, 16 Apr 2013 05:11:22 -0500

This link: http://www.couchbase.com/docs/couchbase-devguide-1.8/about-client-timeouts.html, states that there aren't any timeouts available for PHP

The PHP docs don't describe any.

However, I know that the underlying libcouchbase exposes at least one basic request timeout setting so either the PHP library needs some help exposing that, or it already does and we need to document it.

[PCBC-189] [Better sample needed] Code sample of PHP Get and Lock

Tue, 26 Mar 2013 15:21:55 -0500

One of our users asked for a code example demonstrating Get and Lock in PHP for the Developer Guide.

[PCBC-185] Create an example to show how to use the getAndLock feature

Tue, 22 Jan 2013 08:48:27 -0600

It will be useful for user to see how to use the getAndLock function in PHP here:
https://github.com/couchbase/php-ext-couchbase/tree/master/example

[PCBC-184] It would be nice to support the flags sections for the memcache extension

Tue, 16 Apr 2013 06:32:49 -0500

It would be nice to support the flags sections for the memcache extension

[PCBC-182] Update the documentation to show when a parameter is a copy or a reference

Fri, 18 Jan 2013 05:46:45 -0600

When I look at the PHP core documentation I see when a parameter is a reference or not. (so we should review all our function documentation)

For example if you look at:
http://www.php.net/sort

Not only I know the type but also when it is a reference it is mentionned as &$array

I think we should do the same in our documentation, when I see our API with cas, for example:
http://www.couchbase.com/docs/couchbase-sdk-php-1.1/api-reference-retrieve-get.html#table-couchbase-sdk_php_get

it is not clear to me.

[PCBC-179] Couchbase PHP client library v1.1.1 returns random integer on get request

Thu, 17 Jan 2013 02:01:13 -0600

Forum thread with bug history
http://www.couchbase.com/forums/thread/couchbase-php-client-library-v1-1-1-returns-random-integer-get-request

[PCBC-171] Package build scripts don't build source correctly

Thu, 27 Dec 2012 13:43:05 -0600

The prefix is missing the trailing slash, so the source packages are prefixed incorrectly.

[PCBC-162] include_docs support missing

Tue, 11 Dec 2012 20:54:40 -0600

viewopts.c appears to be missing include_docs as a valid parameter for the array values that get passed in for a view.

[PCBC-152] Release notes needed fro 1.0.6

Fri, 30 Nov 2012 12:51:16 -0600

As with Ruby, PHP 1.0.5 and 1.0.6 are marked as "unreleased" in Jira yet have been avialable for d/l. Release notes needed for 1.0.6

[PCBC-226] Key limit in view Queries and likely other SDK calls

Mon, 29 Apr 2013 11:41:36 -0500

I'm querying a view using the PHP SDK using the view method, $object->view($ddocname [, $viewname ] [, $viewoptions ]), and finding that when I pass in a certain number of keys in the viewoptions param, the method silently fails and just returns null. It appears that 164 keys is OK, but 179 is not. I didn't see documentation indicating a key limit and would expect an error if there were.
Here's the call:
// 179 keys breaks, 164 OK
$result = $this->cb->view(self::VIEW_DAP,'modelcount',array('keys' => $keys,
'group_level' => 2,
'group' => true,
'skip' => 0)

Here's a link to the forum thread I created:
http://www.couchbase.com/forums/thread/key-limit-view-queries

As you'll see in the responses, this is probably a much more general issue that the PHP SDK uses GET calls that have a string length limit. It seems that the SDK should either use POSTs to avoid the limit or document the size limits in the documentation.

[PCBC-227] setMulti doesn't support pure digit key

Fri, 3 May 2013 13:10:28 -0500

This bug didn't exist in 1.1.0dp5, but I've seen it before in php-memcached. The issue is when issuing a setMulti() array into CB it doesn't like it if the key is not a string.

$key = 12345
$value = 67890

$value = json_encode($value);
$array[$key] = $value;

$cb_obj->setMulti($array,$expire);

PHP Fatal error: Uncaught exception 'CouchbaseIllegalKeyException' with message 'Invalid key specified (not a string)'

test2.php(67): Couchbase->setMulti(Array, 604800)

The reference bug for php-memcached is: https://bugs.php.net/bug.php?id=59016

After experiencing the issue there I recompiled their newest version and it fixed the problem. I'm not sure if you can dovetail off of that work or not.

[PCBC-225] Failure to load JSON module, even with workaround provided via instructions

Tue, 7 May 2013 12:32:52 -0500

On a Centos 5.8 system, I am unable to follow our instructions (http://www.couchbase.com/develop/php/current) to success.

After setting everything up, I get the following error about JSON:
NOTICE: PHP message: PHP Warning: PHP Startup: Unable to load dynamic library '/usr/lib64/php/modules/couchbase.so' - /usr/lib64/php/modules/couchbase.so: undefined symbol: php_json_decode in Unknown on line 0

This is even after I put the json.so as an extension in the PHP.ini file.

php -i shows the proper JSON related output:
~ $ php -i | grep json
json
json support => enabled
json version => 1.2.1

I will note that installing via the new PECL method helps to resolve this, but you still get the error if you don't include json.so in the php.ini file.

[PCBC-223] Docs: Instructions to find php.ini incorrect

Sat, 11 May 2013 13:27:40 -0500

http://www.couchbase.com/develop/php/current

"You will add the couchbase.so extension to your php.ini file. To find where your php.inifile is, try php -i | grep extension_dir or look at your <?php phpinfo() ?> output. Edit your php.ini to include these two lines:"

Not correct..."extension_dir" should be "Configuration" and there should be another set of instructions for finding the extension directory

[PCBC-125] Tests: require get validation to also ensure CAS is expected value

Sat, 11 May 2013 13:30:45 -0500

Tests: require get validation to also ensure CAS is expected value

[PCBC-69] Add Pagination to the new 1.1.0 line.

Mon, 13 May 2013 02:37:31 -0500

We should bake in pagination into ext/couchbase

$result = $cb->view("ddoc", "viewname");
$pager = $result->getPager($rowsPerPage = 10);
foreach($pager->nextPage() AS $page) {
  foreach($page->rows AS $row) {
    var_dump($row);
  }
}

[PCBC-53] include windows in release

Mon, 13 May 2013 02:37:43 -0500

Once libcouchbase is in a release for Windows, there should be a PHP release to go along with it.

[PCBC-233] build php 1.1.5 for windows

Tue, 14 May 2013 06:11:31 -0500

Since we've released 1.1.5, we need to get some builds of that for Windows.

[PCBC-222] couchbase.default_prefix setting in PHP.ini

Mon, 22 Apr 2013 03:11:27 -0500

It will be nice to have couchbase.default_prefix setting in PHP.ini to set default value of couchbase_res->prefix_key in new connections.

[PCBC-202] Missing documentations how to setup php client on windows 7

Tue, 2 Apr 2013 04:13:04 -0500

Missing documentations how to setup php client on windows 7

[PCBC-118] add functionality to use setMulti with CAS (and individual expiry)

Wed, 7 Nov 2012 15:45:42 -0600

This would need to be called setMultiEx as the key-value array passed to setMulti itself already assumes the value is the value to serialize and store on the server.

sample:

$kv = array($key => array($value, $cas, $exp));

[PCBC-101] Provide Standardized Logging

Sun, 16 Dec 2012 11:11:35 -0600

Provides the consistent level of logging provided by other SDKs. Provide more information on configuring logging for developers.

[PCBC-102] Provide Consistent Order of Parameters

Sun, 16 Dec 2012 11:11:34 -0600

Provide consistent, predictable order for method parameters as other SDKS.

[PCBC-96] Create compatibility layer for flags in PHP

Sun, 16 Dec 2012 11:11:37 -0600

In ~~PCBC-78~~, we'd added a simple workaround to working with JSON from multiple languages. We need a more elegant approach though, and that'd need to consider standardizing flags or some other approach. This issue will track that need.

[PCBC-24] deploying to download locations directly from CI

Sun, 16 Dec 2012 11:11:37 -0600

The idea here is that non-releases should automatically upload deploy to one location, and releases should automatically deploy to a different location.

[PCBC-235] Documentation: Document how to install our SDK with PEAR

Thu, 23 May 2013 23:54:26 -0500

Based on a community feedback it is possible and easy to install Couchbase PHP SDK with Pear, it could be interested to add that as part of our documentation to let the developer chose the type of install (manual, pecl, pear, ...)

You can find the steps here:
http://www.couchbase.com/forums/thread/php-sdk-install-pear

[PCBC-93] Support for HipHop

Fri, 24 May 2013 10:44:30 -0500

https://github.com/facebook/hiphop-php/wiki/

According to Sergey we need at least write adapter code for it: https://github.com/facebook/hiphop-php/pull/244/files