src/php/ext/grpc/call.c

   1 /*
   2  *
   3  * Copyright 2015 gRPC authors.
   4  *
   5  * Licensed under the Apache License, Version 2.0 (the "License");
   6  * you may not use this file except in compliance with the License.
   7  * You may obtain a copy of the License at
   8  *
   9  *     http://www.apache.org/licenses/LICENSE-2.0
  10  *
  11  * Unless required by applicable law or agreed to in writing, software
  12  * distributed under the License is distributed on an "AS IS" BASIS,
  13  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14  * See the License for the specific language governing permissions and
  15  * limitations under the License.
  16  *
  17  */
  18
  19 #include "call.h"
  20
  21 #include <ext/spl/spl_exceptions.h>
  22 #include <zend_exceptions.h>
  23
  24 #include <grpc/support/alloc.h>
  25
  26 #include "call_credentials.h"
  27 #include "completion_queue.h"
  28 #include "timeval.h"
  29 #include "channel.h"
  30 #include "byte_buffer.h"
  31
  32 zend_class_entry *grpc_ce_call;
  33 PHP_GRPC_DECLARE_OBJECT_HANDLER(call_ce_handlers)
  34
  35 /* Frees and destroys an instance of wrapped_grpc_call */
  36 PHP_GRPC_FREE_WRAPPED_FUNC_START(wrapped_grpc_call)
  37   if (p->owned && p->wrapped != NULL) {
  38     grpc_call_unref(p->wrapped);
  39   }
  40 PHP_GRPC_FREE_WRAPPED_FUNC_END()
  41
  42 /* Initializes an instance of wrapped_grpc_call to be associated with an
  43  * object of a class specified by class_type */
  44 php_grpc_zend_object create_wrapped_grpc_call(zend_class_entry *class_type
  45                                               TSRMLS_DC) {
  46   PHP_GRPC_ALLOC_CLASS_OBJECT(wrapped_grpc_call);
  47   zend_object_std_init(&intern->std, class_type TSRMLS_CC);
  48   object_properties_init(&intern->std, class_type);
  49   PHP_GRPC_FREE_CLASS_OBJECT(wrapped_grpc_call, call_ce_handlers);
  50 }
  51
  52 /* Creates and returns a PHP array object with the data in a
  53  * grpc_metadata_array. Returns NULL on failure */
  54 zval *grpc_parse_metadata_array(grpc_metadata_array
  55                                 *metadata_array TSRMLS_DC) {
  56   int count = metadata_array->count;
  57   grpc_metadata *elements = metadata_array->metadata;
  58   zval *array;
  59   PHP_GRPC_MAKE_STD_ZVAL(array);
  60   array_init(array);
  61   int i;
  62   HashTable *array_hash;
  63   zval *inner_array;
  64   char *str_key;
  65   char *str_val;
  66   size_t key_len;
  67   zval *data = NULL;
  68
  69   array_hash = Z_ARRVAL_P(array);
  70   grpc_metadata *elem;
  71   for (i = 0; i < count; i++) {
  72     elem = &elements[i];
  73     key_len = GRPC_SLICE_LENGTH(elem->key);
  74     str_key = ecalloc(key_len + 1, sizeof(char));
  75     memcpy(str_key, GRPC_SLICE_START_PTR(elem->key), key_len);
  76     str_val = ecalloc(GRPC_SLICE_LENGTH(elem->value) + 1, sizeof(char));
  77     memcpy(str_val, GRPC_SLICE_START_PTR(elem->value),
  78            GRPC_SLICE_LENGTH(elem->value));
  79     if (php_grpc_zend_hash_find(array_hash, str_key, key_len, (void **)&data)
  80         == SUCCESS) {
  81       if (Z_TYPE_P(data) != IS_ARRAY) {
  82         zend_throw_exception(zend_exception_get_default(TSRMLS_C),
  83                              "Metadata hash somehow contains wrong types.",
  84                              1 TSRMLS_CC);
  85         efree(str_key);
  86         efree(str_val);
  87         PHP_GRPC_FREE_STD_ZVAL(array);
  88         return NULL;
  89       }
  90       php_grpc_add_next_index_stringl(data, str_val,
  91                                       GRPC_SLICE_LENGTH(elem->value),
  92                                       false);
  93     } else {
  94       PHP_GRPC_MAKE_STD_ZVAL(inner_array);
  95       array_init(inner_array);
  96       php_grpc_add_next_index_stringl(inner_array, str_val,
  97                                       GRPC_SLICE_LENGTH(elem->value), false);
  98       add_assoc_zval(array, str_key, inner_array);
  99       PHP_GRPC_FREE_STD_ZVAL(inner_array);
 100     }
 101     efree(str_key);
 102 #if PHP_MAJOR_VERSION >= 7
 103     efree(str_val);
 104 #endif
 105   }
 106   return array;
 107 }
 108
 109 /* Populates a grpc_metadata_array with the data in a PHP array object.
 110    Returns true on success and false on failure */
 111 bool create_metadata_array(zval *array, grpc_metadata_array *metadata) {
 112   HashTable *array_hash;
 113   HashTable *inner_array_hash;
 114   zval *value;
 115   zval *inner_array;
 116   grpc_metadata_array_init(metadata);
 117   metadata->count = 0;
 118   metadata->metadata = NULL;
 119   if (Z_TYPE_P(array) != IS_ARRAY) {
 120     return false;
 121   }
 122   array_hash = Z_ARRVAL_P(array);
 123
 124   char *key;
 125   int key_type;
 126   PHP_GRPC_HASH_FOREACH_STR_KEY_VAL_START(array_hash, key, key_type,
 127                                           inner_array)
 128     if (key_type != HASH_KEY_IS_STRING || key == NULL) {
 129       return false;
 130     }
 131     if (Z_TYPE_P(inner_array) != IS_ARRAY) {
 132       return false;
 133     }
 134     inner_array_hash = Z_ARRVAL_P(inner_array);
 135     metadata->capacity += zend_hash_num_elements(inner_array_hash);
 136   PHP_GRPC_HASH_FOREACH_END()
 137
 138   metadata->metadata = gpr_malloc(metadata->capacity * sizeof(grpc_metadata));
 139
 140   char *key1 = NULL;
 141   int key_type1;
 142   PHP_GRPC_HASH_FOREACH_STR_KEY_VAL_START(array_hash, key1, key_type1,
 143                                           inner_array)
 144     if (key_type1 != HASH_KEY_IS_STRING) {
 145       return false;
 146     }
 147     if (!grpc_header_key_is_legal(grpc_slice_from_static_string(key1))) {
 148       return false;
 149     }
 150     inner_array_hash = Z_ARRVAL_P(inner_array);
 151     PHP_GRPC_HASH_FOREACH_VAL_START(inner_array_hash, value)
 152       if (Z_TYPE_P(value) != IS_STRING) {
 153         return false;
 154       }
 155       metadata->metadata[metadata->count].key =
 156         grpc_slice_from_copied_string(key1);
 157       metadata->metadata[metadata->count].value =
 158         grpc_slice_from_copied_buffer(Z_STRVAL_P(value), Z_STRLEN_P(value));
 159       metadata->count += 1;
 160     PHP_GRPC_HASH_FOREACH_END()
 161   PHP_GRPC_HASH_FOREACH_END()
 162   return true;
 163 }
 164
 165 void grpc_php_metadata_array_destroy_including_entries(
 166     grpc_metadata_array* array) {
 167   size_t i;
 168   if (array->metadata) {
 169     for (i = 0; i < array->count; i++) {
 170       grpc_slice_unref(array->metadata[i].key);
 171       grpc_slice_unref(array->metadata[i].value);
 172     }
 173   }
 174   grpc_metadata_array_destroy(array);
 175 }
 176
 177 /* Wraps a grpc_call struct in a PHP object. Owned indicates whether the
 178    struct should be destroyed at the end of the object's lifecycle */
 179 zval *grpc_php_wrap_call(grpc_call *wrapped, bool owned TSRMLS_DC) {
 180   zval *call_object;
 181   PHP_GRPC_MAKE_STD_ZVAL(call_object);
 182   object_init_ex(call_object, grpc_ce_call);
 183   wrapped_grpc_call *call = PHP_GRPC_GET_WRAPPED_OBJECT(wrapped_grpc_call,
 184                                                         call_object);
 185   call->wrapped = wrapped;
 186   call->owned = owned;
 187   return call_object;
 188 }
 189
 190 /**
 191  * Constructs a new instance of the Call class.
 192  * @param Channel $channel_obj The channel to associate the call with.
 193  *                             Must not be closed.
 194  * @param string $method The method to call
 195  * @param Timeval $deadline_obj The deadline for completing the call
 196  * @param string $host_override The host is set by user (optional)
 197  */
 198 PHP_METHOD(Call, __construct) {
 199   zval *channel_obj;
 200   char *method;
 201   php_grpc_int method_len;
 202   zval *deadline_obj;
 203   char *host_override = NULL;
 204   php_grpc_int host_override_len = 0;
 205   wrapped_grpc_call *call = PHP_GRPC_GET_WRAPPED_OBJECT(wrapped_grpc_call,
 206                                                         getThis());
 207
 208   /* "OsO|s" == 1 Object, 1 string, 1 Object, 1 optional string */
 209   if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "OsO|s", &channel_obj,
 210                             grpc_ce_channel, &method, &method_len,
 211                             &deadline_obj, grpc_ce_timeval, &host_override,
 212                             &host_override_len) == FAILURE) {
 213     zend_throw_exception(spl_ce_InvalidArgumentException,
 214                          "Call expects a Channel, a String, a Timeval and "
 215                          "an optional String", 1 TSRMLS_CC);
 216     return;
 217   }
 218   wrapped_grpc_channel *channel =
 219     PHP_GRPC_GET_WRAPPED_OBJECT(wrapped_grpc_channel, channel_obj);
 220   if (channel->wrapper == NULL) {
 221     zend_throw_exception(spl_ce_InvalidArgumentException,
 222                          "Call cannot be constructed from a closed Channel",
 223                          1 TSRMLS_CC);
 224     return;
 225   }
 226   gpr_mu_lock(&channel->wrapper->mu);
 227   if (channel->wrapper == NULL || channel->wrapper->wrapped == NULL) {
 228     zend_throw_exception(spl_ce_InvalidArgumentException,
 229                          "Call cannot be constructed from a closed Channel",
 230                          1 TSRMLS_CC);
 231     gpr_mu_unlock(&channel->wrapper->mu);
 232     return;
 233   }
 234   add_property_zval(getThis(), "channel", channel_obj);
 235   wrapped_grpc_timeval *deadline =
 236     PHP_GRPC_GET_WRAPPED_OBJECT(wrapped_grpc_timeval, deadline_obj);
 237   grpc_slice method_slice = grpc_slice_from_copied_string(method);
 238   grpc_slice host_slice = host_override != NULL ?
 239       grpc_slice_from_copied_string(host_override) : grpc_empty_slice();
 240   call->wrapped =
 241     grpc_channel_create_call(channel->wrapper->wrapped, NULL,
 242                              GRPC_PROPAGATE_DEFAULTS,
 243                              completion_queue, method_slice,
 244                              host_override != NULL ? &host_slice : NULL,
 245                              deadline->wrapped, NULL);
 246   grpc_slice_unref(method_slice);
 247   grpc_slice_unref(host_slice);
 248   call->owned = true;
 249   call->channel = channel;
 250   gpr_mu_unlock(&channel->wrapper->mu);
 251 }
 252
 253 /**
 254  * Start a batch of RPC actions.
 255  * @param array $array Array of actions to take
 256  * @return object Object with results of all actions
 257  */
 258 PHP_METHOD(Call, startBatch) {
 259   zval *result;
 260   PHP_GRPC_MAKE_STD_ZVAL(result);
 261   object_init(result);
 262   php_grpc_ulong index;
 263   zval *recv_status;
 264   zval *value;
 265   zval *inner_value;
 266   zval *message_value;
 267   zval *message_flags;
 268   wrapped_grpc_call *call = PHP_GRPC_GET_WRAPPED_OBJECT(wrapped_grpc_call,
 269                                                         getThis());
 270   if (call->channel) {
 271     // startBatch in gRPC PHP server doesn't have channel in it.
 272     if (call->channel->wrapper == NULL ||
 273         call->channel->wrapper->wrapped == NULL) {
 274       zend_throw_exception(spl_ce_RuntimeException,
 275                            "startBatch Error. Channel is closed",
 276                            1 TSRMLS_CC);
 277     }
 278   }
 279
 280   grpc_op ops[8];
 281   size_t op_num = 0;
 282   zval *array;
 283   HashTable *array_hash;
 284   HashTable *status_hash;
 285   HashTable *message_hash;
 286
 287   grpc_metadata_array metadata;
 288   grpc_metadata_array trailing_metadata;
 289   grpc_metadata_array recv_metadata;
 290   grpc_metadata_array recv_trailing_metadata;
 291   grpc_status_code status;
 292   grpc_slice recv_status_details = grpc_empty_slice();
 293   grpc_slice send_status_details = grpc_empty_slice();
 294   grpc_byte_buffer *message;
 295   int cancelled;
 296   grpc_call_error error;
 297   char *message_str;
 298   size_t message_len;
 299
 300   grpc_metadata_array_init(&metadata);
 301   grpc_metadata_array_init(&trailing_metadata);
 302   grpc_metadata_array_init(&recv_metadata);
 303   grpc_metadata_array_init(&recv_trailing_metadata);
 304   memset(ops, 0, sizeof(ops));
 305
 306   /* "a" == 1 array */
 307   if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "a", &array) ==
 308       FAILURE) {
 309     zend_throw_exception(spl_ce_InvalidArgumentException,
 310                          "start_batch expects an array", 1 TSRMLS_CC);
 311     goto cleanup;
 312   }
 313
 314   array_hash = Z_ARRVAL_P(array);
 315
 316   char *key = NULL;
 317   int key_type;
 318   PHP_GRPC_HASH_FOREACH_LONG_KEY_VAL_START(array_hash, key, key_type, index,
 319                                            value)
 320     if (key_type != HASH_KEY_IS_LONG || key != NULL) {
 321       zend_throw_exception(spl_ce_InvalidArgumentException,
 322                            "batch keys must be integers", 1 TSRMLS_CC);
 323       goto cleanup;
 324     }
 325
 326     ops[op_num].op = (grpc_op_type)index;
 327     ops[op_num].flags = 0;
 328     ops[op_num].reserved = NULL;
 329
 330     switch(index) {
 331     case GRPC_OP_SEND_INITIAL_METADATA:
 332       if (!create_metadata_array(value, &metadata)) {
 333         zend_throw_exception(spl_ce_InvalidArgumentException,
 334                              "Bad metadata value given", 1 TSRMLS_CC);
 335         goto cleanup;
 336       }
 337       ops[op_num].data.send_initial_metadata.count = metadata.count;
 338       ops[op_num].data.send_initial_metadata.metadata = metadata.metadata;
 339       break;
 340     case GRPC_OP_SEND_MESSAGE:
 341       if (Z_TYPE_P(value) != IS_ARRAY) {
 342         zend_throw_exception(spl_ce_InvalidArgumentException,
 343                              "Expected an array for send message",
 344                              1 TSRMLS_CC);
 345         goto cleanup;
 346       }
 347       message_hash = Z_ARRVAL_P(value);
 348       if (php_grpc_zend_hash_find(message_hash, "flags", sizeof("flags"),
 349                          (void **)&message_flags) == SUCCESS) {
 350         if (Z_TYPE_P(message_flags) != IS_LONG) {
 351           zend_throw_exception(spl_ce_InvalidArgumentException,
 352                                "Expected an int for message flags",
 353                                1 TSRMLS_CC);
 354         }
 355         ops[op_num].flags = Z_LVAL_P(message_flags) & GRPC_WRITE_USED_MASK;
 356       }
 357       if (php_grpc_zend_hash_find(message_hash, "message", sizeof("message"),
 358                          (void **)&message_value) != SUCCESS ||
 359           Z_TYPE_P(message_value) != IS_STRING) {
 360         zend_throw_exception(spl_ce_InvalidArgumentException,
 361                              "Expected a string for send message",
 362                              1 TSRMLS_CC);
 363         goto cleanup;
 364       }
 365       ops[op_num].data.send_message.send_message =
 366           string_to_byte_buffer(Z_STRVAL_P(message_value),
 367                                 Z_STRLEN_P(message_value));
 368       break;
 369     case GRPC_OP_SEND_CLOSE_FROM_CLIENT:
 370       break;
 371     case GRPC_OP_SEND_STATUS_FROM_SERVER:
 372       status_hash = Z_ARRVAL_P(value);
 373       if (php_grpc_zend_hash_find(status_hash, "metadata", sizeof("metadata"),
 374                          (void **)&inner_value) == SUCCESS) {
 375         if (!create_metadata_array(inner_value, &trailing_metadata)) {
 376           zend_throw_exception(spl_ce_InvalidArgumentException,
 377                                "Bad trailing metadata value given",
 378                                1 TSRMLS_CC);
 379           goto cleanup;
 380         }
 381         ops[op_num].data.send_status_from_server.trailing_metadata =
 382             trailing_metadata.metadata;
 383         ops[op_num].data.send_status_from_server.trailing_metadata_count =
 384             trailing_metadata.count;
 385       }
 386       if (php_grpc_zend_hash_find(status_hash, "code", sizeof("code"),
 387                          (void**)&inner_value) == SUCCESS) {
 388         if (Z_TYPE_P(inner_value) != IS_LONG) {
 389           zend_throw_exception(spl_ce_InvalidArgumentException,
 390                                "Status code must be an integer",
 391                                1 TSRMLS_CC);
 392           goto cleanup;
 393         }
 394         ops[op_num].data.send_status_from_server.status =
 395             Z_LVAL_P(inner_value);
 396       } else {
 397         zend_throw_exception(spl_ce_InvalidArgumentException,
 398                              "Integer status code is required",
 399                              1 TSRMLS_CC);
 400         goto cleanup;
 401       }
 402       if (php_grpc_zend_hash_find(status_hash, "details", sizeof("details"),
 403                          (void**)&inner_value) == SUCCESS) {
 404         if (Z_TYPE_P(inner_value) != IS_STRING) {
 405           zend_throw_exception(spl_ce_InvalidArgumentException,
 406                                "Status details must be a string",
 407                                1 TSRMLS_CC);
 408           goto cleanup;
 409         }
 410         send_status_details = grpc_slice_from_copied_string(
 411           Z_STRVAL_P(inner_value));
 412         ops[op_num].data.send_status_from_server.status_details =
 413           &send_status_details;
 414       } else {
 415         zend_throw_exception(spl_ce_InvalidArgumentException,
 416                              "String status details is required",
 417                              1 TSRMLS_CC);
 418         goto cleanup;
 419       }
 420       break;
 421     case GRPC_OP_RECV_INITIAL_METADATA:
 422       ops[op_num].data.recv_initial_metadata.recv_initial_metadata =
 423           &recv_metadata;
 424       break;
 425     case GRPC_OP_RECV_MESSAGE:
 426       ops[op_num].data.recv_message.recv_message = &message;
 427       break;
 428     case GRPC_OP_RECV_STATUS_ON_CLIENT:
 429       ops[op_num].data.recv_status_on_client.trailing_metadata =
 430           &recv_trailing_metadata;
 431       ops[op_num].data.recv_status_on_client.status = &status;
 432       ops[op_num].data.recv_status_on_client.status_details =
 433           &recv_status_details;
 434       break;
 435     case GRPC_OP_RECV_CLOSE_ON_SERVER:
 436       ops[op_num].data.recv_close_on_server.cancelled = &cancelled;
 437       break;
 438     default:
 439       zend_throw_exception(spl_ce_InvalidArgumentException,
 440                            "Unrecognized key in batch", 1 TSRMLS_CC);
 441       goto cleanup;
 442     }
 443     op_num++;
 444   PHP_GRPC_HASH_FOREACH_END()
 445
 446   error = grpc_call_start_batch(call->wrapped, ops, op_num, call->wrapped,
 447                                 NULL);
 448   if (error != GRPC_CALL_OK) {
 449     zend_throw_exception(spl_ce_LogicException,
 450                          "start_batch was called incorrectly",
 451                          (long)error TSRMLS_CC);
 452     goto cleanup;
 453   }
 454   grpc_completion_queue_pluck(completion_queue, call->wrapped,
 455                               gpr_inf_future(GPR_CLOCK_REALTIME), NULL);
 456 #if PHP_MAJOR_VERSION >= 7
 457   zval *recv_md;
 458 #endif
 459   for (int i = 0; i < op_num; i++) {
 460     switch(ops[i].op) {
 461     case GRPC_OP_SEND_INITIAL_METADATA:
 462       add_property_bool(result, "send_metadata", true);
 463       break;
 464     case GRPC_OP_SEND_MESSAGE:
 465       add_property_bool(result, "send_message", true);
 466       break;
 467     case GRPC_OP_SEND_CLOSE_FROM_CLIENT:
 468       add_property_bool(result, "send_close", true);
 469       break;
 470     case GRPC_OP_SEND_STATUS_FROM_SERVER:
 471       add_property_bool(result, "send_status", true);
 472       break;
 473     case GRPC_OP_RECV_INITIAL_METADATA:
 474 #if PHP_MAJOR_VERSION < 7
 475       array = grpc_parse_metadata_array(&recv_metadata TSRMLS_CC);
 476       add_property_zval(result, "metadata", array);
 477 #else
 478       recv_md = grpc_parse_metadata_array(&recv_metadata);
 479       add_property_zval(result, "metadata", recv_md);
 480       zval_ptr_dtor(recv_md);
 481       PHP_GRPC_FREE_STD_ZVAL(recv_md);
 482 #endif
 483       PHP_GRPC_DELREF(array);
 484       break;
 485     case GRPC_OP_RECV_MESSAGE:
 486       byte_buffer_to_string(message, &message_str, &message_len);
 487       if (message_str == NULL) {
 488         add_property_null(result, "message");
 489       } else {
 490         php_grpc_add_property_stringl(result, "message", message_str,
 491                                       message_len, false);
 492       }
 493       break;
 494     case GRPC_OP_RECV_STATUS_ON_CLIENT:
 495       PHP_GRPC_MAKE_STD_ZVAL(recv_status);
 496       object_init(recv_status);
 497 #if PHP_MAJOR_VERSION < 7
 498       array = grpc_parse_metadata_array(&recv_trailing_metadata TSRMLS_CC);
 499       add_property_zval(recv_status, "metadata", array);
 500 #else
 501       recv_md = grpc_parse_metadata_array(&recv_trailing_metadata);
 502       add_property_zval(recv_status, "metadata", recv_md);
 503       zval_ptr_dtor(recv_md);
 504       PHP_GRPC_FREE_STD_ZVAL(recv_md);
 505 #endif
 506       PHP_GRPC_DELREF(array);
 507       add_property_long(recv_status, "code", status);
 508       char *status_details_text = grpc_slice_to_c_string(recv_status_details);
 509       php_grpc_add_property_string(recv_status, "details", status_details_text,
 510                                    true);
 511       gpr_free(status_details_text);
 512       add_property_zval(result, "status", recv_status);
 513 #if PHP_MAJOR_VERSION >= 7
 514       zval_ptr_dtor(recv_status);
 515 #endif
 516       PHP_GRPC_DELREF(recv_status);
 517       PHP_GRPC_FREE_STD_ZVAL(recv_status);
 518       break;
 519     case GRPC_OP_RECV_CLOSE_ON_SERVER:
 520       add_property_bool(result, "cancelled", cancelled);
 521       break;
 522     default:
 523       break;
 524     }
 525   }
 526
 527 cleanup:
 528   grpc_php_metadata_array_destroy_including_entries(&metadata);
 529   grpc_php_metadata_array_destroy_including_entries(&trailing_metadata);
 530   grpc_metadata_array_destroy(&recv_metadata);
 531   grpc_metadata_array_destroy(&recv_trailing_metadata);
 532   grpc_slice_unref(recv_status_details);
 533   grpc_slice_unref(send_status_details);
 534   for (int i = 0; i < op_num; i++) {
 535     if (ops[i].op == GRPC_OP_SEND_MESSAGE) {
 536       grpc_byte_buffer_destroy(ops[i].data.send_message.send_message);
 537     }
 538     if (ops[i].op == GRPC_OP_RECV_MESSAGE) {
 539       grpc_byte_buffer_destroy(message);
 540       PHP_GRPC_FREE_STD_ZVAL(message_str);
 541     }
 542   }
 543   RETURN_DESTROY_ZVAL(result);
 544 }
 545
 546 /**
 547  * Get the endpoint this call/stream is connected to
 548  * @return string The URI of the endpoint
 549  */
 550 PHP_METHOD(Call, getPeer) {
 551   wrapped_grpc_call *call = PHP_GRPC_GET_WRAPPED_OBJECT(wrapped_grpc_call,
 552                                                         getThis());
 553   char *peer = grpc_call_get_peer(call->wrapped);
 554   PHP_GRPC_RETVAL_STRING(peer, 1);
 555   gpr_free(peer);
 556 }
 557
 558 /**
 559  * Cancel the call. This will cause the call to end with STATUS_CANCELLED
 560  * if it has not already ended with another status.
 561  * @return void
 562  */
 563 PHP_METHOD(Call, cancel) {
 564   wrapped_grpc_call *call = PHP_GRPC_GET_WRAPPED_OBJECT(wrapped_grpc_call,
 565                                                         getThis());
 566   grpc_call_cancel(call->wrapped, NULL);
 567 }
 568
 569 /**
 570  * Set the CallCredentials for this call.
 571  * @param CallCredentials $creds_obj The CallCredentials object
 572  * @return int The error code
 573  */
 574 PHP_METHOD(Call, setCredentials) {
 575   zval *creds_obj;
 576
 577   /* "O" == 1 Object */
 578   if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "O", &creds_obj,
 579                             grpc_ce_call_credentials) == FAILURE) {
 580     zend_throw_exception(spl_ce_InvalidArgumentException,
 581                          "setCredentials expects 1 CallCredentials",
 582                          1 TSRMLS_CC);
 583     return;
 584   }
 585
 586   wrapped_grpc_call_credentials *creds =
 587     PHP_GRPC_GET_WRAPPED_OBJECT(wrapped_grpc_call_credentials, creds_obj);
 588   wrapped_grpc_call *call = PHP_GRPC_GET_WRAPPED_OBJECT(wrapped_grpc_call,
 589                                                         getThis());
 590
 591   grpc_call_error error = GRPC_CALL_ERROR;
 592   error = grpc_call_set_credentials(call->wrapped, creds->wrapped);
 593   RETURN_LONG(error);
 594 }
 595
 596 ZEND_BEGIN_ARG_INFO_EX(arginfo_construct, 0, 0, 3)
 597   ZEND_ARG_INFO(0, channel)
 598   ZEND_ARG_INFO(0, method)
 599   ZEND_ARG_INFO(0, deadline)
 600   ZEND_ARG_INFO(0, host_override)
 601 ZEND_END_ARG_INFO()
 602
 603 ZEND_BEGIN_ARG_INFO_EX(arginfo_startBatch, 0, 0, 1)
 604   ZEND_ARG_INFO(0, ops)
 605 ZEND_END_ARG_INFO()
 606
 607 ZEND_BEGIN_ARG_INFO_EX(arginfo_getPeer, 0, 0, 0)
 608 ZEND_END_ARG_INFO()
 609
 610 ZEND_BEGIN_ARG_INFO_EX(arginfo_cancel, 0, 0, 0)
 611 ZEND_END_ARG_INFO()
 612
 613 ZEND_BEGIN_ARG_INFO_EX(arginfo_setCredentials, 0, 0, 1)
 614   ZEND_ARG_INFO(0, credentials)
 615 ZEND_END_ARG_INFO()
 616
 617 static zend_function_entry call_methods[] = {
 618   PHP_ME(Call, __construct, arginfo_construct, ZEND_ACC_PUBLIC | ZEND_ACC_CTOR)
 619   PHP_ME(Call, startBatch, arginfo_startBatch, ZEND_ACC_PUBLIC)
 620   PHP_ME(Call, getPeer, arginfo_getPeer, ZEND_ACC_PUBLIC)
 621   PHP_ME(Call, cancel, arginfo_cancel, ZEND_ACC_PUBLIC)
 622   PHP_ME(Call, setCredentials, arginfo_setCredentials, ZEND_ACC_PUBLIC)
 623   PHP_FE_END
 624 };
 625
 626 void grpc_init_call(TSRMLS_D) {
 627   zend_class_entry ce;
 628   INIT_CLASS_ENTRY(ce, "Grpc\\Call", call_methods);
 629   ce.create_object = create_wrapped_grpc_call;
 630   grpc_ce_call = zend_register_internal_class(&ce TSRMLS_CC);
 631   PHP_GRPC_INIT_HANDLER(wrapped_grpc_call, call_ce_handlers);
 632 }