Slide 1

Slide 1 text

怖くないComposer 2025 PHP Conference 2025.06.28 | CTO室 雫石 © kaonavi, inc.

Slide 2

Slide 2 text

INDEX 1 . 自己紹介 3 .Composer 4 .ちょっとしたデモ 5 .お伝えしたいこと 2 © kaonavi, inc. 2 2 .お伝えしたいこと

Slide 3

Slide 3 text

自己紹介 © kaonavi, inc. 3

Slide 4

Slide 4 text

雫石    株式会社カオナビ CTO室所属 現在13社目... 組み込み系 /家庭用ゲーム開発 /ソシャゲ開発 PHP暦約9年、最近は Goばかり書いてます ・X、やってません。 ・Facebook、やってません。 ・Note、やってません。 「発信」という行動は今回が初です...。優しい目で見ていただけると嬉しいです...! 自己紹介 © kaonavi, inc. 4

Slide 5

Slide 5 text

お伝えしたいこと © kaonavi, inc. 5

Slide 6

Slide 6 text

ドメイン固有処理以外は、 大抵Packagistにある (PHPのとても良い点) ・多言語と比較しても、PHPのエコシステムはとても充実 ・世界中から使われているライブラリは信頼に足る ・多くの場合、実装がエレガント ・自分で作ると単純に時間がかかる 車輪の再発明は辛いということ © kaonavi, inc. 6 自前での実装をなるべく減らし、楽をしましょう

Slide 7

Slide 7 text

Composer © kaonavi, inc. 7

Slide 8

Slide 8 text

composerの概要 © kaonavi, inc. 8 PHPの依存関係管理ツールです。プロジェクトに必要なライ ブラリやパッケージを自動的にダウンロード・管理してくれま す。 他にも... - よく使うコマンドをタスクとして登録できたり - 動作環境の制限指定ができたり - パッケージの脆弱性を診断したり

Slide 9

Slide 9 text

おそらく使っていないプロジェクトの方が少ないはず © kaonavi, inc. 9 必要要件  PHP5.3.2以上 インストール   curl -sS https://getcomposer.org/installer | php mv composer.phar /usr/local/bin/composer php:8.2-fpmなどのDockerイメージには最初から インストールされていないことがほとんどなので、 Dockerfileなどでインストールが必要

Slide 10

Slide 10 text

経験則ですが ... © kaonavi, inc. 10 リアルガチに、 composer使っていないプロジェクトっ て結構経験しました。   大抵、オレオレ PHPフレームワークを採用している場 合でした。   「どうして composer使ってないんですか?」 という質問に、明確に理由が返ってきた経験はありま せん。

Slide 11

Slide 11 text

composer無くてもよくない? © kaonavi, inc. 11 別に無くても製品は作れますが、 ツラい   できるだけ、プロジェクトに composerを導入できるよう にこのセッションで怖くなってほしいです - 手動でライブラリをダウンロード・配置する必要がある - バージョン管理が困難で、ライブラリ同士の依存関係で頭を抱える - アップデートの度に手作業で差し替え作業

Slide 12

Slide 12 text

[技術的]composer.jsonについて © kaonavi, inc. 12 - composerにおける動作の起点となるファイル - composer.jsonを理解する = composerを理解する { "name": "your-company/awesome-project", "require": { "monolog/monolog": "^3.0" }, "autoload": { "psr-4": { "App\\": "src/" } } }

Slide 13

Slide 13 text

