Sylius项目实战：如何添加自定义购物车促销规则-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00388/article/details/148441012

Sylius项目实战：如何添加自定义购物车促销规则

Sylius Sylius/Sylius: Sylius是一个基于Symfony PHP框架构建的开源电子商务平台，具备高度模块化和可配置性，提供商品管理、订单处理、库存控制等一系列电商核心功能，帮助企业快速搭建自己的在线商店。项目地址: https://gitcode.com/gh_mirrors/sy/Sylius

前言

在电商平台运营中，促销活动是吸引客户、提升销量的重要手段。Sylius作为一个功能强大的电商框架，提供了灵活的促销系统。本文将详细介绍如何在Sylius中实现一个自定义的购物车促销规则——"高级会员专属优惠"。

理解Sylius促销系统架构

Sylius的促销系统由几个核心组件构成：

规则检查器(RuleChecker)：负责验证促销条件是否满足
动作处理器(ActionProcessor)：执行促销优惠操作
配置表单(ConfigurationType)：为规则提供配置界面

在本文案例中，我们将重点实现一个规则检查器，用于验证客户是否为高级会员。

实现步骤详解

第一步：创建规则检查器

规则检查器是促销系统的核心组件，它决定了促销活动是否适用于当前购物车。

<?php

namespace App\Promotion\Checker\Rule;

use Sylius\Component\Promotion\Checker\Rule\RuleCheckerInterface;
use Sylius\Component\Promotion\Model\PromotionSubjectInterface;

class PremiumCustomerRuleChecker implements RuleCheckerInterface
{
    public const TYPE = 'premium_customer';

    public function isEligible(PromotionSubjectInterface $subject, array $configuration): bool
    {
        return $subject->getCustomer()?->isPremium() === true;
    }
}

关键点说明：

TYPE常量定义了规则的唯一标识符
isEligible方法返回布尔值，表示规则是否满足
我们假设购物车对象可以通过getCustomer()方法获取关联客户

第二步：扩展客户实体

为了实现高级会员功能，我们需要在客户实体中添加一个标志字段。

<?php

namespace App\Entity\Customer;

use Doctrine\ORM\Mapping as ORM;
use Sylius\Component\Core\Model\Customer as BaseCustomer;

#[ORM\Entity]
#[ORM\Table(name: 'sylius_customer')]
class Customer extends BaseCustomer
{
    #[ORM\Column(type: 'boolean', options: ['default' => false])]
    private bool $premium = false;

    public function isPremium(): bool
    {
        return $this->premium;
    }

    public function setPremium(bool $premium): void
    {
        $this->premium = $premium;
    }
}

数据库迁移：

php bin/console doctrine:migrations:diff
php bin/console doctrine:migrations:migrate

第三步：扩展管理后台表单

为了让管理员能够设置客户为高级会员，我们需要扩展客户管理表单。

<?php

namespace App\Form\Extension;

use Sylius\Bundle\AdminBundle\Form\Type\CustomerType;
use Symfony\Component\Form\AbstractTypeExtension;
use Symfony\Component\Form\Extension\Core\Type\CheckboxType;
use Symfony\Component\Form\FormBuilderInterface;

final class CustomerTypeExtension extends AbstractTypeExtension
{
    public function buildForm(FormBuilderInterface $builder, array $options): void
    {
        $builder->add('premium', CheckboxType::class, [
            'label' => 'Premium',
            'required' => false,
        ]);
    }

    public static function getExtendedTypes(): iterable
    {
        return [CustomerType::class];
    }
}

第四步：创建模板部分

使用Sylius的Twig Hooks系统将高级会员字段添加到客户表单中。

{# templates/admin/customer/form/sections/general/premium.html.twig #}

{{ form_row(hookable_metadata.context.form.premium) }}

配置钩子：

# config/packages/_sylius.yaml

sylius_twig_hooks:
    hooks:
        'sylius_admin.customer.update.content.form.sections.general':
            premium:
                template: '/admin/customer/form/sections/general/premium.html.twig'
                priority: -50

第五步：创建配置表单类型

即使我们的规则不需要额外配置，Sylius仍然需要一个表单类型。

<?php

namespace App\Form\Type\Rule;

use Symfony\Component\Form\AbstractType;

class PremiumCustomerConfigurationType extends AbstractType
{
    public function getBlockPrefix(): string
    {
        return 'app_promotion_rule_premium_customer_configuration';
    }
}

第六步：注册服务

最后，将所有组件注册到服务容器中。

# config/services.yaml
services:
    App\Promotion\Checker\Rule\PremiumCustomerRuleChecker:
        tags:
            - {
                name: sylius.promotion_rule_checker,
                type: premium_customer,
                form_type: App\Form\Type\Rule\PremiumCustomerConfigurationType,
                label: 'Premium customer'
              }