新しいPHP拡張モジュールインストール方法「PHP Installer for Extensions (PIE)」を使ってみよう！

#phpcon_odawara © 2012-2025 BASE, Inc. 新しいPHP拡張モジュールインストール方法「PHP Installer for Extensions
(PIE)」を使ってみよう！ | BASE, Inc. 新しいPHP拡張モジュールインストール方法「PHP Installer for Extensions (PIE)」を使ってみよう！ 02 @PHPカンファレンス小田原2025 2025.04.12

(PIE)」を使ってみよう！ Speaker Proﬁle 2 02 Otsu Kazuki BASE BANK Dept. Engineering Program Manager ：@cocoeyes02 PHPカンファレンス2024,2025 実行委員長

(PIE)」を使ってみよう！ 3 今回話すこと • PIEとは？ • PIEを実際に動かしてみる • PIEの仕組みや背景を広く浅く解説する

(PIE)」を使ってみよう！ 4 今回話さないこと • PIEの最適な運用 ◦ まだ開発初期段階なので、今後のアップデートで最適な運用も変わりそう • PIEをクラスレベルまでリーディングする ◦ リーディングのヒントになる資料や図は紹介します

(PIE)」を使ってみよう！ 6 PIEとは？新しい PECL の要件このドキュメントでは、PECL の代替として必要な要件について説明します。現在の PECL は以下の要素で構成されています： • インストーラー兼パッケージャー（pecl コマンドラインツール） • ウェブサイト（pecl.php.net） • パッケージの内容を記述する方法（package.xml）このウェブサイトと pecl ツールはかなり前に作られたもので、保守性の問題やコードの劣化に悩まされています。PECL には、パッケージの署名や、PHP バージョンごとの対応拡張の最新バージョン検索といった、現代的な機能が欠けています。このドキュメントは、PHP 拡張エコシステムを最新のプロセスに追いつかせるための代替ツールに必要な要件をまとめたものです。（後略） https://docs.google.com/document/d/1_N0E9xo3jn9aKrIZHIbTYaY5lXw71BpSO6-it4cRpDo/edit?tab=t.0

(PIE)」を使ってみよう！ 7 ざっと初期段階の要件をまとめると • PEAR に依存しない、新しいPHP Extension（C言語製のPHP拡張モジュール）インストール方法 • PECLの代わりとなることを強く意識して生まれた • 初回リリースするものと将来的にリリースするかもしれないものでスコープを分けてリリースする https://docs.google.com/document/d/1_N0E9xo3jn9aKrIZHIbTYaY5lXw71BpSO6-it4cRpDo/edit?tab=t.0 PIEとは？

(PIE)」を使ってみよう！ 8 PIEの設計ドキュメントも公開されています https://github.com/ThePHPF/pie-design PIEとは？

(PIE)」を使ってみよう！ 9 PHP Foundation内でのdisucussionした公開ログも（45分のログ） https://gist.github.com/pronskiy/621bc8f8e901d4cd1f5a630c463be5b2 PIEとは？

(PIE)」を使ってみよう！ 11 PIEをインストールしてみる PIEのインストール手順 https://github.com/php/pie/blob/main/docs/usage.md

(PIE)」を使ってみよう！ 12 PIEをインストールしてみるせっかくなので、PECLとPIEを使ってインストールしてみましょう例：Xdebug環境をDockerで用意する試したい方はURLからどうぞ！ https://github.com/cocoeyes02/phpconodawara2025-pie

(PIE)」を使ってみよう！ 13 PIEをインストールしてみる PECL https://github.com/cocoeyes02/phpconodawara2025-pie/blob/main/pecl/Dockerﬁle

(PIE)」を使ってみよう！ 14 PIEをインストールしてみる PECL https://github.com/cocoeyes02/phpconodawara2025-pie/blob/main/pecl/Dockerﬁle PECLでxdebugをインストールする

(PIE)」を使ってみよう！ 15 PIEをインストールしてみる PIE https://github.com/cocoeyes02/phpconodawara2025-pie/blob/main/pie/Dockerﬁle

(PIE)」を使ってみよう！ 16 PIEをインストールしてみる PIE https://github.com/cocoeyes02/phpconodawara2025-pie/blob/main/pie/Dockerﬁle PIEに必要な依存関係を追加する

