システム開発

Laravel(API)とNuxt.jsの連携を行う【Laravel6+Nuxt.jsで作る管理画面】

PHPの人気のフレームワークLaravelを利用してWebサイトの管理画面を開発することができます。

このシリーズではそんな管理画面の構築に関して、技術者向けにその手順を紹介していきます。

まず本記事ではNuxt.jsの連携方法まで。続きはこちらの記事を参考にして下さいね。

・Laravelを使って構築をしたい方
・Webサイト構築の具体的な手法が知りたい方

これらに当てはまる方におすすめの記事となっています。これを読めばLaravel(API)とNuxt.jsの連携方法が丸わかりですよ。

Nuxt.jsでの構築がおすすめの理由

Laravel6ではVue.jsがデフォルトから削除され、JSの構成に関しては開発者に完全に委ねられている状態のため、
しっかり規約を設けて開発スピードの向上を図る必要があります。

そこで必要な機能が一通り揃っていて、 規約に沿った開発思想でスピードが出そうなNuxt.jsがおすすめです。

Next.jsはNuxtに比べると機能がミニマムですが、Reactの既存資産が多い場合はありだと思います。

リポジトリは別々で管理しよう

そもそもフロントエンドにJSを使う理由は、 Laravelと疎結合にすることで人材の採用要件を下げたりそれぞれの開発に集中できるようにするためです。

同一リポジトリだと結局両方の知識が求められますし複雑になるので、リポジトリは別管理していきましょう。

Laravel(API)とNuxt.jsの連携を行う

いよいよLaravel(API)とNuxt.jsの具体的な連携方法を紹介していきます。

1.最低限必要な機能を決める

機能を詰め込みすぎても実装が終わりません。必要最低限の機能にとどめて構築することをおすすめします。

今回は、 管理画面に最低限必要な機能としてユーザー認証とCRUD機能を作ることにしました。

2.Laravelのプロジェクトを作成する

こちらの記事でLaravel6の環境構築は解説しているので、詳しくは割愛します。

以下のコマンドでLaravelのプロジェクトを作成します。

composer create-project --prefer-dist laravel/laravel admin_laravel_api "6.*"

3.APIを作る

次にフロントエンド側との通信を試すため、シンプルなAPIを用意します。

routes/api.phpに以下コードを追加します。

Route::get('/', function() {
    return 'helloworld';
});

下記コマンドでサーバーを立ち上げておきます。

php artisan serve

これでhttp:localhost:8000/apiへアクセスしたらhelloworldの文字列を返すAPIが出来ました。

4.Nuxt.jsのプロジェクトを作成する

次に下記コマンドでLaravelとは別にNuxt.jsのプロジェクトを作成します。

yarn create nuxt-app admin_next_app

yarn create nuxt-appは下記コマンドと同義です。

yarn global add create-nuxt-app
create-nuxt-app my-app

create-nuxt-appはNuxt.jsのセットアップをコマンド1つで行ってくれるツールです。

必要なものは後から入れたいので、
すぐに利用するaxios以外はデフォルトのままにしました。

5.Nuxt.jsからAPIを使う

pages/index.vue<script>の中身を以下に書き換えます。

<script>
import Logo from '~/components/Logo.vue'

export default {
  components: {
    Logo
  },
  async asyncData(app) {
    const data = await app.$axios.$get('http://localhost:8000/api')
    return {
      data
    }
  }
}
</script>

asyncDataは非同期なデータが用意できてから画面描写してくれるメソッドです。
returnで返したオブジェクトを<template>内で参照できます。

先ほど受け取ったデータを{{data}}で画面に表示します。

<template>
  <div class="container">
    <div>
      <logo />
      <h1 class="title">
        {{data}}
      </h1>
      <h2 class="subtitle">
        My superb Nuxt.js project
      </h2>
      <div class="links">
        <a
          href="https://nuxtjs.org/"
          target="_blank"
          class="button--green"
        >
          Documentation
        </a>
        <a
          href="https://github.com/nuxt/nuxt.js"
          target="_blank"
          class="button--grey"
        >
          GitHub
        </a>
      </div>
    </div>
  </div>
</template>

下記のコマンドでサーバーを立ち上げ、

yarn run dev 

http://localhost:3000にアクセスしたら以下の画面が表示されればOKです。

5.プロキシ設定を行う

今のままだとAPIアクセスする時にホスト名を毎回指定する必要があります。

それを解決するためのモジュールがNuxt.jsには用意されているので、
下記コマンドでインストールします。

yarn add @nuxtjs/proxy

次にnuxt.config.jsを下記のように変更します。

const environment = process.env.NODE_ENV || 'development';

export default {
  mode: 'universal',
  /*
  ** Headers of the page
  */  head: {
    title: process.env.npm_package_name || '',
    meta: [
      { charset: 'utf-8' },
      { name: 'viewport', content: 'width=device-width, initial-scale=1' },
      { hid: 'description', name: 'description', content: process.env.npm_package_description || '' }
    ],
    link: [
      { rel: 'icon', type: 'image/x-icon', href: '/favicon.ico' }
    ]
  },
  /*
  ** Customize the progress-bar color
  */  loading: { color: '#fff' },
  /*
  ** Global CSS
  */  css: [
  ],
  /*
  ** Plugins to load before mounting the App
  */  plugins: [
  ],
  /*
  ** Nuxt.js dev-modules
  */  buildModules: [
  ],
  /*
  ** Nuxt.js modules
  */  modules: [
    // Doc: https://axios.nuxtjs.org/usage
    '@nuxtjs/axios',
    '@nuxtjs/proxy',
  ],
  proxy: {
    '/api': (environment === 'development') ? 'http://localhost:8000' : 'https://api.example.com'
  },
  /*
  ** Axios module configuration
  ** See https://axios.nuxtjs.org/options
  */  axios: {
  },
  /*
  ** Build configuration
  */  build: {
    /*
    ** You can extend webpack config here
    */    extend (config, ctx) {
    }
  }
}

