Laravel EasyWeChat 詳解

一、Laravel EasyWeChat 簡介

Laravel EasyWeChat 是一個基於 Laravel 開發的微信開發 SDK，它是一款簡單易用、功能豐富的微信開發框架，支持包括微信公眾號、小程序、支付、開放平台等多個模塊。

Laravel EasyWeChat 採用 Composer 構建，在安裝和使用時只需使用 Composer 安裝，無需繁瑣的配置即可輕鬆搭建微信開發環境。

Laravel EasyWeChat 模塊豐富，包括微信公眾號、微信小程序、微信支付、消息推送、SDK 的測試和調試等多個功能，可滿足不同場景的應用需求。

二、微信公眾號模塊

WeChat 公眾號是目前開發最廣泛的一個微信模塊，那麼 Laravel EasyWeChat 如何使用此模塊呢？我們可以通過以下步驟來創建一個公眾號實例：

use EasyWeChat\Factory;

$options = [
    'app_id' => 'your-app-id',
    'secret' => 'your-app-secret',
    // 更多配置項
];

$app = Factory::officialAccount($options);

以上代碼引入 Laravel EasyWeChat 的 Factory 類，調用 officialAccount 方法創建一個公眾號實例。其中，$options 參數包含 app_id、secret、token 等必填項，更多配置項可參考官方文檔。

創建公眾號實例後，我們可以通過 Laravel EasyWeChat 封裝好的方法來調用微信 API，例如獲取 access_token：

$response = $app->access_token->getToken();

調用以上代碼後，獲取到的 access_token 將存於 $response[‘access_token’] 中。

三、微信小程序模塊

除了微信公眾號，微信小程序也是開發者較為關注的一個模塊。我們可以使用 Laravel EasyWeChat 提供的 weapp 方法來創建一個小程序實例：

use EasyWeChat\Factory;

$options = [
    'app_id' => 'your-app-id',
    'secret' => 'your-app-secret',
    // 更多配置項
];

$app = Factory::miniProgram($options);

創建小程序實例後，我們就可以像操作公眾號一樣操作小程序了。例如獲取 access_token：

$response = $app->access_token->getToken();

調用以上代碼後，獲取到的 access_token 將存於 $response[‘access_token’] 中。

四、微信支付模塊

微信支付模塊是 Laravel EasyWeChat 的另一個重要模塊。我們同樣可以使用 Laravel EasyWeChat 封裝好的方法來快速調用微信支付 API。

首先，我們需要通過 Factory 類創建一個支付實例：

use EasyWeChat\Factory;

$options = [
    'app_id' => 'your-app-id',
    // 商戶號
    'mch_id' => 'your-mch-id',
    // API 密鑰
    'key' => 'your-key',
    // 異步通知地址
    'notify_url' => 'your-notify-url',
];

$app = Factory::payment($options);

以上代碼中，必須配置 app_id、mch_id 和 key 等參數，notify_url 表示微信支付異步通知的回調地址，需配置為自己服務器的接收回調信息的 URL 地址。

創建支付實例後，我們可以通過以下代碼來創建訂單：

// 創建訂單
$result = $app->order->unify([
    'body' => 'test', // 商品描述
    'out_trade_no' => '201702141224235', // 商戶訂單號
    'total_fee' => 1, // 總金額，單位為分
    'openid' => 'oUpF8uMuAJ2pxb1Q9zNjpiObCc1I', // 用戶的 OpenId
]);

通過 $app->order->unify 方法調用微信支付的統一下單接口，提交商品描述、商戶訂單號、總金額和用戶的 OpenId 等參數，成功後將返回微信支付的預支付 ID 和二維碼等信息。

五、消息推送模塊

在實際開發中，我們需要為用戶推送消息，例如關注提示、訂單信息等。Laravel EasyWeChat 可以將消息推送與公眾號、小程序等結合起來，快速實現消息推送功能。

我們可以通過以下代碼來創建一個模板消息並發送：

// 創建模板消息
$message = new \EasyWeChat\Kernel\Messages\TemplateMessage([
    'touser' => 'oO7uIwbqp_4O5E1bFq3zhCwr0WkE', // 接受者 OpenId
    'template_id' => 'your-template-id', // 模板 ID
    'url' => 'https://www.baidu.com', // 跳轉鏈接
    'data' => [
        'key1' => 'hello world',
        'key2' => '你好世界',
    ],
]);

// 發送模板消息
$response = $app->template_message->send($message);

以上代碼創建一個模板消息並發送，其中，模板 ID 可以在自己的公眾號/小程序中創建並設置，data 則為模板消息中的變量。

六、SDK 測試和調試

Laravel EasyWeChat 提供了內置的 SDK 調試工具，可供開發者在開發過程中進行測試和調試。

我們可以通過以下命令來啟動 SDK 調試工具：

php artisan serve-wechat-sdk

啟動調試工具後，在瀏覽器中打開 http://localhost:8000 即可進入到 SDK 調試界面。在界面中輸入微信公眾號/小程序的 app_id 和 secret，即可開始測試和調試微信 API 。

總結

Laravel EasyWeChat 是一個功能豐富、易用性高的微信開發框架，支持多種微信開發模塊。在實際開發中，我們可以通過 Laravel EasyWeChat 快速搭建微信開發環境，並實現消息推送、支付、小程序開發等功能。