Guide/スターター

スターター

Nuxt × WordPress Development Starter

Nuxt 4、WordPress 7、MySQL 8.4をDocker Composeでまとめて起動できる公開スターターです。

更新 2026-11-01読了 8分

このプロジェクトについて

このサイトは、hane-jp/nuxt-wordpress-docker の公式ドキュメントです。Nuxt、WordPress、MySQLを個別に準備せず、Docker Composeでまとめて起動できます。

ガイドの本文はMarkdownで管理しながら、開発環境ではWordPressも同時に起動します。Qiitaへ転用する原稿はGitで履歴を残し、WordPressでは実際のヘッドレスCMS連携を試せます。

2026年11月1日時点のスターターmainはNuxt 4.6.3を使い、Node.js >=24.22.1 <25・npm 11以上に対応します。DockerのNuxtサービスもNode.js 24.22.1です。PCへ直接Node.jsを入れて cd nuxt && npm ci を実行する場合は、この対応範囲を使ってください。

直近のmainにはnode-forge 1.4.1への限定修正が含まれます。brace-expansion 2.1.7 / 5.0.12はv1.1.1時点で反映済みです。glob/minimatchの対象GHSAは調査・検証のみで未解決のため、全依存が修正済みとは扱いません。版ごとの変更と残る課題は、スターターのCHANGELOGを確認してください。

それぞれの役割

担当役割
WordPress 7記事の作成、画像の管理、REST APIの提供
REST APIWordPressの投稿データをJSONで届ける
Nuxt 4REST APIをサーバー側で取得し、閲覧ページを表示
MySQL 8.4WordPressの投稿や設定を保存

このサイトの公開方法

公開用のNuxtは静的ファイルとして生成し、エックスサーバーへ配置します。WordPressは同じドメインの /wp で動かし、管理画面とREST APIを担当します。

ローカルでは元のスターターと同時に確認できるよう、このガイド自身は http://localhost:3001、付属WordPressは http://localhost:8081 を使います。

含まれるサンプル

  1. / — API接続状態と投稿件数
  2. /posts — WordPress投稿一覧
  3. /posts/[slug] — 投稿詳細
  4. /guide — 日本語の使い方ガイド
  5. /guide/en — 英語の使い方ガイド

導入だけを一気に読みたい場合は、公開済みのQiita入門記事も利用できます。