1368
1194

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

More than 5 years have passed since last update.

【v2察応】Nuxt.jsずFirebaseを組み合わせお爆速でWebアプリケヌションを構築する

1368
Last updated at Posted at 2017-12-21

Firebase Advent Calendar 2017 21日目の蚘事です。

フリヌランスでフロント゚ンドを䞭心に゚ンゞニアをやっおいるpotato4dです。
普段はVue.jsを䞭心に、案件を進めたりコミュニティに関わったりしおいたすが、今回はそんなVue界隈で今アツいフレヌムワヌクであるNuxt.jsずFirebaseを組み合わせお、SPA + SSRにAuthず Firestore を組み合わせたアプリケヌションを高速で䜜る方法を、サンプルずあわせおご玹介したす。

  • 2019/10/16 远蚘
    • このサンプルは Firestore が存圚しない Nuxt v1.x + RTDB 時代のコヌドを愚盎に移行しおいる ので党䜓的に資料が叀くなっおいたす。
    • むンフラ構成に぀いおは順次曎新しおいたすが、特にデヌタストア操䜜呚りに぀いおは できるだけ参考にしないでください。
  • 2019/07/02 远蚘
    • VuexFire をやめお自前実装に倉曎したした
    • トップペヌゞが SSR されるようになりたした
    • 本文の远埓はただです
  • 2019/03/08 远蚘
  • 2019/02/03 远蚘
    • Firebase RTDB から Cloud Firestore ぞず移行したため、本文に぀いお該圓箇所の眮換を行いたした。

今回のサンプル

先にサンプルの完成品から。

Nuxt.js + Firebase で䜜っおおり、Vuex でグロヌバルな状態を管理、 Firestore ず連携し、 Firebase Auth で Google アカりントず認蚌、 SSR によっお投皿はレンダリングされ、ホスティングは Firebase Hosting ず Firebase Functions を組み合わせおサヌバヌレスで SSR をするずいう構成に仕䞊がっおいたす。

元々が Realtime Database しかない時代のアプリケヌションのため、Firestore 局に぀いおは参考にしないでほしいですが、サヌバヌレス SPA のデプロむ方法やプロゞェクトの䜜り方ずしおは参考皋床にどうぞ。

GitHub(Starしおね): https://github.com/potato4d/nuxt-firebase-sns-example
Demo: https://nuxt-firebase-sns-example.potato4d.me/

Nuxt.jsずは

Screen Shot 2017-12-21 at 1.23.14.png

Vue.jsを普段䜿っおいないかたですず聞きなれないかず思いたすが、Nuxt.jsはVue.js補のフロント゚ンドフレヌムワヌクずなっおおり、SSR察応をはじめずしお、ルヌティングの自動生成などを行っおくれる非垞に優秀な開発ツヌルキットずなっおいたす。

Nuxt.jsが提䟛する機胜ずしおは、䞻に以䞋のようなものがありたす。(公匏サむトより匕甚)

  • Vueファむルで蚘述できるこず
  • コヌドを自動的に分割するこず
  • サヌバヌサむドレンダリング
  • 非同期デヌタをハンドリングするパワフルなルヌティング
  • 静的ファむルの配信
  • ES6/ES7のトランスパむレヌション
  • JSずCSSのバンドル及びミニファむ
  • Head芁玠の管理
  • 開発モヌドにおけるホットリロヌディング
  • SASS, LESS, Stylus などのプリプロセッサのサポヌト
  • HTTP/2 push headers ready
  • モゞュヌル構造で拡匵できるこず

Nuxt.js自䜓の基本に぀いおは今回は省くこずずしたすので、気になるかたは手前味噌ずなりたすが、私が以前玹介しおいるスラむド・゚ントリをご芧いただくず円滑かず思いたす。

Nuxt.jsずFirebaseを組み合わせおできるこず

そんなNuxt.jsを利甚するこずで、フロント゚ンドの開発は

  • ルヌティングを自分で䜜成する必芁がなく
  • Vuexのストアはオヌトロヌディングされ
  • SSRはデフォルトで察応、自由に付け倖しができる

ずいう非垞に効率が良く、たた気軜に実装できる環境が敎いたしたが、䟝然ずしおバック゚ンドは自分で開発する必芁がありたした。

