编辑文件

编辑文件：class-wc-shipping-zone-data-store.php

<?php
/**
 * Class WC_Shipping_Zone_Data_Store file.
 *
 * @package WooCommerce\DataStores
 */

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * WC Shipping Zone Data Store.
 *
 * @version  3.0.0
 */
class WC_Shipping_Zone_Data_Store extends WC_Data_Store_WP implements WC_Object_Data_Store_Interface, WC_Shipping_Zone_Data_Store_Interface {

/**
	 * Method to create a new shipping zone.
	 *
	 * @since 3.0.0
	 * @param WC_Shipping_Zone $zone Shipping zone object.
	 */
	public function create( &$zone ) {
		global $wpdb;
		$wpdb->insert(
			$wpdb->prefix . 'woocommerce_shipping_zones',
			array(
				'zone_name'  => $zone->get_zone_name(),
				'zone_order' => $zone->get_zone_order(),
			)
		);
		$zone->set_id( $wpdb->insert_id );
		$zone->save_meta_data();
		$this->save_locations( $zone );
		$zone->apply_changes();
		WC_Cache_Helper::invalidate_cache_group( 'shipping_zones' );
		WC_Cache_Helper::get_transient_version( 'shipping', true );
	}

/**
	 * Update zone in the database.
	 *
	 * @since 3.0.0
	 * @param WC_Shipping_Zone $zone Shipping zone object.
	 */
	public function update( &$zone ) {
		global $wpdb;
		if ( $zone->get_id() ) {
			$wpdb->update(
				$wpdb->prefix . 'woocommerce_shipping_zones',
				array(
					'zone_name'  => $zone->get_zone_name(),
					'zone_order' => $zone->get_zone_order(),
				),
				array( 'zone_id' => $zone->get_id() )
			);
		}
		$zone->save_meta_data();
		$this->save_locations( $zone );
		$zone->apply_changes();
		WC_Cache_Helper::invalidate_cache_group( 'shipping_zones' );
		WC_Cache_Helper::get_transient_version( 'shipping', true );
	}

/**
	 * Method to read a shipping zone from the database.
	 *
	 * @since 3.0.0
	 * @param WC_Shipping_Zone $zone Shipping zone object.
	 * @throws Exception If invalid data store.
	 */
	public function read( &$zone ) {
		$zones = array( $zone->get_id() => $zone );
		$this->read_multiple( $zones );
	}

/**
	 * Reads multiple WC_Shipping_Zone objects from the data store.
	 *
	 * @param WC_Shipping_Zone[] $zones Array of zones to read keyed by the zone_id.
	 *
	 * @return void
	 *
	 * @throws Exception If invalid zone_id givein for data store.
	 */
	public function read_multiple( array &$zones ) {
		$zone_ids  = array_keys( $zones );
		$zone_data = $this->get_zone_data_for_ids( $zone_ids );
		foreach ( $zones as $zone_id => $zone ) {
			if ( 0 === $zone_id || '0' === $zone_id ) {
				$zone->set_zone_name( __( 'Locations not covered by your other zones', 'woocommerce' ) );
			} else {
				if ( ! isset( $zone_data[ $zone_id ] ) ) {
					throw new Exception( __( 'Invalid data store.', 'woocommerce' ) ); // phpcs:ignore WordPress.Security.EscapeOutput.ExceptionNotEscaped
				}
				$zone->set_zone_name( $zone_data[ $zone_id ]->zone_name );
				$zone->set_zone_order( $zone_data[ $zone_id ]->zone_order );
			}
		}

$zone_locations = $this->get_zone_locations_for_ids( $zone_ids );
		foreach ( $zone_locations as $zone_location ) {
			if ( isset( $zones[ $zone_location->zone_id ] ) ) {
				$zones[ $zone_location->zone_id ]->add_location( $zone_location->location_code, $zone_location->location_type );
			}
		}

foreach ( $zones as $zone_id => $zone ) {
			$zone->set_object_read( true );
			/**
			 * Indicate that the WooCommerce shipping zone has been loaded.
			 *
			 * @param WC_Shipping_Zone $zone The shipping zone that has been loaded.
			 */
			do_action( 'woocommerce_shipping_zone_loaded', $zone );
		}
	}

/**
	 * Retrieve the zone data for the given zone_ids.
	 *
	 * @param array $ids The zone_ids to retrieve.
	 *
	 * @return stdClass[] An array of objects containing the zone data, keyed by the zone_id.
	 */
	private function get_zone_data_for_ids( array $ids ) {
		global $wpdb;

if ( empty( $ids ) || array( '0' ) === $ids || array( 0 ) === $ids ) {
			return array();
		}

$zone_ids = array_map( 'absint', $ids );

// phpcs:disable WordPress.DB.PreparedSQL.NotPrepared -- $zone_ids already run through absint.
		return $wpdb->get_results(
			"SELECT zone_id, zone_name, zone_order FROM {$wpdb->prefix}woocommerce_shipping_zones " .
			'WHERE zone_id IN ( ' . implode( ',', $zone_ids ) . ' ) ',
			OBJECT_K
		);
		// phpcs:enable WordPress.DB.PreparedSQL.NotPrepared
	}

/**
	 * Retrieve the zone location data for the given zone_ids.
	 *
	 * @param array $ids The zone_ids to retrieve.
	 *
	 * @return stdClass[] An array of objects containing the zone_id, location_code, and location_type for each zone location.
	 */
	private function get_zone_locations_for_ids( array $ids ) {
		global $wpdb;

if ( empty( $ids ) || array( '0' ) === $ids || array( 0 ) === $ids ) {
			return array();
		}

$zone_ids = array_map( 'absint', $ids );
		// phpcs:disable WordPress.DB.PreparedSQL.NotPrepared -- $zone_ids already run through absint.
		return $wpdb->get_results(
			"SELECT zone_id, location_code, location_type FROM {$wpdb->prefix}woocommerce_shipping_zone_locations " .
			'WHERE zone_id IN ( ' . implode( ',', $zone_ids ) . ' ) '
		);
		// phpcs:enable WordPress.DB.PreparedSQL.NotPrepared
	}

/**
	 * Deletes a shipping zone from the database.
	 *
	 * @since  3.0.0
	 * @param  WC_Shipping_Zone $zone Shipping zone object.
	 * @param  array            $args Array of args to pass to the delete method.
	 * @return void
	 */
	public function delete( &$zone, $args = array() ) {
		$zone_id = $zone->get_id();

if ( $zone_id ) {
			global $wpdb;

// Delete methods and their settings.
			$methods = $this->get_methods( $zone_id, false );

if ( $methods ) {
				foreach ( $methods as $method ) {
					$this->delete_method( $method->instance_id );
				}
			}

// Delete zone.
			$wpdb->delete( $wpdb->prefix . 'woocommerce_shipping_zone_locations', array( 'zone_id' => $zone_id ) );
			$wpdb->delete( $wpdb->prefix . 'woocommerce_shipping_zones', array( 'zone_id' => $zone_id ) );

$zone->set_id( null );

WC_Cache_Helper::invalidate_cache_group( 'shipping_zones' );
			WC_Cache_Helper::get_transient_version( 'shipping', true );

do_action( 'woocommerce_delete_shipping_zone', $zone_id );
		}
	}

/**
	 * Get a list of shipping methods for a specific zone.
	 *
	 * @since  3.0.0
	 * @param  int  $zone_id      Zone ID.
	 * @param  bool $enabled_only True to request enabled methods only.
	 * @return array               Array of objects containing method_id, method_order, instance_id, is_enabled
	 */
	public function get_methods( $zone_id, $enabled_only ) {
		global $wpdb;

if ( $enabled_only ) {
			$raw_methods_sql = "SELECT method_id, method_order, instance_id, is_enabled FROM {$wpdb->prefix}woocommerce_shipping_zone_methods WHERE zone_id = %d AND is_enabled = 1";
		} else {
			$raw_methods_sql = "SELECT method_id, method_order, instance_id, is_enabled FROM {$wpdb->prefix}woocommerce_shipping_zone_methods WHERE zone_id = %d";
		}

return $wpdb->get_results( $wpdb->prepare( $raw_methods_sql, $zone_id ) ); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
	}

/**
	 * Get count of methods for a zone.
	 *
	 * @since  3.0.0
	 * @param  int $zone_id Zone ID.
	 * @return int Method Count
	 */
	public function get_method_count( $zone_id ) {
		global $wpdb;
		return $wpdb->get_var( $wpdb->prepare( "SELECT COUNT(*) FROM {$wpdb->prefix}woocommerce_shipping_zone_methods WHERE zone_id = %d", $zone_id ) );
	}

/**
	 * Add a shipping method to a zone.
	 *
	 * @since  3.0.0
	 * @param  int    $zone_id Zone ID.
	 * @param  string $type    Method Type/ID.
	 * @param  int    $order   Method Order.
	 * @return int             Instance ID
	 */
	public function add_method( $zone_id, $type, $order ) {
		global $wpdb;
		$wpdb->insert(
			$wpdb->prefix . 'woocommerce_shipping_zone_methods',
			array(
				'method_id'    => $type,
				'zone_id'      => $zone_id,
				'method_order' => $order,
			),
			array(
				'%s',
				'%d',
				'%d',
			)
		);
		return $wpdb->insert_id;
	}

/**
	 * Delete a method instance.
	 *
	 * @since 3.0.0
	 * @param int $instance_id Instance ID.
	 */
	public function delete_method( $instance_id ) {
		global $wpdb;

$method = $this->get_method( $instance_id );

if ( ! $method ) {
			return;
		}

delete_option( 'woocommerce_' . $method->method_id . '_' . $instance_id . '_settings' );

$wpdb->delete( $wpdb->prefix . 'woocommerce_shipping_zone_methods', array( 'instance_id' => $instance_id ) );

do_action( 'woocommerce_delete_shipping_zone_method', $instance_id );
	}

/**
	 * Get a shipping zone method instance.
	 *
	 * @since  3.0.0
	 * @param  int $instance_id Instance ID.
	 * @return object
	 */
	public function get_method( $instance_id ) {
		global $wpdb;
		return $wpdb->get_row( $wpdb->prepare( "SELECT zone_id, method_id, instance_id, method_order, is_enabled FROM {$wpdb->prefix}woocommerce_shipping_zone_methods WHERE instance_id = %d LIMIT 1;", $instance_id ) );
	}

/**
	 * Find a matching zone ID for a given package.
	 *
	 * @since  3.0.0
	 * @param  object $package Package information.
	 * @return int
	 */
	public function get_zone_id_from_package( $package ) {
		global $wpdb;

$country   = strtoupper( wc_clean( $package['destination']['country'] ) );
		$state     = strtoupper( wc_clean( $package['destination']['state'] ) );
		$continent = strtoupper( wc_clean( WC()->countries->get_continent_code_for_country( $country ) ) );
		$postcode  = wc_normalize_postcode( wc_clean( $package['destination']['postcode'] ) );

// Work out criteria for our zone search.
		$criteria   = array();
		$criteria[] = $wpdb->prepare( "( ( location_type = 'country' AND location_code = %s )", $country );
		$criteria[] = $wpdb->prepare( "OR ( location_type = 'state' AND location_code = %s )", $country . ':' . $state );
		$criteria[] = $wpdb->prepare( "OR ( location_type = 'continent' AND location_code = %s )", $continent );
		$criteria[] = 'OR ( location_type IS NULL ) )';

// Postcode range and wildcard matching.
		$postcode_locations = $wpdb->get_results( "SELECT zone_id, location_code FROM {$wpdb->prefix}woocommerce_shipping_zone_locations WHERE location_type = 'postcode';" );

if ( $postcode_locations ) {
			$zone_ids_with_postcode_rules = array_map( 'absint', wp_list_pluck( $postcode_locations, 'zone_id' ) );
			$matches                      = wc_postcode_location_matcher( $postcode, $postcode_locations, 'zone_id', 'location_code', $country );
			$do_not_match                 = array_unique( array_diff( $zone_ids_with_postcode_rules, array_keys( $matches ) ) );

if ( ! empty( $do_not_match ) ) {
				$criteria[] = 'AND zones.zone_id NOT IN (' . implode( ',', $do_not_match ) . ')';
			}
		}

/**
		 * Get shipping zone criteria
		 *
		 * @since 3.6.6
		 * @param array $criteria Get zone criteria.
		 * @param array $package Package information.
		 * @param array $postcode_locations Postcode range and wildcard matching.
		 */
		$criteria = apply_filters( 'woocommerce_get_zone_criteria', $criteria, $package, $postcode_locations );

// Get matching zones.
		return $wpdb->get_var(
			"SELECT zones.zone_id FROM {$wpdb->prefix}woocommerce_shipping_zones as zones
			LEFT OUTER JOIN {$wpdb->prefix}woocommerce_shipping_zone_locations as locations ON zones.zone_id = locations.zone_id AND location_type != 'postcode'
			WHERE " . implode( ' ', $criteria ) // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
			. ' ORDER BY zone_order ASC, zones.zone_id ASC LIMIT 1'
		);
	}

/**
	 * Return an ordered list of zones.
	 *
	 * @since 3.0.0
	 * @return array An array of objects containing a zone_id, zone_name, and zone_order.
	 */
	public function get_zones() {
		global $wpdb;
		return $wpdb->get_results( "SELECT zone_id, zone_name, zone_order FROM {$wpdb->prefix}woocommerce_shipping_zones order by zone_order ASC, zone_id ASC;" );
	}

/**
	 * Return a zone ID from an instance ID.
	 *
	 * @since  3.0.0
	 * @param  int $id Instance ID.
	 * @return int
	 */
	public function get_zone_id_by_instance_id( $id ) {
		global $wpdb;
		return $wpdb->get_var( $wpdb->prepare( "SELECT zone_id FROM {$wpdb->prefix}woocommerce_shipping_zone_methods as methods WHERE methods.instance_id = %d LIMIT 1;", $id ) );
	}

/**
	 * Save locations to the DB.
	 * This function clears old locations, then re-inserts new if any changes are found.
	 *
	 * @since 3.0.0
	 *
	 * @param WC_Shipping_Zone $zone Shipping zone object.
	 *
	 * @return bool|void
	 */
	private function save_locations( &$zone ) {
		$changed_props = array_keys( $zone->get_changes() );
		if ( ! in_array( 'zone_locations', $changed_props, true ) ) {
			return false;
		}

global $wpdb;
		$wpdb->delete( $wpdb->prefix . 'woocommerce_shipping_zone_locations', array( 'zone_id' => $zone->get_id() ) );

foreach ( $zone->get_zone_locations( 'edit' ) as $location ) {
			$wpdb->insert(
				$wpdb->prefix . 'woocommerce_shipping_zone_locations',
				array(
					'zone_id'       => $zone->get_id(),
					'location_code' => $location->code,
					'location_type' => $location->type,
				)
			);
		}
	}

/**
	 * Shipping zones do not support meta data.
	 *
	 * This override prevents the parent class from incorrectly reading from wp_postmeta,
	 * which would happen because shipping zones use their own table but there is no
	 * corresponding shipping zone meta table.
	 *
	 * @since 10.5.0
	 * @param WC_Shipping_Zone $zone Shipping zone object.
	 * @return array Empty array - shipping zones have no meta table.
	 */
	public function read_meta( &$zone ) {
		return array();
	}

/**
	 * Shipping zones do not support meta data.
	 *
	 * @since 10.5.0
	 * @param WC_Shipping_Zone $zone Shipping zone object.
	 * @param stdClass         $meta Meta object (containing at least ->id).
	 * @return array Empty array - no meta was deleted.
	 */
	public function delete_meta( &$zone, $meta ) {
		wc_get_logger()->warning(
			'Attempted to delete meta from a shipping zone, but shipping zones do not support meta data.',
			array(
				'source'    => 'shipping_zone_data_store',
				'zone_id'   => $zone->get_id(),
				'backtrace' => true,
			)
		);
		return array();
	}

/**
	 * Shipping zones do not support meta data.
	 *
	 * Returns 0 to indicate no meta was added. Valid meta IDs are always positive
	 * integers, so 0 indicates failure while remaining type-compatible with parent.
	 *
	 * @since 10.5.0
	 * @param WC_Shipping_Zone $zone Shipping zone object.
	 * @param stdClass         $meta Meta object (containing ->key and ->value).
	 * @return int Always returns 0 as shipping zones do not support meta storage.
	 */
	public function add_meta( &$zone, $meta ) {
		wc_get_logger()->warning(
			'Attempted to add meta to a shipping zone, but shipping zones do not support meta data.',
			array(
				'source'    => 'shipping_zone_data_store',
				'zone_id'   => $zone->get_id(),
				'key'       => $meta->key ?? '',
				'backtrace' => true,
			)
		);
		return 0;
	}

/**
	 * Shipping zones do not support meta data.
	 *
	 * @since 10.5.0
	 * @param WC_Shipping_Zone $zone Shipping zone object.
	 * @param stdClass         $meta Meta object (containing ->id, ->key and ->value).
	 * @return bool False - meta was not updated.
	 */
	public function update_meta( &$zone, $meta ) {
		wc_get_logger()->warning(
			'Attempted to update meta on a shipping zone, but shipping zones do not support meta data.',
			array(
				'source'    => 'shipping_zone_data_store',
				'zone_id'   => $zone->get_id(),
				'key'       => $meta->key ?? '',
				'backtrace' => true,
			)
		);
		return false;
	}
}