お風呂に入った後、ドアは閉めておいた方が湿気が居室に流れてこないので望ましい と今日ネットで見たのですが、Hackerの皆様はどのようにお考えですか?
...話がそれました。早速本題に入ってまいります。
問題が生じた経緯
現在、以下のような構成で構築を進めているWebサイトのプロジェクトがあります。
ステータス変更を伴う管理画面 を開発していたのですが、頻繁にデータパターンの追加 が伴います。
例えば注文データを例に取った場合。以下のように並列で多数のステータスデータができ、フォームのセレクトボックスとして表示する必要が生じます。
<select name="status">
<option value="1">新規</option>
<option value="2">梱包中</option>
<option value="3">梱包完了</option>
<option value="4">発送準備</option>
<option value="5">発送開始</option>
<option value="6">配送センターに向けて輸送中</option>
<option value="7">配送センター到着</option>
<option value="8">顧客に向けて輸送中</option>
<option value="9">到着</option>
<option value="10">返送中</option>
<option value="11">返送完了</option>
</select>
改修前
改修を行う前はフロントエンド・バックエンドでそれぞれ以下のように別々にデータを持っていました。
フロントエンド(Next.js)の改修前
src/utils/common.ts
にgetOrderStatuses()
というメソッドを作り、配列を返すようにしていました。
export const getOrderStatuses = () => {
const orderStatuses = [
"新規",
"梱包中",
"梱包完了",
"発送準備",
"発送開始",
"配送センターに向けて輸送中",
"配送センター到着",
"顧客に向けて配達中",
"配達完了",
"返送中",
"返送完了",
];
return orderStatuses
}
Next.jsで開発段階においてこのような配列形式のデータを定義する場合
- こちらのように共通tsファイルに書いてしまうか
- そのまま配列をexportできるようにするか(よく考えたらこっちのほうが良かったですね...)
- ページコンポーネント(Appレイアウトの場合
/src/app/path/to/page.tsx
)に直接書いてしまうか
のいずれかになるでしょう。
バックエンド(Laravel)の改修前
config/適当なファイル名.php
にコンフィグファイルとして配列を定義します。
<?php
return [
'order_statuses' => [
'新規',
'梱包中',
'梱包完了',
'発送準備',
'発送開始',
'配送センターに向けて輸送中',
'配送センター到着',
'顧客に向けて配達中',
'配達完了',
'返送中',
'返送完了'
]
];
こちらを、ControllerやMiddlewareなど判定が必要な箇所で以下のように呼び出します。(configのキャッシュの再読み込みはこちらの方法で行っておきましょう)
$order_statused = config('order_status.order_statuses');
突き当たった問題
上記ご覧になっていただく通り、このままではファイルを定義する箇所が2箇所になってしまいます。1つ2つの属性を追加するだけでは手作業で済みますが、頻度が増えた場合、以下の問題が起きてくると思われます。
- 都度コピペ作業が生じて保守性が低下する。
- コピペ漏れにより、片方の環境で必要なパラメータが存在せず、バグとなってしまう。
プロジェクトに関わる人が多いほど、呼び出す箇所が多いほど、飛躍的に効率は落ちます。
こうなる前に両者を定義する箇所を1つにまとめましょう本記事のゴール
LaravelとNextJsの両方で同じ設定ファイルを手間なしで共有できるようにする。本記事では、YAML化までの解説を行い、ソートできる設定ファイル化は別稿にてお伝えします。
作業
yamlファイルの採用
古典的ではありますが、データ作成時の手間を考えて、yamlファイル を利用します。メンテしやすいように、バックエンドのLaravelの格納用ディレクトリであるstorage/app
にconfig.yaml
を作成し、両方のプロジェクトで利用が必要な定義をこちらにどんどん追加していきます。
結果、以下のようになります。
order:
statuses:
name:
- '新規',
- '梱包中'
- '梱包完了'
- '発送準備'
- '発送開始'
- '配送センターに向けて輸送中'
- '配送センター到着'
- '顧客に向けて配達中'
- '配達完了'
- '返送中'
- '返送完了'
フロントエンド(Nextjs)の改修後
以下のように、yamlファイルを読み込む専用の関数 を用意します。Appレイアウトではこちらは、ファイルの入出力を伴うため、サーバサイドコンポーネントとなることを留意してください。
(フロントエンドではブラウザでの実行となるので、読み込む対象のファイルがないはず、ですよね)
事前に js-yaml のインストールが必要
yarn add js-yaml
コンフィグを読み込む
import fs from 'fs'; // fsを使うのでサーバサイドとなる
import path from 'path';
import yaml from 'js-yaml';
export function getConfigData(configName = 'config.yaml') {
const configPath = path.join(process.cwd(), configName);
try {
const fileContents = fs.readFileSync(configPath, 'utf8');
const data = yaml.load(fileContents);
return data;
} catch (error) {
console.error('cant find yaml file', error);
return null;
}
}
こちらを、ページコンポーネントなどから以下の形で読み込みます。
const config = getConfigData('config.yaml')
読み込む対象のconfig.yaml
はフロントエンドのプロジェクトのルート直下にあることを想定しています。
バックエンド(Laravel)の改修後
Laravelでは、config以下の呼び出し箇所でYAMLを呼ぶように変えてしまいます。
以下のような形になります。
<?php
use Symfony\Component\Yaml\Yaml;
$configPath = storage_path('app/config.yaml');
$config = [];
if (file_exists($configPath)) {
$config = Yaml::parseFile($configPath);
}
return $config;
汎用的にYAMLの全データを取得できます が、一部に絞りたいときは、return $config["order"];
など適宜スコープのように
絞っていきましょう。
バックエンド => フロントエンドに共有する処理
これについてはいろいろ方法が考えられますが、一番シンプルに開発環境ということでコピーでやりましょう。
コピーする方向は、
- バックエンドからフロントエンドへ
です!
本番環境ではCIを組んでいたり、VercelのようなPaaSを使用しているとデプロイ時にコピー後のものが反映されるはずなので、あまり難しく考える必要はないはずです。それ以外の特殊な環境の場合は本記事の対象から漏れるものとします。どうしてもやりたいなら、自分だったらGCPのFirebase Realtime Databaseでも使うかな?
フロントエンド、Next.jsのpackage.json
を開き
開発サーバ立ち上げの呼び出し部分 を以下のようにしました。
"scripts": {
"dev": "cp -f ../backEndLaravelProject/storage/app/config.yaml ./ && next dev",
},
こうすることでリアルタイムではないですが、開発作業をしていれば両者の設定ファイルは基本的に同じものに保たれるはずです。
※パスは適宜自分の環境にものに変更してください。私の開発環境は、フロントエンドとバックエンドが同じディレクトリ以下に並列で設置してあります ので上記で対応しています。
デプロイするアプリケーションのバージョン違いには今後注意
フロントエンドとバックエンド、両者の整合性は、以前のバージョンにアプリケーションを切り戻すなどの場合は考える必要がありそうです。
バージョンが違うと結局設定ファイルが食い違いエラーが出る可能性があるため です。予防のためGitにて、リリース時のタグを貼っておくとミスが避けられて良いかと思います。
まとめ
本日は、フロントエンド・バックエンドで共通のYAMLを参照できるようにするまでを解説しました。基本的には開発環境にて、開発効率を上げるためのTIPS的な記事です。
余裕があれば、第2回記事として、ソートできるYAML設定ファイルを考えてみたいと思います。 (ソートするのであればデータベーステーブル化するのが一番早そうですが、本記事から具体的な方法は省略したいと思います。)
この記事が何かのお役に立てれば幸いです。
最後までお読みいただきありがとうございました!