(PIE)」を使ってみよう！ 17 PIEをインストールしてみる PIE https://github.com/cocoeyes02/phpconodawara2025-pie/blob/main/pie/Dockerﬁle PIE自体をダウンロードする

(PIE)」を使ってみよう！ 18 PIEをインストールしてみる PIE https://github.com/cocoeyes02/phpconodawara2025-pie/blob/main/pie/Dockerﬁle PIEでxdebugをインストールする

(PIE)」を使ってみよう！ 19 PIEをインストールしてみる PECL PIE

(PIE)」を使ってみよう！ 20 PIEをインストールしてみる PECL PIE 単純な比較だが、xdebugなら PIEの方が処理早い？（条件揃えてベンチマークしてみても面白いかも）

(PIE)」を使ってみよう！ 22 PIEはComposerライクな仕様で柔軟性がある

(PIE)」を使ってみよう！ 23 PECLとPIEの使用感を比較してみると一例を紹介します • バージョニング • ダウンロード元について

(PIE)」を使ってみよう！ 25 バージョニング PECL • 何もバージョン指定がない場合、常に最新バージョンを持ってくる • バージョン指定する場合は、完全固定（xdebug-3.4.1みたいな）

(PIE)」を使ってみよう！ 26 バージョニング PIE • 何もバージョン指定がない場合、条件に合う中で最新の安定バージョンを持ってきてくれる • Composer同様の記法を採用しているので、柔軟なバージョン指定ができる（~1.0、^2.3@beta）

(PIE)」を使ってみよう！ 27 バージョニング https://github.com/cocoeyes02/phpconodawara2025-pie/blob/main/pie-versioning/Dockerﬁle バージョニング

(PIE)」を使ってみよう！ 28 https://github.com/cocoeyes02/phpconodawara2025-pie/blob/main/pie-versioning/Dockerﬁle 3.4.1 or 3.4.0がインストールされる（この場合は3.4.1）バージョニング

(PIE)」を使ってみよう！ 30 ダウンロード元について PECL • 基本PECLリポジトリのみダウンロードできるので、時にはローカルで手動ビルドすることも・・・ ◦ 「PECLには古いバージョンしかない」 ◦ 「バグフィックスがGitHubリポジトリにだけある」 • channel.xmlを使ってPECLリポジトリ以外をダウンロード元にする事もできるが、今だと使いづらい ◦ REST APIである必要がある ◦ .tgz のパッケージや package.xmlが必要

(PIE)」を使ってみよう！ 31 PIE • 様々な経路でダウンロード、ビルド&インストールが可能 ◦ packagist（基本はここがデフォルト） ◦ private packagist ◦ packagistに登録していないgithubリポジトリ ◦ ローカルファイルで • 経路を変えてあげるだけで、手動でビルドする必要がなくなるダウンロード元について

(PIE)」を使ってみよう！ 32 https://github.com/cocoeyes02/phpconodawara2025-pie/blob/main/pie-download-repository/Dockerﬁle ダウンロード元について

(PIE)」を使ってみよう！ 33 https://github.com/cocoeyes02/phpconodawara2025-pie/blob/main/pie-download-repository/Dockerﬁle ダウンロード元について Githubリポジトリから直接ダウンロードするようにする

(PIE)」を使ってみよう！ 35 PIE • 様々な経路でダウンロード、ビルド&インストールが可能 ◦ packagist（基本はここがデフォルト） ◦ private packagist ◦ packagistに登録していないgithubリポジトリ ◦ ローカルファイルで • 経路を変えてあげるだけで、手動でビルドする必要がなくなるダウンロード元について（再掲）

(PIE)」を使ってみよう！ 36 1. 条件に合う中で最新の安定バージョンを持ってくる a. composerがメタデータを取得しにpackagistへリクエストしている 2. ファイルをビルド or 取得 a. ファイルを解凍してビルド（Windows 以外） b. DLL を取得（Windows） 3. インストール a. Make Install（Windows 以外） b. DLL をコピー（Windows） 4. リリースノートを表示して、ダウンロードとビルドファイルの削除 packagist経由でPIEのインストールをする

