Skip to main content

wechat_mp_core/
config.rs

1//! 小程序配置
2
3use crate::error::{MpError, Result};
4
5/// 微信 API 默认域名
6pub const DEFAULT_BASE_URL: &str = "https://api.weixin.qq.com";
7
8/// access_token 获取方式
9#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
10pub enum TokenMode {
11    /// 稳定版 `/cgi-bin/stable_token`(推荐)
12    #[default]
13    Stable,
14    /// 经典版 `/cgi-bin/token`
15    Classic,
16}
17
18/// 小程序配置
19#[derive(Clone)]
20pub struct Config {
21    /// 小程序 AppID
22    pub app_id: String,
23    /// 小程序 AppSecret
24    pub app_secret: String,
25    /// API 基础地址
26    pub base_url: String,
27    /// token 获取模式
28    pub token_mode: TokenMode,
29}
30
31impl std::fmt::Debug for Config {
32    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
33        f.debug_struct("Config")
34            .field("app_id", &self.app_id)
35            .field("app_secret", &"***")
36            .field("base_url", &self.base_url)
37            .field("token_mode", &self.token_mode)
38            .finish()
39    }
40}
41
42impl Config {
43    /// 使用 AppID / AppSecret 创建配置
44    pub fn new(app_id: impl Into<String>, app_secret: impl Into<String>) -> Self {
45        Self {
46            app_id: app_id.into(),
47            app_secret: app_secret.into(),
48            base_url: DEFAULT_BASE_URL.to_string(),
49            token_mode: TokenMode::Stable,
50        }
51    }
52
53    /// 自定义 API 域名
54    pub fn with_base_url(mut self, url: impl Into<String>) -> Self {
55        self.base_url = url.into();
56        self
57    }
58
59    /// 设置 token 获取模式
60    pub fn with_token_mode(mut self, mode: TokenMode) -> Self {
61        self.token_mode = mode;
62        self
63    }
64
65    /// 从环境变量加载
66    ///
67    /// - `WECHAT_MP_APP_ID`
68    /// - `WECHAT_MP_APP_SECRET`
69    /// - `WECHAT_MP_BASE_URL`(可选)
70    /// - `WECHAT_MP_TOKEN_MODE`(可选:`stable` / `classic`)
71    pub fn from_env() -> Result<Self> {
72        let app_id = env_required("WECHAT_MP_APP_ID")?;
73        let app_secret = env_required("WECHAT_MP_APP_SECRET")?;
74        let mut cfg = Self::new(app_id, app_secret);
75
76        if let Ok(url) = std::env::var("WECHAT_MP_BASE_URL") {
77            cfg = cfg.with_base_url(url);
78        }
79
80        if let Ok(mode) = std::env::var("WECHAT_MP_TOKEN_MODE") {
81            let mode = match mode.to_ascii_lowercase().as_str() {
82                "classic" | "token" => TokenMode::Classic,
83                "stable" | "" => TokenMode::Stable,
84                other => {
85                    return Err(MpError::Config(format!(
86                        "无效的 WECHAT_MP_TOKEN_MODE: {other}(支持 stable / classic)"
87                    )));
88                }
89            };
90            cfg = cfg.with_token_mode(mode);
91        }
92
93        Ok(cfg)
94    }
95}
96
97fn env_required(key: &str) -> Result<String> {
98    std::env::var(key).map_err(|_| MpError::Config(format!("缺少环境变量: {key}")))
99}