🦣

かんたんWindowsでFrankenPHP

に公開

Intro

https://frankenphp.dev/

FrankenPHPというCaddyにPHPモジュールを組み込んだWebサーバーがあるのですが、久しぶりに最新リリースを見にいったらWindowsサポートしていたので動かしてみたいと思います。

FrankenPHP

公式ページに記載されている通りPowerShellでインストールしてもいいのですが、配布されているzipを展開してパスを通すだけで使えるので、リリースページからダウンロードしていきます。

https://github.com/php/frankenphp/releases

「frankenphp-windows-x86_64.zip」をダウンロードして、%USERPROFILE%\.frankenphpか%USERPROFILE%\.local\binのようなパスが通っているフォルダ上で展開します。

Windows版FrankenPHPはfrankenphp.exeのようなワンバイナリだけで動くわけではなく、PHPのビルド済みバイナリに直接リンクして動く仕組みなので、php-cgi.exeをはじめとしたexeファイルやdllファイルも同じフォルダで一緒に展開されます。

FrankenPHPのバージョンを確認します。

$ frankenphp version
FrankenPHP 1.12.1 PHP 8.5.4 Caddy v2.11.2 h1:iOlpsSiSKqEW+SIXrcZsZ/NO74SzB/ycqqvAIEfIm64=

PHPのバージョンも一緒に確認できました。

PHP

publicフォルダにindex.phpファイルを作成します。

mkdir public
public/index.php
<?php phpinfo(); ?>

FrankenPHPを起動してみるとエラーが発生します。

$ frankenphp php-server -r public -l localhost:8080
2026/03/13 08:00:00.333 WARN    admin   admin endpoint disabled
2026/03/13 08:00:00.334 INFO    tls.cache.maintenance   started background certificate maintenance      {"cache": "0x2bcf2f12fd80"}
2026/03/13 08:00:00.335 INFO    frankenphp      PHP Warning:  'C:\WINDOWS\SYSTEM32\VCRUNTIME140.dll' 14.29 is not compatible with this PHP build linked with 14.44 in Unknown on line 0 {"syslog_level": "notice"}

どうやらFrankenPHPではなくリンクしているPHPに関するエラーのようです。
これはWindowsにデフォルトでインストールされているMSVCのバージョンとPHPのバージョンが合わない時に発生するエラーです。

したがって、最新のVisual C++ v14再頒布可能パッケージをダウンロードしてインストールします(インストールには管理者権限が必要です)。

https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170

大体のPCはvc_redist.x64.exeをインストールすることになると思います。

最新のVisual C++ v14再頒布可能パッケージをインストールすることでPHPのエラーを解消でき、FrankenPHPを正常に起動できました。

$ frankenphp php-server -r public -l localhost:8080
2026/03/13 08:30:00.333 WARN    admin   admin endpoint disabled
2026/03/13 08:30:00.334 INFO    tls.cache.maintenance   started background certificate maintenance      {"cache": "0x169aea338100"}
2026/03/13 08:30:00.335 INFO    frankenphp      FrankenPHP started 🐘   {"php_version": "8.5.4", "num_threads": 8, "max_threads": 8}
2026/03/13 08:30:00.336 WARN    http    HTTP/2 skipped because it requires TLS  {"network": "tcp", "addr": "localhost:8080"}
2026/03/13 08:30:00.336 WARN    http    HTTP/3 skipped because it requires TLS  {"network": "tcp", "addr": "localhost:8080"}
2026/03/13 08:30:00.336 INFO    http.log        server running  {"name": "php", "protocols": ["h1", "h2", "h3"]}
2026/03/13 08:30:00.336 INFO    Caddy serving PHP app on localhost:8080
2026/03/13 08:30:00.337 INFO    tls     storage cleaning happened too recently; skipping for now        {"storage": "FileStorage:C:\\Users\\frankenphp\\AppData\\Roaming\\Caddy", "instance": "550e8400-e29b-41d4-a716-446655440000", "try_again": "2026/03/14 08:30:00.337", "try_again_in": 86400}
2026/03/13 08:30:00.338 INFO    tls     finished cleaning storage units

http://localhost:8080/にアクセスしてphpinfoをスクロールしていくと、FrankenPHPのバージョンも確認できます。

phpinfo

Outro

WindowsでPHPの環境構築をすると、まずはPHPのビルド済みバイナリをダウンロードして、php-cgi.exeを起動してもWebアプリが動かないのでFastCGIに対応したWebサーバーをインストールして、Webサーバーを起動してもCGIとリンクしないのでWebサーバーの設定ファイルをいじって、PHPの拡張機能が動かないのでphp.iniをいじって……と無限にやることがあるのですが、FrankenPHPを使えば簡単にモダンなWebサーバーと最新のPHPをWindowsに導入でき、他のOSでも同じように使えるfrankenphp php-cliコマンドとfrankenphp php-serverコマンドで簡単にCLIツールを使ったりWebアプリを作ったりできるようになるので、ぜひWindowsでPHPの環境構築に困った時は試してみてください。

Breakthrough

ちなみにFrankenPHPがWindowsサポートできたのはGo 1.26に追加されたMSVC clangサポートのおかげだそうです。

https://dunglas.dev/2026/03/windows-support-for-frankenphp-its-finally-alive/
https://learn.microsoft.com/en-us/cpp/build/clang-support-msbuild?view=msvc-170

Discussion