README

此Bundle用于实现symfony第三方适配器。为了更好地理解此Bundle的使用，您可以下载示例项目。见

https://github.com/afrikpaysas/symfony-thirdparty-adapter-console

安装

请确保已全局安装Composer，如Composer文档中的安装章节所述。

使用Symfony Flex的应用程序

打开命令控制台，进入您的项目目录，并执行以下命令

$ composer require afrikpaysas/symfony-thirdparty-adapter

不使用Symfony Flex的应用程序

步骤 1: 下载Bundle

打开命令控制台，进入您的项目目录，并执行以下命令以下载此Bundle的最新稳定版本

$ composer require afrikpaysas/symfony-thirdparty-adapter

步骤 2: 启用Bundle

然后，通过将其添加到项目中config/bundles.php文件中注册的Bundle列表中来启用Bundle

// config/bundles.php

return [
    // ...
    Afrikpaysas\SymfonyThirdpartyAdapter\AfrikpaysasSymfonyThirdpartyAdapterBundle::class => ['all' => true],
];

步骤 3: 配置错误页面

然后，通过将其添加到项目中config/packages/framework.yaml文件中来配置错误URL

# config/packages/framework.yaml

framework:
  error_controller: Afrikpaysas\SymfonyThirdpartyAdapter\Controller\ErrorController::error

#......

步骤 4: 配置路由

然后，通过将其添加到项目中config/routes.yaml文件中来配置路由

# config/routes_app.yaml

#......

afrikpaysas_thirdparty_adapter:
  resource: '@AfrikpaysasSymfonyThirdpartyAdapterBundle/Resources/config/routes.yaml'

#afrikpaysas_thirdparty_adapter_app:
#  resource: '@AfrikpaysasSymfonyThirdpartyAdapterBundle/Resources/config/routes_app.yaml'

#......

步骤 5: 配置文档

然后，通过将其添加到项目中config/packages/nelmio_api_doc.yaml文件中来配置文档

# config/packages/nelmio_api_doc.yaml

nelmio_api_doc:
  documentation:
    info:
      title: Third Party Adapter
      description: This is the documentation of third party adapter!
      version: 1.0.0

#......

步骤 6: 配置.env文件

然后，通过将其添加到项目中.env文件中来配置.env文件

# In all environments, the following files are loaded if they exist,
# the latter taking precedence over the former:
#
#  * .env                contains default values for the environment variables needed by the app
#  * .env.local          uncommitted file with local overrides
#  * .env.$APP_ENV       committed environment-specific defaults
#  * .env.$APP_ENV.local uncommitted environment-specific overrides
#
# Real environment variables win over .env files.
#
# DO NOT DEFINE PRODUCTION SECRETS IN THIS FILE NOR IN ANY OTHER COMMITTED FILES.
# https://symfony.com.cn/doc/current/configuration/secrets.html
#
# Run "composer dump-env prod" to compile .env files for production use (requires symfony/flex >=1.2).
# https://symfony.com.cn/doc/current/best_practices.html#use-environment-variables-for-infrastructure-configuration

###> symfony/framework-bundle ###
APP_ENV=dev
APP_DEBUG=1
APP_SECRET=""
SHOW_CONFIG=true
###< symfony/framework-bundle ###

###> symfony/security-bundle ###
HTTP_BASIC_AUTH_USERNAME=user
HTTP_BASIC_AUTH_PASSWORD=password
###< symfony/security-bundle ###

###> doctrine/doctrine-bundle ###
# Format described at https://www.doctrine-project.org/projects/doctrine-dbal/en/latest/reference/configuration.html#connecting-using-a-url
# IMPORTANT: You MUST configure your server version, either here or in config/packages/doctrine.yaml
#
# DATABASE_URL="sqlite:///%kernel.project_dir%/var/data.db"
DATABASE_URL="mysql://user:pssword@127.0.0.1:3306/db?serverVersion=5&charset=utf8mb4"
#DATABASE_URL="postgresql://app:!ChangeMe!@127.0.0.1:5432/app?serverVersion=14&charset=utf8"
###< doctrine/doctrine-bundle ###

APP_CODE=00
APP_NAME=NAME

APP_DB_ID_LENGTH=16
TIME_ZONE=UTC
TIME_ZONE_PROVIDER=UTC
DEFAULT_DATE_TIME=now

