def.c 37 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076
  1. // Protocol Buffers - Google's data interchange format
  2. // Copyright 2008 Google Inc. All rights reserved.
  3. // https://developers.google.com/protocol-buffers/
  4. //
  5. // Redistribution and use in source and binary forms, with or without
  6. // modification, are permitted provided that the following conditions are
  7. // met:
  8. //
  9. // * Redistributions of source code must retain the above copyright
  10. // notice, this list of conditions and the following disclaimer.
  11. // * Redistributions in binary form must reproduce the above
  12. // copyright notice, this list of conditions and the following disclaimer
  13. // in the documentation and/or other materials provided with the
  14. // distribution.
  15. // * Neither the name of Google Inc. nor the names of its
  16. // contributors may be used to endorse or promote products derived from
  17. // this software without specific prior written permission.
  18. //
  19. // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  20. // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  21. // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  22. // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  23. // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  24. // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  25. // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  26. // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  27. // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  28. // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  29. // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  30. #include "protobuf.h"
  31. // Forward declare.
  32. static void descriptor_init_c_instance(Descriptor* intern TSRMLS_DC);
  33. static void descriptor_free_c(Descriptor* object TSRMLS_DC);
  34. static void field_descriptor_init_c_instance(FieldDescriptor* intern TSRMLS_DC);
  35. static void field_descriptor_free_c(FieldDescriptor* object TSRMLS_DC);
  36. static void enum_descriptor_init_c_instance(EnumDescriptor* intern TSRMLS_DC);
  37. static void enum_descriptor_free_c(EnumDescriptor* object TSRMLS_DC);
  38. static void enum_value_descriptor_init_c_instance(
  39. EnumValueDescriptor *intern TSRMLS_DC);
  40. static void enum_value_descriptor_free_c(EnumValueDescriptor *object TSRMLS_DC);
  41. static void descriptor_pool_free_c(DescriptorPool* object TSRMLS_DC);
  42. static void descriptor_pool_init_c_instance(DescriptorPool* pool TSRMLS_DC);
  43. static void internal_descriptor_pool_free_c(
  44. InternalDescriptorPool *object TSRMLS_DC);
  45. static void internal_descriptor_pool_init_c_instance(
  46. InternalDescriptorPool *pool TSRMLS_DC);
  47. static void oneof_descriptor_free_c(Oneof* object TSRMLS_DC);
  48. static void oneof_descriptor_init_c_instance(Oneof* pool TSRMLS_DC);
  49. // -----------------------------------------------------------------------------
  50. // Common Utilities
  51. // -----------------------------------------------------------------------------
  52. static void check_upb_status(const upb_status* status, const char* msg) {
  53. if (!upb_ok(status)) {
  54. zend_error(E_ERROR, "%s: %s\n", msg, upb_status_errmsg(status));
  55. }
  56. }
  57. static void upb_filedef_free(void *r) {
  58. upb_filedef *f = *(upb_filedef **)r;
  59. size_t i;
  60. for (i = 0; i < upb_filedef_depcount(f); i++) {
  61. upb_filedef_unref(upb_filedef_dep(f, i), f);
  62. }
  63. upb_inttable_uninit(&f->defs);
  64. upb_inttable_uninit(&f->deps);
  65. upb_gfree((void *)f->name);
  66. upb_gfree((void *)f->package);
  67. upb_gfree(f);
  68. }
  69. // Camel-case the field name and append "Entry" for generated map entry name.
  70. // e.g. map<KeyType, ValueType> foo_map => FooMapEntry
  71. static void append_map_entry_name(char *result, const char *field_name,
  72. int pos) {
  73. bool cap_next = true;
  74. int i;
  75. for (i = 0; i < strlen(field_name); ++i) {
  76. if (field_name[i] == '_') {
  77. cap_next = true;
  78. } else if (cap_next) {
  79. // Note: Do not use ctype.h due to locales.
  80. if ('a' <= field_name[i] && field_name[i] <= 'z') {
  81. result[pos++] = field_name[i] - 'a' + 'A';
  82. } else {
  83. result[pos++] = field_name[i];
  84. }
  85. cap_next = false;
  86. } else {
  87. result[pos++] = field_name[i];
  88. }
  89. }
  90. strcat(result, "Entry");
  91. }
  92. #define CHECK_UPB(code, msg) \
  93. do { \
  94. upb_status status = UPB_STATUS_INIT; \
  95. code; \
  96. check_upb_status(&status, msg); \
  97. } while (0)
  98. // -----------------------------------------------------------------------------
  99. // GPBType
  100. // -----------------------------------------------------------------------------
  101. zend_class_entry* gpb_type_type;
  102. static zend_function_entry gpb_type_methods[] = {
  103. ZEND_FE_END
  104. };
  105. void gpb_type_init(TSRMLS_D) {
  106. zend_class_entry class_type;
  107. INIT_CLASS_ENTRY(class_type, "Google\\Protobuf\\Internal\\GPBType",
  108. gpb_type_methods);
  109. gpb_type_type = zend_register_internal_class(&class_type TSRMLS_CC);
  110. zend_declare_class_constant_long(gpb_type_type, STR("DOUBLE"), 1 TSRMLS_CC);
  111. zend_declare_class_constant_long(gpb_type_type, STR("FLOAT"), 2 TSRMLS_CC);
  112. zend_declare_class_constant_long(gpb_type_type, STR("INT64"), 3 TSRMLS_CC);
  113. zend_declare_class_constant_long(gpb_type_type, STR("UINT64"), 4 TSRMLS_CC);
  114. zend_declare_class_constant_long(gpb_type_type, STR("INT32"), 5 TSRMLS_CC);
  115. zend_declare_class_constant_long(gpb_type_type, STR("FIXED64"), 6 TSRMLS_CC);
  116. zend_declare_class_constant_long(gpb_type_type, STR("FIXED32"), 7 TSRMLS_CC);
  117. zend_declare_class_constant_long(gpb_type_type, STR("BOOL"), 8 TSRMLS_CC);
  118. zend_declare_class_constant_long(gpb_type_type, STR("STRING"), 9 TSRMLS_CC);
  119. zend_declare_class_constant_long(gpb_type_type, STR("GROUP"), 10 TSRMLS_CC);
  120. zend_declare_class_constant_long(gpb_type_type, STR("MESSAGE"), 11 TSRMLS_CC);
  121. zend_declare_class_constant_long(gpb_type_type, STR("BYTES"), 12 TSRMLS_CC);
  122. zend_declare_class_constant_long(gpb_type_type, STR("UINT32"), 13 TSRMLS_CC);
  123. zend_declare_class_constant_long(gpb_type_type, STR("ENUM"), 14 TSRMLS_CC);
  124. zend_declare_class_constant_long(gpb_type_type, STR("SFIXED32"),
  125. 15 TSRMLS_CC);
  126. zend_declare_class_constant_long(gpb_type_type, STR("SFIXED64"),
  127. 16 TSRMLS_CC);
  128. zend_declare_class_constant_long(gpb_type_type, STR("SINT32"), 17 TSRMLS_CC);
  129. zend_declare_class_constant_long(gpb_type_type, STR("SINT64"), 18 TSRMLS_CC);
  130. }
  131. // -----------------------------------------------------------------------------
  132. // Descriptor
  133. // -----------------------------------------------------------------------------
  134. static zend_function_entry descriptor_methods[] = {
  135. PHP_ME(Descriptor, getClass, NULL, ZEND_ACC_PUBLIC)
  136. PHP_ME(Descriptor, getFullName, NULL, ZEND_ACC_PUBLIC)
  137. PHP_ME(Descriptor, getField, NULL, ZEND_ACC_PUBLIC)
  138. PHP_ME(Descriptor, getFieldCount, NULL, ZEND_ACC_PUBLIC)
  139. PHP_ME(Descriptor, getOneofDecl, NULL, ZEND_ACC_PUBLIC)
  140. PHP_ME(Descriptor, getOneofDeclCount, NULL, ZEND_ACC_PUBLIC)
  141. ZEND_FE_END
  142. };
  143. DEFINE_CLASS(Descriptor, descriptor, "Google\\Protobuf\\Descriptor");
  144. static void descriptor_free_c(Descriptor *self TSRMLS_DC) {
  145. if (self->layout) {
  146. free_layout(self->layout);
  147. }
  148. if (self->fill_handlers) {
  149. upb_handlers_unref(self->fill_handlers, &self->fill_handlers);
  150. }
  151. if (self->fill_method) {
  152. upb_pbdecodermethod_unref(self->fill_method, &self->fill_method);
  153. }
  154. if (self->json_fill_method) {
  155. upb_json_parsermethod_unref(self->json_fill_method,
  156. &self->json_fill_method);
  157. }
  158. if (self->pb_serialize_handlers) {
  159. upb_handlers_unref(self->pb_serialize_handlers,
  160. &self->pb_serialize_handlers);
  161. }
  162. if (self->json_serialize_handlers) {
  163. upb_handlers_unref(self->json_serialize_handlers,
  164. &self->json_serialize_handlers);
  165. }
  166. if (self->json_serialize_handlers_preserve) {
  167. upb_handlers_unref(self->json_serialize_handlers_preserve,
  168. &self->json_serialize_handlers_preserve);
  169. }
  170. }
  171. static void descriptor_init_c_instance(Descriptor *desc TSRMLS_DC) {
  172. desc->msgdef = NULL;
  173. desc->layout = NULL;
  174. desc->klass = NULL;
  175. desc->fill_handlers = NULL;
  176. desc->fill_method = NULL;
  177. desc->json_fill_method = NULL;
  178. desc->pb_serialize_handlers = NULL;
  179. desc->json_serialize_handlers = NULL;
  180. desc->json_serialize_handlers_preserve = NULL;
  181. }
  182. PHP_METHOD(Descriptor, getClass) {
  183. Descriptor *intern = UNBOX(Descriptor, getThis());
  184. #if PHP_MAJOR_VERSION < 7
  185. const char* classname = intern->klass->name;
  186. #else
  187. const char* classname = ZSTR_VAL(intern->klass->name);
  188. #endif
  189. PHP_PROTO_RETVAL_STRINGL(classname, strlen(classname), 1);
  190. }
  191. PHP_METHOD(Descriptor, getFullName) {
  192. Descriptor *intern = UNBOX(Descriptor, getThis());
  193. const char* fullname = upb_msgdef_fullname(intern->msgdef);
  194. PHP_PROTO_RETVAL_STRINGL(fullname, strlen(fullname), 1);
  195. }
  196. PHP_METHOD(Descriptor, getField) {
  197. long index;
  198. if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "l", &index) ==
  199. FAILURE) {
  200. zend_error(E_USER_ERROR, "Expect integer for index.\n");
  201. return;
  202. }
  203. Descriptor *intern = UNBOX(Descriptor, getThis());
  204. int field_num = upb_msgdef_numfields(intern->msgdef);
  205. if (index < 0 || index >= field_num) {
  206. zend_error(E_USER_ERROR, "Cannot get element at %ld.\n", index);
  207. return;
  208. }
  209. upb_msg_field_iter iter;
  210. int i;
  211. for(upb_msg_field_begin(&iter, intern->msgdef), i = 0;
  212. !upb_msg_field_done(&iter) && i < index;
  213. upb_msg_field_next(&iter), i++);
  214. const upb_fielddef *field = upb_msg_iter_field(&iter);
  215. PHP_PROTO_HASHTABLE_VALUE field_hashtable_value = get_def_obj(field);
  216. if (field_hashtable_value == NULL) {
  217. #if PHP_MAJOR_VERSION < 7
  218. MAKE_STD_ZVAL(field_hashtable_value);
  219. ZVAL_OBJ(field_hashtable_value, field_descriptor_type->create_object(
  220. field_descriptor_type TSRMLS_CC));
  221. Z_DELREF_P(field_hashtable_value);
  222. #else
  223. field_hashtable_value =
  224. field_descriptor_type->create_object(field_descriptor_type TSRMLS_CC);
  225. GC_DELREF(field_hashtable_value);
  226. #endif
  227. FieldDescriptor *field_php =
  228. UNBOX_HASHTABLE_VALUE(FieldDescriptor, field_hashtable_value);
  229. field_php->fielddef = field;
  230. add_def_obj(field, field_hashtable_value);
  231. }
  232. #if PHP_MAJOR_VERSION < 7
  233. RETURN_ZVAL(field_hashtable_value, 1, 0);
  234. #else
  235. GC_ADDREF(field_hashtable_value);
  236. RETURN_OBJ(field_hashtable_value);
  237. #endif
  238. }
  239. PHP_METHOD(Descriptor, getFieldCount) {
  240. Descriptor *intern = UNBOX(Descriptor, getThis());
  241. RETURN_LONG(upb_msgdef_numfields(intern->msgdef));
  242. }
  243. PHP_METHOD(Descriptor, getOneofDecl) {
  244. long index;
  245. if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "l", &index) ==
  246. FAILURE) {
  247. zend_error(E_USER_ERROR, "Expect integer for index.\n");
  248. return;
  249. }
  250. Descriptor *intern = UNBOX(Descriptor, getThis());
  251. int field_num = upb_msgdef_numoneofs(intern->msgdef);
  252. if (index < 0 || index >= field_num) {
  253. zend_error(E_USER_ERROR, "Cannot get element at %ld.\n", index);
  254. return;
  255. }
  256. upb_msg_oneof_iter iter;
  257. int i;
  258. for(upb_msg_oneof_begin(&iter, intern->msgdef), i = 0;
  259. !upb_msg_oneof_done(&iter) && i < index;
  260. upb_msg_oneof_next(&iter), i++);
  261. upb_oneofdef *oneof = upb_msg_iter_oneof(&iter);
  262. ZVAL_OBJ(return_value, oneof_descriptor_type->create_object(
  263. oneof_descriptor_type TSRMLS_CC));
  264. Oneof *oneof_php = UNBOX(Oneof, return_value);
  265. oneof_php->oneofdef = oneof;
  266. }
  267. PHP_METHOD(Descriptor, getOneofDeclCount) {
  268. Descriptor *intern = UNBOX(Descriptor, getThis());
  269. RETURN_LONG(upb_msgdef_numoneofs(intern->msgdef));
  270. }
  271. // -----------------------------------------------------------------------------
  272. // EnumDescriptor
  273. // -----------------------------------------------------------------------------
  274. static zend_function_entry enum_descriptor_methods[] = {
  275. PHP_ME(EnumDescriptor, getValue, NULL, ZEND_ACC_PUBLIC)
  276. PHP_ME(EnumDescriptor, getValueCount, NULL, ZEND_ACC_PUBLIC)
  277. ZEND_FE_END
  278. };
  279. DEFINE_CLASS(EnumDescriptor, enum_descriptor,
  280. "Google\\Protobuf\\EnumDescriptor");
  281. static void enum_descriptor_free_c(EnumDescriptor *self TSRMLS_DC) {
  282. }
  283. static void enum_descriptor_init_c_instance(EnumDescriptor *self TSRMLS_DC) {
  284. self->enumdef = NULL;
  285. self->klass = NULL;
  286. }
  287. PHP_METHOD(EnumDescriptor, getValue) {
  288. long index;
  289. if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "l", &index) ==
  290. FAILURE) {
  291. zend_error(E_USER_ERROR, "Expect integer for index.\n");
  292. return;
  293. }
  294. EnumDescriptor *intern = UNBOX(EnumDescriptor, getThis());
  295. int field_num = upb_enumdef_numvals(intern->enumdef);
  296. if (index < 0 || index >= field_num) {
  297. zend_error(E_USER_ERROR, "Cannot get element at %ld.\n", index);
  298. return;
  299. }
  300. upb_enum_iter iter;
  301. int i;
  302. for(upb_enum_begin(&iter, intern->enumdef), i = 0;
  303. !upb_enum_done(&iter) && i < index;
  304. upb_enum_next(&iter), i++);
  305. ZVAL_OBJ(return_value, enum_value_descriptor_type->create_object(
  306. enum_value_descriptor_type TSRMLS_CC));
  307. EnumValueDescriptor *enum_value_php =
  308. UNBOX(EnumValueDescriptor, return_value);
  309. enum_value_php->name = upb_enum_iter_name(&iter);
  310. enum_value_php->number = upb_enum_iter_number(&iter);
  311. }
  312. PHP_METHOD(EnumDescriptor, getValueCount) {
  313. EnumDescriptor *intern = UNBOX(EnumDescriptor, getThis());
  314. RETURN_LONG(upb_enumdef_numvals(intern->enumdef));
  315. }
  316. // -----------------------------------------------------------------------------
  317. // EnumValueDescriptor
  318. // -----------------------------------------------------------------------------
  319. static zend_function_entry enum_value_descriptor_methods[] = {
  320. PHP_ME(EnumValueDescriptor, getName, NULL, ZEND_ACC_PUBLIC)
  321. PHP_ME(EnumValueDescriptor, getNumber, NULL, ZEND_ACC_PUBLIC)
  322. ZEND_FE_END
  323. };
  324. DEFINE_CLASS(EnumValueDescriptor, enum_value_descriptor,
  325. "Google\\Protobuf\\EnumValueDescriptor");
  326. static void enum_value_descriptor_free_c(EnumValueDescriptor *self TSRMLS_DC) {
  327. }
  328. static void enum_value_descriptor_init_c_instance(EnumValueDescriptor *self TSRMLS_DC) {
  329. self->name = NULL;
  330. self->number = 0;
  331. }
  332. PHP_METHOD(EnumValueDescriptor, getName) {
  333. EnumValueDescriptor *intern = UNBOX(EnumValueDescriptor, getThis());
  334. PHP_PROTO_RETVAL_STRINGL(intern->name, strlen(intern->name), 1);
  335. }
  336. PHP_METHOD(EnumValueDescriptor, getNumber) {
  337. EnumValueDescriptor *intern = UNBOX(EnumValueDescriptor, getThis());
  338. RETURN_LONG(intern->number);
  339. }
  340. // -----------------------------------------------------------------------------
  341. // FieldDescriptor
  342. // -----------------------------------------------------------------------------
  343. static zend_function_entry field_descriptor_methods[] = {
  344. PHP_ME(FieldDescriptor, getName, NULL, ZEND_ACC_PUBLIC)
  345. PHP_ME(FieldDescriptor, getNumber, NULL, ZEND_ACC_PUBLIC)
  346. PHP_ME(FieldDescriptor, getLabel, NULL, ZEND_ACC_PUBLIC)
  347. PHP_ME(FieldDescriptor, getType, NULL, ZEND_ACC_PUBLIC)
  348. PHP_ME(FieldDescriptor, isMap, NULL, ZEND_ACC_PUBLIC)
  349. PHP_ME(FieldDescriptor, getEnumType, NULL, ZEND_ACC_PUBLIC)
  350. PHP_ME(FieldDescriptor, getMessageType, NULL, ZEND_ACC_PUBLIC)
  351. ZEND_FE_END
  352. };
  353. DEFINE_CLASS(FieldDescriptor, field_descriptor,
  354. "Google\\Protobuf\\FieldDescriptor");
  355. static void field_descriptor_free_c(FieldDescriptor *self TSRMLS_DC) {
  356. }
  357. static void field_descriptor_init_c_instance(FieldDescriptor *self TSRMLS_DC) {
  358. self->fielddef = NULL;
  359. }
  360. upb_fieldtype_t to_fieldtype(upb_descriptortype_t type) {
  361. switch (type) {
  362. #define CASE(descriptor_type, type) \
  363. case UPB_DESCRIPTOR_TYPE_##descriptor_type: \
  364. return UPB_TYPE_##type;
  365. CASE(FLOAT, FLOAT);
  366. CASE(DOUBLE, DOUBLE);
  367. CASE(BOOL, BOOL);
  368. CASE(STRING, STRING);
  369. CASE(BYTES, BYTES);
  370. CASE(MESSAGE, MESSAGE);
  371. CASE(GROUP, MESSAGE);
  372. CASE(ENUM, ENUM);
  373. CASE(INT32, INT32);
  374. CASE(INT64, INT64);
  375. CASE(UINT32, UINT32);
  376. CASE(UINT64, UINT64);
  377. CASE(SINT32, INT32);
  378. CASE(SINT64, INT64);
  379. CASE(FIXED32, UINT32);
  380. CASE(FIXED64, UINT64);
  381. CASE(SFIXED32, INT32);
  382. CASE(SFIXED64, INT64);
  383. #undef CONVERT
  384. }
  385. zend_error(E_ERROR, "Unknown field type.");
  386. return 0;
  387. }
  388. PHP_METHOD(FieldDescriptor, getName) {
  389. FieldDescriptor *intern = UNBOX(FieldDescriptor, getThis());
  390. const char* name = upb_fielddef_name(intern->fielddef);
  391. PHP_PROTO_RETVAL_STRINGL(name, strlen(name), 1);
  392. }
  393. PHP_METHOD(FieldDescriptor, getNumber) {
  394. FieldDescriptor *intern = UNBOX(FieldDescriptor, getThis());
  395. RETURN_LONG(upb_fielddef_number(intern->fielddef));
  396. }
  397. PHP_METHOD(FieldDescriptor, getLabel) {
  398. FieldDescriptor *intern = UNBOX(FieldDescriptor, getThis());
  399. RETURN_LONG(upb_fielddef_label(intern->fielddef));
  400. }
  401. PHP_METHOD(FieldDescriptor, getType) {
  402. FieldDescriptor *intern = UNBOX(FieldDescriptor, getThis());
  403. RETURN_LONG(upb_fielddef_descriptortype(intern->fielddef));
  404. }
  405. PHP_METHOD(FieldDescriptor, isMap) {
  406. FieldDescriptor *intern = UNBOX(FieldDescriptor, getThis());
  407. RETURN_BOOL(upb_fielddef_ismap(intern->fielddef));
  408. }
  409. PHP_METHOD(FieldDescriptor, getEnumType) {
  410. FieldDescriptor *intern = UNBOX(FieldDescriptor, getThis());
  411. const upb_enumdef *enumdef = upb_fielddef_enumsubdef(intern->fielddef);
  412. if (enumdef == NULL) {
  413. char error_msg[100];
  414. sprintf(error_msg, "Cannot get enum type for non-enum field '%s'",
  415. upb_fielddef_name(intern->fielddef));
  416. zend_throw_exception(NULL, error_msg, 0 TSRMLS_CC);
  417. return;
  418. }
  419. PHP_PROTO_HASHTABLE_VALUE desc = get_def_obj(enumdef);
  420. #if PHP_MAJOR_VERSION < 7
  421. RETURN_ZVAL(desc, 1, 0);
  422. #else
  423. GC_ADDREF(desc);
  424. RETURN_OBJ(desc);
  425. #endif
  426. }
  427. PHP_METHOD(FieldDescriptor, getMessageType) {
  428. FieldDescriptor *intern = UNBOX(FieldDescriptor, getThis());
  429. const upb_msgdef *msgdef = upb_fielddef_msgsubdef(intern->fielddef);
  430. if (msgdef == NULL) {
  431. char error_msg[100];
  432. sprintf(error_msg, "Cannot get message type for non-message field '%s'",
  433. upb_fielddef_name(intern->fielddef));
  434. zend_throw_exception(NULL, error_msg, 0 TSRMLS_CC);
  435. return;
  436. }
  437. PHP_PROTO_HASHTABLE_VALUE desc = get_def_obj(msgdef);
  438. #if PHP_MAJOR_VERSION < 7
  439. RETURN_ZVAL(desc, 1, 0);
  440. #else
  441. GC_ADDREF(desc);
  442. RETURN_OBJ(desc);
  443. #endif
  444. }
  445. // -----------------------------------------------------------------------------
  446. // Oneof
  447. // -----------------------------------------------------------------------------
  448. static zend_function_entry oneof_descriptor_methods[] = {
  449. PHP_ME(Oneof, getName, NULL, ZEND_ACC_PUBLIC)
  450. PHP_ME(Oneof, getField, NULL, ZEND_ACC_PUBLIC)
  451. PHP_ME(Oneof, getFieldCount, NULL, ZEND_ACC_PUBLIC)
  452. ZEND_FE_END
  453. };
  454. DEFINE_CLASS(Oneof, oneof_descriptor,
  455. "Google\\Protobuf\\OneofDescriptor");
  456. static void oneof_descriptor_free_c(Oneof *self TSRMLS_DC) {
  457. }
  458. static void oneof_descriptor_init_c_instance(Oneof *self TSRMLS_DC) {
  459. self->oneofdef = NULL;
  460. }
  461. PHP_METHOD(Oneof, getName) {
  462. Oneof *intern = UNBOX(Oneof, getThis());
  463. const char *name = upb_oneofdef_name(intern->oneofdef);
  464. PHP_PROTO_RETVAL_STRINGL(name, strlen(name), 1);
  465. }
  466. PHP_METHOD(Oneof, getField) {
  467. long index;
  468. if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "l", &index) ==
  469. FAILURE) {
  470. zend_error(E_USER_ERROR, "Expect integer for index.\n");
  471. return;
  472. }
  473. Oneof *intern = UNBOX(Oneof, getThis());
  474. int field_num = upb_oneofdef_numfields(intern->oneofdef);
  475. if (index < 0 || index >= field_num) {
  476. zend_error(E_USER_ERROR, "Cannot get element at %ld.\n", index);
  477. return;
  478. }
  479. upb_oneof_iter iter;
  480. int i;
  481. for(upb_oneof_begin(&iter, intern->oneofdef), i = 0;
  482. !upb_oneof_done(&iter) && i < index;
  483. upb_oneof_next(&iter), i++);
  484. const upb_fielddef *field = upb_oneof_iter_field(&iter);
  485. PHP_PROTO_HASHTABLE_VALUE field_hashtable_value = get_def_obj(field);
  486. if (field_hashtable_value == NULL) {
  487. #if PHP_MAJOR_VERSION < 7
  488. MAKE_STD_ZVAL(field_hashtable_value);
  489. ZVAL_OBJ(field_hashtable_value, field_descriptor_type->create_object(
  490. field_descriptor_type TSRMLS_CC));
  491. #else
  492. field_hashtable_value =
  493. field_descriptor_type->create_object(field_descriptor_type TSRMLS_CC);
  494. #endif
  495. FieldDescriptor *field_php =
  496. UNBOX_HASHTABLE_VALUE(FieldDescriptor, field_hashtable_value);
  497. field_php->fielddef = field;
  498. add_def_obj(field, field_hashtable_value);
  499. }
  500. #if PHP_MAJOR_VERSION < 7
  501. RETURN_ZVAL(field_hashtable_value, 1, 0);
  502. #else
  503. GC_ADDREF(field_hashtable_value);
  504. RETURN_OBJ(field_hashtable_value);
  505. #endif
  506. }
  507. PHP_METHOD(Oneof, getFieldCount) {
  508. Oneof *intern = UNBOX(Oneof, getThis());
  509. RETURN_LONG(upb_oneofdef_numfields(intern->oneofdef));
  510. }
  511. // -----------------------------------------------------------------------------
  512. // DescriptorPool
  513. // -----------------------------------------------------------------------------
  514. static zend_function_entry descriptor_pool_methods[] = {
  515. PHP_ME(DescriptorPool, getGeneratedPool, NULL,
  516. ZEND_ACC_PUBLIC|ZEND_ACC_STATIC)
  517. PHP_ME(DescriptorPool, getDescriptorByClassName, NULL, ZEND_ACC_PUBLIC)
  518. PHP_ME(DescriptorPool, getEnumDescriptorByClassName, NULL, ZEND_ACC_PUBLIC)
  519. ZEND_FE_END
  520. };
  521. static zend_function_entry internal_descriptor_pool_methods[] = {
  522. PHP_ME(InternalDescriptorPool, getGeneratedPool, NULL,
  523. ZEND_ACC_PUBLIC|ZEND_ACC_STATIC)
  524. PHP_ME(InternalDescriptorPool, internalAddGeneratedFile, NULL, ZEND_ACC_PUBLIC)
  525. ZEND_FE_END
  526. };
  527. DEFINE_CLASS(DescriptorPool, descriptor_pool,
  528. "Google\\Protobuf\\DescriptorPool");
  529. DEFINE_CLASS(InternalDescriptorPool, internal_descriptor_pool,
  530. "Google\\Protobuf\\Internal\\DescriptorPool");
  531. // wrapper of generated pool
  532. #if PHP_MAJOR_VERSION < 7
  533. zval* generated_pool_php;
  534. zval* internal_generated_pool_php;
  535. #else
  536. zend_object *generated_pool_php;
  537. zend_object *internal_generated_pool_php;
  538. #endif
  539. InternalDescriptorPool *generated_pool; // The actual generated pool
  540. void init_generated_pool_once(TSRMLS_D) {
  541. if (generated_pool == NULL) {
  542. #if PHP_MAJOR_VERSION < 7
  543. MAKE_STD_ZVAL(generated_pool_php);
  544. MAKE_STD_ZVAL(internal_generated_pool_php);
  545. ZVAL_OBJ(internal_generated_pool_php,
  546. internal_descriptor_pool_type->create_object(
  547. internal_descriptor_pool_type TSRMLS_CC));
  548. generated_pool = UNBOX(InternalDescriptorPool, internal_generated_pool_php);
  549. ZVAL_OBJ(generated_pool_php, descriptor_pool_type->create_object(
  550. descriptor_pool_type TSRMLS_CC));
  551. #else
  552. internal_generated_pool_php = internal_descriptor_pool_type->create_object(
  553. internal_descriptor_pool_type TSRMLS_CC);
  554. generated_pool = (InternalDescriptorPool *)((char *)internal_generated_pool_php -
  555. XtOffsetOf(InternalDescriptorPool, std));
  556. generated_pool_php =
  557. descriptor_pool_type->create_object(descriptor_pool_type TSRMLS_CC);
  558. #endif
  559. }
  560. }
  561. static void internal_descriptor_pool_init_c_instance(
  562. InternalDescriptorPool *pool TSRMLS_DC) {
  563. pool->symtab = upb_symtab_new();
  564. ALLOC_HASHTABLE(pool->pending_list);
  565. zend_hash_init(pool->pending_list, 1, NULL, ZVAL_PTR_DTOR, 0);
  566. }
  567. static void internal_descriptor_pool_free_c(
  568. InternalDescriptorPool *pool TSRMLS_DC) {
  569. upb_symtab_free(pool->symtab);
  570. zend_hash_destroy(pool->pending_list);
  571. FREE_HASHTABLE(pool->pending_list);
  572. }
  573. static void descriptor_pool_init_c_instance(DescriptorPool *pool TSRMLS_DC) {
  574. assert(generated_pool != NULL);
  575. pool->intern = generated_pool;
  576. }
  577. static void descriptor_pool_free_c(DescriptorPool *pool TSRMLS_DC) {
  578. }
  579. static void validate_enumdef(const upb_enumdef *enumdef) {
  580. // Verify that an entry exists with integer value 0. (This is the default
  581. // value.)
  582. const char *lookup = upb_enumdef_iton(enumdef, 0);
  583. if (lookup == NULL) {
  584. zend_error(E_USER_ERROR,
  585. "Enum definition does not contain a value for '0'.");
  586. }
  587. }
  588. static void validate_msgdef(const upb_msgdef* msgdef) {
  589. // Verify that no required fields exist. proto3 does not support these.
  590. upb_msg_field_iter it;
  591. for (upb_msg_field_begin(&it, msgdef);
  592. !upb_msg_field_done(&it);
  593. upb_msg_field_next(&it)) {
  594. const upb_fielddef* field = upb_msg_iter_field(&it);
  595. if (upb_fielddef_label(field) == UPB_LABEL_REQUIRED) {
  596. zend_error(E_ERROR, "Required fields are unsupported in proto3.");
  597. }
  598. }
  599. }
  600. PHP_METHOD(DescriptorPool, getGeneratedPool) {
  601. init_generated_pool_once(TSRMLS_C);
  602. #if PHP_MAJOR_VERSION < 7
  603. RETURN_ZVAL(generated_pool_php, 1, 0);
  604. #else
  605. GC_ADDREF(generated_pool_php);
  606. RETURN_OBJ(generated_pool_php);
  607. #endif
  608. }
  609. PHP_METHOD(InternalDescriptorPool, getGeneratedPool) {
  610. init_generated_pool_once(TSRMLS_C);
  611. #if PHP_MAJOR_VERSION < 7
  612. RETURN_ZVAL(internal_generated_pool_php, 1, 0);
  613. #else
  614. GC_ADDREF(internal_generated_pool_php);
  615. RETURN_OBJ(internal_generated_pool_php);
  616. #endif
  617. }
  618. static size_t classname_len_max(const char *fullname,
  619. const char *package,
  620. const char *php_namespace,
  621. const char *prefix) {
  622. size_t fullname_len = strlen(fullname);
  623. size_t package_len = 0;
  624. size_t prefix_len = 0;
  625. size_t namespace_len = 0;
  626. size_t length = fullname_len;
  627. int i, segment, classname_start = 0;
  628. if (package != NULL) {
  629. package_len = strlen(package);
  630. }
  631. if (prefix != NULL) {
  632. prefix_len = strlen(prefix);
  633. }
  634. if (php_namespace != NULL) {
  635. namespace_len = strlen(php_namespace);
  636. }
  637. // Process package
  638. if (package_len > 0) {
  639. segment = 1;
  640. for (i = 0; i < package_len; i++) {
  641. if (package[i] == '.') {
  642. segment++;
  643. }
  644. }
  645. // In case of reserved name in package.
  646. length += 3 * segment;
  647. classname_start = package_len + 1;
  648. }
  649. // Process class name
  650. segment = 1;
  651. for (i = classname_start; i < fullname_len; i++) {
  652. if (fullname[i] == '.') {
  653. segment++;
  654. }
  655. }
  656. if (prefix_len == 0) {
  657. length += 3 * segment;
  658. } else {
  659. length += prefix_len * segment;
  660. }
  661. // The additional 2, one is for preceding '.' and the other is for trailing 0.
  662. return length + namespace_len + 2;
  663. }
  664. static bool is_reserved(const char *segment, int length) {
  665. bool result;
  666. char* lower = ALLOC_N(char, length + 1);
  667. memset(lower, 0, length + 1);
  668. memcpy(lower, segment, length);
  669. int i = 0;
  670. while(lower[i]) {
  671. lower[i] = (char)tolower(lower[i]);
  672. i++;
  673. }
  674. lower[length] = 0;
  675. result = is_reserved_name(lower);
  676. FREE(lower);
  677. return result;
  678. }
  679. static char* fill_prefix(const char *segment, int length,
  680. const char *prefix_given,
  681. const char *package_name, char *classname) {
  682. size_t i;
  683. if (prefix_given != NULL && strcmp(prefix_given, "") != 0) {
  684. size_t prefix_len = strlen(prefix_given);
  685. memcpy(classname, prefix_given, strlen(prefix_given));
  686. classname += prefix_len;
  687. } else {
  688. if (is_reserved(segment, length)) {
  689. if (package_name != NULL &&
  690. strcmp("google.protobuf", package_name) == 0) {
  691. memcpy(classname, "GPB", 3);
  692. classname += 3;
  693. } else {
  694. memcpy(classname, "PB", 2);
  695. classname += 2;
  696. }
  697. }
  698. }
  699. return classname;
  700. }
  701. static char* fill_segment(const char *segment, int length,
  702. char *classname, bool use_camel) {
  703. memcpy(classname, segment, length);
  704. if (use_camel && (segment[0] < 'A' || segment[0] > 'Z')) {
  705. classname[0] += 'A' - 'a';
  706. }
  707. return classname + length;
  708. }
  709. static char* fill_namespace(const char *package, const char *namespace_given,
  710. char *classname) {
  711. if (namespace_given != NULL) {
  712. size_t namespace_len = strlen(namespace_given);
  713. memcpy(classname, namespace_given, namespace_len);
  714. classname += namespace_len;
  715. *classname = '\\';
  716. classname++;
  717. } else if (package != NULL) {
  718. int i = 0, j, offset = 0;
  719. size_t package_len = strlen(package);
  720. while (i < package_len) {
  721. j = i;
  722. while (j < package_len && package[j] != '.') {
  723. j++;
  724. }
  725. classname = fill_prefix(package + i, j - i, "", package, classname);
  726. classname = fill_segment(package + i, j - i, classname, true);
  727. classname[0] = '\\';
  728. classname++;
  729. i = j + 1;
  730. }
  731. }
  732. return classname;
  733. }
  734. static char* fill_classname(const char *fullname,
  735. const char *package,
  736. const char *namespace_given,
  737. const char *prefix, char *classname) {
  738. int classname_start = 0;
  739. if (package != NULL) {
  740. size_t package_len = strlen(package);
  741. classname_start = package_len == 0 ? 0 : package_len + 1;
  742. }
  743. size_t fullname_len = strlen(fullname);
  744. classname = fill_prefix(fullname + classname_start,
  745. fullname_len - classname_start,
  746. prefix, package, classname);
  747. int i = classname_start, j;
  748. while (i < fullname_len) {
  749. j = i;
  750. while (j < fullname_len && fullname[j] != '.') {
  751. j++;
  752. }
  753. classname = fill_segment(fullname + i, j - i, classname, false);
  754. if (j != fullname_len) {
  755. *classname = '_';
  756. classname++;
  757. }
  758. i = j + 1;
  759. }
  760. return classname;
  761. }
  762. static char* fill_qualified_classname(const char *fullname,
  763. const char *package,
  764. const char *namespace_given,
  765. const char *prefix, char *classname) {
  766. classname = fill_namespace(package, namespace_given, classname);
  767. return fill_classname(fullname, package, namespace_given, prefix, classname);
  768. }
  769. static void classname_no_prefix(const char *fullname, const char *package_name,
  770. char *class_name) {
  771. size_t i = 0, j;
  772. bool first_char = true, is_reserved = false;
  773. size_t pkg_name_len = package_name == NULL ? 0 : strlen(package_name);
  774. size_t message_name_start = package_name == NULL ? 0 : pkg_name_len + 1;
  775. size_t message_len = (strlen(fullname) - message_name_start);
  776. // Submessage is concatenated with its containing messages by '_'.
  777. for (j = message_name_start; j < message_name_start + message_len; j++) {
  778. if (fullname[j] == '.') {
  779. class_name[i++] = '_';
  780. } else {
  781. class_name[i++] = fullname[j];
  782. }
  783. }
  784. }
  785. void internal_add_generated_file(const char *data, PHP_PROTO_SIZE data_len,
  786. InternalDescriptorPool *pool TSRMLS_DC) {
  787. upb_filedef **files;
  788. size_t i;
  789. CHECK_UPB(files = upb_loaddescriptor(data, data_len, &pool, &status),
  790. "Parse binary descriptors to internal descriptors failed");
  791. // This method is called only once in each file.
  792. assert(files[0] != NULL);
  793. assert(files[1] == NULL);
  794. CHECK_UPB(upb_symtab_addfile(pool->symtab, files[0], &status),
  795. "Unable to add file to DescriptorPool");
  796. // For each enum/message, we need its PHP class, upb descriptor and its PHP
  797. // wrapper. These information are needed later for encoding, decoding and type
  798. // checking. However, sometimes we just have one of them. In order to find
  799. // them quickly, here, we store the mapping for them.
  800. for (i = 0; i < upb_filedef_defcount(files[0]); i++) {
  801. const upb_def *def = upb_filedef_def(files[0], i);
  802. switch (upb_def_type(def)) {
  803. #define CASE_TYPE(def_type, def_type_lower, desc_type, desc_type_lower) \
  804. case UPB_DEF_##def_type: { \
  805. CREATE_HASHTABLE_VALUE(desc, desc_php, desc_type, desc_type_lower##_type); \
  806. const upb_##def_type_lower *def_type_lower = \
  807. upb_downcast_##def_type_lower(def); \
  808. desc->def_type_lower = def_type_lower; \
  809. add_def_obj(desc->def_type_lower, desc_php); \
  810. /* Unlike other messages, MapEntry is shared by all map fields and doesn't \
  811. * have generated PHP class.*/ \
  812. if (upb_def_type(def) == UPB_DEF_MSG && \
  813. upb_msgdef_mapentry(upb_downcast_msgdef(def))) { \
  814. break; \
  815. } \
  816. /* Prepend '.' to package name to make it absolute. In the 5 additional \
  817. * bytes allocated, one for '.', one for trailing 0, and 3 for 'GPB' if \
  818. * given message is google.protobuf.Empty.*/ \
  819. const char *fullname = upb_##def_type_lower##_fullname(def_type_lower); \
  820. const char *package = upb_filedef_package(files[0]); \
  821. const char *php_namespace = upb_filedef_phpnamespace(files[0]); \
  822. const char *prefix_given = upb_filedef_phpprefix(files[0]); \
  823. size_t classname_len = classname_len_max(fullname, package, \
  824. php_namespace, prefix_given); \
  825. char *classname = ecalloc(sizeof(char), classname_len); \
  826. fill_qualified_classname(fullname, package, php_namespace, \
  827. prefix_given, classname); \
  828. PHP_PROTO_CE_DECLARE pce; \
  829. if (php_proto_zend_lookup_class(classname, strlen(classname), &pce) == \
  830. FAILURE) { \
  831. zend_error(E_ERROR, "Generated message class %s hasn't been defined", \
  832. classname); \
  833. return; \
  834. } else { \
  835. desc->klass = PHP_PROTO_CE_UNREF(pce); \
  836. } \
  837. add_ce_obj(desc->klass, desc_php); \
  838. add_proto_obj(upb_##def_type_lower##_fullname(desc->def_type_lower), \
  839. desc_php); \
  840. efree(classname); \
  841. break; \
  842. }
  843. CASE_TYPE(MSG, msgdef, Descriptor, descriptor)
  844. CASE_TYPE(ENUM, enumdef, EnumDescriptor, enum_descriptor)
  845. #undef CASE_TYPE
  846. default:
  847. break;
  848. }
  849. }
  850. for (i = 0; i < upb_filedef_defcount(files[0]); i++) {
  851. const upb_def *def = upb_filedef_def(files[0], i);
  852. if (upb_def_type(def) == UPB_DEF_MSG) {
  853. const upb_msgdef *msgdef = upb_downcast_msgdef(def);
  854. PHP_PROTO_HASHTABLE_VALUE desc_php = get_def_obj(msgdef);
  855. build_class_from_descriptor(desc_php TSRMLS_CC);
  856. }
  857. }
  858. upb_filedef_unref(files[0], &pool);
  859. upb_gfree(files);
  860. }
  861. PHP_METHOD(InternalDescriptorPool, internalAddGeneratedFile) {
  862. char *data = NULL;
  863. PHP_PROTO_SIZE data_len;
  864. upb_filedef **files;
  865. size_t i;
  866. if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &data, &data_len) ==
  867. FAILURE) {
  868. return;
  869. }
  870. InternalDescriptorPool *pool = UNBOX(InternalDescriptorPool, getThis());
  871. internal_add_generated_file(data, data_len, pool TSRMLS_CC);
  872. }
  873. PHP_METHOD(DescriptorPool, getDescriptorByClassName) {
  874. DescriptorPool *public_pool = UNBOX(DescriptorPool, getThis());
  875. InternalDescriptorPool *pool = public_pool->intern;
  876. char *classname = NULL;
  877. PHP_PROTO_SIZE classname_len;
  878. if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &classname,
  879. &classname_len) == FAILURE) {
  880. return;
  881. }
  882. PHP_PROTO_CE_DECLARE pce;
  883. if (php_proto_zend_lookup_class(classname, classname_len, &pce) ==
  884. FAILURE) {
  885. RETURN_NULL();
  886. }
  887. PHP_PROTO_HASHTABLE_VALUE desc = get_ce_obj(PHP_PROTO_CE_UNREF(pce));
  888. if (desc == NULL) {
  889. RETURN_NULL();
  890. }
  891. zend_class_entry* instance_ce = HASHTABLE_VALUE_CE(desc);
  892. if (!instanceof_function(instance_ce, descriptor_type TSRMLS_CC)) {
  893. RETURN_NULL();
  894. }
  895. #if PHP_MAJOR_VERSION < 7
  896. RETURN_ZVAL(desc, 1, 0);
  897. #else
  898. GC_ADDREF(desc);
  899. RETURN_OBJ(desc);
  900. #endif
  901. }
  902. PHP_METHOD(DescriptorPool, getEnumDescriptorByClassName) {
  903. DescriptorPool *public_pool = UNBOX(DescriptorPool, getThis());
  904. InternalDescriptorPool *pool = public_pool->intern;
  905. char *classname = NULL;
  906. PHP_PROTO_SIZE classname_len;
  907. if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &classname,
  908. &classname_len) == FAILURE) {
  909. return;
  910. }
  911. PHP_PROTO_CE_DECLARE pce;
  912. if (php_proto_zend_lookup_class(classname, classname_len, &pce) ==
  913. FAILURE) {
  914. RETURN_NULL();
  915. }
  916. PHP_PROTO_HASHTABLE_VALUE desc = get_ce_obj(PHP_PROTO_CE_UNREF(pce));
  917. if (desc == NULL) {
  918. RETURN_NULL();
  919. }
  920. zend_class_entry* instance_ce = HASHTABLE_VALUE_CE(desc);
  921. if (!instanceof_function(instance_ce, enum_descriptor_type TSRMLS_CC)) {
  922. RETURN_NULL();
  923. }
  924. #if PHP_MAJOR_VERSION < 7
  925. RETURN_ZVAL(desc, 1, 0);
  926. #else
  927. GC_ADDREF(desc);
  928. RETURN_OBJ(desc);
  929. #endif
  930. }