開発環境: /api http://localhost:8000/api
開発環境以外: /apihttps//api.example.com/api

にそれぞれアクセスを変更する設定です。
これで以下のようにホスト名を省略した記述が可能になります。

<script>
import Logo from '~/components/Logo.vue'

export default {
  components: {
    Logo
  },
  async asyncData(app) {
    const data = await app.$axios.$get('/api')
    return {
      data
    }
  }
}
</script>

おわりに

この記事では Nuxt.jsからLaravelのAPIをAjaxで通信できるようにする手順まで紹介していきました。
管理画面に最低限必要なユーザー認証やCRUD機能の実装方法などに関しては、こちらの記事で紹介しています。

このようにPHPを利用すればWeb開発が行えます。今回紹介した内容の他にも様々な構築が可能。

DEHAソリューションズではPHPに強いエンジニアが多数在籍しています。エンジニアを1から採用するよりも、効率的で低コストで、エンジニアのスポット派遣や開発サポートもおこなっています。

Laravelの環境構築を行いたい方や、PHPエンジニアの採用をしたい方はぜひお問い合わせください。

PHPエンジニアについての無料お問い合わせはこちら▶

Mai Tran

Recent Posts

請負型とは?メリット・デメリットから活用シーンまで徹底解説

近年、開発コスト削減やリソース確保を目的として「オフショア開発」を導入する企業が増えています。 その中でも開発スタイルとして注目されているのが「請負型(受託型)」の契約形態です。 この記事では、請負型の基本的な概要から、メリット・デメリット、向いているプロジェクトの特徴、活用シーンまでを徹底解説します。 オフショア開発が気になる方 請負型について気になる方 社内のIT人材が不足している方 これらに当てはまる方におすすめの記事となっています。これを読めばオフショア開発の請負型について メリットデメリットがわかるだけでなく活用できるシーンまで丸わかりですよ。 (more…)

20 hours ago

【2025年版】「ベトナムIT企業トップ10」から見るベトナムIT企業の現状と課題|オフショア開発

ITの進化が止まらないベトナム。国策としてのIT教育が充実していて、若者のIT人口が多いのも特徴です。 そんなベトナムIT企業のランキング指標として、毎年発表されているのが「ベトナムIT企業トップ10」(前身:ベトナムIT企業 トップ50+10社)というものです。 この記事ではそんな「ベトナムIT企業トップ10」を参考に、ベトナムのIT企業の現状と課題について見ていきましょう。 ベトナムのIT事情が気になる方 オフショア開発が気になる方 ベトナムITの課題を知りたい方 社内のIT人材が不足している方 これらに当てはまる方におすすめの記事となっています。これを読めばベトナムのIT企業の現状が丸わかりですよ。 (more…)

4 days ago

オフショア開発でベトナムが選ばれる7つの理由

安価な労働力を利用して開発コストの削減ができるオフショア開発は中国とインドが中心でしたが、近年ベトナムオフショアに注目が集まっています。 この記事ではそんなベトナムオフショアが選ばれる7つの理由について解説しています。 ・オフショア開発が気になる方・社内のIT人材が不足している事業者の方・ベトナムオフショアについて知りたい方 これらに当てはまる方におすすめの記事となっています。これを読めば今大注目のベトナムオフショアのことがまる分かりですよ。 (more…)

2 weeks ago

PWAとは?機能、導入メリットと実装事例

近年、スマートフォンの普及とともに、ユーザーにとって使いやすく、企業にとっても効果的なウェブ体験の提供が求められています。 そうした中で注目されているのが「PWA(Progressive Web Apps)」です。 この記事では、PWAの概要や機能、導入によるメリット、そして具体的な導入事例についてわかりやすく解説します。 PWAが気になる方 アプリ開発をしたい方 開発効率を上げたい方 これらに当てはまる方におすすめの記事となっています。これを読めばPWAの特徴や導入のメリットなども分かりますよ。 (more…)

2 weeks ago

【保存版・発注者向け】アプリ開発の方法についてゼロから解説

アプリ開発を検討する企業や個人にとって、最初に直面する課題は「どのようにアプリを作るか」です。 そこで本記事ではアプリ開発について、どのような工程があるのかゼロから徹底解説していきたいと思います。 アプリ開発をしたい方 アプリ開発初心者の方 社内のIT人材が不足している方 これらに当てはまる方におすすめの記事となっています。これを読めばアプリ開発の効率の良い方法が丸わかりですよ。 アプリ開発に関わるすべての工程や手法を理解することで、発注者としてより良い判断ができ、プロジェクトを円滑に進めることが可能になります。 (more…)

3 weeks ago

チャイナプラスワンとは?製造業だけではなく、IT業界も注目

近年、製造業を中心に広がってきた「チャイナプラスワン(China Plus One、中国+1)」戦略が、IT業界でも注目され始めています。 中国に依存しすぎない経営体制を構築するためのこの動きは、製造業の枠を越え、ソフトウェア開発やITインフラといったデジタル領域にも拡大しています。 この記事では、チャイナプラスワンの概要から背景、IT業界における注目理由、そしてオフショア開発との関係性や活用事例までを詳しく解説します。 チャイナプラスワンについて知りたい方 オフショア開発に興味がある方 社内のIT人材が不足している方 これらに当てはまる方におすすめの記事となっています。これを読めばチャイナプラスワンの概要がわかるだけでなく、今後の展望も分かりますよ。 (more…)

3 weeks ago