+global\EE_Base_Class::save()

Complexity

Conditions	16
Paths	24

Size

Total Lines	110
Code Lines	60

Duplication

Lines	0
Ratio	0 %

Importance

Changes

0

<?php
    public function save($set_cols_n_values = array())
    {
        $model = $this->get_model();
        /**
         * Filters the fields we're about to save on the model object
         *
         * @param array         $set_cols_n_values
         * @param EE_Base_Class $model_object
         */
        $set_cols_n_values = (array)apply_filters('FHEE__EE_Base_Class__save__set_cols_n_values', $set_cols_n_values,
            $this);
        //set attributes as provided in $set_cols_n_values
        foreach ($set_cols_n_values as $column => $value) {
            $this->set($column, $value);
        }
        // no changes ? then don't do anything
        if (! $this->_has_changes && $this->ID() && $model->get_primary_key_field()->is_auto_increment()) {
            return 0;
        }
        /**
         * Saving a model object.
         * Before we perform a save, this action is fired.
         *
         * @param EE_Base_Class $model_object the model object about to be saved.
         */
        do_action('AHEE__EE_Base_Class__save__begin', $this);
        if ( ! $this->allow_persist()) {
            return 0;
        }
        //now get current attribute values
        $save_cols_n_values = $this->_fields;
        //if the object already has an ID, update it. Otherwise, insert it
        //also: change the assumption about values passed to the model NOT being prepare dby the model object. They have been
        $old_assumption_concerning_value_preparation = $model
                                                            ->get_assumption_concerning_values_already_prepared_by_model_object();
        $model->assume_values_already_prepared_by_model_object(true);
        //does this model have an autoincrement PK?
        if ($model->has_primary_key_field()) {
            if ($model->get_primary_key_field()->is_auto_increment()) {
                //ok check if it's set, if so: update; if not, insert
                if ( ! empty($save_cols_n_values[$model->primary_key_name()])) {
                    $results = $model->update_by_ID($save_cols_n_values, $this->ID());
                } else {
                    unset($save_cols_n_values[$model->primary_key_name()]);
                    $results = $model->insert($save_cols_n_values);
                    if ($results) {
                        //if successful, set the primary key
                        //but don't use the normal SET method, because it will check if
                        //an item with the same ID exists in the mapper & db, then
                        //will find it in the db (because we just added it) and THAT object
                        //will get added to the mapper before we can add this one!
                        //but if we just avoid using the SET method, all that headache can be avoided
                        $pk_field_name = $model->primary_key_name();
                        $this->_fields[$pk_field_name] = $results;
                        $this->_clear_cached_property($pk_field_name);
                        $model->add_to_entity_map($this);
                        $this->_update_cached_related_model_objs_fks();
                    }
                }
            } else {//PK is NOT auto-increment
                //so check if one like it already exists in the db
                if ($model->exists_by_ID($this->ID())) {
                    if (WP_DEBUG && ! $this->in_entity_map()) {
                        throw new EE_Error(
                            sprintf(
                                __('Using a model object %1$s that is NOT in the entity map, can lead to unexpected errors. You should either: %4$s 1. Put it in the entity mapper by calling %2$s %4$s 2. Discard this model object and use what is in the entity mapper %4$s 3. Fetch from the database using %3$s',
                                    'event_espresso'),
                                get_class($this),
                                get_class($model) . '::instance()->add_to_entity_map()',
                                get_class($model) . '::instance()->get_one_by_ID()',
                                '<br />'
                            )
                        );
                    }
                    $results = $model->update_by_ID($save_cols_n_values, $this->ID());
                } else {
                    $results = $model->insert($save_cols_n_values);
                    $this->_update_cached_related_model_objs_fks();
                }
            }
        } else {//there is NO primary key
            $already_in_db = false;
            foreach ($model->unique_indexes() as $index) {
                $uniqueness_where_params = array_intersect_key($save_cols_n_values, $index->fields());
                if ($model->exists(array($uniqueness_where_params))) {
                    $already_in_db = true;
                }
            }
            if ($already_in_db) {
                $combined_pk_fields_n_values = array_intersect_key($save_cols_n_values,
                    $model->get_combined_primary_key_fields());
                $results = $model->update($save_cols_n_values, $combined_pk_fields_n_values);
            } else {
                $results = $model->insert($save_cols_n_values);
            }
        }
        //restore the old assumption about values being prepared by the model object
        $model
             ->assume_values_already_prepared_by_model_object($old_assumption_concerning_value_preparation);
        /**
         * After saving the model object this action is called
         *
         * @param EE_Base_Class $model_object which was just saved
         * @param boolean|int   $results      if it were updated, TRUE or FALSE; if it were newly inserted
         *                                    the new ID (or 0 if an error occurred and it wasn't updated)
         */
        do_action('AHEE__EE_Base_Class__save__end', $this, $results);
        $this->_has_changes = false;
        return $results;
    }