头图

VueFire,一个一流的 Vue 和 Firebase 体验 — 包括对 Nuxt 的支持,现在已经稳定了。

Vue 和 Firebase 现在比以往任何时候都更好了。

构建更好的VueFire

去年,我们宣布与 Eduardo San Martin Morote 合作,构建一个成熟的 Vue 和 Firebase 体验。自那时起,我们一直在努力构建我们的特性,如 Nuxt 支持,并使库通过 alpha 和 beta 阶段。我们很高兴地说,库现在是稳定的。

今天,我们很高兴地宣布VueFire现在已经稳定,可以使用了。

在本博客中,我们将介绍 VueFire 帮助简化 Vue 和 Firebase 开发的所有方式,但请务必查看文档以获取完整的详细信息。

VueFire 有什么新功能?

惯用的实时绑定

一行实时数据绑定

VueFire 为您提供了方便的可组合项,以便为 Firestore 和实时数据库创建实时数据绑定。

<script setup>
import { useCollection } from 'vuefire';
import { collection } from 'firebase/firestore';

// This is a composable. It only needs a ref to manage 
// the subscription.
const todos = useCollection(collection(db, 'todos'));
</script>

<template>
  <ul>
    <li v-for="todo in todos" :key="todo.id">
     <span>{{ todo.text }}</span>
    </li>
  </ul>
</template>

只需几行代码,您就拥有一个与本地或远程数据库更改保持同步的 todos 数组。

在幕后,VueFire 依靠 Firebase SDK 使用 onSnapshot()onValue() 等方法完成繁重的工作,剥离所有样板代码,为 Vue 开发人员提供量身定制的开发人员体验。

除了 useCollection()(适用于 Firestore)外,您还可以使用 useDocument() 找到与文档(document)对应的功能,使用 useDatabaseList()useDatabaseObject() 找到与列表和对象(适用于实时数据库)对应的功能:

import { useDatabaseList, useDatabaseObject, useDatabase } from 'vuefire'
import { ref as dbRef } from 'firebase/database'

const db = useDatabase()
const contacts = useDatabaseList(dbRef(db, 'contacts'))
const someContact = useDatabaseObject(dbRef(db, 'contacts', '24'))

VueFire 允许您传递对文档和集合(collections)的动态引用,并自动解除先前引用的绑定并绑定新引用。例如,我们可以依靠路由参数来绑定到特定文档:

<script setup lang="ts">
import { useRoute } from 'vue'
import { useDocument } from 'vuefire'
import { doc } from 'firebase/firestore'

const route = useRoute()
// note the () => doc() to pass a dynamic reference
const contact = useDocument(() => doc(db, 'contacts', route.params.id))
</script>

<template>
  <Contact :contact="contact" />
</template>

当从 /contacts/1 导航到 /contacts/2 时,前一个文档将被解除绑定,而新的文档将被绑定,所有这一切只需将一个函数传递给一个文档,而不仅仅是文档。请注意,这也适用于 computed() 属性和 ref() 变量。

身份验证变得更容易

VueFire 采用 Firebase 的底层身份验证功能,并将其封装到 Vue 组件中,使其可以在您的 Vue 应用程序中轻松、习以为常地使用。

<script setup>
import { useCurrentUser } from 'vuefire'

const user = useCurrentUser()
</script>

<template>
  <p v-if="user">Hello {{ user.providerData.displayName }}</p>
</template>

user 变量是响应式的,因此您可以将其与其他 Composition API 函数(例如 computed()watch() )一起使用。

<script setup>
import { useCurrentUser } from 'vuefire'
import { useRouter } from 'vue-router'

const user = useCurrentUser()

watch(user, user => {
  if (user == null) {
    router.push('/login')
  }
})
</script>

<template>
  <!-- ... -->
</template>

如果没有用户经过身份验证,则 user 变量将为 null ,因此您可以看到它只需几行即可重定向到登录页面,如上所示。

忠实于 Firebase SDK

VueFire 会尽量不妨碍您,并让您像平常一样使用 Firebase SDK。它提供了在 Vue 上下文中有用的 API,但您可以而且仍然应该使用 Firebase SDK 来完成许多事情,例如事务、批量写入、转换器等。

尽管有特定的 Vue 集成,您仍然可以通过手动调用 doc()collection() 以及 Firebase SDK 中的其他方法来访问 Firebase 引用。我们相信这有助于我们更接近 Firebase SDK,并使同时使用两者变得更加直观。例如,不能使用VueFire写入绑定数据,必须使用Firebase SDK进行更新操作:

<script setup lang="ts">
import { useFirestore } from 'vuefire'
import { doc, addDoc, serverTimestamp } from "firebase/firestore"; 

const db = useFirestore()

function addTodo(text: string) {
  // ✨ add a new todo
  await addDoc(collection(db, "todos"), {
    text,
    createdAt: serverTimestamp(),
    done: false
  });
}
</script>

