feat：集成发送微公众号通知功能

app/Services/WechatNotificationService.php

@@ -0,0 +1,123 @@
+<?php
+
+namespace App\Services;
+
+use EasyWeChat\Factory;
+use Illuminate\Support\Facades\Log;
+
+class WechatNotificationService
+{
+    protected $app;
+
+    public function __construct()
+    {
+        $this->app = app('wechat.official_account');
+    }
+
+    /**
+     * 发送模板消息
+     *
+     *
+     * @param string $openid 接收者openid
+     * @param string $templateId 模板ID
+     * @param array $data 模板数据
+     * @param string|null $url 点击跳转链接
+     * @param array|null $miniprogram 跳小程序配置
+     * @return array
+     */
+    public function sendTemplateMessage(
+        string $openid,
+        string $templateId,
+        array $data,
+        ?string $url = null,
+        ?array $miniprogram = null
+    ): array {
+        try {
+            $message = [
+                'touser' => $openid,
+                'template_id' => $templateId,
+                'data' => $data,
+            ];
+
+            // 添加跳转链接
+            if ($url) {
+                $message['url'] = $url;
+            }
+
+            // 添加小程序跳转配置
+            if ($miniprogram) {
+                $message['miniprogram'] = $miniprogram;
+            }
+
+            $result = $this->app->template_message->send($message);
+
+            if ($result['errcode'] === 0) {
+                Log::info('微信模板消息发送成功', [
+                    'openid' => $openid,
+                    'template_id' => $templateId,
+                    'data' => $data,
+                ]);
+
+                return [
+                    'success' => true,
+                    'message' => '发送成功',
+                ];
+            }
+
+            Log::error('微信模板消息发送失败', [
+                'openid' => $openid,
+                'template_id' => $templateId,
+                'data' => $data,
+                'error' => $result['errmsg'],
+            ]);
+
+            return [
+                'success' => false,
+                'message' => $result['errmsg'],
+            ];
+        } catch (\Exception $e) {
+            Log::error('微信模板消息发送异常', [
+                'openid' => $openid,
+                'template_id' => $templateId,
+                'data' => $data,
+                'error' => $e->getMessage(),
+            ]);
+
+            return [
+                'success' => false,
+                'message' => '发送失败：' . $e->getMessage(),
+            ];
+        }
+    }
+
+    /**
+     * 发送订单状态变更通知
+     *
+     *     $result = $this->wechatService->sendOrderStatusNotification(
+     *     $order->user->wechat_openid,
+     *     [
+     *         'order_no' => $order->order_no,
+     *         'status' => $order->status_text,
+     *         'time' => now()->format('Y-m-d H:i:s')
+     *     ]
+     * );
+     *
+     * @param string $openid
+     * @param array $orderInfo
+     * @return array
+     */
+    public function sendOrderStatusNotification(string $openid, array $orderInfo): array
+    {
+        $templateId = env('WECHAT_ORDER_STATUS_TEMPLATE_ID');
+
+        $data = [
+            'first' => ['value' => '您的订单状态有更新'],
+            'keyword1' => ['value' => $orderInfo['order_no']],
+            'keyword2' => ['value' => $orderInfo['status']],
+            'keyword3' => ['value' => $orderInfo['time']],
+            'remark' => ['value' => '感谢您的使用！'],
+        ];
+
+        return $this->sendTemplateMessage($openid, $templateId, $data);
+    }
+}

composer.json

@@ -13,6 +13,7 @@
         "laravel/tinker": "^2.9",
         "monolog/monolog": "^3.5",
         "overtrue/easy-sms": "^3.0",
+        "overtrue/laravel-wechat": "^7.3",
         "rap2hpoutre/laravel-log-viewer": "^2.4",
         "simplesoftwareio/simple-qrcode": "^4.2",
         "slowlyo/owl-admin": "^4.0",

config/easywechat.php