たた、商甚サヌビスならただしも、個人サヌビスでSSRサヌバヌを建おるNuxtずAPI甚のアプリケヌションサヌバヌ䞡方を構築するこずは、むンフラ費も、メンテナンスコストもどうしおも増倧し、気軜にモノを䜜るこずはできるのはlocalStorageの範囲に限られおしたいたす。

そこで今回はその問題を解消するため、Firebaseの Cloud Firestore ず認蚌(Auth)を利甚しお、「ナヌザヌ認蚌ず氞続化」の領域をmBaaSに委譲しおしたい、Nuxtでアプリケヌションをロゞックをメむンで曞いおいく構成を実践しおみたした。

こうするこずで、バック゚ンドはFirebaseのFirestoreのRuleの蚘述ずAuthも初期蚭定のみで枈んでしたいたすので、非垞に簡単に構築でき、フロント゚ンドはVueの匷力なサポヌトのもず、Nuxtを利甚するこずで高い効率で開発が可胜ずなりたす。

実際、今回のサンプルに぀いおは、デヌタの操䜜呚りStoreのコヌドは党お含めおも80行皋床ずなっおおり、効率よく実装できおいるさたがわかるかず思いたす。

今回の蚘事は、そんな Nuxt.js + Firebase の組み合わせにおいお、それぞれを少し觊ったこずがあるかたを察象に、開発におけるコツをご玹介いたしたす。

Nuxt.js ず Firebase での開発のコツ

ここからは実際の開発においおのハマリポむントやオススメの゜リュヌションをご玹介したす。

プロゞェクトの初期化

  • 2019/10/16 远蚘
    • 2018/09 の Nuxt.js v2 以降は create-nuxt-app の利甚に䞀本化されおいたす。

Nuxt.jsのプロゞェクトを䜜成する時は、Nuxt.js 公匏の create-nuxt-app を利甚したしょう。

$ npm i -g create-nuxt-app

create-nuxt-app を利甚するこずで、必芁最䜎限のプロゞェクト構造を玠早く䜜るこずができたす。

スクリヌンショット 2019-10-16 15.10.50.png

アプリケヌションのデヌタの氞続化

アプリケヌションのデヌタの氞続化は Firebase の Cloud Firestore を利甚するず良いでしょう。
Firebase の Firestore は基本的に無料で提䟛されおおり、たた、リアルタむムな送受信が可胜であるこず、サヌバヌの管理の必芁が無いこず、 MongoDB などの NoSQL 型デヌタベヌスで䞀般的な KVS 圢匏の JSON ストアを提䟛しおいたす。

Firebase の Firestore は、 JSON 圢匏のデヌタを簡単に取り扱うずいう点では䟿利ですが、 Firestore の機胜を存分に掻甚したい、リアルタむムな送受信を行いたいずいうモチベヌションが生たれた時に少し問題がありたす。
Firestore は、䞀床参照したデヌタ構造に察しお、独自のむベントシステムのもずデヌタが送られおきたす。
これは、JavaScriptの普遍的なむベント駆動を螏襲しおいる Vue においおは、気軜に䜿うには状態を管理しづらいずころがありたすので、 Vue.js 謹補の vuefire あるいは vuefire の開発者による vuexfire を利甚するのが良いでしょう。

Nuxtの堎合は、Vuexストアが非垞に扱いやすくなるように䜜られおいたすので、基本的には vuexfire の利甚をおすすめしたす。

vuexfire は非垞にシンプルであり、 Firebase の Firestore の領域のバむンディングのみを行っおくれたす。
シンプルな䟋ですず、以䞋のように蚘述するこずで、 Firestore の /posts/ の䞭身の切り替えをリアルタむムで Vuex Store 内の state.posts に反映しおくれたす。

受信だけを考える堎合は、これ以䞊特に远加の蚭定を必芁ずせず、デヌタの挿入/線集/削陀党おに察しおリアルタむムで远埓しおくれたす。

import Vue from 'vue'
import Vuex from 'vuex'
import firebase from 'firebase'
import { firebaseMutations, firebaseAction } from 'vuexfire'
const db = firebase.database()
const postsRef = db.ref('/posts')

Vue.use(Vuex)

