README

Sylius PausePay 插件

Sylius PausePay支付方式的插件

安装

1. 运行

   composer require webgriffe/sylius-pausepay-plugin

2. 将以下代码添加到您的 config/bundles.php 文件中：Webgriffe\SyliusPausePayPlugin\WebgriffeSyliusPausePayPlugin::class => ['all' => true]。

   通常，通过 composer require 命令，插件会自动添加到 config/bundles.php 文件中。如果没有，您需要手动添加。

3. 创建一个新的文件 config/packages/webgriffe_sylius_pausepay_plugin.yaml。

   imports:
     - { resource: "@WebgriffeSyliusPausePayPlugin/config/config.php" }

4. 创建一个新的文件 config/routes/webgriffe_sylius_pausepay_plugin.yaml。

   webgriffe_sylius_pausepay_plugin_shop:
       resource: "@WebgriffeSyliusPausePayPlugin/config/routes/shop.php"
       prefix: /{_locale}
       requirements:
           _locale: ^[A-Za-z]{2,4}(_([A-Za-z]{4}|[0-9]{3}))?(_([A-Za-z]{2}|[0-9]{3}))?$
   
   webgriffe_sylius_pausepay_plugin_index:
       resource: "@WebgriffeSyliusPausePayPlugin/config/routes/index.php"
   
   webgriffe_sylius_pausepay_plugin_payum:
       resource: "@WebgriffeSyliusPausePayPlugin/config/routes/payum.php"
   
   sylius_shop_payum_cancel:
       resource: "@PayumBundle/Resources/config/routing/cancel.xml"

5. 添加 PaymentOrder 实体。创建一个名为 src/Entity/Payment/PaymentOrder.php 的新文件，内容如下：

   <?php
   
   declare(strict_types=1);
   
   namespace App\Entity\Payment;
   
   use Doctrine\ORM\Mapping as ORM;
   use Webgriffe\SyliusPausePayPlugin\Entity\PaymentOrder as BasePaymentOrder;
   
   /**
    * @ORM\Entity
    * @ORM\Table(name="webgriffe_sylius_pausepay_payment_order")
    */
   class PaymentOrder extends BasePaymentOrder
   {
   }

6. 添加一个新的 CompanyInfoResolver 服务，它装饰了插件中的虚拟服务 webgriffe_sylius_pausepay.resolver.company_info。此服务用于解析“订单”的公司信息，并在创建支付时传递给 PausePay 系统。

   创建一个名为 src/Resolver/PausePay/CompanyInfoResolver.php 的新文件，内容如下：

   <?php
   
   declare(strict_types=1);
   
   namespace App\Resolver\PausePay;
   
   use Sylius\Component\Core\Model\OrderInterface;
   use Webgriffe\SyliusPausePayPlugin\Resolver\CompanyInfoResolverInterface;
   use Webgriffe\SyliusPausePayPlugin\ValueObject\CompanyInfo;
   
   final class CompanyInfoResolver implements CompanyInfoResolverInterface
   {
       public function resolveFromOrder(OrderInterface $order): CompanyInfo
       {
           // TODO: your logic here
       }
   }

   并将其定义为具有别名 webgriffe_sylius_pausepay.resolver.company_info 的服务装饰/替换。例如，创建一个名为 config/services/resolver.yaml 的文件，内容如下：

   services:
       webgriffe_sylius_pausepay.resolver.company_info:
           class: App\Resolver\PausePay\CompanyInfoResolver

   TODO: 添加沙盒逻辑

7. 如果您有 Sylius 服务 PaymentMethodResolver 的自定义实现，您必须使用服务 PausePayAvailabilityChecker 添加逻辑以检查 PausePay 支付方法的可用性。

   TODO: 添加示例

8. 运行

   php bin/console doctrine:migrations:migrate

9. 运行

   php bin/console sylius:install:assets

   或者，您可以将条目添加到您的 webpack.config.js 文件中

   .addEntry(
       'webgriffe-sylius-pausepay-entry',
       './vendor/webgriffe/sylius-pausepay-plugin/public/poll_payment.js'
   )

   然后覆盖模板 WebgriffeSyliusPausePayPlugin/after_pay.html.twig 以包含条目

   {% block javascripts %}
       {{ parent() }}
   
       <script>
           window.afterUrl = "{{ afterUrl }}";
           window.paymentStatusUrl = "{{ paymentStatusUrl }}";
       </script>
       {{ encore_entry_script_tags('webgriffe-sylius-pausepay-entry', null, 'sylius.shop') }}
   {% endblock %}

用法

访问管理员面板并转到“支付方式”部分。创建一个新的支付方式，并将“PausePay”作为网关选择。然后，使用所需的参数配置支付方式。

贡献

有关Sylius插件开发的全面指南，请访问Sylius文档，在那里您可以找到插件开发指南，其中充满了示例。

快速入门安装

传统

1. 运行 composer create-project sylius/plugin-skeleton ProjectName。

2. 从插件骨架根目录，运行以下命令

   $ (cd tests/Application && yarn install)
   $ (cd tests/Application && yarn build)
   $ (cd tests/Application && APP_ENV=test bin/console assets:install public)
   
   $ (cd tests/Application && APP_ENV=test bin/console doctrine:database:create)
   $ (cd tests/Application && APP_ENV=test bin/console doctrine:schema:create)

要设置插件数据库，请记住在 tests/Application/.env 和 tests/Application/.env.test 中配置您的数据库凭据。

Docker

1. 执行 docker compose up -d

2. 初始化插件 docker compose exec app make init

3. 在浏览器中打开 open localhost

用法

运行插件测试

• PHPUnit

  vendor/bin/phpunit

• PHPSpec

  vendor/bin/phpspec run

• Behat（非JS场景）

  vendor/bin/behat --strict --tags="~@javascript"

• Behat（JS场景）

  1. 安装Symfony CLI命令.

  2. 启动无头Chrome

  google-chrome-stable --enable-automation --disable-background-networking --no-default-browser-check --no-first-run --disable-popup-blocking --disable-default-apps --allow-insecure-localhost --disable-translate --disable-extensions --no-sandbox --enable-features=Metal --headless --remote-debugging-port=9222 --window-size=2880,1800 --proxy-server='direct://' --proxy-bypass-list='*' http://127.0.0.1

  1. 安装SSL证书（仅需要一次）并在 127.0.0.1:8080 上运行测试应用程序的web服务器

  symfony server:ca:install
  APP_ENV=test symfony server:start --port=8080 --dir=tests/Application/public --daemon

  1. 运行Behat

  vendor/bin/behat --strict --tags="@javascript"

• 静态分析

  • Psalm

    vendor/bin/psalm

  • PHPStan

    vendor/bin/phpstan analyse -c phpstan.neon -l max src/  

• 编码标准

  vendor/bin/ecs check

使用您的插件打开Sylius

• 使用 test 环境

  (cd tests/Application && APP_ENV=test bin/console sylius:fixtures:load)
  (cd tests/Application && APP_ENV=test bin/console server:run -d public)

• 使用 dev 环境

  (cd tests/Application && APP_ENV=dev bin/console sylius:fixtures:load)
  (cd tests/Application && APP_ENV=dev bin/console server:run -d public)