feat: 上线前安全加固与发布工程化；appmall 由插件迁移为独立应用

安全（P0） - 发布包签名：新增 scripts/package_keygen.php、scripts/package_verify.php、 ywxapp\service\PackageVerifier；FrameworkService::apply() 解压前强制验签（ywxapp.framework_package_verify，默认开启） - JWT 收紧：config/jwt.php 移除公开默认密钥，JwtService::assertStrongSecret() 校验非空 / 长度≥32 / 已知弱值；.env.production.example 键名由 JWT_SECRET_KEY 修正为 JWT_SECRET - /api/v1/Article：免登录白名单收窄为只读接口，写操作字段白名单 + assertOwner() 越权校验 - 开发者令牌：查找接口不再回显明文、统一失败文案 + 限流 - TemplateInstaller：文件名白名单 + realpath 归一化 + 目录内断言，修复 Zip Slip；补 use ZipArchive - 后台登录：接入验证码、失败锁定与登录限流（config/ratelimit.php） - 缓存 / Session 驱动可由 .env 覆盖（CACHE_DRIVER / SESSION_TYPE），集群部署改 redis - paycenter 支付日志开关改为 PAY_LOG，不再跟随 APP_DEBUG 工程化 / 交付 - 新增 CHANGELOG.md 与 .env.production.example；composer.lock 入库锁定依赖版本 - 插件离线安装 CLI 增加 --uid，后台上传安装透传 uid，付费插件授权校验可通过 - 授权拒绝文案区分「未携带 uid」与「未找到有效授权」，便于排障 - .gitignore 放行 .env.production.example / .env.addon.example / .gitattributes / public/.htaccess 结构 - appmall 由 addon/appmall 迁移为独立应用 app/appmall（市场 / 开发者中心 / 审核 / 分润）
2026-10-22 00:53:39 +08:00
1 parent 1d49e6f5ee
commit 18101cf11a
@@ -0,0 +1,85 @@
+<?php
+declare(strict_types=1);
+
+namespace addon\paycenter\library;
+
+use Yansongda\Pay\Pay;
+
+/**
+ * 支付 SDK（yansongda/pay v3.7）的统一装配层。
+ *
+ * 为什么不能在各处直接 Pay::alipay(config('pay.alipay'))：
+ *
+ * 1) 配置是【两级】的。Pay::alipay($config) 走 __callStatic → Artful::config($config)，
+ *    整份数组被塞进 Config 容器；插件按 get_provider_config() 取 `alipay.<租户>` 的值，
+ *    默认租户是 'default'。也就是说必须传进去
+ *        ['alipay' => ['default' => [...实际配置...]]]
+ *    而 config('pay.alipay') 是扁平的，缺了外两层 → 取不到任何字段，
+ *    只会抛「配置异常: 缺少支付宝配置 -- [app_public_cert_path]」。
+ *
+ * 2) 运行时不能改配置。Artful::config() 在容器已存在时直接 return false，
+ *    第二次传进去的配置会被整个忽略。所以 return_url / notify_url 这种每单不同的值
+ *    必须走快捷方法的 params：
+ *        支付宝 → params['_return_url'] / params['_notify_url']（StartPlugin 优先读它们）
+ *        微信   → params['notify_url']（V3 Pay 插件里 $payload->get('notify_url', 配置兜底)）
+ *    不要再写 `$config['notify_url'] = xxx; Pay::alipay($config)`，那是无效的。
+ */
+class PayFactory
+{
+    public static function config(): array
+    {
+        return [
+            'alipay' => ['default' => PayConfig::get('alipay')],
+            'wechat' => ['default' => PayConfig::get('wechat')],
+            'logger' => [
+                // 日志开关走配置项 PAY_LOG，**不跟 APP_DEBUG 联动**：
+                // 生产一旦误把 APP_DEBUG 打开，就会把网关请求/明文签名写进 runtime/log/pay.log。
+                'enable'    => (bool) config('paycenter.log_enable', env('PAY_LOG', false)),
+                'file'      => runtime_path('log') . 'pay.log',
+                'level'     => (string) config('paycenter.log_level', 'debug'),
+                'type'      => 'daily',
+                'max_files' => 7,
+            ],
+            'http' => [
+                'timeout'         => 15.0,
+                'connect_timeout' => 5.0,
+                // Windows 上 PHP 常没配 curl.cainfo / openssl.cafile，连网关会报
+                // cURL error 60: SSL certificate problem: unable to get local issuer certificate。
+                // 这时下载 https://curl.se/ca/cacert.pem 放到本地，再用 PAY_HTTP_CA 指过去。
+                'verify'          => self::caBundle() ?: true,
+            ],
+        ];
+    }
+
+    /**
+     * CA 证书包绝对路径（相对路径按项目根目录解析）；未配置返回 '' 表示「用 PHP 默认配置」。
+     */
+    public static function caBundle(): string
+    {
+        $path = (string) env('PAY_HTTP_CA', '');
+        if ($path === '') {
+            return '';
+        }
+
+        return PayConfig::resolvePath($path);
+    }
+
+    public static function alipay(): \Yansongda\Pay\Provider\Alipay
+    {
+        Pay::config(self::config());
+
+        return Pay::alipay();
+    }
+
+    public static function wechat(): \Yansongda\Pay\Provider\Wechat
+    {
+        Pay::config(self::config());
+
+        return Pay::wechat();
+    }
+
+    public static function available(): bool
+    {
+        return class_exists(Pay::class);
+    }
+}