VueFire 并未覆盖所有 Firebase 服务,也没有尝试覆盖所有 Firebase 服务。大多数时候不需要抽象,Firebase SDK 就足够了。例如,您可以直接将消息服务与 Firebase SDK 结合使用:

<script setup>
import { useFirebaseApp } from 'vuefire'
import { getMessaging, onMessage } from 'firebase/messaging'

const firebaseApp = useFirebaseApp()
const messaging = getMessaging(firebaseApp)
onMessage(messaging, payload => {
   console.log('Message received. ', payload)
})
</script>

不需要 Vue 集成或 VueFire 特定代码。

Nuxt支持,服务器支持变得简单

VueFire 最令人兴奋的功能之一是它的 Nuxt 模块。它不仅负责 Firebase 初始化,还处理将 Firebase 与 Nuxt 集成的最复杂部分之一:服务器端渲染 (SSR)。为了使用 VueFire 的 Nuxt 模块,请使用您最喜欢的包管理器安装它:

npm install nuxt-vuefire

然后你可以在 Nuxt 配置文件中配置它:

export default defineNuxtConfig({
  modules: [
    // ... other modules
    'nuxt-vuefire',
  ],

  vuefire: {
    // Firebase App configuration
    config: {
      apiKey: '...',
      authDomain: '...',
      projectId: '...',
      appId: '...',
    },
  },
})

最重要的是,VueFire 的 Nuxt 模块还使得使用 AppCheck、身份验证和模拟器等功能变得非常容易。

App Check 支持,轻松、安全的后端访问

Firebase App Check 是一个额外的安全层,通过证明传入流量来自您的应用程序并阻止没有有效凭据的流量,帮助保护对您的服务的访问。它有助于保护您的后端免遭滥用,例如计费欺诈、网络钓鱼、应用程序假冒和数据中毒。

启用 AppCheck 就像将 appCheck 属性添加到 vuefire 配置对象一样简单:

export default defineNuxtConfig({
  // ...
  vuefire: {
    // Enables AppCheck
    appCheck: {
      // Allows you to use a debug token in development
      debug: process.env.NODE_ENV !== 'production',
      provider: 'ReCaptchaEnterprise',
      key: '...',
    },
  },
})

通过使用 debug 选项,您可以在开发中使用调试令牌。无论是在开发期间还是在重要发布之前,这对于在没有模拟器的情况下进行本地测试非常有用。

服务器和客户端身份验证同步

通过客户端和服务器进行同步身份验证可能很难管理。每台机器都需要验证和维护相同的身份验证上下文。这可能需要设置 cookie、后台云函数或其他复杂的方法。

然而,使用 VueFire 的 Nuxt 模块设置身份验证也很容易:

export default defineNuxtConfig({
  // ...
  vuefire: {
    // Enables and initializes the auth module
    auth: {
      enabled: true,
    },
  },
})

默认情况下,这不会启用服务器端渲染需要验证用户的页面。在大多数情况下,这样做是没有问题的,因为你不需要对隐藏在身份验证后面的页面进行搜索引擎优化。这还能节省大量计算能力。

但是,可以通过让模块为经过身份验证的用户创建一个 cookie 并在每个请求上使用它来对它们进行身份验证来启用此功能。然后,呈现页面,就像用户已通过身份验证一样:

export default defineNuxtConfig({
  // ...
  vuefire: {
    // Enables and initializes the auth module
    auth: {
      enabled: true,
      sessionCookie: true,
    },
  },
})

设置完成后,您可以使用 useCurrentUser(),如上所示。它会自动导入,使其更易于使用。您还可以使用 getCurrentUser() 等待用户在中间件中登录:

export default defineNuxtRouteMiddleware(async to => {
  const user = await getCurrentUser()

  if (!user) {
    // redirect to the login page
    return navigateTo({
      path: '/login',
      query: {
        // keep the original path as a query parameter
        redirect: to.fullPath,
      },
    })
  }
})

然后在路由中定义页面元数据:

<script setup lang="ts">
definePageMeta({
  middleware: ['authenticated'],
});
</script>

模拟器设置变得简单

Firebase 模拟器套件是使用 Firebase 进行开发的推荐方式。这使您可以针对 Firebase 服务的本地实例进行开发,而不是处理需要网络连接或可能产生计费问题的云连接项目。

通常,要使用模拟器,您需要编写代码来告诉 Firebase SDK 连接到模拟器而不是云项目。然而,在 Nuxt 模块中,这一切都会自动发生。

默认情况下,如果您有一个带有 emulators 属性的 firebase.json 文件,VueFire 将在开发过程中自动启用模拟器。

一个全新的文档站点

VueFire 文档位于 https://vuefire.vuejs.org/

这些文档在主存储库中是开源的。如果您想看到任何更改或添加,请告诉我们!


杭州程序员张张
11.8k 声望6.7k 粉丝

Web/Flutter/独立开发者/铲屎官