v8js_class.cc 32 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089
  1. /*
  2. +----------------------------------------------------------------------+
  3. | PHP Version 5 |
  4. +----------------------------------------------------------------------+
  5. | Copyright (c) 1997-2013 The PHP Group |
  6. +----------------------------------------------------------------------+
  7. | http://www.opensource.org/licenses/mit-license.php MIT License |
  8. +----------------------------------------------------------------------+
  9. | Author: Jani Taskinen <[email protected]> |
  10. | Author: Patrick Reilly <[email protected]> |
  11. +----------------------------------------------------------------------+
  12. */
  13. #ifdef HAVE_CONFIG_H
  14. #include "config.h"
  15. #endif
  16. extern "C" {
  17. #include "php.h"
  18. #include "ext/date/php_date.h"
  19. #include "ext/standard/php_string.h"
  20. #include "zend_interfaces.h"
  21. #include "zend_closures.h"
  22. #include "ext/spl/spl_exceptions.h"
  23. #include "zend_exceptions.h"
  24. }
  25. #include "php_v8js_macros.h"
  26. #include "v8js_v8.h"
  27. #include "v8js_debug.h"
  28. #include "v8js_exceptions.h"
  29. #include "v8js_v8object_class.h"
  30. #include "v8js_timer.h"
  31. #include <functional>
  32. #define PHP_V8JS_SCRIPT_RES_NAME "V8Js script"
  33. /* {{{ Class Entries */
  34. static zend_class_entry *php_ce_v8js;
  35. /* }}} */
  36. /* {{{ Object Handlers */
  37. static zend_object_handlers v8js_object_handlers;
  38. /* }}} */
  39. typedef struct _v8js_script {
  40. char *name;
  41. v8::Isolate *isolate;
  42. v8::Persistent<v8::Script, v8::CopyablePersistentTraits<v8::Script>> *script;
  43. } v8js_script;
  44. static void v8js_script_free(v8js_script *res, bool dispose_persistent);
  45. int le_v8js_script;
  46. /* {{{ Extension container */
  47. struct v8js_jsext {
  48. zend_bool auto_enable;
  49. HashTable *deps_ht;
  50. const char **deps;
  51. int deps_count;
  52. char *name;
  53. char *source;
  54. };
  55. /* }}} */
  56. #if PHP_V8_API_VERSION >= 4004010
  57. class ArrayBufferAllocator : public v8::ArrayBuffer::Allocator {
  58. public:
  59. virtual void* Allocate(size_t length) {
  60. void* data = AllocateUninitialized(length);
  61. return data == NULL ? data : memset(data, 0, length);
  62. }
  63. virtual void* AllocateUninitialized(size_t length) { return malloc(length); }
  64. virtual void Free(void* data, size_t) { free(data); }
  65. };
  66. #endif
  67. static void v8js_free_storage(void *object TSRMLS_DC) /* {{{ */
  68. {
  69. v8js_ctx *c = (v8js_ctx *) object;
  70. zend_object_std_dtor(&c->std TSRMLS_CC);
  71. if (c->pending_exception) {
  72. zval_ptr_dtor(&c->pending_exception);
  73. }
  74. if (c->module_loader) {
  75. zval_ptr_dtor(&c->module_loader);
  76. }
  77. /* Delete PHP global object from JavaScript */
  78. if (!c->context.IsEmpty()) {
  79. v8::Locker locker(c->isolate);
  80. v8::Isolate::Scope isolate_scope(c->isolate);
  81. v8::HandleScope handle_scope(c->isolate);
  82. v8::Local<v8::Context> v8_context = v8::Local<v8::Context>::New(c->isolate, c->context);
  83. v8::Context::Scope context_scope(v8_context);
  84. v8::Local<v8::String> object_name_js = v8::Local<v8::String>::New(c->isolate, c->object_name);
  85. V8JS_GLOBAL(c->isolate)->Delete(object_name_js);
  86. }
  87. c->object_name.Reset();
  88. c->object_name.~Persistent();
  89. c->global_template.Reset();
  90. c->global_template.~Persistent();
  91. /* Clear persistent handles in template cache */
  92. for (std::map<const char *,v8js_tmpl_t>::iterator it = c->template_cache.begin();
  93. it != c->template_cache.end(); ++it) {
  94. it->second.Reset();
  95. }
  96. c->template_cache.~map();
  97. /* Clear contexts */
  98. for (std::vector<v8js_accessor_ctx*>::iterator it = c->accessor_list.begin();
  99. it != c->accessor_list.end(); ++it) {
  100. v8js_accessor_ctx_dtor(*it TSRMLS_CC);
  101. }
  102. c->accessor_list.~vector();
  103. /* Clear global object, dispose context */
  104. if (!c->context.IsEmpty()) {
  105. c->context.Reset();
  106. }
  107. c->context.~Persistent();
  108. /* Dispose yet undisposed weak refs */
  109. for (std::map<zval *, v8js_persistent_obj_t>::iterator it = c->weak_objects.begin();
  110. it != c->weak_objects.end(); ++it) {
  111. zval *value = it->first;
  112. zval_ptr_dtor(&value);
  113. c->isolate->AdjustAmountOfExternalAllocatedMemory(-1024);
  114. it->second.Reset();
  115. }
  116. c->weak_objects.~map();
  117. for (std::map<v8js_tmpl_t *, v8js_persistent_obj_t>::iterator it = c->weak_closures.begin();
  118. it != c->weak_closures.end(); ++it) {
  119. v8js_tmpl_t *persist_tpl_ = it->first;
  120. persist_tpl_->Reset();
  121. delete persist_tpl_;
  122. it->second.Reset();
  123. }
  124. c->weak_closures.~map();
  125. for (std::list<v8js_v8object *>::iterator it = c->v8js_v8objects.begin();
  126. it != c->v8js_v8objects.end(); it ++) {
  127. (*it)->v8obj.Reset();
  128. (*it)->ctx = NULL;
  129. }
  130. c->v8js_v8objects.~list();
  131. /* Clear persistent handles in module cache */
  132. for (std::map<char *, v8js_persistent_obj_t>::iterator it = c->modules_loaded.begin();
  133. it != c->modules_loaded.end(); ++it) {
  134. it->second.Reset();
  135. }
  136. c->modules_loaded.~map();
  137. if(c->isolate) {
  138. /* c->isolate is initialized by V8Js::__construct, but __wakeup calls
  139. * are not fully constructed and hence this would cause a NPE. */
  140. c->isolate->Dispose();
  141. }
  142. if(c->tz != NULL) {
  143. free(c->tz);
  144. }
  145. c->modules_stack.~vector();
  146. c->modules_base.~vector();
  147. efree(object);
  148. }
  149. /* }}} */
  150. static zend_object_value v8js_new(zend_class_entry *ce TSRMLS_DC) /* {{{ */
  151. {
  152. zend_object_value retval;
  153. v8js_ctx *c;
  154. c = (v8js_ctx *) ecalloc(1, sizeof(*c));
  155. zend_object_std_init(&c->std, ce TSRMLS_CC);
  156. TSRMLS_SET_CTX(c->zts_ctx);
  157. #if PHP_VERSION_ID >= 50400
  158. object_properties_init(&c->std, ce);
  159. #else
  160. zval *tmp;
  161. zend_hash_copy(c->std.properties, &ce->default_properties,
  162. (copy_ctor_func_t) zval_add_ref, (void *) &tmp, sizeof(zval *));
  163. #endif
  164. new(&c->object_name) v8::Persistent<v8::String>();
  165. new(&c->context) v8::Persistent<v8::Context>();
  166. new(&c->global_template) v8::Persistent<v8::FunctionTemplate>();
  167. new(&c->modules_stack) std::vector<char*>();
  168. new(&c->modules_base) std::vector<char*>();
  169. new(&c->modules_loaded) std::map<char *, v8js_persistent_obj_t>;
  170. new(&c->template_cache) std::map<const char *,v8js_tmpl_t>();
  171. new(&c->accessor_list) std::vector<v8js_accessor_ctx *>();
  172. new(&c->weak_closures) std::map<v8js_tmpl_t *, v8js_persistent_obj_t>();
  173. new(&c->weak_objects) std::map<zval *, v8js_persistent_obj_t>();
  174. new(&c->v8js_v8objects) std::list<v8js_v8object *>();
  175. retval.handle = zend_objects_store_put(c, NULL, (zend_objects_free_object_storage_t) v8js_free_storage, NULL TSRMLS_CC);
  176. retval.handlers = &v8js_object_handlers;
  177. return retval;
  178. }
  179. /* }}} */
  180. static void v8js_free_ext_strarr(const char **arr, int count) /* {{{ */
  181. {
  182. int i;
  183. if (arr) {
  184. for (i = 0; i < count; i++) {
  185. if (arr[i]) {
  186. free((void *) arr[i]);
  187. }
  188. }
  189. free(arr);
  190. }
  191. }
  192. /* }}} */
  193. static void v8js_jsext_dtor(v8js_jsext *jsext) /* {{{ */
  194. {
  195. if (jsext->deps_ht) {
  196. zend_hash_destroy(jsext->deps_ht);
  197. free(jsext->deps_ht);
  198. }
  199. if (jsext->deps) {
  200. v8js_free_ext_strarr(jsext->deps, jsext->deps_count);
  201. }
  202. free(jsext->name);
  203. free(jsext->source);
  204. }
  205. /* }}} */
  206. static int v8js_create_ext_strarr(const char ***retval, int count, HashTable *ht) /* {{{ */
  207. {
  208. const char **exts = NULL;
  209. HashPosition pos;
  210. zval **tmp;
  211. int i = 0;
  212. exts = (const char **) calloc(1, count * sizeof(char *));
  213. zend_hash_internal_pointer_reset_ex(ht, &pos);
  214. while (zend_hash_get_current_data_ex(ht, (void **) &tmp, &pos) == SUCCESS) {
  215. if (Z_TYPE_PP(tmp) == IS_STRING) {
  216. exts[i++] = zend_strndup(Z_STRVAL_PP(tmp), Z_STRLEN_PP(tmp));
  217. } else {
  218. v8js_free_ext_strarr(exts, i);
  219. return FAILURE;
  220. }
  221. zend_hash_move_forward_ex(ht, &pos);
  222. }
  223. *retval = exts;
  224. return SUCCESS;
  225. }
  226. /* }}} */
  227. static void v8js_fatal_error_handler(const char *location, const char *message) /* {{{ */
  228. {
  229. v8::Isolate *isolate = v8::Isolate::GetCurrent();
  230. if (isolate) {
  231. isolate->Exit();
  232. }
  233. if (location) {
  234. zend_error(E_ERROR, "%s %s", location, message);
  235. } else {
  236. zend_error(E_ERROR, "%s", message);
  237. }
  238. }
  239. /* }}} */
  240. /* {{{ proto void V8Js::__construct([string object_name [, array variables [, array extensions [, bool report_uncaught_exceptions]]])
  241. __construct for V8Js */
  242. static PHP_METHOD(V8Js, __construct)
  243. {
  244. char *object_name = NULL, *class_name = NULL;
  245. int object_name_len = 0, free = 0;
  246. zend_uint class_name_len = 0;
  247. zend_bool report_uncaught = 1;
  248. zval *vars_arr = NULL, *exts_arr = NULL;
  249. const char **exts = NULL;
  250. int exts_count = 0;
  251. v8js_ctx *c = (v8js_ctx *) zend_object_store_get_object(getThis() TSRMLS_CC);
  252. if (!c->context.IsEmpty()) {
  253. /* called __construct() twice, bail out */
  254. return;
  255. }
  256. if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|saab", &object_name, &object_name_len, &vars_arr, &exts_arr, &report_uncaught) == FAILURE) {
  257. return;
  258. }
  259. /* Initialize V8 */
  260. v8js_v8_init(TSRMLS_C);
  261. /* Throw PHP exception if uncaught exceptions exist */
  262. c->report_uncaught = report_uncaught;
  263. c->pending_exception = NULL;
  264. c->in_execution = 0;
  265. #if PHP_V8_API_VERSION >= 4004044
  266. static ArrayBufferAllocator array_buffer_allocator;
  267. static v8::Isolate::CreateParams create_params;
  268. create_params.array_buffer_allocator = &array_buffer_allocator;
  269. c->isolate = v8::Isolate::New(create_params);
  270. #else
  271. c->isolate = v8::Isolate::New();
  272. #endif
  273. c->isolate->SetData(0, c);
  274. c->time_limit = 0;
  275. c->time_limit_hit = false;
  276. c->memory_limit = 0;
  277. c->memory_limit_hit = false;
  278. c->module_loader = NULL;
  279. /* Include extensions used by this context */
  280. /* Note: Extensions registered with auto_enable do not need to be added separately like this. */
  281. if (exts_arr)
  282. {
  283. exts_count = zend_hash_num_elements(Z_ARRVAL_P(exts_arr));
  284. if (v8js_create_ext_strarr(&exts, exts_count, Z_ARRVAL_P(exts_arr)) == FAILURE) {
  285. php_error_docref(NULL TSRMLS_CC, E_WARNING, "Invalid extensions array passed");
  286. return;
  287. }
  288. }
  289. /* Declare configuration for extensions */
  290. v8::ExtensionConfiguration extension_conf(exts_count, exts);
  291. // Isolate execution
  292. v8::Isolate *isolate = c->isolate;
  293. v8::Locker locker(isolate);
  294. v8::Isolate::Scope isolate_scope(isolate);
  295. /* Handle scope */
  296. v8::HandleScope handle_scope(isolate);
  297. /* Redirect fatal errors to PHP error handler */
  298. // This needs to be done within the context isolate
  299. v8::V8::SetFatalErrorHandler(v8js_fatal_error_handler);
  300. /* Create global template for global object */
  301. // Now we are using multiple isolates this needs to be created for every context
  302. v8::Local<v8::FunctionTemplate> tpl = v8::FunctionTemplate::New(c->isolate, 0);
  303. tpl->SetClassName(V8JS_SYM("V8Js"));
  304. c->global_template.Reset(isolate, tpl);
  305. /* Register builtin methods */
  306. v8js_register_methods(tpl->InstanceTemplate(), c);
  307. /* Create context */
  308. v8::Local<v8::Context> context = v8::Context::New(isolate, &extension_conf, tpl->InstanceTemplate());
  309. if (exts) {
  310. v8js_free_ext_strarr(exts, exts_count);
  311. }
  312. /* If extensions have errors, context will be empty. (NOTE: This is V8 stuff, they expect the passed sources to compile :) */
  313. if (context.IsEmpty()) {
  314. php_error_docref(NULL TSRMLS_CC, E_WARNING, "Failed to create V8 context. Check that registered extensions do not have errors.");
  315. ZVAL_NULL(getThis());
  316. return;
  317. }
  318. context->SetAlignedPointerInEmbedderData(1, c);
  319. c->context.Reset(isolate, context);
  320. /* Enter context */
  321. v8::Context::Scope context_scope(context);
  322. /* Create the PHP container object's function template */
  323. v8::Local<v8::FunctionTemplate> php_obj_t = v8::FunctionTemplate::New(isolate, 0);
  324. /* Set class name for PHP object */
  325. #if PHP_VERSION_ID >= 50400
  326. free = !zend_get_object_classname(getThis(), const_cast<const char**>(&class_name), &class_name_len TSRMLS_CC);
  327. #else
  328. free = !zend_get_object_classname(getThis(), &class_name, &class_name_len TSRMLS_CC);
  329. #endif
  330. php_obj_t->SetClassName(V8JS_SYML(class_name, class_name_len));
  331. if (free) {
  332. efree(class_name);
  333. }
  334. /* Register Get accessor for passed variables */
  335. if (vars_arr && zend_hash_num_elements(Z_ARRVAL_P(vars_arr)) > 0) {
  336. v8js_register_accessors(&c->accessor_list, php_obj_t, vars_arr, isolate TSRMLS_CC);
  337. }
  338. /* Set name for the PHP JS object */
  339. v8::Local<v8::String> object_name_js = (object_name_len) ? V8JS_SYML(object_name, object_name_len) : V8JS_SYM("PHP");
  340. c->object_name.Reset(isolate, object_name_js);
  341. /* Add the PHP object into global object */
  342. v8::Local<v8::Object> php_obj = php_obj_t->InstanceTemplate()->NewInstance();
  343. V8JS_GLOBAL(isolate)->ForceSet(object_name_js, php_obj, v8::ReadOnly);
  344. /* Export public property values */
  345. HashTable *properties = zend_std_get_properties(getThis() TSRMLS_CC);
  346. HashPosition pos;
  347. zval **value;
  348. ulong index;
  349. char *member;
  350. uint member_len;
  351. for(zend_hash_internal_pointer_reset_ex(properties, &pos);
  352. zend_hash_get_current_data_ex(properties, (void **) &value, &pos) == SUCCESS;
  353. zend_hash_move_forward_ex(properties, &pos)) {
  354. if(zend_hash_get_current_key_ex(properties, &member, &member_len, &index, 0, &pos) != HASH_KEY_IS_STRING) {
  355. continue;
  356. }
  357. zval zmember;
  358. INIT_ZVAL(zmember);
  359. ZVAL_STRING(&zmember, member, 0);
  360. zend_property_info *property_info = zend_get_property_info(c->std.ce, &zmember, 1 TSRMLS_CC);
  361. if(property_info && property_info->flags & ZEND_ACC_PUBLIC) {
  362. /* Write value to PHP JS object */
  363. php_obj->ForceSet(V8JS_SYML(member, member_len - 1), zval_to_v8js(*value, isolate TSRMLS_CC), v8::ReadOnly);
  364. }
  365. }
  366. }
  367. /* }}} */
  368. /* {{{ proto V8JS::__sleep()
  369. */
  370. PHP_METHOD(V8Js, __sleep)
  371. {
  372. zend_throw_exception(php_ce_v8js_exception,
  373. "You cannot serialize or unserialize V8Js instances", 0 TSRMLS_CC);
  374. RETURN_FALSE;
  375. }
  376. /* }}} */
  377. /* {{{ proto V8JS::__wakeup()
  378. */
  379. PHP_METHOD(V8Js, __wakeup)
  380. {
  381. zend_throw_exception(php_ce_v8js_exception,
  382. "You cannot serialize or unserialize V8Js instances", 0 TSRMLS_CC);
  383. RETURN_FALSE;
  384. }
  385. /* }}} */
  386. static void v8js_compile_script(zval *this_ptr, const char *str, int str_len, const char *identifier, int identifier_len, v8js_script **ret TSRMLS_DC)
  387. {
  388. v8js_script *res = NULL;
  389. V8JS_BEGIN_CTX(c, this_ptr)
  390. /* Catch JS exceptions */
  391. v8::TryCatch try_catch;
  392. /* Set script identifier */
  393. v8::Local<v8::String> sname = identifier_len ? V8JS_SYML(identifier, identifier_len) : V8JS_SYM("V8Js::compileString()");
  394. /* Compiles a string context independently. TODO: Add a php function which calls this and returns the result as resource which can be executed later. */
  395. v8::Local<v8::String> source = V8JS_STRL(str, str_len);
  396. v8::Local<v8::Script> script = v8::Script::Compile(source, sname);
  397. /* Compile errors? */
  398. if (script.IsEmpty()) {
  399. v8js_throw_script_exception(&try_catch TSRMLS_CC);
  400. return;
  401. }
  402. res = (v8js_script *)emalloc(sizeof(v8js_script));
  403. res->script = new v8::Persistent<v8::Script, v8::CopyablePersistentTraits<v8::Script>>(c->isolate, script);
  404. v8::String::Utf8Value _sname(sname);
  405. res->name = estrndup(ToCString(_sname), _sname.length());
  406. res->isolate = c->isolate;
  407. *ret = res;
  408. return;
  409. }
  410. static void v8js_execute_script(zval *this_ptr, v8js_script *res, long flags, long time_limit, long memory_limit, zval **return_value TSRMLS_DC)
  411. {
  412. v8js_ctx *c = (v8js_ctx *) zend_object_store_get_object(getThis() TSRMLS_CC);
  413. if (res->isolate != c->isolate) {
  414. zend_error(E_WARNING, "Script resource from wrong V8Js object passed");
  415. ZVAL_BOOL(*return_value, 0);
  416. return;
  417. }
  418. if (!c->in_execution && time_limit == 0) {
  419. time_limit = c->time_limit;
  420. }
  421. if (!c->in_execution && memory_limit == 0) {
  422. memory_limit = c->memory_limit;
  423. }
  424. std::function< v8::Local<v8::Value>(v8::Isolate *) > v8_call = [res](v8::Isolate *isolate) {
  425. v8::Local<v8::Script> script = v8::Local<v8::Script>::New(isolate, *res->script);
  426. return script->Run();
  427. };
  428. v8js_v8_call(c, return_value, flags, time_limit, memory_limit, v8_call TSRMLS_CC);
  429. }
  430. /* {{{ proto mixed V8Js::executeString(string script [, string identifier [, int flags]])
  431. */
  432. static PHP_METHOD(V8Js, executeString)
  433. {
  434. char *str = NULL, *identifier = NULL, *tz = NULL;
  435. int str_len = 0, identifier_len = 0;
  436. long flags = V8JS_FLAG_NONE, time_limit = 0, memory_limit = 0;
  437. v8js_script *res = NULL;
  438. if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|slll", &str, &str_len, &identifier, &identifier_len, &flags, &time_limit, &memory_limit) == FAILURE) {
  439. return;
  440. }
  441. v8js_compile_script(getThis(), str, str_len, identifier, identifier_len, &res TSRMLS_CC);
  442. if (!res) {
  443. RETURN_FALSE;
  444. }
  445. v8js_execute_script(getThis(), res, flags, time_limit, memory_limit, &return_value TSRMLS_CC);
  446. v8js_script_free(res, true);
  447. efree(res);
  448. }
  449. /* }}} */
  450. /* {{{ proto mixed V8Js::compileString(string script [, string identifier])
  451. */
  452. static PHP_METHOD(V8Js, compileString)
  453. {
  454. char *str = NULL, *identifier = NULL;
  455. int str_len = 0, identifier_len = 0;
  456. v8js_script *res = NULL;
  457. if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|s", &str, &str_len, &identifier, &identifier_len) == FAILURE) {
  458. return;
  459. }
  460. v8js_compile_script(getThis(), str, str_len, identifier, identifier_len, &res TSRMLS_CC);
  461. if (res) {
  462. ZEND_REGISTER_RESOURCE(return_value, res, le_v8js_script);
  463. }
  464. return;
  465. }
  466. /* }}} */
  467. /* {{{ proto mixed V8Js::executeScript(resource script [, int flags]])
  468. */
  469. static PHP_METHOD(V8Js, executeScript)
  470. {
  471. long flags = V8JS_FLAG_NONE, time_limit = 0, memory_limit = 0;
  472. zval *zscript;
  473. v8js_script *res;
  474. if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "r|lll", &zscript, &flags, &time_limit, &memory_limit) == FAILURE) {
  475. return;
  476. }
  477. ZEND_FETCH_RESOURCE(res, v8js_script*, &zscript, -1, PHP_V8JS_SCRIPT_RES_NAME, le_v8js_script);
  478. ZEND_VERIFY_RESOURCE(res);
  479. v8js_execute_script(getThis(), res, flags, time_limit, memory_limit, &return_value TSRMLS_CC);
  480. }
  481. /* }}} */
  482. /* {{{ proto mixed V8Js::checkString(string script)
  483. */
  484. static PHP_METHOD(V8Js, checkString)
  485. {
  486. char *str = NULL;
  487. int str_len = 0;
  488. const char *identifier = "V8Js::checkString()";
  489. int identifier_len = 19;
  490. v8js_script *res = NULL;
  491. if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &str, &str_len) == FAILURE) {
  492. return;
  493. }
  494. v8js_compile_script(getThis(), str, str_len, identifier, identifier_len, &res TSRMLS_CC);
  495. if (!res) {
  496. RETURN_FALSE;
  497. }
  498. v8js_script_free(res, true);
  499. efree(res);
  500. RETURN_TRUE;
  501. }
  502. /* }}} */
  503. /* {{{ proto mixed V8Js::getPendingException()
  504. */
  505. static PHP_METHOD(V8Js, getPendingException)
  506. {
  507. v8js_ctx *c;
  508. if (zend_parse_parameters_none() == FAILURE) {
  509. return;
  510. }
  511. c = (v8js_ctx *) zend_object_store_get_object(getThis() TSRMLS_CC);
  512. if (c->pending_exception) {
  513. RETURN_ZVAL(c->pending_exception, 1, 0);
  514. }
  515. }
  516. /* }}} */
  517. /* {{{ proto void V8Js::clearPendingException()
  518. */
  519. static PHP_METHOD(V8Js, clearPendingException)
  520. {
  521. v8js_ctx *c;
  522. if (zend_parse_parameters_none() == FAILURE) {
  523. return;
  524. }
  525. c = (v8js_ctx *) zend_object_store_get_object(getThis() TSRMLS_CC);
  526. if (c->pending_exception) {
  527. zval_ptr_dtor(&c->pending_exception);
  528. c->pending_exception = NULL;
  529. }
  530. }
  531. /* }}} */
  532. /* {{{ proto void V8Js::setModuleLoader(string module)
  533. */
  534. static PHP_METHOD(V8Js, setModuleLoader)
  535. {
  536. v8js_ctx *c;
  537. zval *callable;
  538. if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "z", &callable) == FAILURE) {
  539. return;
  540. }
  541. c = (v8js_ctx *) zend_object_store_get_object(getThis() TSRMLS_CC);
  542. c->module_loader = callable;
  543. Z_ADDREF_P(c->module_loader);
  544. }
  545. /* }}} */
  546. /* {{{ proto void V8Js::setTimeLimit(int time_limit)
  547. */
  548. static PHP_METHOD(V8Js, setTimeLimit)
  549. {
  550. v8js_ctx *c;
  551. long time_limit = 0;
  552. if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "l", &time_limit) == FAILURE) {
  553. return;
  554. }
  555. c = (v8js_ctx *) zend_object_store_get_object(getThis() TSRMLS_CC);
  556. c->time_limit = time_limit;
  557. V8JSG(timer_mutex).lock();
  558. for (std::deque< v8js_timer_ctx* >::iterator it = V8JSG(timer_stack).begin();
  559. it != V8JSG(timer_stack).end(); it ++) {
  560. if((*it)->ctx == c && !(*it)->killed) {
  561. (*it)->time_limit = time_limit;
  562. // Calculate the time point when the time limit is exceeded
  563. std::chrono::milliseconds duration(time_limit);
  564. std::chrono::time_point<std::chrono::high_resolution_clock> from = std::chrono::high_resolution_clock::now();
  565. (*it)->time_point = from + duration;
  566. }
  567. }
  568. V8JSG(timer_mutex).unlock();
  569. if (c->in_execution && time_limit && !V8JSG(timer_thread)) {
  570. /* If timer thread is not started already and we now impose a time limit
  571. * finally install the timer. */
  572. V8JSG(timer_thread) = new std::thread(v8js_timer_thread TSRMLS_CC);
  573. }
  574. }
  575. /* }}} */
  576. /* {{{ proto void V8Js::setMemoryLimit(int memory_limit)
  577. */
  578. static PHP_METHOD(V8Js, setMemoryLimit)
  579. {
  580. v8js_ctx *c;
  581. long memory_limit = 0;
  582. if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "l", &memory_limit) == FAILURE) {
  583. return;
  584. }
  585. c = (v8js_ctx *) zend_object_store_get_object(getThis() TSRMLS_CC);
  586. c->memory_limit = memory_limit;
  587. V8JSG(timer_mutex).lock();
  588. for (std::deque< v8js_timer_ctx* >::iterator it = V8JSG(timer_stack).begin();
  589. it != V8JSG(timer_stack).end(); it ++) {
  590. if((*it)->ctx == c && !(*it)->killed) {
  591. (*it)->memory_limit = memory_limit;
  592. }
  593. }
  594. V8JSG(timer_mutex).unlock();
  595. if (c->in_execution && memory_limit && !V8JSG(timer_thread)) {
  596. /* If timer thread is not started already and we now impose a memory limit
  597. * finally install the timer. */
  598. V8JSG(timer_thread) = new std::thread(v8js_timer_thread TSRMLS_CC);
  599. }
  600. }
  601. /* }}} */
  602. static void v8js_persistent_zval_ctor(zval **p) /* {{{ */
  603. {
  604. zval *orig_ptr = *p;
  605. *p = (zval *) malloc(sizeof(zval));
  606. **p = *orig_ptr;
  607. switch (Z_TYPE_P(*p)) {
  608. case IS_STRING:
  609. Z_STRVAL_P(*p) = (char *) zend_strndup(Z_STRVAL_P(*p), Z_STRLEN_P(*p));
  610. break;
  611. default:
  612. zend_bailout();
  613. }
  614. INIT_PZVAL(*p);
  615. }
  616. /* }}} */
  617. static void v8js_persistent_zval_dtor(zval **p) /* {{{ */
  618. {
  619. switch (Z_TYPE_P(*p)) {
  620. case IS_STRING:
  621. free(Z_STRVAL_P(*p));
  622. break;
  623. default:
  624. zend_bailout();
  625. }
  626. free(*p);
  627. }
  628. /* }}} */
  629. static void v8js_script_free(v8js_script *res, bool dispose_persistent)
  630. {
  631. if (res->name) {
  632. efree(res->name);
  633. res->name = NULL;
  634. }
  635. if (dispose_persistent) {
  636. res->script->~Persistent(); // does Reset()
  637. res->script = NULL;
  638. }
  639. }
  640. static void v8js_script_dtor(zend_rsrc_list_entry *rsrc TSRMLS_DC) /* {{{ */
  641. {
  642. v8js_script *res = (v8js_script *)rsrc->ptr;
  643. if (res) {
  644. v8js_script_free(res, false);
  645. efree(res);
  646. }
  647. }
  648. /* }}} */
  649. static int v8js_register_extension(char *name, uint name_len, char *source, uint source_len, zval *deps_arr, zend_bool auto_enable TSRMLS_DC) /* {{{ */
  650. {
  651. v8js_jsext *jsext = NULL;
  652. if (!V8JSG(extensions)) {
  653. V8JSG(extensions) = (HashTable *) malloc(sizeof(HashTable));
  654. zend_hash_init(V8JSG(extensions), 1, NULL, (dtor_func_t) v8js_jsext_dtor, 1);
  655. } else if (zend_hash_exists(V8JSG(extensions), name, name_len + 1)) {
  656. return FAILURE;
  657. }
  658. jsext = (v8js_jsext *) calloc(1, sizeof(v8js_jsext));
  659. if (deps_arr) {
  660. jsext->deps_count = zend_hash_num_elements(Z_ARRVAL_P(deps_arr));
  661. if (v8js_create_ext_strarr(&jsext->deps, jsext->deps_count, Z_ARRVAL_P(deps_arr)) == FAILURE) {
  662. php_error_docref(NULL TSRMLS_CC, E_WARNING, "Invalid dependency array passed");
  663. v8js_jsext_dtor(jsext);
  664. free(jsext);
  665. return FAILURE;
  666. }
  667. }
  668. jsext->auto_enable = auto_enable;
  669. jsext->name = zend_strndup(name, name_len);
  670. jsext->source = zend_strndup(source, source_len);
  671. if (jsext->deps) {
  672. jsext->deps_ht = (HashTable *) malloc(sizeof(HashTable));
  673. zend_hash_init(jsext->deps_ht, jsext->deps_count, NULL, (dtor_func_t) v8js_persistent_zval_dtor, 1);
  674. zend_hash_copy(jsext->deps_ht, Z_ARRVAL_P(deps_arr), (copy_ctor_func_t) v8js_persistent_zval_ctor, NULL, sizeof(zval *));
  675. }
  676. if (zend_hash_add(V8JSG(extensions), name, name_len + 1, jsext, sizeof(v8js_jsext), NULL) == FAILURE) {
  677. v8js_jsext_dtor(jsext);
  678. free(jsext);
  679. return FAILURE;
  680. }
  681. v8::Extension *extension = new v8::Extension(jsext->name, jsext->source, jsext->deps_count, jsext->deps);
  682. extension->set_auto_enable(auto_enable ? true : false);
  683. v8::RegisterExtension(extension);
  684. free(jsext);
  685. return SUCCESS;
  686. }
  687. /* }}} */
  688. /* {{{ proto bool V8Js::registerExtension(string ext_name, string script [, array deps [, bool auto_enable]])
  689. */
  690. static PHP_METHOD(V8Js, registerExtension)
  691. {
  692. char *ext_name, *script;
  693. zval *deps_arr = NULL;
  694. int ext_name_len, script_len;
  695. zend_bool auto_enable = 0;
  696. if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ss|ab", &ext_name, &ext_name_len, &script, &script_len, &deps_arr, &auto_enable) == FAILURE) {
  697. return;
  698. }
  699. if (!ext_name_len) {
  700. php_error_docref(NULL TSRMLS_CC, E_WARNING, "Extension name cannot be empty");
  701. } else if (!script_len) {
  702. php_error_docref(NULL TSRMLS_CC, E_WARNING, "Script cannot be empty");
  703. } else if (v8js_register_extension(ext_name, ext_name_len, script, script_len, deps_arr, auto_enable TSRMLS_CC) == SUCCESS) {
  704. RETURN_TRUE;
  705. }
  706. RETURN_FALSE;
  707. }
  708. /* }}} */
  709. /* ## Static methods ## */
  710. /* {{{ proto array V8Js::getExtensions()
  711. */
  712. static PHP_METHOD(V8Js, getExtensions)
  713. {
  714. v8js_jsext *jsext;
  715. zval *ext, *deps_arr;
  716. HashPosition pos;
  717. ulong index;
  718. char *key;
  719. uint key_len;
  720. if (zend_parse_parameters_none() == FAILURE) {
  721. return;
  722. }
  723. array_init(return_value);
  724. if (V8JSG(extensions)) {
  725. zend_hash_internal_pointer_reset_ex(V8JSG(extensions), &pos);
  726. while (zend_hash_get_current_data_ex(V8JSG(extensions), (void **) &jsext, &pos) == SUCCESS) {
  727. if (zend_hash_get_current_key_ex(V8JSG(extensions), &key, &key_len, &index, 0, &pos) == HASH_KEY_IS_STRING) {
  728. MAKE_STD_ZVAL(ext)
  729. array_init(ext);
  730. add_assoc_bool_ex(ext, ZEND_STRS("auto_enable"), jsext->auto_enable);
  731. if (jsext->deps_ht) {
  732. MAKE_STD_ZVAL(deps_arr);
  733. array_init(deps_arr);
  734. zend_hash_copy(Z_ARRVAL_P(deps_arr), jsext->deps_ht, (copy_ctor_func_t) zval_add_ref, NULL, sizeof(zval *));
  735. add_assoc_zval_ex(ext, ZEND_STRS("deps"), deps_arr);
  736. }
  737. add_assoc_zval_ex(return_value, key, key_len, ext);
  738. }
  739. zend_hash_move_forward_ex(V8JSG(extensions), &pos);
  740. }
  741. }
  742. }
  743. /* }}} */
  744. /* {{{ arginfo */
  745. ZEND_BEGIN_ARG_INFO_EX(arginfo_v8js_construct, 0, 0, 0)
  746. ZEND_ARG_INFO(0, object_name)
  747. ZEND_ARG_INFO(0, variables)
  748. ZEND_ARG_INFO(0, extensions)
  749. ZEND_ARG_INFO(0, report_uncaught_exceptions)
  750. ZEND_END_ARG_INFO()
  751. ZEND_BEGIN_ARG_INFO(arginfo_v8js_sleep, 0)
  752. ZEND_END_ARG_INFO()
  753. ZEND_BEGIN_ARG_INFO(arginfo_v8js_wakeup, 0)
  754. ZEND_END_ARG_INFO()
  755. ZEND_BEGIN_ARG_INFO_EX(arginfo_v8js_executestring, 0, 0, 1)
  756. ZEND_ARG_INFO(0, script)
  757. ZEND_ARG_INFO(0, identifier)
  758. ZEND_ARG_INFO(0, flags)
  759. ZEND_ARG_INFO(0, time_limit)
  760. ZEND_ARG_INFO(0, memory_limit)
  761. ZEND_END_ARG_INFO()
  762. ZEND_BEGIN_ARG_INFO_EX(arginfo_v8js_compilestring, 0, 0, 1)
  763. ZEND_ARG_INFO(0, script)
  764. ZEND_ARG_INFO(0, identifier)
  765. ZEND_END_ARG_INFO()
  766. ZEND_BEGIN_ARG_INFO_EX(arginfo_v8js_executescript, 0, 0, 1)
  767. ZEND_ARG_INFO(0, script)
  768. ZEND_ARG_INFO(0, flags)
  769. ZEND_ARG_INFO(0, time_limit)
  770. ZEND_ARG_INFO(0, memory_limit)
  771. ZEND_END_ARG_INFO()
  772. ZEND_BEGIN_ARG_INFO_EX(arginfo_v8js_checkstring, 0, 0, 1)
  773. ZEND_ARG_INFO(0, script)
  774. ZEND_END_ARG_INFO()
  775. #ifdef ENABLE_DEBUGGER_SUPPORT
  776. ZEND_BEGIN_ARG_INFO_EX(arginfo_v8js_destruct, 0, 0, 0)
  777. ZEND_END_ARG_INFO()
  778. ZEND_BEGIN_ARG_INFO_EX(arginfo_v8js_startdebugagent, 0, 0, 0)
  779. ZEND_ARG_INFO(0, agentName)
  780. ZEND_ARG_INFO(0, port)
  781. ZEND_ARG_INFO(0, auto_break)
  782. ZEND_END_ARG_INFO()
  783. #endif /* ENABLE_DEBUGGER_SUPPORT */
  784. ZEND_BEGIN_ARG_INFO(arginfo_v8js_getpendingexception, 0)
  785. ZEND_END_ARG_INFO()
  786. ZEND_BEGIN_ARG_INFO(arginfo_v8js_clearpendingexception, 0)
  787. ZEND_END_ARG_INFO()
  788. ZEND_BEGIN_ARG_INFO_EX(arginfo_v8js_setmoduleloader, 0, 0, 1)
  789. ZEND_ARG_INFO(0, callable)
  790. ZEND_END_ARG_INFO()
  791. ZEND_BEGIN_ARG_INFO_EX(arginfo_v8js_registerextension, 0, 0, 2)
  792. ZEND_ARG_INFO(0, extension_name)
  793. ZEND_ARG_INFO(0, script)
  794. ZEND_ARG_INFO(0, dependencies)
  795. ZEND_ARG_INFO(0, auto_enable)
  796. ZEND_END_ARG_INFO()
  797. ZEND_BEGIN_ARG_INFO(arginfo_v8js_getextensions, 0)
  798. ZEND_END_ARG_INFO()
  799. ZEND_BEGIN_ARG_INFO_EX(arginfo_v8js_settimelimit, 0, 0, 1)
  800. ZEND_ARG_INFO(0, time_limit)
  801. ZEND_END_ARG_INFO()
  802. ZEND_BEGIN_ARG_INFO_EX(arginfo_v8js_setmemorylimit, 0, 0, 1)
  803. ZEND_ARG_INFO(0, memory_limit)
  804. ZEND_END_ARG_INFO()
  805. static const zend_function_entry v8js_methods[] = { /* {{{ */
  806. PHP_ME(V8Js, __construct, arginfo_v8js_construct, ZEND_ACC_PUBLIC|ZEND_ACC_CTOR)
  807. PHP_ME(V8Js, __sleep, arginfo_v8js_sleep, ZEND_ACC_PUBLIC|ZEND_ACC_FINAL)
  808. PHP_ME(V8Js, __wakeup, arginfo_v8js_sleep, ZEND_ACC_PUBLIC|ZEND_ACC_FINAL)
  809. PHP_ME(V8Js, executeString, arginfo_v8js_executestring, ZEND_ACC_PUBLIC)
  810. PHP_ME(V8Js, compileString, arginfo_v8js_compilestring, ZEND_ACC_PUBLIC)
  811. PHP_ME(V8Js, executeScript, arginfo_v8js_executescript, ZEND_ACC_PUBLIC)
  812. PHP_ME(V8Js, checkString, arginfo_v8js_checkstring, ZEND_ACC_PUBLIC|ZEND_ACC_DEPRECATED)
  813. PHP_ME(V8Js, getPendingException, arginfo_v8js_getpendingexception, ZEND_ACC_PUBLIC)
  814. PHP_ME(V8Js, clearPendingException, arginfo_v8js_clearpendingexception, ZEND_ACC_PUBLIC)
  815. PHP_ME(V8Js, setModuleLoader, arginfo_v8js_setmoduleloader, ZEND_ACC_PUBLIC)
  816. PHP_ME(V8Js, registerExtension, arginfo_v8js_registerextension, ZEND_ACC_PUBLIC|ZEND_ACC_STATIC)
  817. PHP_ME(V8Js, getExtensions, arginfo_v8js_getextensions, ZEND_ACC_PUBLIC|ZEND_ACC_STATIC)
  818. PHP_ME(V8Js, setTimeLimit, arginfo_v8js_settimelimit, ZEND_ACC_PUBLIC)
  819. PHP_ME(V8Js, setMemoryLimit, arginfo_v8js_setmemorylimit, ZEND_ACC_PUBLIC)
  820. #ifdef ENABLE_DEBUGGER_SUPPORT
  821. PHP_ME(V8Js, __destruct, arginfo_v8js_destruct, ZEND_ACC_PUBLIC|ZEND_ACC_DTOR)
  822. PHP_ME(V8Js, startDebugAgent, arginfo_v8js_startdebugagent, ZEND_ACC_PUBLIC)
  823. #endif
  824. {NULL, NULL, NULL}
  825. };
  826. /* }}} */
  827. /* V8Js object handlers */
  828. static void v8js_write_property(zval *object, zval *member, zval *value ZEND_HASH_KEY_DC TSRMLS_DC) /* {{{ */
  829. {
  830. V8JS_BEGIN_CTX(c, object)
  831. /* Check whether member is public, if so, export to V8. */
  832. zend_property_info *property_info = zend_get_property_info(c->std.ce, member, 1 TSRMLS_CC);
  833. if(property_info->flags & ZEND_ACC_PUBLIC) {
  834. /* Global PHP JS object */
  835. v8::Local<v8::String> object_name_js = v8::Local<v8::String>::New(isolate, c->object_name);
  836. v8::Local<v8::Object> jsobj = V8JS_GLOBAL(isolate)->Get(object_name_js)->ToObject();
  837. /* Write value to PHP JS object */
  838. jsobj->ForceSet(V8JS_SYML(Z_STRVAL_P(member), Z_STRLEN_P(member)), zval_to_v8js(value, isolate TSRMLS_CC), v8::ReadOnly);
  839. }
  840. /* Write value to PHP object */
  841. std_object_handlers.write_property(object, member, value ZEND_HASH_KEY_CC TSRMLS_CC);
  842. }
  843. /* }}} */
  844. static void v8js_unset_property(zval *object, zval *member ZEND_HASH_KEY_DC TSRMLS_DC) /* {{{ */
  845. {
  846. V8JS_BEGIN_CTX(c, object)
  847. /* Global PHP JS object */
  848. v8::Local<v8::String> object_name_js = v8::Local<v8::String>::New(isolate, c->object_name);
  849. v8::Local<v8::Object> jsobj = V8JS_GLOBAL(isolate)->Get(object_name_js)->ToObject();
  850. /* Delete value from PHP JS object */
  851. jsobj->Delete(V8JS_SYML(Z_STRVAL_P(member), Z_STRLEN_P(member)));
  852. /* Unset from PHP object */
  853. std_object_handlers.unset_property(object, member ZEND_HASH_KEY_CC TSRMLS_CC);
  854. }
  855. /* }}} */
  856. PHP_MINIT_FUNCTION(v8js_class) /* {{{ */
  857. {
  858. zend_class_entry ce;
  859. /* V8Js Class */
  860. INIT_CLASS_ENTRY(ce, "V8Js", v8js_methods);
  861. php_ce_v8js = zend_register_internal_class(&ce TSRMLS_CC);
  862. php_ce_v8js->create_object = v8js_new;
  863. /* V8Js handlers */
  864. memcpy(&v8js_object_handlers, zend_get_std_object_handlers(), sizeof(zend_object_handlers));
  865. v8js_object_handlers.clone_obj = NULL;
  866. v8js_object_handlers.write_property = v8js_write_property;
  867. v8js_object_handlers.unset_property = v8js_unset_property;
  868. /* V8Js Class Constants */
  869. zend_declare_class_constant_string(php_ce_v8js, ZEND_STRL("V8_VERSION"), PHP_V8_VERSION TSRMLS_CC);
  870. zend_declare_class_constant_long(php_ce_v8js, ZEND_STRL("FLAG_NONE"), V8JS_FLAG_NONE TSRMLS_CC);
  871. zend_declare_class_constant_long(php_ce_v8js, ZEND_STRL("FLAG_FORCE_ARRAY"), V8JS_FLAG_FORCE_ARRAY TSRMLS_CC);
  872. #ifdef ENABLE_DEBUGGER_SUPPORT
  873. zend_declare_class_constant_long(php_ce_v8js, ZEND_STRL("DEBUG_AUTO_BREAK_NEVER"), V8JS_DEBUG_AUTO_BREAK_NEVER TSRMLS_CC);
  874. zend_declare_class_constant_long(php_ce_v8js, ZEND_STRL("DEBUG_AUTO_BREAK_ONCE"), V8JS_DEBUG_AUTO_BREAK_ONCE TSRMLS_CC);
  875. zend_declare_class_constant_long(php_ce_v8js, ZEND_STRL("DEBUG_AUTO_BREAK_ALWAYS"), V8JS_DEBUG_AUTO_BREAK_ALWAYS TSRMLS_CC);
  876. #endif
  877. le_v8js_script = zend_register_list_destructors_ex(v8js_script_dtor, NULL, PHP_V8JS_SCRIPT_RES_NAME, module_number);
  878. #if PHP_V8_API_VERSION >= 4004010 && PHP_V8_API_VERSION < 4004044
  879. static ArrayBufferAllocator array_buffer_allocator;
  880. v8::V8::SetArrayBufferAllocator(&array_buffer_allocator);
  881. #endif
  882. return SUCCESS;
  883. } /* }}} */
  884. /*
  885. * Local variables:
  886. * tab-width: 4
  887. * c-basic-offset: 4
  888. * End:
  889. * vim600: noet sw=4 ts=4 fdm=marker
  890. * vim<600: noet sw=4 ts=4
  891. */