
※当ブログの記事にはアフィリエイトリンクを使用している場合があります。
目次
前提
CakePHPとVite+Reactを統合する際に、エラーとなった箇所があったため書き残します。
CakePHPとReactの統合はViteHelper plugin for CakePHPを使用しました。
この方法はVite公式にも記載されている推奨の方法になります。
バージョン情報
- CakePHP 4.3
- Vite 5.1
- React 18.2
エラー内容
ViteHelper plugin for CakePHPの手順通りに設定を行うと、ブラウザのコンソールに以下のエラーが表示されました。
Uncaught Error: vite-plugin-react can't detect preamble. Something is bad.
修正方法
fetchを行っている箇所の前(手順通りに構築している場合はレイアウトファイル)に以下を追加します。
<script type="module">
import RefreshRuntime from "http://localhost:3000/@react-refresh"
RefreshRuntime.injectIntoGlobalHook(window)
window.$RefreshReg$ = () => {}
window.$RefreshSig$ = () => (type) => type
window.__vite_plugin_react_preamble_installed__ = true
</script>
<?= $this->fetch('css') ?>
<?= $this->fetch('script') ?>
補足
今回のエラーと修正方法は以下のIssueに記載されていました。
Viteの開発者であるEvan Youさんが、以下のようにコメントをしています。(Google翻訳済み、一部省略)
PHP サーバー経由で HTML を提供しているのですね。
残念ながら、Vite プラグイン (この場合は@vitejs/plugin-react-refresh) は HTML の変更を挿入できません。
Node.js を使用していないため、Vite のプログラム API を利用して HTML 変更を挿入することはできません。
これ自体はバグではありませんが、改善する方法を検討する必要があります。
PHPサーバ経由でHTMLを提供している場合、HTMLの変更ができないためエラーが発生するようです。
私の場合はCakePHPとReactでしたが、他のPHP環境(Laravel等)や他のJavaScript環境(Vue等)でも同じエラーが発生するかもしれません。
まとめ
CakePHPにViteを導入する際にエラーが発生したため、この記事を書きました。
参考になれば幸いです。
関連記事

AWS IAMでPasskeyが利用可能に Windows PCで指紋認証を設定してみました
2024/08/22

React公式チュートリアルをVueでも書いて比較してみた
2024/06/22

Vueのスコープ付きCSSで子コンポーネントにCSSを適用する【Vue3】
2024/06/12

Vercel(Hobby)→AWS Amplify 移行して分かった両者の違い
2024/05/17

手軽に使えるVueプレイグラウンド環境。Vue SFC Playground解説
2024/04/08

Vite、TailwindCSS v4環境を構築【Tailwind CSS v4-alpha】
2024/03/07
オススメ記事

React公式チュートリアルをVueでも書いて比較してみた
2024/06/22

フロントエンド開発体験を向上させる10のnpmライブラリ【2024年版】
2024/01/14
2024/01/19

VueのdefineModelを活用した入力コンポーネントの作成方法【Vue3.4】
2024/01/07
2024/03/07

Nuxt3にStorybookを導入する方法
2023/11/22
2024/03/18

NuxtJSを使ってブログを作ってみた【Nuxt Content/TailwindCSS/daisyUI】
2023/08/25
2024/01/19

メッセージ送受信時にスクロール位置を最下部に維持する処理を実装【TypeScript/Vue.js】
2023/08/01
