PCBC-788: handle rate/quota limit error codes

Change-Id: I4eb955a209cd056f1581be5c53609490b45c4df2
Reviewed-on: https://review.couchbase.org/c/php-couchbase/+/167024
Tested-by: Build Bot <[email protected]>
Reviewed-by: Sergey Avseyev <[email protected]>

Author: avsej

api/couchbase.php

@@ -636,6 +636,10 @@ public function context(): ?object {}
 
 class RequestCanceledException extends BaseException implements Throwable {}
 
+class RateLimitedException extends BaseException implements Throwable {}
+
+class QuotaLimitedException extends BaseException implements Throwable {}
+
 /**
  *  Thrown for exceptions that originate from underlying Http operations.
  */

config.m4

@@ -18,12 +18,12 @@ if test "$PHP_COUCHBASE" != "no"; then
   elif test -x "$PKG_CONFIG" && $PKG_CONFIG --exists libcouchbase; then
     LIBCOUCHBASE_VERSION=`$PKG_CONFIG libcouchbase --modversion`
 
-    if $PKG_CONFIG libcouchbase --atleast-version 3.2.2; then
+    if $PKG_CONFIG libcouchbase --atleast-version 3.2.4; then
       LIBCOUCHBASE_CFLAGS=`$PKG_CONFIG libcouchbase --cflags`
       LIBCOUCHBASE_LIBS=`$PKG_CONFIG libcouchbase --libs`
       AC_MSG_RESULT(from pkgconfig: version $LIBCOUCHBASE_VERSION found)
     else
-      AC_MSG_ERROR([libcouchbase version $LIBCOUCHBASE_VERSION found, must be upgraded to version >= 3.2.2])
+      AC_MSG_ERROR([libcouchbase version $LIBCOUCHBASE_VERSION found, must be upgraded to version >= 3.2.4])
     fi
 
   dnl fallback on standard directory
@@ -50,14 +50,14 @@ if test "$PHP_COUCHBASE" != "no"; then
 
   dnl found in directory
   else
-    AC_MSG_CHECKING([for libcouchbase version >= 3.2.2])
+    AC_MSG_CHECKING([for libcouchbase version >= 3.2.4])
     LCB_VERSION=$($EGREP "define LCB_VERSION " $LIBCOUCHBASE_DIR/include/libcouchbase/configuration.h | $SED -e 's/[[^0-9x]]//g')
     AC_MSG_RESULT([$LCB_VERSION])
     if test "x$LCB_VERSION" = "x0x000000"; then
       AC_MSG_ERROR([seems like libcouchbase is not installed from official tarball or git clone. Do not use github tags to download releases.])
     fi
-    if test $(printf %d $LCB_VERSION) -lt $(printf %d 0x030202); then
-      AC_MSG_ERROR([libcouchbase greater or equal to 3.2.2 required])
+    if test $(printf %d $LCB_VERSION) -lt $(printf %d 0x030204); then
+      AC_MSG_ERROR([libcouchbase greater or equal to 3.2.4 required])
     fi
 
     PHP_ADD_INCLUDE($LIBCOUCHBASE_DIR/include)

exception.c

@@ -78,6 +78,8 @@ zend_class_entry *pcbc_keyspace_not_found_exception_ce;
 zend_class_entry *pcbc_prepared_statement_failure_exception_ce;
 zend_class_entry *pcbc_dml_failure_exception_ce;
 zend_class_entry *pcbc_request_canceled_exception_ce;
+zend_class_entry *pcbc_rate_limited_exception_ce;
+zend_class_entry *pcbc_quota_limited_exception_ce;
 
 ZEND_BEGIN_ARG_WITH_RETURN_TYPE_INFO(ai_BaseException_ref, IS_STRING, 1)
 ZEND_END_ARG_INFO()
@@ -220,6 +222,12 @@ PHP_MINIT_FUNCTION(CouchbaseException)
     INIT_NS_CLASS_ENTRY(ce, "Couchbase", "SubdocumentException", NULL);
     pcbc_subdocument_exception_ce = zend_register_internal_class_ex(&ce, pcbc_base_exception_ce);
 
+    INIT_NS_CLASS_ENTRY(ce, "Couchbase", "RateLimitedException", NULL);
+    pcbc_rate_limited_exception_ce = zend_register_internal_class_ex(&ce, pcbc_base_exception_ce);
+
+    INIT_NS_CLASS_ENTRY(ce, "Couchbase", "QuotaLimitedException", NULL);
+    pcbc_quota_limited_exception_ce = zend_register_internal_class_ex(&ce, pcbc_base_exception_ce);
+
     return SUCCESS;
 }
 
@@ -442,6 +450,14 @@ void pcbc_create_lcb_exception(zval *return_value, long code, zend_string *conte
         exc_ce = pcbc_dml_failure_exception_ce;
         break;
 
+    case LCB_ERR_RATE_LIMITED:
+        exc_ce = pcbc_rate_limited_exception_ce;
+        break;
+
+    case LCB_ERR_QUOTA_LIMITED:
+        exc_ce = pcbc_quota_limited_exception_ce;
+        break;
+
     default:
         exc_ce = pcbc_base_exception_ce;
         break;