このページはコミュニティによって翻訳されたもので、最新ではない可能性があります。参照用のバージョンをご覧ください。
このページはコミュニティによって翻訳されたもので、最新ではない可能性があります。参照用のバージョンをご覧ください。
このページはコミュニティによって翻訳されたもので、最新ではない可能性があります。参照用のバージョンをご覧ください。
FrankenPHPは、ウェブサーバー (Nginx、Apache) とPHP-FPMの両方を単一のバイナリで置き換えます。 このガイドでは、一般的なPHPアプリケーションの基本的な移行について説明します。
| PHP-FPM セットアップ | FrankenPHP の同等機能 |
|---|---|
| Nginx/Apache + PHP-FPM | 単一の frankenphp バイナリ |
php-fpm.conf プール設定 | frankenphp グローバルオプション |
Nginx server {} ブロック | Caddyfile サイトブロック |
php_value / php_admin_value | php_ini Caddyfile ディレクティブ |
pm = static / pm.max_children | num_threads |
pm = dynamic | max_threads auto |
| Webサーバーのリクエストフィルタリング | Caddy ルートとマッチャー |
標準のNginxまたはApacheパッケージから移行する場合、PHP-FPMがリクエストを受け取る前にウェブサーバーによって行われていたリクエストフィルタリングを確認してください。
FrankenPHPはCaddy上に構築されているため、Caddyfileまたは別のプロキシが最初に拒否しない限り、有効なHTTPメソッドとヘッダーはCaddyの通常のルーティングを通過します。
例えば、一部のウェブサーバーはデフォルトでTRACEリクエストを拒否します。
アプリケーションがその動作を維持する必要がある場合は、php_serverの前に明示的なマッチャーを追加してください。
example.com {
@trace method TRACE
respond @trace 405
root /var/www/app/public
php_server
}
以前のウェブサーバーが強制していたより厳密なメソッドまたはヘッダーポリシーに対しても、同じアプローチを適用してください。 リクエストヘッダー名にも同じことが言えます。一部のウェブサーバーやプロキシは、PHP-FPMがそれらを見る前に有効だが一般的ではないHTTPフィールド名を拒否または破棄しますが、FrankenPHPはそれらをPHPアプリケーションに渡す場合があります。
典型的なNginx + PHP-FPMの設定:
# /etc/nginx/sites-available/example.com
server {
listen 80;
server_name example.com;
root /var/www/app/public;
index index.php;
location / {
try_files $uri $uri/ /index.php$is_args$args;
}
location ~ \.php$ {
fastcgi_pass unix:/run/php/php-fpm.sock;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
単一のCaddyfileになります:
example.com {
root /var/www/app/public
php_server
}
これだけです。php_serverディレクティブは、PHPルーティング、try_filesのような動作、および静的ファイルの提供を処理します。
既存のphp.iniはそのまま動作します。設定で、インストール方法に応じてどこに配置するかを確認してください。
1つの設定の意味が変わります: max_execution_timeはFrankenPHPでは実時間をカウントしますが、Linux上のPHP-FPMの非ZTSビルドではCPU時間をカウントします。
データベースクエリ、HTTP呼び出し、sleep()、またはセッションファイルのロックを待つ時間も制限にカウントされるため、PHP-FPM用に調整された値は低すぎる可能性があります。
ディレクティブをCaddyfileに直接設定することもできます:
{
frankenphp {
php_ini memory_limit 256M
php_ini max_execution_time 30
}
}
example.com {
root /var/www/app/public
php_server
}
PHP-FPMでは、ワーカープロセスの数を制御するためにpm.max_childrenを調整します。
FrankenPHPでは、これに相当するのがnum_threadsです。
{
frankenphp {
num_threads 16
}
}
デフォルトでは、FrankenPHPはCPUあたり2つのスレッドを開始します。PHP-FPMのpm = dynamicに似た動的なスケーリングには:
{
frankenphp {
num_threads 4
max_threads auto
}
}
2つのコンテナ (Nginx + PHP-FPM) を使用する典型的なPHP-FPM Dockerセットアップは、単一のコンテナに置き換えることができます。
変更前:
# compose.yaml
services:
nginx:
image: nginx:1
volumes:
# mount Nginx config into the container
- ./config:/etc/nginx/conf.d
- .:/var/www/app
ports:
- "80:80"
- "443:443"
php:
image: php:8.5-fpm
volumes:
- .:/var/www/app
変更後:
# compose.yaml
services:
php:
image: dunglas/frankenphp:1-php8.5
volumes:
- .:/var/www/app
# mount the Caddyfile into the container
- ./config:/etc/frankenphp
- caddy_data:/data
- caddy_config:/config
ports:
- "80:80"
- "443:443"
- "443:443/udp"
volumes:
caddy_data:
caddy_config:
追加のPHP拡張機能が必要な場合は、カスタム Docker イメージの構築 を参照してください。
フレームワーク固有のDockerセットアップについては、Symfony Docker と FrankenPHP Docker イメージでLaravelを実行する を参照してください。
クラシックモードでは、FrankenPHPはPHP-FPMと同様に動作します。各リクエストはアプリケーションを最初から起動します。これは移行の安全な出発点です。
パフォーマンスを向上させるには、ワーカーモード に切り替えることができます。これはアプリケーションを一度起動し、メモリに保持します。
example.com {
root /var/www/app/public
php_server {
root /var/www/app/public
worker index.php 4
}
}
[!注意]
ワーカーモードはアプリケーションをリクエスト間でメモリに保持します。コードがリクエスト間でグローバル状態がリセットされることに依存していないことを確認してください。Symfony、Laravel、および API Platform のようなフレームワークは、このモードをネイティブでサポートしています。
移行後、以下のものは不要になります。
php-fpmサービス/プロセス)