/* * Copyright 2017-present MongoDB, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "bson/bson.h" #include "mongoc/mongoc.h" #include #include #include "php_array_api.h" #include "php_phongo.h" #include "phongo_bson_encode.h" #include "phongo_client.h" #include "phongo_error.h" #include "MongoDB/ReadConcern.h" #include "MongoDB/ReadPreference.h" #include "MongoDB/Server.h" #include "MongoDB/Session.h" #include "MongoDB/WriteConcern.h" #include "Session_arginfo.h" #include "BSON/Timestamp.h" zend_class_entry* php_phongo_session_ce; #define SESSION_CHECK_LIVELINESS(i, m) \ if (!(i)->client_session) { \ phongo_throw_exception( \ PHONGO_ERROR_LOGIC, \ "Cannot call '%s', as the session has already been ended.", \ (m)); \ return; \ } static bool php_phongo_session_get_timestamp_parts(zval* obj, uint32_t* timestamp, uint32_t* increment) { bool retval = false; zval ztimestamp = ZVAL_STATIC_INIT; zval zincrement = ZVAL_STATIC_INIT; zend_call_method_with_0_params(Z_OBJ_P(obj), NULL, NULL, "getTimestamp", &ztimestamp); if (Z_ISUNDEF(ztimestamp) || EG(exception)) { goto cleanup; } zend_call_method_with_0_params(Z_OBJ_P(obj), NULL, NULL, "getIncrement", &zincrement); if (Z_ISUNDEF(zincrement) || EG(exception)) { goto cleanup; } *timestamp = Z_LVAL(ztimestamp); *increment = Z_LVAL(zincrement); retval = true; cleanup: if (!Z_ISUNDEF(ztimestamp)) { zval_ptr_dtor(&ztimestamp); } if (!Z_ISUNDEF(zincrement)) { zval_ptr_dtor(&zincrement); } return retval; } static const char* php_phongo_get_transaction_state_string(mongoc_transaction_state_t state) { switch (state) { case MONGOC_TRANSACTION_NONE: return PHONGO_TRANSACTION_NONE; case MONGOC_TRANSACTION_STARTING: return PHONGO_TRANSACTION_STARTING; case MONGOC_TRANSACTION_IN_PROGRESS: return PHONGO_TRANSACTION_IN_PROGRESS; case MONGOC_TRANSACTION_COMMITTED: return PHONGO_TRANSACTION_COMMITTED; case MONGOC_TRANSACTION_ABORTED: return PHONGO_TRANSACTION_ABORTED; default: phongo_throw_exception(PHONGO_ERROR_INVALID_ARGUMENT, "Invalid transaction state %d given", (int) state); return NULL; } } static void php_phongo_transaction_options_to_zval(mongoc_client_session_t* cs, zval* retval) { mongoc_transaction_opt_t* opts; int64_t max_commit_time_ms; const mongoc_read_concern_t* read_concern; const mongoc_read_prefs_t* read_preference; const mongoc_write_concern_t* write_concern; if (!cs) { ZVAL_NULL(retval); return; } opts = mongoc_session_opts_get_transaction_opts(cs); if (!opts) { ZVAL_NULL(retval); return; } max_commit_time_ms = mongoc_transaction_opts_get_max_commit_time_ms(opts); read_concern = mongoc_transaction_opts_get_read_concern(opts); read_preference = mongoc_transaction_opts_get_read_prefs(opts); write_concern = mongoc_transaction_opts_get_write_concern(opts); array_init_size(retval, 4); if (max_commit_time_ms) { ADD_ASSOC_LONG_EX(retval, "maxCommitTimeMS", max_commit_time_ms); } if (!mongoc_read_concern_is_default(read_concern)) { zval zread_concern; phongo_readconcern_init(&zread_concern, read_concern); ADD_ASSOC_ZVAL_EX(retval, "readConcern", &zread_concern); } if (read_preference) { zval zread_preference; phongo_readpreference_init(&zread_preference, read_preference); ADD_ASSOC_ZVAL_EX(retval, "readPreference", &zread_preference); } if (!mongoc_write_concern_is_default(write_concern)) { zval zwrite_concern; phongo_writeconcern_init(&zwrite_concern, write_concern); ADD_ASSOC_ZVAL_EX(retval, "writeConcern", &zwrite_concern); } mongoc_transaction_opts_destroy(opts); } PHONGO_DISABLED_CONSTRUCTOR(MongoDB_Driver_Session) /* Advances the cluster time for this Session */ static PHP_METHOD(MongoDB_Driver_Session, advanceClusterTime) { php_phongo_session_t* intern; zval* zcluster_time; bson_t cluster_time = BSON_INITIALIZER; intern = Z_SESSION_OBJ_P(getThis()); SESSION_CHECK_LIVELINESS(intern, "advanceClusterTime") PHONGO_PARSE_PARAMETERS_START(1, 1) Z_PARAM_ARRAY_OR_OBJECT(zcluster_time) PHONGO_PARSE_PARAMETERS_END(); php_phongo_zval_to_bson(zcluster_time, PHONGO_BSON_NONE, &cluster_time, NULL); /* An exception may be thrown during BSON conversion */ if (EG(exception)) { goto cleanup; } mongoc_client_session_advance_cluster_time(intern->client_session, &cluster_time); cleanup: bson_destroy(&cluster_time); } /* Advances the operation time for this Session */ static PHP_METHOD(MongoDB_Driver_Session, advanceOperationTime) { php_phongo_session_t* intern; zval* ztimestamp; uint32_t timestamp = 0; uint32_t increment = 0; intern = Z_SESSION_OBJ_P(getThis()); SESSION_CHECK_LIVELINESS(intern, "advanceOperationTime") PHONGO_PARSE_PARAMETERS_START(1, 1) Z_PARAM_OBJECT_OF_CLASS(ztimestamp, php_phongo_timestamp_interface_ce) PHONGO_PARSE_PARAMETERS_END(); if (!php_phongo_session_get_timestamp_parts(ztimestamp, ×tamp, &increment)) { return; } mongoc_client_session_advance_operation_time(intern->client_session, timestamp, increment); } /* Returns the cluster time for this Session */ static PHP_METHOD(MongoDB_Driver_Session, getClusterTime) { php_phongo_session_t* intern; const bson_t* cluster_time; php_phongo_bson_state state; PHONGO_BSON_INIT_STATE(state); intern = Z_SESSION_OBJ_P(getThis()); SESSION_CHECK_LIVELINESS(intern, "getClusterTime") PHONGO_PARSE_PARAMETERS_NONE(); cluster_time = mongoc_client_session_get_cluster_time(intern->client_session); if (!cluster_time) { RETURN_NULL(); } if (!php_phongo_bson_to_zval_ex(cluster_time, &state)) { /* Exception should already have been thrown */ zval_ptr_dtor(&state.zchild); return; } RETURN_ZVAL(&state.zchild, 0, 1); } /* Returns the logical session ID for this Session */ static PHP_METHOD(MongoDB_Driver_Session, getLogicalSessionId) { php_phongo_session_t* intern; const bson_t* lsid; php_phongo_bson_state state; PHONGO_BSON_INIT_STATE(state); intern = Z_SESSION_OBJ_P(getThis()); SESSION_CHECK_LIVELINESS(intern, "getLogicalSessionId") PHONGO_PARSE_PARAMETERS_NONE(); lsid = mongoc_client_session_get_lsid(intern->client_session); if (!php_phongo_bson_to_zval_ex(lsid, &state)) { /* Exception should already have been thrown */ zval_ptr_dtor(&state.zchild); return; } RETURN_ZVAL(&state.zchild, 0, 1); } /* Returns the operation time for this Session */ static PHP_METHOD(MongoDB_Driver_Session, getOperationTime) { php_phongo_session_t* intern; uint32_t timestamp, increment; intern = Z_SESSION_OBJ_P(getThis()); SESSION_CHECK_LIVELINESS(intern, "getOperationTime") PHONGO_PARSE_PARAMETERS_NONE(); mongoc_client_session_get_operation_time(intern->client_session, ×tamp, &increment); /* mongoc_client_session_get_operation_time() returns 0 for both parts if * the session has not been used. According to the causal consistency spec, * the operation time for an unused session is null. */ if (timestamp == 0 && increment == 0) { RETURN_NULL(); } phongo_timestamp_new(return_value, increment, timestamp); } /* Returns the server this session is pinned to */ static PHP_METHOD(MongoDB_Driver_Session, getServer) { php_phongo_session_t* intern; uint32_t server_id = 0; intern = Z_SESSION_OBJ_P(getThis()); SESSION_CHECK_LIVELINESS(intern, "getServer") PHONGO_PARSE_PARAMETERS_NONE(); server_id = mongoc_client_session_get_server_id(intern->client_session); /* For sessions without a pinned server, 0 is returned. */ if (!server_id) { RETURN_NULL(); } phongo_server_init(return_value, &intern->manager, server_id); } /* Returns options for the currently running transaction */ static PHP_METHOD(MongoDB_Driver_Session, getTransactionOptions) { php_phongo_session_t* intern; intern = Z_SESSION_OBJ_P(getThis()); SESSION_CHECK_LIVELINESS(intern, "getTransactionOptions") PHONGO_PARSE_PARAMETERS_NONE(); php_phongo_transaction_options_to_zval(intern->client_session, return_value); } /* Returns the current transaction state for this session */ static PHP_METHOD(MongoDB_Driver_Session, getTransactionState) { php_phongo_session_t* intern; const char* state; intern = Z_SESSION_OBJ_P(getThis()); SESSION_CHECK_LIVELINESS(intern, "getTransactionState") PHONGO_PARSE_PARAMETERS_NONE(); state = php_phongo_get_transaction_state_string(mongoc_client_session_get_transaction_state(intern->client_session)); if (!state) { /* Exception already thrown */ return; } RETURN_STRING(state); } /* Creates a opts structure from an array optionally containing an RP, RC, * WC object, and/or maxCommitTimeMS int. Returns NULL if no options were found, * or there was an invalid option. If there was an invalid option or structure, * an exception will be thrown too. */ mongoc_transaction_opt_t* php_mongodb_session_parse_transaction_options(zval* options) { mongoc_transaction_opt_t* opts = NULL; if (php_array_existsc(options, "maxCommitTimeMS")) { int64_t max_commit_time_ms = php_array_fetchc_long(options, "maxCommitTimeMS"); if (max_commit_time_ms < 0) { phongo_throw_exception(PHONGO_ERROR_INVALID_ARGUMENT, "Expected \"maxCommitTimeMS\" option to be >= 0, %" PRId64 " given", max_commit_time_ms); /* Freeing opts is not needed here, as it can't be set yet. The * code is here to keep it consistent with the others in case more * options are added before this one. */ if (opts) { mongoc_transaction_opts_destroy(opts); } return NULL; } if (max_commit_time_ms > UINT32_MAX) { phongo_throw_exception(PHONGO_ERROR_INVALID_ARGUMENT, "Expected \"maxCommitTimeMS\" option to be <= %" PRIu32 ", %" PRId64 " given", UINT32_MAX, max_commit_time_ms); /* Freeing opts is not needed here, as it can't be set yet. The * code is here to keep it consistent with the others in case more * options are added before this one. */ if (opts) { mongoc_transaction_opts_destroy(opts); } return NULL; } if (!opts) { opts = mongoc_transaction_opts_new(); } mongoc_transaction_opts_set_max_commit_time_ms(opts, max_commit_time_ms); } if (php_array_existsc(options, "readConcern")) { zval* read_concern = php_array_fetchc_deref(options, "readConcern"); if (Z_TYPE_P(read_concern) != IS_OBJECT || !instanceof_function(Z_OBJCE_P(read_concern), php_phongo_readconcern_ce)) { phongo_throw_exception(PHONGO_ERROR_INVALID_ARGUMENT, "Expected \"readConcern\" option to be %s, %s given", ZSTR_VAL(php_phongo_readconcern_ce->name), zend_zval_type_name(read_concern)); if (opts) { mongoc_transaction_opts_destroy(opts); } return NULL; } if (!opts) { opts = mongoc_transaction_opts_new(); } mongoc_transaction_opts_set_read_concern(opts, phongo_read_concern_from_zval(read_concern)); } if (php_array_existsc(options, "readPreference")) { zval* read_preference = php_array_fetchc_deref(options, "readPreference"); if (Z_TYPE_P(read_preference) != IS_OBJECT || !instanceof_function(Z_OBJCE_P(read_preference), php_phongo_readpreference_ce)) { phongo_throw_exception(PHONGO_ERROR_INVALID_ARGUMENT, "Expected \"readPreference\" option to be %s, %s given", ZSTR_VAL(php_phongo_readpreference_ce->name), zend_zval_type_name(read_preference)); if (opts) { mongoc_transaction_opts_destroy(opts); } return NULL; } if (!opts) { opts = mongoc_transaction_opts_new(); } mongoc_transaction_opts_set_read_prefs(opts, phongo_read_preference_from_zval(read_preference)); } if (php_array_existsc(options, "writeConcern")) { zval* write_concern = php_array_fetchc_deref(options, "writeConcern"); if (Z_TYPE_P(write_concern) != IS_OBJECT || !instanceof_function(Z_OBJCE_P(write_concern), php_phongo_writeconcern_ce)) { phongo_throw_exception(PHONGO_ERROR_INVALID_ARGUMENT, "Expected \"writeConcern\" option to be %s, %s given", ZSTR_VAL(php_phongo_writeconcern_ce->name), zend_zval_type_name(write_concern)); if (opts) { mongoc_transaction_opts_destroy(opts); } return NULL; } if (!opts) { opts = mongoc_transaction_opts_new(); } mongoc_transaction_opts_set_write_concern(opts, phongo_write_concern_from_zval(write_concern)); } return opts; } /* Starts a new transaction */ static PHP_METHOD(MongoDB_Driver_Session, startTransaction) { php_phongo_session_t* intern; zval* options = NULL; mongoc_transaction_opt_t* txn_options = NULL; bson_error_t error; intern = Z_SESSION_OBJ_P(getThis()); SESSION_CHECK_LIVELINESS(intern, "startTransaction") PHONGO_PARSE_PARAMETERS_START(0, 1) Z_PARAM_OPTIONAL Z_PARAM_ARRAY_OR_NULL(options) PHONGO_PARSE_PARAMETERS_END(); if (options) { txn_options = php_mongodb_session_parse_transaction_options(options); } if (EG(exception)) { return; } if (!mongoc_client_session_start_transaction(intern->client_session, txn_options, &error)) { phongo_throw_exception_from_bson_error_t(&error); } if (txn_options) { mongoc_transaction_opts_destroy(txn_options); } } /* Commits an existing transaction */ static PHP_METHOD(MongoDB_Driver_Session, commitTransaction) { php_phongo_session_t* intern; bson_error_t error; bson_t reply; intern = Z_SESSION_OBJ_P(getThis()); SESSION_CHECK_LIVELINESS(intern, "commitTransaction") PHONGO_PARSE_PARAMETERS_NONE(); if (!mongoc_client_session_commit_transaction(intern->client_session, &reply, &error)) { phongo_throw_exception_from_bson_error_t_and_reply(&error, &reply); } bson_destroy(&reply); } /* Aborts (rolls back) an existing transaction */ static PHP_METHOD(MongoDB_Driver_Session, abortTransaction) { php_phongo_session_t* intern; bson_error_t error; intern = Z_SESSION_OBJ_P(getThis()); SESSION_CHECK_LIVELINESS(intern, "abortTransaction") PHONGO_PARSE_PARAMETERS_NONE(); if (!mongoc_client_session_abort_transaction(intern->client_session, &error)) { phongo_throw_exception_from_bson_error_t(&error); } } /* Ends the session, and a running transaction if active */ static PHP_METHOD(MongoDB_Driver_Session, endSession) { php_phongo_session_t* intern; intern = Z_SESSION_OBJ_P(getThis()); PHONGO_PARSE_PARAMETERS_NONE(); mongoc_client_session_destroy(intern->client_session); intern->client_session = NULL; } /* Returns whether the session is dirty (i.e. was used with a command that encountered a network error) and will be discarded when returned to the server session pool. */ static PHP_METHOD(MongoDB_Driver_Session, isDirty) { php_phongo_session_t* intern = Z_SESSION_OBJ_P(getThis()); SESSION_CHECK_LIVELINESS(intern, "isDirty") PHONGO_PARSE_PARAMETERS_NONE(); RETVAL_BOOL(mongoc_client_session_get_dirty(intern->client_session)); } /* Returns whether a multi-document transaction is in progress */ static PHP_METHOD(MongoDB_Driver_Session, isInTransaction) { php_phongo_session_t* intern; intern = Z_SESSION_OBJ_P(getThis()); SESSION_CHECK_LIVELINESS(intern, "isInTransaction") PHONGO_PARSE_PARAMETERS_NONE(); RETURN_BOOL(mongoc_client_session_in_transaction(intern->client_session)); } /* MongoDB\Driver\Session object handlers */ static zend_object_handlers php_phongo_handler_session; static void php_phongo_session_free_object(zend_object* object) { php_phongo_session_t* intern = Z_OBJ_SESSION(object); zend_object_std_dtor(&intern->std); /* If this Session was created in a different process, reset the client so * that its session pool is cleared and mongoc_client_session_destroy will * destroy the corresponding server session rather than return it to the * now-empty pool. This will ensure that we do not re-use a server session * (i.e. LSID) created by a parent process. */ PHONGO_RESET_CLIENT_IF_PID_DIFFERS(intern, Z_MANAGER_OBJ_P(&intern->manager)); if (intern->client_session) { mongoc_client_session_destroy(intern->client_session); } if (!Z_ISUNDEF(intern->manager)) { zval_ptr_dtor(&intern->manager); } } static zend_object* php_phongo_session_create_object(zend_class_entry* class_type) { php_phongo_session_t* intern = zend_object_alloc(sizeof(php_phongo_session_t), class_type); zend_object_std_init(&intern->std, class_type); object_properties_init(&intern->std, class_type); PHONGO_SET_CREATED_BY_PID(intern); intern->std.handlers = &php_phongo_handler_session; return &intern->std; } static HashTable* php_phongo_session_get_debug_info(zend_object* object, int* is_temp) { php_phongo_session_t* intern = NULL; zval retval = ZVAL_STATIC_INIT; *is_temp = 1; intern = Z_OBJ_SESSION(object); array_init(&retval); if (!intern->client_session) { ADD_ASSOC_BOOL_EX(&retval, "ended", true); goto done; } { const bson_t* lsid = mongoc_client_session_get_lsid(intern->client_session); php_phongo_bson_state state; PHONGO_BSON_INIT_DEBUG_STATE(state); if (!php_phongo_bson_to_zval_ex(lsid, &state)) { zval_ptr_dtor(&state.zchild); goto done; } ADD_ASSOC_ZVAL_EX(&retval, "logicalSessionId", &state.zchild); } { const bson_t* cluster_time = mongoc_client_session_get_cluster_time(intern->client_session); if (cluster_time) { php_phongo_bson_state state; PHONGO_BSON_INIT_DEBUG_STATE(state); if (!php_phongo_bson_to_zval_ex(cluster_time, &state)) { zval_ptr_dtor(&state.zchild); goto done; } ADD_ASSOC_ZVAL_EX(&retval, "clusterTime", &state.zchild); } else { ADD_ASSOC_NULL_EX(&retval, "clusterTime"); } } { const mongoc_session_opt_t* cs_opts = mongoc_client_session_get_opts(intern->client_session); ADD_ASSOC_BOOL_EX(&retval, "causalConsistency", mongoc_session_opts_get_causal_consistency(cs_opts)); ADD_ASSOC_BOOL_EX(&retval, "snapshot", mongoc_session_opts_get_snapshot(cs_opts)); } { uint32_t timestamp, increment; mongoc_client_session_get_operation_time(intern->client_session, ×tamp, &increment); if (timestamp && increment) { zval ztimestamp; if (!phongo_timestamp_new(&ztimestamp, increment, timestamp)) { /* Exception should already have been thrown */ goto done; } ADD_ASSOC_ZVAL_EX(&retval, "operationTime", &ztimestamp); } else { ADD_ASSOC_NULL_EX(&retval, "operationTime"); } } { uint32_t server_id = mongoc_client_session_get_server_id(intern->client_session); if (server_id) { zval server; phongo_server_init(&server, &intern->manager, server_id); ADD_ASSOC_ZVAL_EX(&retval, "server", &server); } else { ADD_ASSOC_NULL_EX(&retval, "server"); } } ADD_ASSOC_BOOL_EX(&retval, "dirty", mongoc_client_session_get_dirty(intern->client_session)); ADD_ASSOC_BOOL_EX(&retval, "inTransaction", mongoc_client_session_in_transaction(intern->client_session)); { const char* state = php_phongo_get_transaction_state_string(mongoc_client_session_get_transaction_state(intern->client_session)); if (!state) { /* Exception should already have been thrown */ goto done; } ADD_ASSOC_STRING(&retval, "transactionState", state); } { zval txn_opts; php_phongo_transaction_options_to_zval(intern->client_session, &txn_opts); ADD_ASSOC_ZVAL_EX(&retval, "transactionOptions", &txn_opts); } done: return Z_ARRVAL(retval); } void php_phongo_session_init_ce(INIT_FUNC_ARGS) { php_phongo_session_ce = register_class_MongoDB_Driver_Session(); php_phongo_session_ce->create_object = php_phongo_session_create_object; memcpy(&php_phongo_handler_session, phongo_get_std_object_handlers(), sizeof(zend_object_handlers)); php_phongo_handler_session.get_debug_info = php_phongo_session_get_debug_info; php_phongo_handler_session.free_obj = php_phongo_session_free_object; php_phongo_handler_session.offset = XtOffsetOf(php_phongo_session_t, std); } void phongo_session_init(zval* return_value, zval* manager, mongoc_client_session_t* client_session) { php_phongo_session_t* session; object_init_ex(return_value, php_phongo_session_ce); session = Z_SESSION_OBJ_P(return_value); session->client_session = client_session; ZVAL_ZVAL(&session->manager, manager, 1, 0); }