README

QBWC Laravel 是一个具有Laravel风格的QuickBooks Web Connector软件包。这个库仍在开发中，但已基本完成且稳定，可通过SOAP服务与QuickBooks桌面版进行通信。

安装

要安装该软件包，请运行

composer require aarongrtech/qbwc-laravel

确保您的 composer.json 包含必要的自动加载设置

"autoload": {
    "psr-4": {
        "AaronGRTech\\QbwcLaravel\\": "./src/AaronGRTech/QbwcLaravel"
    }
},
"extra": {
    "laravel": {
        "providers": [
            "AaronGRTech\\QbwcLaravel\\Providers\\QbwcServiceProvider"
        ]
    }
}

更新Composer后，将服务提供者添加到 config/app.php 文件中

'providers' => [
    // Other Service Providers

    AaronGRTech\QbwcLaravel\Providers\QbwcServiceProvider::class,
],

用法

设置WSDL文件

确保WSDL文件在 storage_path('app/wsdl/QBWebConnectorSvc.wsdl') 可用。您可以使用以下命令将WSDL文件发布到存储目录：

php artisan vendor:publish --provider="AaronGRTech\QbwcLaravel\Providers\QbwcServiceProvider"

路由

该软件包提供处理SOAP请求的路由。这些路由由 QbwcServiceProvider 自动注册。

控制器

SoapController 处理各种SOAP请求

• 服务器版本

  • 路由: /soap/serverVersion
  • 方法: serverVersion
  • 请求: POST

• 客户端版本

  • 路由: /soap/clientVersion
  • 方法: clientVersion
  • 请求: POST

• 验证

  • 路由: /soap/authenticate
  • 方法: authenticate
  • 请求: POST

• 发送请求XML

  • 路由: /soap/sendRequestXML
  • 方法: sendRequestXML
  • 请求: POST

• 接收响应XML

  • 路由: /soap/receiveResponseXML
  • 方法: receiveResponseXML
  • 请求: POST

安装后步骤

安装此软件包后，请更新应用程序的 composer.json 文件以自动加载回调

{
    "autoload": {
        "psr-4": {
            "App\\Callbacks\\": "app/Callbacks/"
        }
    }
}

要求

• PHP >= 7.4
• Laravel框架
• 扩展: ext-dom, ext-mbstring, ext-soap
• 依赖: wsdltophp/packagebase ~5.0

许可

此软件包根据MIT许可证授权。有关更多信息，请参阅LICENSE 文件。

作者

• AaronGRTech - aaron@goldenruleweb.com

贡献

请阅读 CONTRIBUTING 文件，了解我们的行为准则以及提交拉取请求的过程。