ランタイム設定

警告:

この機能は非推奨です。 代わりに環境変数の使用を推奨します。これによりランタイム値の読み取りもサポートできます。

register関数を使用してサーバー起動時にコードを実行できます。

この機能は自動静的最適化、出力ファイルトレース、またはReactサーバーコンポーネントと互換性がありません。

アプリにランタイム設定を追加するには、next.config.jsを開き、publicRuntimeConfigとserverRuntimeConfigの設定を追加します：

next.config.js

module.exports = {
  serverRuntimeConfig: {
    // サーバー側でのみ利用可能
    mySecret: 'secret',
    secondSecret: process.env.SECOND_SECRET, // 環境変数をパススルー
  },
  publicRuntimeConfig: {
    // サーバーとクライアントの両方で利用可能
    staticFolder: '/static',
  },
}

サーバー専用のランタイム設定はserverRuntimeConfigの下に配置します。

クライアントとサーバーの両方のコードでアクセス可能な設定はpublicRuntimeConfigの下に配置します。

publicRuntimeConfigに依存するページは、必ずgetInitialPropsまたはgetServerSidePropsを使用するか、getInitialPropsを持つカスタムAppを使用して自動静的最適化をオプトアウトする必要があります。サーバーサイドでレンダリングされない限り、ランタイム設定はどのページ（またはページ内のコンポーネント）でも利用できません。

アプリ内でランタイム設定にアクセスするには、次のようにnext/configを使用します：

import getConfig from 'next/config'
import Image from 'next/image'
 
// serverRuntimeConfigとpublicRuntimeConfigのみを保持
const { serverRuntimeConfig, publicRuntimeConfig } = getConfig()
// サーバー側でのみ利用可能
console.log(serverRuntimeConfig.mySecret)
// サーバー側とクライアント側の両方で利用可能
console.log(publicRuntimeConfig.staticFolder)
 
function MyImage() {
  return (
    <div>
      <Image
        src={`${publicRuntimeConfig.staticFolder}/logo.png`}
        alt="logo"
        layout="fill"
      />
    </div>
  )
}
 
export default MyImage