Drupal 8 Commerce自定义模块加载客户地址档案问题求助

Hey there! I’ve run into similar hurdles working with Commerce and the Address module in Drupal 8, so let’s walk through how to get that address data you need for your export module.

Step 1: Understand the Entity Relationship First #

Commerce doesn’t store addresses directly on orders or users—they’re linked via Profile entities. Orders reference billing/shipping profiles, and users can have default billing/shipping profiles attached. So your first step is to load the relevant Profile, then extract the address from it.

Step 2: Fetch Billing/Shipping Profiles from an Order #

If you’re starting with an order ID, here’s how to pull the associated profiles:

// Load the order entity (replace $order_id with your actual order ID)
$order = \Drupal\commerce_order\Entity\Order::load($order_id);

// Get the billing profile (returns a Profile entity or NULL)
$billing_profile = $order->getBillingProfile();

// Get shipping profiles (only applicable if the order has shipments, e.g., physical products)
$shipping_order_manager = \Drupal::service('commerce_shipping.order_manager');
$shipments = $shipping_order_manager->getShipments($order);
if (!empty($shipments)) {
  // Grab the first shipment's shipping profile (adjust if multiple shipments exist)
  $shipping_profile = reset($shipments)->getShippingProfile();
}

Step 3: Extract Address Data from the Profile #

Once you have the Profile entity, you can access the Address field (by default, the field is named address—double-check with Devel if you’ve customized it):

if ($billing_profile) {
  // Get the Address field item (returns an AddressItem object)
  $address_item = $billing_profile->get('address')->first();
  if ($address_item) {
    // Get the Address plugin object (this is where all the address data lives)
    $address = $address_item->getAddress();
    
    // Now you can pull individual address components:
    $country = $address->getCountryCode();
    $state = $address->getAdministrativeArea();
    $city = $address->getLocality();
    $zip = $address->getPostalCode();
    $street1 = $address->getAddressLine1();
    $street2 = $address->getAddressLine2();
    $first_name = $address->getGivenName();
    $last_name = $address->getFamilyName();
    $company = $address->getOrganization();
  }
}

Step 4: Fetch Addresses Directly from a User #

If you need to get a user’s default billing/shipping addresses (not tied to a specific order), use their linked profile fields:

// Load the user entity (replace $user_id with your user's ID)
$user = \Drupal\user\Entity\User::load($user_id);

// Get default billing profile
$default_billing_profile = $user->get('commerce_billing_profile')->entity;
// Get default shipping profile (if your setup includes it)
$default_shipping_profile = $user->get('commerce_shipping_profile')->entity;

// Then extract address data the same way as Step 3

Pro Tips for Debugging #

• Use the Devel module (if you can) to inspect entities: Run dpm($order) or dpm($billing_profile) to visualize the field structure and confirm field names.
• If Devel isn’t an option, use print_r($order->toArray()) or var_export($billing_profile->getFields()) to dump the entity data and find the right fields.
• Always add null checks (like if ($billing_profile)) to avoid PHP errors—some orders might not have a shipping profile (e.g., digital products).

内容的提问来源于stack exchange，提问作者cadev