(PIE)」を使ってみよう！ 37 クラス名に違いはありますが、大まかな全体像は初期構想時点の図を見るとよいです！（コードリーディングにも役立ちます） packagist経由でPIEのインストールをする https://github.com/ThePHPF/pie-design?tab=readme-ov-ﬁle#high-level-overview

(PIE)」を使ってみよう！ 38 現在packagistで対応しているPHP拡張モジュール一覧 https://packagist.org/extensions 新規で登録するには・・・ 1. composer.json に必要な情報を書いてコミットする 2. https://packagist.org/packages/submit にアクセス 3. リポジトリのURLを入力し、手順に従って登録（Windowsの場合はビルド済みのdllを用意するなど別の手順が必要ですが、時間の関係で割愛します🙏）新規のPHP拡張モジュールをpackagistに登録する

(PIE)」を使ってみよう！ 39 現在packagistで対応しているPHP拡張モジュール一覧 https://packagist.org/extensions 新規で登録するには・・・ 1. composer.json に必要な情報を書いてコミットする 2. https://packagist.org/packages/submit にアクセス 3. リポジトリのURLを入力し、手順に従って登録（Windowsの場合はビルド済みのdllを用意するなど別の手順が必要ですが、時間の関係で割愛します🙏）新規のPHP拡張モジュールをpackagistに登録する

(PIE)」を使ってみよう！ 40 composer.jsonに、”php-ext”に続いて書く新規のPHP拡張モジュールをpackagistに登録する https://github.com/ThePHPF/pie-design?tab=readme-ov-ﬁle#extension-maintainer-register-a-pie-package

(PIE)」を使ってみよう！ 41 PHPerKaigi 2025にて、きんじょうひできさんがパンフ記事に書いた、「PIEとPackagist」がpackagistへのリクエストの理解に役立ちます！新規のPHP拡張モジュールをpackagistに登録する https://fortee.jp/phperkaigi-2025/proposal/729a5966-42ed-4199-abc4-54017d795ace

(PIE)」を使ってみよう！ 43 ざっと初期段階の要件をまとめると • PEAR に依存しない、新しいPHP Extension（C言語製のPHP拡張モジュール）インストール方法 • PECLの代わりとなることを強く意識して生まれた • 初回リリースするものと将来的にリリースするかもしれないものでスコープを分けてリリースする https://docs.google.com/document/d/1_N0E9xo3jn9aKrIZHIbTYaY5lXw71BpSO6-it4cRpDo/edit?tab=t.0 PIEとは？（再掲）

(PIE)」を使ってみよう！ 44 • pie self-update • Windows 環境での動的バイナリビルド • Windows 以外のプラットフォーム向けバイナリ配布 • プロジェクト単位での拡張機能インストール • 署名インフラと署名の検証処理 • composer.json 内に Changelog セクションを追加する機能 • PIE ツールに「search」機能を追加すること • composer.json ファイル内でセキュリティ上の問題を一覧表示する https://github.com/ThePHPF/pie-design?tab=readme-ov-ﬁle#out-of-initial-scope 初期リリースから外したもの

(PIE)」を使ってみよう！ 45 まだ開発初期段階とのことなので、開発環境や試験的なプロジェクトだったら導入してみても良さそうかなと思いました！本番環境で使用するのは、まだ慎重になった方が良いかも・・・ composerみたいにプロジェクト毎でPHP Extentionがインストール、管理できるようになったらアツいなあ・・・と個人的には思います！今後の動向に注目しましょう！最後に

(PIE)」を使ってみよう！ BASE Recruitment Information Our Mission Payment to the People, Power to the People. 自分の好きなことを仕事にしたり経済活動を行っている個人やスモールチームのエンパワーメントを目指しています。 46 BASE BANKで一緒に働くメンバーを大募集中！絶賛募集中！！ - Webアプリケーションエンジニア - シニアエンジニア - テックリード - とにかくエンジニア

新しいPHP拡張モジュールインストール方法「PHP Installer for Extensi...

新しいPHP拡張モジュールインストール方法「PHP Installer for Extensions (PIE)」を使ってみよう！

More Decks by 02

Other Decks in Programming

Featured

Transcript