如何在Craft CMS模块中程序化创建产品类型、产品及默认变体？

错误原因分析 #

你遇到的saveElement()参数错误，是因为代码中误将ProductTypeSite（产品类型站点模型）传给了仅接受ElementInterface实例的元素保存服务。正确流程应该是先创建并保存产品类型，再基于它创建产品，最后添加默认变体，每个步骤都要调用对应服务的正确方法，而非混用元素保存服务。

正确实现代码示例 #

以下是模块中完成三个需求的完整正确代码：

1. 创建并保存产品类型 #

use craft\commerce\models\ProductType;
use craft\commerce\services\ProductTypes;
use craft\helpers\ArrayHelper;

// 初始化产品类型模型
$productType = new ProductType();
$productType->name = '自定义产品类型';
$productType->handle = 'customProductType';
$productType->hasVariants = true; // 启用变体
$productType->skuFormat = '{product.sku}-{variant.sku}'; // SKU格式
$productType->trackStock = true; // 启用库存跟踪

// 设置产品类型关联的站点（必填）
$siteIds = ArrayHelper::getColumn(\Craft::$app->getSites()->getAllSites(), 'id');
$productType->setProductTypeSitesForSiteIds($siteIds);

// 调用产品类型服务保存
/** @var ProductTypes $productTypeService */
$productTypeService = \Craft::$app->get('commerce_productTypes');
if (!$productTypeService->saveProductType($productType)) {
    // 处理保存失败逻辑
    var_dump($productType->getErrors());
    return;
}

2. 基于产品类型创建产品 #

use craft\commerce\elements\Product;

// 初始化产品元素
$product = new Product();
$product->typeId = $productType->id; // 关联刚创建的产品类型ID
$product->title = '测试产品';
$product->slug = 'test-product';
$product->siteId = \Craft::$app->getSites()->getPrimarySite()->id;
$product->enabled = true;

// 保存产品（使用元素服务，因为Product是ElementInterface实例）
if (!\Craft::$app->getElements()->saveElement($product)) {
    var_dump($product->getErrors());
    return;
}

3. 创建默认产品变体 #

use craft\commerce\models\Variant;
use craft\commerce\services\Variants;

// 初始化变体模型
$variant = new Variant();
$variant->productId = $product->id; // 关联刚创建的产品ID
$variant->sku = 'TEST-VAR-001';
$variant->price = 99.99;
$variant->stock = 100;
$variant->enabled = true;

// 调用变体服务保存
/** @var Variants $variantService */
$variantService = \Craft::$app->get('commerce_variants');
if (!$variantService->saveVariant($variant)) {
    var_dump($variant->getErrors());
    return;
}

关键注意事项 #

• 产品类型的保存必须用commerce_productTypes服务的saveProductType()方法，而非元素服务的saveElement()，因为ProductType不是元素类。
• 产品是元素类（实现ElementInterface），所以用getElements()->saveElement()保存。
• 变体的保存要用commerce_variants服务的saveVariant()方法，同样不属于元素类。
• 所有模型在保存前必须设置必填字段（如产品类型的站点关联、产品的站点ID、变体的SKU和价格等），否则会触发验证错误。

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