class backup_migrate_destination_email in Backup and Migrate 8.3

A destination for emailing database backups.

Hierarchy

• class \backup_migrate_item
  • class \backup_migrate_location
    • class \backup_migrate_destination
      • class \backup_migrate_destination_email

1 string reference to 'backup_migrate_destination_email'

backup_migrate_backup_migrate_destination_subtypes in includes/destinations.inc

Implementation of hook_backup_migrate_destination_subtypes().

File

includes/destinations.email.inc, line 14

Functions to handle the email backup destination.

class backup_migrate_destination_email extends backup_migrate_destination {
  var $supported_ops = array(
    'scheduled backup',
    'manual backup',
    'remote backup',
    'configure',
  );

  /**
   * Save to (ie. email the file) to the email destination.
   */
  function save_file($file, $settings) {
    $size = filesize($file
      ->filepath());
    $max = variable_get('backup_migrate_max_email_size', 20971520);
    if ($size > $max) {
      _backup_migrate_message('Could not email the file @file because it is @size and Backup and Migrate only supports emailing files smaller than @max.', array(
        '@file' => $file
          ->filename(),
        '@size' => format_size($size),
        '@max' => format_size($max),
      ), 'error');
      return FALSE;
    }
    $attachment = new stdClass();
    $attachment->filename = $file
      ->filename();
    $attachment->path = $file
      ->filepath();
    _backup_migrate_destination_email_mail_backup($attachment, $this
      ->get_location());
    return $file;
  }

  /**
   * Get the form for the settings for this filter.
   */
  function edit_form() {
    $form = parent::edit_form();
    $form['location'] = array(
      "#type" => "textfield",
      "#title" => t("Email Address"),
      "#default_value" => $this
        ->get_location(),
      "#required" => TRUE,
      "#description" => t('Enter the email address to send the backup files to. Make sure the email sever can handle large file attachments'),
    );
    return $form;
  }

  /**
   * Validate the configuration form. Make sure the email address is valid.
   */
  function settings_form_validate($values) {
    if (!valid_email_address($values['location'])) {
      form_set_error('[location]', t('The e-mail address %mail is not valid.', array(
        '%mail' => $form_state['values']['location'],
      )));
    }
  }

}

Members

