ドキュメントの全ページを検索するには、2文字以上入力してください。

↑ ↓ で移動 ↵ で開く esc で閉じる

rdev の使い方

PHP 拡張機能

rdev の PHP には、ほとんどのプロジェクトで必要な拡張機能が含まれています。bcmath、gd、imagick、intl、mbstring、pdo_mysql、pdo_pgsql、redis、apcu、soap、sodium、swoole、zip などです。完全な一覧は、サーバーで php -m を実行して確認できます。組み込みでない拡張機能は、rdev 独自のカタログからコマンド1つでインストールできます。

PHP バージョンを追加する

パネルで、サイドバーの サーバー からサーバーを開きます。PHP カードには、インストール済みの各 PHP バージョン、どれがデフォルトか、追加された拡張機能、読み込まれているモジュールが一覧表示されます。カード上部の PHP バージョンを追加 は、7.4 から 8.5 までの別のバージョンを、通常1分以内にインストールします。ほかのバージョンにあるカタログ拡張機能も追加され、デフォルトのバージョンは変わりません。この機能には rdev 0.2.0-beta.28 以降が必要です。サーバーでは、rdev install php 8.5 で同じことを(拡張機能なしで)行えます。

バージョンの行の ⋯ メニューから、デフォルトにしたり(php が実行するバージョンで、新しいサイトが使用します)、削除したりできます。デフォルトのバージョンは削除できません。サイトがまだ使用しているバージョンも削除できないため、先にサイトを移行してください。プロジェクト 列には、各バージョンで動作しているプロジェクトが表示されます。クリックすると別のバージョンに移行できます(rdev 0.2.0-beta.30 以降)。バージョンの横の phpinfo バッジを開くと、そのモジュールと完全な phpinfo が表示されます。サーバーは、依頼されたときにそれを読み取ります。これらには rdev 0.2.0-beta.29 以降が必要です。

バージョンの行の ⋯ メニューから、デフォルトにしたり(php が実行するバージョンで、新しいサイトが使用します)、削除したりできます。デフォルトのバージョンは削除できません。サイトがまだ使用しているバージョンも削除できないため、先にサイトを移行してください。これらには rdev 0.2.0-beta.29 以降が必要です。

拡張機能をインストールする

PHP カードで、バージョンの行の 拡張機能を追加 を選ぶと、そのバージョン用にカタログから拡張機能がインストールされます。追加された拡張機能の × で削除できます。サーバーは数秒で処理します。この機能には rdev 0.2.0-beta.24 以降が必要です。

サーバーでは次のとおりです。

rdev php ext install mongodb

これは、デフォルトの PHP バージョン用に拡張機能をインストールします。バージョンを指定するには --php を追加します。

rdev php ext install xdebug --php 8.3

rdev は、その PHP バージョンとサーバーのプロセッサ向けに作られたビルドをダウンロードし、署名とチェックサムを確認し、PHP が読み込めることを確かめてから、Web サーバーとコマンドラインの両方で有効にします。サーバー上でコンパイルされるものはありません。別の PHP バージョンのサイトでは、そのバージョン用にも拡張機能をインストールする必要があります。デフォルトのバージョンは、rdev use 8.4 で設定したものです。

拡張機能 PHP バージョン 備考
mongodb 8.1 – 8.5 mongodb/mongodb と mongodb/laravel-mongodb パッケージが必要とする MongoDB ドライバー。MongoDB サービス と併用します。
xdebug 7.4 – 8.5 ステップデバッグとプロファイリング。サイトを遅くしないよう、オフの状態でインストールされます。rdev php ini set 8.4 xdebug.mode debug でオンにします。
memcached 8.1 – 8.5 Memcached サーバー用のクライアント。
ssh2 8.1 – 8.5 PHP からの SSH と SFTP 接続。
yaml 8.1 – 8.5 高速な YAML の解析と書き込み。
maxminddb 8.1 – 8.5 MaxMind GeoIP2 データベースの高速リーダー。
igbinary 7.4 – 8.5 コンパクトなバイナリシリアライザー。Redis やキャッシュでよく使われます。
msgpack 7.4 – 8.5 MessagePack シリアライザー。
ds 7.4 – 8.5 効率的なデータ構造(ベクター、マップ、キュー)。
excimer 7.4 – 8.5 オーバーヘッドの小さいサンプリングプロファイラー。
xhprof 7.4 – 8.5 関数レベルのプロファイラー。
mailparse 7.4 – 8.5 メールメッセージの解析。
zstd 7.4 – 8.5 Zstandard 圧縮。
pcov 7.4 – 8.5 PHPUnit と Pest 向けの高速なコードカバレッジ(--coverage)。

memcached、ssh2、maxminddb は、rdev 0.2.0-beta.28 の環境に含まれるライブラリを使用します。それより前にインストールされたサーバーでは、先に sudo rdev host update を実行してください。

拡張機能は今後も追加されます。プロジェクトで必要なものが見つからない場合は、お知らせください。

拡張機能を確認・削除する

rdev php ext list
rdev php ext remove 8.4 mongodb

list は、各 PHP バージョンにインストールされているものを表示します。remove は、そのバージョンの拡張機能をオフにします。

独自のビルド

拡張機能を自分でビルドした場合は、その .so を PHP バージョンに登録します。

rdev php ext add 8.4 /home/dev/ext/scrypt.so

Xdebug や OPcache のように読み込まれる Zend 拡張機能の場合は、--zend を追加します。rdev は、その PHP バージョンに読み込めない拡張機能を拒否します。