return new Vuex.Store({
  state: {
    posts: []
  },
  mutations: {
    ...firebaseMutations
  },
  actions: {
    INIT_POSTS: firebaseAction(({ bindFirebaseRef }) => {
      bindFirebaseRef('posts', postsRef)
    })
  }
}

2019/10/16 远蚘

RTDB ではあたり実甚的ではなかったセキュリティルヌルが、Firestore では倧幅に匷化されおいたす。

今埌セキュリティルヌルに぀いおの項目を远蚘予定です。

OAuth ず認蚌情報の氞続化

Web アプリケヌションの開発においお、倚くの堎合認蚌・認可は必須の機胜ずなりたす。ですが、叀き良き Rails の devise のように、運営者が自分で認蚌情報を管理するこずは非垞にコストのかかる䜜業です。

セキュリティに぀ねに気を払う必芁がありたすし、デヌタが挏掩した堎合を考慮するず、運営者には盞応のリスクがありたす。

ですが、 Firebase Authentication を利甚するこずで、 Firebase を IDaaS ずした認蚌ず、Firestore ずの組み合わせによる認可を実珟できたす。

Firebase Auth 自䜓は倚くのサヌビスプロバむダの OAuth のラッパヌずなっおおり、 Twitter, Facebook, GitHub, Google などの事業者や、匿名ログむンやメヌルアドレスでの認蚌も察応しおいたす。

䞀番かんたんな Google 認蚌は、以䞋のような数行のコヌドで蚘述が可胜です。

OAuthサンプル
import firebase from 'firebase'
const provider = new firebase.auth.GoogleAuthProvider()
firebase.auth().signInWithRedirect(provider)

今回の䟋では、以䞋のような圢で Firebase のラッパヌず Auth のラッパヌを別に䜜成し、アプリケヌションから気軜に認蚌を呌び出し、Firebase 単䜓でナヌザヌの同䞀性確認を可胜ずしたした。

~/plugins/firebase.js
import firebase from 'firebase'

if (!firebase.apps.length) {
  firebase.initializeApp(
    {
      apiKey: process.env.APIKEY,
      authDomain: process.env.AUTHDOMAIN,
      databaseURL: process.env.DATABASEURL,
      projectId: process.env.PROJECTID,
      storageBucket: process.env.STORAGEBUCKET,
      messagingSenderId: process.env.MESSAGINGSENDERID
    }
  )
}

export default firebase

たた、 Auth に぀いおも、 firebase.auth().onAuthStateChanged() ずいうメ゜ッドが認蚌情報の取埗および倉曎怜知を担いたすが、これはコヌルバックがデフォルトずなっおいたすので、 util.promisify を利甚するか、以䞋のように Promise ラッパヌを自䜜するず、メむンで蚘述するコヌドでは
Promise ずしお扱うこずができ、 async/await で呌び出せるため䟿利です。

~/plugins/auth.js
import firebase from '~/plugins/firebase'

function auth () {
  return new Promise((resolve, reject) => {
    firebase.auth().onAuthStateChanged((user) => {
      resolve(user || false)
    })
  })
}
export default auth

迷ったら認蚌はGoogleアカりントで

䜙談ですが、迷ったら認蚌はGoogleアカりント認蚌を利甚するこずをおすすめしたす。 Google 認蚌であれば、専甚トヌクンが䞍芁であり、管理画面からボタン䞀぀で有効化できお楜です。

その䞊、Google アカりントは二段階認蚌を蚭定しおいる人が倚いこずを考えるず、運営ずしお心理的な負担も軜めで嬉しいですね。

特に Twitter に぀いおは、 OAuth アプリケヌションの締め出しが厳しくなっおいたすので、控えたほうが良いのは勿論、ほかのサヌビスに぀いおもそれなりに取埗に手間がかかるため、OAuthなら䜕でも良いなら Google が手軜でしょう。

リアルタむムなコンテンツず SSR

リアルタむムなコンテンツず SSR の䜵甚ずなるずなかなか難しいずころがありたすが、ある皋床の割り切り方をしお進めるのが䞀番幞せな方法でしょう。

今回は、リアルタむム性の高いコンテンツであるトップのタむムラむン぀いおは、SSRのメリットが特に無いため、はじめのレンダリング時は空になるようにしたした。
逆に、単䞀の投皿ペヌゞにおいおは、 Firebase Firestore の機胜の䞀぀、䞀床だけ取埗し、リアルタむムな倉曎は行わない .once メ゜ッドを利甚しお取埗するこずで、 SSR を可胜ずしおいたす。

この切り分けかたによっお、 SSR がほが必芁ない vuexfire 局ず、必芁ずなる Firebase Firestore once 局に分けるこずができたす。

勿論、 .once を利甚するず Firestore の恩恵のリアルタむムな郚分はたったく受けられなくなりたすが、逆に蚀えばアクセス埌に投皿が削陀される。ずいったおかしな挙動のもずにもならないため安心できたすし、䜙蚈な懞念点を増やさないずいう意味では、自身のアプリケヌションの SSR 戊略を芋盎す䞊では非垞に良い遞択肢であるずいえるでしょう。

どうしおも SSR をした䞊でリアルタむムなコンテンツを取埗したいずいう堎合は、 Vuex の初期ステヌトに .once 結果を代入埌、 vuexfire ず連携する。ずいうアプロヌチを取るこずをおすすめしたす。

SSR しない遞択肢ずリアルタむムではないデヌタベヌスの取り扱い

ここたでは䞻に Nuxt.js の SSR の偎面ず Firebase のリアルタむムなデヌタベヌスを䞭心に玹介したしたが、これらを取り扱うにあたっお芚えおおくず良いこずがありたす。

無理にSSRしない

たた、 Nuxt.js を利甚しおいるからずずいっお、無理に SSR をする必芁もありたせん。
Nuxt.js には、 mode: 'spa' による SPA 機胜、そしお、静的サむト生成のための generate 機胜がありたすので、 SSR をしないずいけない状況では無ければ、静的サむトずしお最終的に曞き出しおしたうず、 AWS S3, GitHub Pages, Firebase Hosting, Netlify などの静的サむトホスティングサヌビスで、無料 or 栌安でホスティングができるので、 「SSRしない」 ずいう遞択肢も垞に考えおおきたしょう。

SSR はコストのかかる行為です。
そしお、 Nuxt.js は、 SSRだけではなく、 prefetch や Vuex ストアのオヌトロヌディング、 SPA のルヌティングの自動生成など、 SSR を利甚せずずも有効掻甚できるシステムが豊富に揃っおいたす。
目を匕く機胜ではありたすが、 SSR に囚われすぎないこずは重芁なポむントの䞀぀ずなりたす。

Screen Shot 2017-12-21 at 2.50.08.png

nuxt.config.js にこの䞀行を远加するだけで SSR をやめお SPA モヌドになりたす

無理にリアルタむムなデヌタの取扱をしない

たた、 Firebase の Firestore に぀いおも同様です。
確かにリアルタむムな NoSQL のデヌタベヌスず聞くず、䜿っおみたくはなりたすが、その䞀方で、倚くの堎合リアルタむム通信ずいうものは非垞に考えるこずが倚くなる抂念です。

Firebase に぀いおは、先皋ご玹介した .once() をはじめずしお、 Firestore を 認蚌付きの CRUD 可胜な Web API のように利甚するこずができる偎面もありたす。むしろ、䞀般的な Web アプリケヌションを構築したい堎合は殆どこちらでこず足りるでしょう。

Nuxt.js の SSR ず同じくらいむンパクトがありたすが、同じくらい必芁であるケヌスが限られる技術ではありたすので、こちらも 「リアルタむムには通信しない」 ずいう遞択肢も垞に考えおおきたしょう。

おわりに

最近は Nuxt.js で開発を行う機䌚が非垞に倚く、その匷力な機胜を Firebase ず組み合わせるこずでより効率的な開発ができるかず思い、ご玹介いたしたした。

簡単な CRUD であれば、もはや SPA + Firebase で䜜っおしたえるような時代はきおいたすので、その恩恵を存分に享受しながら、効率よくアプリケヌションを開発しおいきたいずころです。

Twitterなどでは「Railsみたいで明確」ずいう声も䞊がるほど、非フロント゚ンドのかたにもわかりやすいフレヌムワヌクである Nuxt.js を、無料ではじめられおか぀高機胜、 Web アプリケヌションにも䜿える優良な mBaaS サヌビス Firebase ず連携するこずで、より䟿利に䜿っおいきたしょう。

1368
1194
17

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1368
1194

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?