Name	Modifiers	Type	Description	Overrides
backup_migrate_destination::$cache_expire		property
backup_migrate_destination::$cache_files		property		2
backup_migrate_destination::$db_table		property	Overrides backup_migrate_location::$db_table
backup_migrate_destination::$default_values		property	Overrides backup_migrate_location::$default_values
backup_migrate_destination::$destination_type		property
backup_migrate_destination::$fetch_time		property
backup_migrate_destination::$plural		property	Overrides backup_migrate_location::$plural
backup_migrate_destination::$singular		property	Overrides backup_migrate_location::$singular
backup_migrate_destination::$title_plural		property	Overrides backup_migrate_location::$title_plural
backup_migrate_destination::$title_singular		property	Overrides backup_migrate_location::$title_singular
backup_migrate_destination::$type_name		property	Overrides backup_migrate_location::$type_name
backup_migrate_destination::$weight		property		1
backup_migrate_destination::can_delete_file		function	Determine if we can read the given file.
backup_migrate_destination::can_read_file		function	Determine if we can read the given file. Overrides backup_migrate_location::can_read_file	1
backup_migrate_destination::confirm_destination		function	Check that a destination is valid.	2
backup_migrate_destination::count_files		function	List all the available files in the given destination with their destination specific id.
backup_migrate_destination::create_info_file		function	Create an ini file and write the meta data.
backup_migrate_destination::delete_confirm_message		function	Get the message to send to the user when confirming the deletion of the item. Overrides backup_migrate_location::delete_confirm_message
backup_migrate_destination::delete_file		function	Delete the file with the given destination specific id.	1
backup_migrate_destination::file_cache_clear		function	Retrieve the file list.
backup_migrate_destination::file_cache_get		function	Retrieve the file list.
backup_migrate_destination::file_cache_set		function	Cache the file list.
backup_migrate_destination::file_exists		function	Check if a file exists in the given destination.
backup_migrate_destination::get_action_links		function	Get the action links for a destination. Overrides backup_migrate_location::get_action_links
backup_migrate_destination::get_file_links		function	Get the action links for a file on a given destination.
backup_migrate_destination::get_menu_items		function	Add the menu items specific to the destination type. Overrides backup_migrate_item::get_menu_items	1
backup_migrate_destination::get_remote		function	Get a boolean representing if the destination is remote or local.
backup_migrate_destination::list_files		function	List all the available files in the given destination with their destination specific id.
backup_migrate_destination::load_file		function	Load the file with the given destination specific id and return as a backup_file object.	5
backup_migrate_destination::load_files_info		function	Load up the file's metadata from the accompanying .info file if applicable.
backup_migrate_destination::save_file_info		function	Save the file metadata
backup_migrate_destination::settings_default		function	Get the form for the settings for this destination type. Overrides backup_migrate_location::settings_default
backup_migrate_destination::settings_form		function	Get the form for the settings for this destination. Overrides backup_migrate_location::settings_form
backup_migrate_destination::settings_form_submit		function	Submit the settings form. Any values returned will be saved. Overrides backup_migrate_location::settings_form_submit
backup_migrate_destination::strings		function	This function is not supposed to be called. It is just here to help the po extractor out. Overrides backup_migrate_location::strings
backup_migrate_destination::_delete_file		function	Delete the file with the given destination specific id.	3
backup_migrate_destination::_file_info_file		function	Create the info file object.
backup_migrate_destination::_file_info_filename		function	Determine the file name of the info file for a file.
backup_migrate_destination::_list_files		function	List all the available files in the given destination with their destination specific id.	4
backup_migrate_destination::_save_file		function	Save the given file to the destination.	3
backup_migrate_destination_email::$supported_ops		property	Overrides backup_migrate_destination::$supported_ops
backup_migrate_destination_email::edit_form		function	Get the form for the settings for this filter. Overrides backup_migrate_destination::edit_form
backup_migrate_destination_email::save_file		function	Save to (ie. email the file) to the email destination. Overrides backup_migrate_destination::save_file
backup_migrate_destination_email::settings_form_validate		function	Validate the configuration form. Make sure the email address is valid. Overrides backup_migrate_destination::settings_form_validate
backup_migrate_item::$settings_path		property
backup_migrate_item::$show_in_list		property
backup_migrate_item::$storage		property
backup_migrate_item::all_items		function	Get all of the given items.
backup_migrate_item::decode_db_row		function	Decode a loaded db row (unserialize necessary fields).
backup_migrate_item::delete		function	Delete the item from the database.
backup_migrate_item::edit_form_submit		function	Submit the edit form for the item.	6
backup_migrate_item::edit_form_validate		function	Validate the edit form for the item.	5
backup_migrate_item::export		function	Return as an exported array of values.
backup_migrate_item::from_array		function	Load an existing item from an array.
backup_migrate_item::generate_id		function	Return a random (very very likely unique) string id for a new item.
backup_migrate_item::get		function	Get the member with the given key.
backup_migrate_item::get_actions		function	Get the rendered action links for a destination.
backup_migrate_item::get_default_values		function	Get the default values for standard parameters.	2
backup_migrate_item::get_id		function	Get the primary id for this item (if any is set).
backup_migrate_item::get_list		function	Get a table of all items of this type.	1
backup_migrate_item::get_list_header		function	Get header for a lost of this type.
backup_migrate_item::get_machine_name_field		function	Get the machine name field name from the schema.
backup_migrate_item::get_primary_key		function	Get the primary key field title from the schema.
backup_migrate_item::get_schema		function	Get the schema for the item type.
backup_migrate_item::get_serialized_fields		function	Return the fields which must be serialized before saving to the db.
backup_migrate_item::get_settings_path		function	Get the columns needed to list the type.	1
backup_migrate_item::item		function	A particular item.
backup_migrate_item::item_exists		function	A particular item.
backup_migrate_item::load_row		function	Load an existing item from an database (serialized) array.
backup_migrate_item::revert_confirm_message		function	Get the message to send to the user when confirming the deletion of the item.
backup_migrate_item::save		function	Save the item to the database.
backup_migrate_item::set_id		function	Set the primary id for this item (if any is set).
backup_migrate_item::show_in_list		function	Get the columns needed to list the type.
backup_migrate_item::to_array		function	Return as an array of values.	1
backup_migrate_item::unique_id		function	Make sure this item has a unique id. Should only be called for new items or the item will collide with itself.
backup_migrate_item::_merge_defaults		function	Merge parameters with the given defaults.
backup_migrate_item::__construct		function	Constructor, set the basic info pulled from the db or generated programatically.	4
backup_migrate_location::$subtype		property
backup_migrate_location::backup_settings_default		function	Get the form for the settings for this filter.	3
backup_migrate_location::backup_settings_form		function	Get the form for the settings for this filter.	3
backup_migrate_location::backup_settings_form_submit		function	Submit the settings form. Any values returned will be saved.
backup_migrate_location::backup_settings_form_validate		function	Get the form for the settings for this filter.
backup_migrate_location::create		function	Create a new location of the correct type. Overrides backup_migrate_item::create
backup_migrate_location::file_types		function	Retrieve a list of filetypes supported by this source/destination.	3
backup_migrate_location::get_display_location		function		4
backup_migrate_location::get_list_column_info		function	Get the columns needed to list the type. Overrides backup_migrate_item::get_list_column_info
backup_migrate_location::get_list_row		function	Get a row of data to be used in a list of items of this type. Overrides backup_migrate_item::get_list_row	1
backup_migrate_location::get_location		function		3
backup_migrate_location::get_name		function	Get the name of the item. Overrides backup_migrate_item::get_name	1
backup_migrate_location::get_subtype_name		function	Get the type name of this location for display to the user.
backup_migrate_location::glue_url		function	Glue a URLs component parts back into a URL.	1
backup_migrate_location::location_types		function	Get the available location types.	1
backup_migrate_location::op		function	Does this location support the given operation.
backup_migrate_location::ops		function
backup_migrate_location::remove_op		function	Remove the given op from the support list.
backup_migrate_location::restore_settings_default		function	Get the form for the settings for this filter.
backup_migrate_location::restore_settings_form		function	Get the form for the settings for this filter.
backup_migrate_location::restore_settings_form_submit		function	Submit the settings form. Any values returned will be saved.
backup_migrate_location::restore_settings_form_validate		function	Get the form for the settings for this filter.
backup_migrate_location::settings		function
backup_migrate_location::set_location		function		3
backup_migrate_location::set_name		function
backup_migrate_location::set_url		function	Break a URL into it's component parts.	1
backup_migrate_location::url		function	Get a url from the parts.	1