[技術的]パッケージを install © kaonavi, inc. 13 composer install - これだけで、依存パッケージ含め、必要なソースがVendor下に配置される - 依存関係を自動的に解決し、配置してくれるのは非常に強力 { "require": {}, // 本番環境の依存関係 "require-dev": {}, // 開発環境のみの依存関係 "autoload": {}, // オートローディング設定 "scripts": {} // カスタムコマンド } composer.jsonの基本構造

Slide 14

Slide 14 text

Packagistとは? © kaonavi, inc. 14 - composerのデフォルトリポジトリ - 数十万のPHPパッケージが登録済み - 欲しいものは大体ある印象 { "repositories": [ { "type": "composer", "url": "https://packages.example.com" } ] } Packagist以外のリポジトリの指定ももちろん可能 (社内gitlabなど...)

Slide 15

Slide 15 text

途中から導入って難しくない? © kaonavi, inc. 15

Slide 16

Slide 16 text

composerって遅くないの? © kaonavi, inc. 16 composerは様々なファイルを生成しますが、私たちが使うのは vendor/autoload.php だけです。 ザックリいうと、ComposerはClassが記述してあるファイルがどのファイルパス にあるかのマップみたいなものを持っています。 未定義なClassが参照されたとき、そのマップから、ファイルパスを取り出し、 requireする関数を、 spl_autoload_registerで登録しているだけです。 ですので、動作が遅くなったりはしません

Slide 17

Slide 17 text

composerが無い世界 © kaonavi, inc. 17

Slide 18

Slide 18 text

composerがある世界 © kaonavi, inc. 18

Slide 19

Slide 19 text

composer.lockとは? © kaonavi, inc. 19 - 実際にinstallされたパッケージの正確な記録 - composer install時に自動生成されます - 手動書き換え厳禁!! 原則、composer installは、composer.lockを参照し、パッケージ をインストールしていきます。.lockが無い場合のみ、新規で生成 します。 このおかげで、本番/開発/ローカル環境でパッケージのバージョ ン等を統一できます

Slide 20

Slide 20 text

composer install --no-dev --optimize-autoloader 本番運用時のオススメ © kaonavi, inc. 20 - 以下のコマンドを使うのが一般的です - 開発環境用パッケージはインストールしない - オートロードの最適化付き(だいたい3倍ほど速くなります) composer install --no-dev --optimize-autoloader \ --apcu-autoloader ← ただし、apcuのキャッシュに詳しく無い場合使わない方が良いです Apcu拡張が入っているなら、更に最適化可能(更に3倍ほど加速)

Slide 21

Slide 21 text

composer install --no-dev --optimize-autoloader --apcu-autoloader php -r "function_exists('apcu_clear_cache') && apcu_clear_cache();" curl -s "https://yourdomain.com/clear-cache.php?token=your-secret-token" または composer install --no-dev --optimize-autoloader --apcu-autoloader sudo systemctl reload php-fpm 本番運用時のオススメ © kaonavi, inc. 21 - 確実なコマンド(php-fpmの場合)

Slide 22

Slide 22 text

もう一つお伝えしたいこと © kaonavi, inc. 22

Slide 23

Slide 23 text

「本当に必要としている機能を 満たしたパッケージか?」 「ドキュメントはあるか?」 「これはパッケージ化するべき か?」 バランス感覚を意識してほしいということ © kaonavi, inc. 23   パッケージの取捨選択はとてもとても重要

Slide 24

Slide 24 text

何をパッケージ化するべきか? © kaonavi, inc. 24 ドメイン固有処理のパッケージは使う側もツライので作らない方が無難で す... をパッケージ化することをオススメします 社内で共通のパッケージを使うことで、プロジェクト間の差分が減り、プロ ジェクト異動時に嬉しいです...(デメリットもありますが) - 再利用可能な機能 - 汎用的なユーティリティ - 独立性の高いコンポーネント - 他プロジェクトでも使えるもの

Slide 25

Slide 25 text

どうやって適切なパッケージを探すか? © kaonavi, inc. 25 Googleで検索したり、Packagistで検索したり...         今はAIがあります!!!! 「他社製のRestful APIをCallしたいんだけど良いPackage はある?」 「もうcronでのバッチ登録は嫌なんだ、何か良いPackageは ある?」

Slide 26

Slide 26 text

最近Go言語を主務にしていま すが、PHPは本当に便利な packageが豊富にあり、満ち満 ちた世界だったんだと感じます 自分で書くコード量を減らして、 ガンガン楽しましょう PHPは本当に恵まれています! © kaonavi, inc. 26   パッケージの取捨選択はとてもとても重要

Slide 27

Slide 27 text

ご清聴ありがとうございました!