MANUAL_MODE=false
ASYNC_MODE=false
SET_BALANCE_AFTER_PAYMENT=false

REFERENCE_REGEX="/^[0-9]{6,20}$/"

AMOUNT_ENABLED=false
AMOUNT_MIN=0
AMOUNT_MAX=0

PHONE_ENABLED=false
PHONE_REGEX="/^[0-9]{6,20}$/"

EMAIL_ENABLED=false

OPTION_ENABLED=false
OPTION_API_ENABLED=false
SEARCH_OPTION_WITH_REFERENCE=false
API_OPTION=""
OPTIONS_FILE="/config/options.yaml"
OPTION_PAY_ENABLED=false

REFERENCE_API_ENABLED=true
PAY_UNIQUE_REFERENCE=false
API_REFERENCE=""

API_PAYMENT=""
API_TOKEN=""
API_USERNAME_TOKEN=""
API_PASSWORD_TOKEN=""
API_DATE_FORMAT="Y-m-d H:i:s"

CURL_TIMEOUT=60
CURL_MAXREDIRS=10

ADMIN_PHONES=""
ADMIN_EMAILS=""
NOTIF_ADMIN_PHONES=false
NOTIF_ADMIN_EMAILS=false
NOTIF_SMS_MESSAGE=""
NOTIF_SMS_ADMIN_MESSAGE=""

SMS_ENABLED=false
SMS_SENDER=""
SMS_COUNTRY=""
SMS_SEPARATOR=";"
API_SMS=""

EMAIL_API_ENABLED=false
EMAIL_ADMIN_OBJECT=""
EMAIL_CLIENT_OBJECT=""
EMAIL_SENDER=""
EMAIL_SEPARATOR=";"
API_EMAIL=""
EMAIL_TEMPLATING_INLINE="<hr>"
EMAIL_TEMPLATING_OBJECT="List"

API_CALLBACK_TOKEN=""
API_CALLBACK_SIGNATURE_VARS=""
API_CALLBACK_SIGNATURE_SEPARATOR="+"
API_CALLBACK_SIGNATURE_SECRET=""
CALLBACK_URL_REGEX="/\b(?:(?:https?|ftp):\/\/|www\.)[-a-z0-9+&@#\/%?=~_|!:,.;]*[-a-z0-9+&@#\/%=~_|]/i"

###> symfony/messenger ###
# Choose one of the transports below
#MESSENGER_TRANSPORT_DSN=doctrine://default
MESSENGER_TRANSPORT_DSN=amqp://guest:guest@localhost:5672/%2f/messages
# MESSENGER_TRANSPORT_DSN=redis://:6379/messages
###< symfony/messenger ###

步骤 7: 配置messenger

然后，通过将其添加到项目中config/packages/messenger.yaml文件中来配置messenger

# config/packages/messenger.yaml

