使用kreait/firebase-php创建和管理Firebase动态链接-CSDN博客

使用kreait/firebase-php创建和管理Firebase动态链接

Firebase动态链接(Dynamic Links)是智能化的URL链接，无论用户是否安装了应用，都能提供最佳的用户体验。本文将详细介绍如何使用kreait/firebase-php库来创建和管理Firebase动态链接。

动态链接简介

Firebase动态链接具有以下特点：

跨平台支持：无论用户使用iOS、Android还是桌面设备，都能获得一致的体验
智能路由：根据用户设备状态自动判断最佳行为（打开应用或跳转到应用商店）
可追踪：提供详细的点击和转化统计

使用kreait/firebase-php库，我们可以通过编程方式创建两种形式的动态链接：

长链接：包含完整参数的URL
短链接：经过缩短的简洁URL，如https://example.page.link/wXYZ

准备工作

在开始编码前，需要完成以下准备工作：

在Firebase控制台中启用动态链接功能
接受服务条款并设置动态链接域名
记下你的动态链接域名，后续代码中需要用到

初始化动态链接组件

基本初始化方式

$dynamicLinksDomain = 'https://example.page.link';
$dynamicLinks = $factory->createDynamicLinksService($dynamicLinksDomain);

依赖注入方式（适用于框架）

对于Laravel等框架，可以使用依赖注入：

use Kreait\Firebase\Contract\DynamicLinks;

class MyService
{
    public function __construct(DynamicLinks $dynamicLinks)
    {
        $this->dynamicLinks = $dynamicLinks;
    }
}

在Laravel中，可以通过环境变量FIREBASE_DYNAMIC_LINKS_DEFAULT_DOMAIN配置默认域名。

创建动态链接

基本创建方法

use Kreait\Firebase\DynamicLink\CreateDynamicLink\FailedToCreateDynamicLink;

$url = 'https://www.example.com/some/path';

try {
    // 创建不可猜测后缀的链接（17字符）
    $link = $dynamicLinks->createUnguessableLink($url);
    
    // 创建短后缀链接（4字符）
    $link = $dynamicLinks->createShortLink($url);
} catch (FailedToCreateDynamicLink $e) {
    // 错误处理
}

链接对象方法

创建的链接对象提供以下实用方法：

$link->uri();         // 获取URI对象
$link->previewUri();  // 获取预览URI
$link->domain();      // 获取域名
$link->suffix();      // 获取后缀
$link->hasWarnings(); // 检查是否有警告
$link->warnings();    // 获取警告数组

长链接转短链接

如果你已经有一个手动构建的长链接，可以将其转换为短链接：

use Kreait\Firebase\DynamicLink\ShortenLongDynamicLink\FailedToShortenLongDynamicLink;

$longLink = 'https://example.page.link?link=https://example.com/some/path';

try {
    $link = $dynamicLinks->shortenLongDynamicLink($longLink);
    // 或指定后缀类型
    $link = $dynamicLinks->shortenLongDynamicLink($longLink, ShortenLongDynamicLink::WITH_SHORT_SUFFIX);
} catch (FailedToShortenLongDynamicLink $e) {
    // 错误处理
}

获取链接统计信息

可以获取动态链接的分析数据，包括点击量、重定向、应用安装等指标：

use Kreait\Firebase\DynamicLink\GetStatisticsForDynamicLink\FailedToGetStatisticsForDynamicLink;

try {
    // 获取7天内的统计（默认）
    $stats = $dynamicLinks->getStatistics('https://example.page.link/wXYZ');
    
    // 获取指定天数的统计
    $stats = $dynamicLinks->getStatistics('https://example.page.link/wXYZ', 14);
} catch (FailedToGetStatisticsForDynamicLink $e) {
    // 错误处理
}

统计数据分析

统计对象提供丰富的方法来分析用户行为：

// 获取所有点击
$allClicks = $stats->eventStatistics()->clicks();

// 获取Android平台的应用首次打开
$androidFirstOpens = $stats->eventStatistics()->appFirstOpens()->onAndroid();

// 获取桌面端的重定向次数
$desktopRedirects = $stats->eventStatistics()->redirects()->onDesktop();

高级用法

使用构建器自定义链接

use Kreait\Firebase\DynamicLink\CreateDynamicLink;

$action = CreateDynamicLink::forUrl($url)
    ->withDynamicLinkDomain('https://example.page.link')
    ->withShortSuffix()
    ->withAnalyticsInfo($analyticsConfig)
    ->withIOSInfo($iosConfig)
    ->withAndroidInfo($androidConfig)
    ->withSocialMetaTagInfo($socialConfig);

$link = $dynamicLinks->createDynamicLink($action);

使用参数数组

如果SDK尚未支持某些新选项，可以直接使用参数数组：

$parameters = [
    'dynamicLinkInfo' => [
        'domainUriPrefix' => 'https://example.page.link',
        'link' => 'https://example.com/some/path',
    ],
    'suffix' => ['option' => 'SHORT'],
];

$link = $dynamicLinks->createDynamicLink($parameters);