完善PC 端链接打开方式

Author: calchen

src/Message/ActionCardMessage.php

@@ -87,7 +87,7 @@ public function setMessage(string $title, string $text, $hideAvatar = null, $btn
      *
      * @param string $singleTitle 单个按钮的方案。(设置此项和singleURL后btns无效。)
      * @param string $singleUrl   点击singleTitle按钮触发的URL
-     * @param bool   $pcSlide     链接在钉钉侧栏打开，false则在浏览器打开
+     * @param bool   $pcSlide     链接是否在 PC 端侧栏打开，true 在 PC 端侧栏打开；false 在系统默认浏览器
      *
      * @return $this
      */
@@ -105,7 +105,7 @@ public function setSingle(string $singleTitle, string $singleUrl, bool $pcSlide
      *
      * @param string $title     按钮方案
      * @param string $actionUrl 点击按钮触发的URL
-     * @param bool   $pcSlide   链接在钉钉侧栏打开，false则在浏览器打开
+     * @param bool   $pcSlide   链接是否在 PC 端侧栏打开，true 在 PC 端侧栏打开；false 在系统默认浏览器
      *
      * @return ActionCardMessage
      */

src/Message/FeedCardMessage.php

@@ -33,7 +33,7 @@ public function setMessage()
      * @param string $title      单条信息文本
      * @param string $messageUrl 点击单条信息到跳转链接
      * @param string $picUrl     单条信息后面图片的URL
-     * @param bool   $pcSlide    链接在钉钉侧栏打开，false则在浏览器打开
+     * @param bool   $pcSlide    链接是否在 PC 端侧栏打开，true 在 PC 端侧栏打开；false 在系统默认浏览器
      *
      * @return FeedCardMessage
      */
@@ -42,7 +42,7 @@ public function addLink(string $title, string $messageUrl, string $picUrl, bool
         $this->message['feedCard']['links'][] = [
             'title'      => $title,
             'messageURL' => $this->getFinalUrl($messageUrl, $pcSlide),
-            'picURL'     => $this->getFinalUrl($picUrl, $pcSlide),
+            'picURL'     => $picUrl,
         ];
 
         return $this;

src/Message/LinkMessage.php

@@ -33,7 +33,7 @@ public function __construct(
      * @param string $text       消息内容。如果太长只会部分展示
      * @param string $messageUrl 点击消息跳转的 URL
      * @param string $picUrl     图片 URL
-     * @param bool   $pcSlide    链接在钉钉侧栏打开，false则在浏览器打开
+     * @param bool   $pcSlide    链接是否在 PC 端侧栏打开，true 在 PC 端侧栏打开；false 在系统默认浏览器
      *
      * @return LinkMessage
      */
@@ -44,7 +44,7 @@ public function setMessage(string $title, string $text, string $messageUrl, stri
             'link'    => [
                 'title'      => $title,
                 'text'       => $text,
-                'picUrl'     => $this->getFinalUrl($picUrl, $pcSlide),
+                'picUrl'     => $picUrl,
                 'messageUrl' => $this->getFinalUrl($messageUrl, $pcSlide),
             ],
         ];

src/Message/Message.php

@@ -18,18 +18,6 @@ abstract class Message
     // 设置机器人名称，默认为 default，会根据名称去找配置
     protected $robot = 'default';
 
-    /**
-     * 获取最终URL.
-     * @param  string  $url
-     * @param  bool  $pcSlide
-     *
-     * @return string
-     */
-    public function getFinalUrl($url, $pcSlide = true): string
-    {
-        return sprintf('dingtalk://dingtalkclient/page/link?url=%s&pc_slide=%s', urlencode($url), $pcSlide ? 'true' : 'false');
-    }
-
     /**
      * 获取消息请求的请求体内容.
      *
@@ -63,4 +51,21 @@ public function getRobot(): string
     {
         return $this->robot;
     }
+
+    /**
+     * 将 URL 转换成指定的 schema 形式，以便控制其 PC 端打开方式为钉钉侧边栏或系统默认浏览器
+     *
+     * @link https://ding-doc.dingtalk.com/doc#/serverapi2/iat9q8/e300ae98
+     *
+     * @param string $url
+     * @param bool   $pcSlide
+     *
+     * @return string
+     */
+    public function getFinalUrl(string $url, bool $pcSlide = true): string
+    {
+        return sprintf(
+            'dingtalk://dingtalkclient/page/link?url=%s&pc_slide=%s', urlencode($url), $pcSlide ? 'true' : 'false'
+        );
+    }
 }