@@ -0,0 +1,168 @@
+<?php
+
+return [
+    /*
+     * 默认配置，将会合并到各模块中
+     */
+    'defaults' => [
+        'http' => [
+            'timeout' => 5.0,
+        ],
+    ],
+
+    /*
+     * 公众号
+     */
+    'official_account' => [
+        'default' => [
+            'app_id' => env('WECHAT_OFFICIAL_ACCOUNT_APPID', ''),     // AppID
+            'secret' => env('WECHAT_OFFICIAL_ACCOUNT_SECRET', ''),    // AppSecret
+            'token' => env('WECHAT_OFFICIAL_ACCOUNT_TOKEN', ''),     // Token
+            'aes_key' => env('WECHAT_OFFICIAL_ACCOUNT_AES_KEY', ''),   // EncodingAESKey
+
+            /*
+             * OAuth 配置
+             *
+             * scopes：公众平台（snsapi_userinfo / snsapi_base），开放平台：snsapi_login
+             * callback：OAuth授权完成后的回调页地址(如果使用中间件，则随便填写。。。)
+             * enforce_https：是否强制使用 HTTPS 跳转
+             */
+            // 'oauth'   => [
+            //     'scopes'        => array_map('trim', explode(',', env('WECHAT_OFFICIAL_ACCOUNT_OAUTH_SCOPES', 'snsapi_userinfo'))),
+            //     'callback'      => env('WECHAT_OFFICIAL_ACCOUNT_OAUTH_CALLBACK', '/examples/oauth_callback.php'),
+            //     'enforce_https' => true,
+            // ],
+
+        /**
+         * 接口请求相关配置，超时时间等，具体可用参数请参考：
+         * https://github.com/symfony/symfony/blob/6.0/src/Symfony/Contracts/HttpClient/HttpClientInterface.php#L26
+         */
+            //'http' => [
+            //  'timeout' => 5.0,
+            //   // 如果你在国外想要覆盖默认的 url 的时候才使用，根据不同的模块配置不同的 uri
+            //  'base_uri' => 'https://api.weixin.qq.com/',
+            //],
+        ],
+    ],
+
+    /*
+     * 开放平台第三方平台
+     */
+    // 'open_platform' => [
+    //     'default' => [
+    //         'app_id'     => env('WECHAT_OPEN_PLATFORM_APPID', ''),
+    //         'secret'     => env('WECHAT_OPEN_PLATFORM_SECRET', ''),
+    //         'token'      => env('WECHAT_OPEN_PLATFORM_TOKEN', ''),
+    //         'aes_key'    => env('WECHAT_OPEN_PLATFORM_AES_KEY', ''),
+
+/**
+ * 接口请求相关配置，超时时间等，具体可用参数请参考：
+ * https://github.com/symfony/symfony/blob/6.0/src/Symfony/Contracts/HttpClient/HttpClientInterface.php#L26
+ */
+    //          'http' => [
+    //            'timeout' => 5.0,
+    //             // 如果你在国外想要覆盖默认的 url 的时候才使用，根据不同的模块配置不同的 uri
+    //            'base_uri' => 'https://api.weixin.qq.com/',
+    //          ],
+    //     ],
+    // ],
+
+    /*
+     * 小程序
+     */
+    // 'mini_app' => [
+    //     'default' => [
+    //         'app_id'     => env('WECHAT_MINI_APP_APPID', ''),
+    //         'secret'     => env('WECHAT_MINI_APP_SECRET', ''),
+    //         'token'      => env('WECHAT_MINI_APP_TOKEN', ''),
+    //         'aes_key'    => env('WECHAT_MINI_APP_AES_KEY', ''),
+
+/**
+ * 接口请求相关配置，超时时间等，具体可用参数请参考：
+ * https://github.com/symfony/symfony/blob/6.0/src/Symfony/Contracts/HttpClient/HttpClientInterface.php#L26
+ */
+    //          'http' => [
+    //            'timeout' => 5.0,
+    //             // 如果你在国外想要覆盖默认的 url 的时候才使用，根据不同的模块配置不同的 uri
+    //            'base_uri' => 'https://api.weixin.qq.com/',
+    //          ],
+    //     ],
+    // ],
+
+    /*
+     * 微信支付
+     */
+    // 'pay' => [
+    //     'default' => [
+    //         'app_id'             => env('WECHAT_PAY_APPID', ''),
+    //         'mch_id'             => env('WECHAT_PAY_MCH_ID', 'your-mch-id'),
+    //         'private_key'        => '/data/private/certs/apiclient_key.pem',
+    //         'certificate'        => '/data/private/certs/apiclient_cert.pem',
+    //         'notify_url'         => 'http://example.com/payments/wechat-notify',                           // 默认支付结果通知地址
+    //          /**
+    //           * 证书序列号，可通过命令从证书获取：
+    //           * `openssl x509 -in application_cert.pem -noout -serial`
+    //           */
+    //          'certificate_serial_no' => '6F2BADBE1738B07EE45C6A85C5F86EE343CAABC3',
+    //
+    //          'http' => [
+    //              'base_uri' => 'https://api.mch.weixin.qq.com/',
+    //          ],
+    //
+    //          // v2 API 秘钥
+    //          //'v2_secret_key' => '26db3e15cfedb44abfbb5fe94fxxxxx',
+    //
+    //          // v3 API 秘钥
+    //          //'secret_key' => '43A03299A3C3FED3D8CE7B820Fxxxxx',
+    //
+    //          // 注意 此处为微信支付平台证书 https://pay.weixin.qq.com/wiki/doc/apiv3/apis/wechatpay5_1.shtml
+    //          'platform_certs' => [
+    //              '/data/private/certs/platform_key.pem',
+    //          ],
+    //     ],
+    // ],
+
+    /*
+     * 企业微信
+     */
+    // 'work' => [
+    //     'default' => [
+    //         'corp_id'    => env('WECHAT_WORK_CORP_ID', ''),
+    //         'secret'     => env('WECHAT_WORK_SECRET', ''),
+    //         'token'      => env('WECHAT_WORK_TOKEN', ''),
+    //         'aes_key'    => env('WECHAT_WORK_AES_KEY', ''),
+
+/**
+ * 接口请求相关配置，超时时间等，具体可用参数请参考：
+ * https://github.com/symfony/symfony/blob/6.0/src/Symfony/Contracts/HttpClient/HttpClientInterface.php#L26
+ */
+    //          'http' => [
+    //            'timeout' => 5.0,
+    //             // 如果你在国外想要覆盖默认的 url 的时候才使用，根据不同的模块配置不同的 uri
+    //            'base_uri' => 'https://api.weixin.qq.com/',
+    //          ],
+    //      ],
+    // ],
+
+    /*
+     * 企业微信开放平台
+     */
+    // 'open_work' => [
+    //     'default' => [
+    //         'corp_id'            => env('WECHAT_OPEN_WORK_CORP_ID', ''),
+    //         'provider_secret'    => env('WECHAT_OPEN_WORK_SECRET', ''),
+    //         'token'              => env('WECHAT_OPEN_WORK_TOKEN', ''),
+    //         'aes_key'            => env('WECHAT_OPEN_WORK_AES_KEY', ''),
+
+/**
+ * 接口请求相关配置，超时时间等，具体可用参数请参考：
+ * https://github.com/symfony/symfony/blob/6.0/src/Symfony/Contracts/HttpClient/HttpClientInterface.php#L26
+ */
+    //          'http' => [
+    //            'timeout' => 5.0,
+    //             // 如果你在国外想要覆盖默认的 url 的时候才使用，根据不同的模块配置不同的 uri
+    //            'base_uri' => 'https://api.weixin.qq.com/',
+    //          ],
+    //      ],
+    // ],
+];

config/wechat.php

@@ -0,0 +1,17 @@
+<?php
+return [
+    'official_account' => [
+        'default' => [
+            'app_id' => env('WECHAT_OFFICIAL_ACCOUNT_APPID', ''),      // AppID
+            'secret' => env('WECHAT_OFFICIAL_ACCOUNT_SECRET', ''),     // AppSecret
+            'token' => env('WECHAT_OFFICIAL_ACCOUNT_TOKEN', ''),       // Token
+            'aes_key' => env('WECHAT_OFFICIAL_ACCOUNT_AES_KEY', ''),  // EncodingAESKey
+
+            'response_type' => 'array',
+            'log' => [
+                'level' => 'debug',
+                'file' => storage_path('logs/wechat.log'),
+            ],
+        ],
+    ],
+];