TheLazy.Dev
Portfolio GitHub

Blog

php |phpfpm |httpd |openbsd

PHP-FPM 8.2 on OpenBSD 7.3

nabbisen

nabbisen

Posted on August 6, 2023

PHP-FPM 8.2 on OpenBSD 7.3

はじめに

OpenBSD 🐡 プロジェクトとコミュニティは PHP を含めて Web サービス向けパッケージを、ありがたいことに、とても良くサポートしています。

PHP 主要パッケージは Ports パッケージ・システムによってプリコンパイルされたバイナリとして提供されています。それだけで無く、エクステンション (拡張モジュール) や Composer、それから PECL ライブラリなどの、重要なソフトウェアも入手できます。NextCloud や Zabbix のようなフレームワークも同様です。

さらに、OpenBSD httpd と統合すると、その chroot 機構によってサーバーをセキュアな状態で維持するのに役立ちます。もちろん追加で relayd と統合することも可能です。

ところで、PHP-FPM という PHP の FastCGI プロセス・マネージャーがありますが、こちらは OpenBSD パッケージ管理上は PHP の一部として提供されています。
そのため PHP (php-?.? パッケージ名はインストールするバージョンによります) をインストールするだけで、php??_fpm も自動的にインストールされます 🙌

本記事でパッケージをインストールしてサーバーとして設定する流れをご紹介します。

環境

✿ ✿ ✿

チュートリアル

PHP のインストール

ます主要パッケージをインストールします:

$ doas pkg_add php
Enter fullscreen mode Exit fullscreen mode

以下のようにたずねられるでしょう:

quirks-6.121 signed on 2023-08-02T17:33:30Z
Ambiguous: choose package for php
a   0: <None>
    1: php-7.4.33p0
    2: php-8.0.29
    3: php-8.1.22
    4: php-8.2.9
Your choice:
Enter fullscreen mode Exit fullscreen mode

"4" すなわち 8.2 を選びます。
余談ですが、各バージョンのライフタイムは こちら で確認できます。

結果は以下の通りでした:

php-8.2.9:capstone-4.0.2: ok
php-8.2.9:femail-1.0p1: ok
php-8.2.9:femail-chroot-1.0p3: ok
php-8.2.9:libsodium-1.0.18p1: ok
php-8.2.9:argon2-20190702: ok
php-8.2.9:oniguruma-6.9.8: ok
php-8.2.9: ok
The following new rcscripts were installed: /etc/rc.d/php82_fpm
See rcctl(8) for details.
New and changed readme(s):
    /usr/local/share/doc/pkg-readmes/femail-chroot
    /usr/local/share/doc/pkg-readmes/php-8.2
Enter fullscreen mode Exit fullscreen mode

php-8.2 とともに php82_fpm がインストールされていますね !!

PHP の設定

以下のディレクトリとファイルが生成されています:

$ ls /etc/php*
/etc/php-8.2.ini    /etc/php-fpm.conf

/etc/php-8.2:

/etc/php-8.2.sample:
opcache.ini

/etc/php-fpm.d:
Enter fullscreen mode Exit fullscreen mode

.ini / .conf ファイル群は必要に応じて編集します。

カスタマイズ例 (オプション)

設定ファイルの編集:

$ doas nvim /etc/php-8.2.ini
Enter fullscreen mode Exit fullscreen mode

編集例:

- post_max_size = 8M
+ post_max_size = 30M
  (...)
- upload_max_filesize = 2M
+ upload_max_filesize = 24M
  (...)
- allow_url_fopen = Off
+ ; for composer; disabled in php-fpm
+ allow_url_fopen = On
Enter fullscreen mode Exit fullscreen mode

さらに、こちらのファイルを編集することもあるかもしれません:

$ doas nvim /etc/php-fpm.conf
Enter fullscreen mode Exit fullscreen mode

例えば末尾に以下を追加する等です:

+ ; set On in php.ini for composer, therefore:
+ php_admin_value[allow_url_fopen] = Off
Enter fullscreen mode Exit fullscreen mode

エクステンションの有効化 (オプション)

/etc/php-8.2.sample の中のファイル群は、PHP のエクステンションです。opcache.ini 等があります。
ニーズに応じて、その中から対象を選んでシンボリック・リンクを /etc/php-8.2/ に作成します。そうすることでエクステンション群が有効化されます:

$ doas ln -sf /etc/php-8.2.sample/${ini} /etc/php-8.2/
Enter fullscreen mode Exit fullscreen mode

ちょっとした参考情報ですが、操作対象が多い場合、シェルでループ処理にまかせることもできます 😉 こんな感じです:

$ # ksh の場合:
$ for x in $(ls /etc/php-8.2.sample/*); do doas ln -sf $x /etc/php-8.2/; done
$ # fish の場合:
$ for x in /etc/php-8.2.sample/*; doas ln -sf $x /etc/php-8.2/; end
Enter fullscreen mode Exit fullscreen mode

PHP-FPM の設定

順調ですね。PHP サービスをローンチするための準備がほぼ完了しました。

PHP の pkg-readme がインストール時に /usr/local/share/doc/pkg-readmes/php-8.2 としてつくられています。そこに以下のように書かれています:

OpenBSD php 主要パッケージに php-fpm すなわち FastCGI プロセス・マネージャーが含まれています。
これを使うことで FastCGI プロセスのプール管理を行えます: プロセスの起動 / 再起動を行ったり、
予備プロセスの最小数や最大数を設定された内容で調整したりできます。
rcctl(8) を使用して、ブート時に php-fpm を有効にしたり、
実行によって php-fpm を起動させたりできます:

rcctl enable php82_fpm

rcctl start php82_fpm

デーモンを有効化しましょう:

$ doas rcctl enable php82_fpm
Enter fullscreen mode Exit fullscreen mode

もう一つちょっとした参考情報です。上記によって /etc/rc.conf.local が更新されて、以下の行が追加あるいは変更されます:

+ pkg_scripts=(...) php82_fpm (...)
Enter fullscreen mode Exit fullscreen mode

さあ、デーモンを起動しましょう:

$ doas rcctl start php82_fpm
Enter fullscreen mode Exit fullscreen mode

結果は以下の通りでした:

php82_fpm(ok)
Enter fullscreen mode Exit fullscreen mode

成功です 😄

/var/www/etc の設定 (オプション)

これは PHP だけで無く他の Web アプリでも必要になることがあります。

/var/www/etc を設定します。ここでの etc は chroot が働いた後のものです。一例ですが、以下のようにして、名前解決や TLS 接続を有効化します:

$ ls -lR /var/www/etc
/var/www/etc:
total 16
-rw-r--r--  1 root  daemon   35 Aug 03 00:00 hosts
-r--r--r--  1 root  daemon  292 Aug 03 00:00 localtime
-rw-r--r--  1 root  daemon   99 Aug 03 00:00 resolv.conf
drwxr-xr-x  2 root  daemon  512 Aug 03 00:00 ssl/

/var/www/etc/ssl:
total 708
-r--r--r--  1 root  daemon  341121 Aug 03 00:00 cert.pem
-r--r--r--  1 root  daemon     745 Aug 03 00:00 openssl.cnf
Enter fullscreen mode Exit fullscreen mode

Web サーバーとの統合

次は、PHP 向け Web サーバーの設定です。

もしもまだ httpd 設定が無い場合のみ、OpenBSD が提供してくれている examples ディレクトリから、.conf ファイルをコピーします。以下のように行います:

$ doas cp -p /etc/examples/httpd.conf /etc/
Enter fullscreen mode Exit fullscreen mode

さて /etc/httpd.conf を更新して、fastcgi socket 定義を追加しましょう。SERVERS セクションに対して行います。以下のような感じです:

server "default" {
    listen on * port 80
    #listen on * port 443

    root "/htdocs"
    directory index index.php

    location "/*.php" {
        fastcgi socket "/run/php-fpm.sock"
    }
    location "/*.php[/?]*" {
        fastcgi socket "/run/php-fpm.sock"
    }
}
Enter fullscreen mode Exit fullscreen mode

このコンテキストで chroot が働いていることに気を付けましょう 💡
このため /etc/httpd.conf の fastcgi socket "/run/php-fpm.sock" は、実際には fastcgi socket "/var/www/run/php-fpm.sock" のことです。
これは root "/htdocs" が実際には "/var/www/htdocs" であることと同様です。

実際に見てみましょう。以下のようになっています:

$ ls -l /var/www/run
total 0
srw-rw----  1 www  www  0 Aug 03 00:01 php-fpm.sock=
Enter fullscreen mode Exit fullscreen mode

おわりに

サーバーのテストをしてみましょう。/var/www/htdocs/index.php を作成します:

$ echo "<?php phpinfo(1); ?>" | \
      doas tee "/var/www/htdocs/index.php" >> /dev/null
$ # delete it afterwards:
$ #doas rm /var/www/htdocs/index.php
Enter fullscreen mode Exit fullscreen mode

ブラウザでホストに接続します。PHP 設定情報が出力されるでしょう !!

php-82-on-openbsd-73

こんにちは PHP 8.2 on OpenBSD 7.3 です 🌻

✿ ✿ ✿

Happy serving 🕊🕊

💖 💪 🙅 🚩
nabbisen
nabbisen

Posted on August 6, 2023

Join Our Newsletter. No Spam, Only the good stuff.

Sign up to receive the latest update from our blog.

Related

PHP-FPM 8.2 on OpenBSD 7.3
php PHP-FPM 8.2 on OpenBSD 7.3

August 6, 2023

PHP-FPM 7.2 on OpenBSD 6.4
php PHP-FPM 7.2 on OpenBSD 6.4

December 13, 2018