framework:
  messenger:
    # reset services after consuming messages
    reset_on_message: true

    # Uncomment this (and the failed transport below) to send failed messages to this transport for later handling.
    # failure_transport: failed

    transports:
      # https://symfony.com.cn/doc/current/messenger.html#transport-configuration
      set_balance:
        dsn: '%env(MESSENGER_TRANSPORT_DSN)%'
        serializer: Afrikpaysas\SymfonyThirdpartyAdapter\Lib\Serializer\ExternalJsonMessageSerializer
        retry_strategy:
          max_retries: 3
          delay: 1000
          multiplier: 10
          max_delay: 0
      upload_provider_data:
        dsn: '%env(MESSENGER_TRANSPORT_DSN)%'
        serializer: Afrikpaysas\SymfonyThirdpartyAdapter\Lib\Serializer\ExternalJsonMessageSerializer
        retry_strategy:
          max_retries: 3
          delay: 1000
          multiplier: 10
          max_delay: 0
      upload_provider_id:
        dsn: '%env(MESSENGER_TRANSPORT_DSN)%'
        serializer: Afrikpaysas\SymfonyThirdpartyAdapter\Lib\Serializer\ExternalJsonMessageSerializer
        retry_strategy:
          max_retries: 5
          delay: 1000
          multiplier: 5
          max_delay: 0
      update_reference_status:
        dsn: '%env(MESSENGER_TRANSPORT_DSN)%'
        serializer: Afrikpaysas\SymfonyThirdpartyAdapter\Lib\Serializer\ExternalJsonMessageSerializer
        retry_strategy:
          max_retries: 3
          delay: 1000
          multiplier: 10
          max_delay: 0
      send_admin_email:
        dsn: '%env(MESSENGER_TRANSPORT_DSN)%'
        serializer: Afrikpaysas\SymfonyThirdpartyAdapter\Lib\Serializer\ExternalJsonMessageSerializer
        retry_strategy:
          max_retries: 3
          delay: 1000
          multiplier: 60
          max_delay: 0
      send_admin_sms:
        dsn: '%env(MESSENGER_TRANSPORT_DSN)%'
        serializer: Afrikpaysas\SymfonyThirdpartyAdapter\Lib\Serializer\ExternalJsonMessageSerializer
        retry_strategy:
          max_retries: 3
          delay: 1000
          multiplier: 60
          max_delay: 0
      send_client_email:
        dsn: '%env(MESSENGER_TRANSPORT_DSN)%'
        serializer: Afrikpaysas\SymfonyThirdpartyAdapter\Lib\Serializer\ExternalJsonMessageSerializer
        retry_strategy:
          max_retries: 3
          delay: 1000
          multiplier: 60
          max_delay: 0
      send_client_sms:
        dsn: '%env(MESSENGER_TRANSPORT_DSN)%'
        serializer: Afrikpaysas\SymfonyThirdpartyAdapter\Lib\Serializer\ExternalJsonMessageSerializer
        retry_strategy:
          max_retries: 3
          delay: 1000
          multiplier: 60
          max_delay: 0
      callback_message:
        dsn: '%env(MESSENGER_TRANSPORT_DSN)%'
        serializer: Afrikpaysas\SymfonyThirdpartyAdapter\Lib\Serializer\ExternalJsonMessageSerializer
        retry_strategy:
          max_retries: 3
          delay: 1000
          multiplier: 60
          max_delay: 0
      update_status_message:
        dsn: '%env(MESSENGER_TRANSPORT_DSN)%'
        serializer: Afrikpaysas\SymfonyThirdpartyAdapter\Lib\Serializer\ExternalJsonMessageSerializer
        retry_strategy:
          max_retries: 3
          delay: 1000
          multiplier: 10
          max_delay: 0
      log_message:
        dsn: '%env(MESSENGER_TRANSPORT_DSN)%'
        serializer: Afrikpaysas\SymfonyThirdpartyAdapter\Lib\Serializer\ExternalJsonMessageSerializer
        retry_strategy:
          max_retries: 3
          delay: 1000
          multiplier: 10
          max_delay: 0
    routing:
      # Route your messages to the transports
      'Afrikpaysas\SymfonyThirdpartyAdapter\Messenger\Message\SetBalanceMessage': set_balance
      'Afrikpaysas\SymfonyThirdpartyAdapter\Messenger\Message\UpdateProviderDataMessage': upload_provider_data
      'Afrikpaysas\SymfonyThirdpartyAdapter\Messenger\Message\UpdateProviderIdMessage': upload_provider_id
      'Afrikpaysas\SymfonyThirdpartyAdapter\Messenger\Message\UpdateReferenceStatusMessage': update_reference_status
      'Afrikpaysas\SymfonyThirdpartyAdapter\Messenger\Message\SendAdminEmailMessage': send_admin_email
      'Afrikpaysas\SymfonyThirdpartyAdapter\Messenger\Message\SendAdminSMSMessage': send_admin_sms
      'Afrikpaysas\SymfonyThirdpartyAdapter\Messenger\Message\SendClientEmailMessage': send_client_sms
      'Afrikpaysas\SymfonyThirdpartyAdapter\Messenger\Message\SendClientSMSMessage': send_client_email
      'Afrikpaysas\SymfonyThirdpartyAdapter\Messenger\Message\CallbackMessage': callback_message
      'Afrikpaysas\SymfonyThirdpartyAdapter\Messenger\Message\UpdateStatusMessage': update_status_message
      'Afrikpaysas\SymfonyThirdpartyAdapter\Messenger\Message\LogMessage': log_message
#......

步骤 8: 运行应用程序

然后，运行应用程序

composer install && php bin/console cache:clear && symfony console doctrine:schema:update -f && symfony server:start

步骤 9: 运行messenger消费者

然后，运行messenger

symfony console messenger:consume set_balance upload_provider_data upload_provider_id update_reference_status send_admin_email send_admin_sms send_client_sms send_client_email callback_message update_status_message log_message -vv