Slide 1

Slide 1 text

「10分以内に機能を消せる状態」 の実現のためにやっていること PHPConference福岡2025

Slide 2

Slide 2 text

自己紹介 名前:荻島 貴(おぎ) 所属:カオナビ 職業:開発者(PHPer) 特技:スノーボード PHPCon福岡は2回目の登壇!

Slide 3

Slide 3 text

過去の登壇履歴

Slide 4

Slide 4 text

※今回はインターフェースの話はしません (でも設計の話はします)

Slide 5

Slide 5 text

本題

Slide 6

Slide 6 text

捨てやすい設計とは?

Slide 7

Slide 7 text

Package By Feature (PBF) レガシー回避のPHP開発術

Slide 8

Slide 8 text

今回削除した機能を開発したチームの哲学 ソフトウェアは捨てやすく作ろう

Slide 9

Slide 9 text

フラクタル構造 packages |---packageA | |---FeatureA | |---Http | |---Models | |---FeatureB | |---Http | |---Models |---packageB ● パッケージの中で更に機能でディレクトリを 分ける入れ子構造 ● 機能間の相互依存がないような構成 (依存の向きは常に一方向) ソフトウェアは捨てやすく作ろう

Slide 10

Slide 10 text

依存関係が明確 = 不要なコードが削除しやすい

Slide 11

Slide 11 text

実際にローカルで 機能を1つ消してみた

Slide 12

Slide 12 text

No content

Slide 13

Slide 13 text

(いきなりリリースするの怖い🥶)

Slide 14

Slide 14 text

“削除対象を探す時に本当に使われていな いのか見極めているのであれば恐れるこ とはないです。” 不要なコードを見極めて削除するポイント

Slide 15

Slide 15 text

「使われていない」ことが 保証できれば...?🧐

Slide 16

Slide 16 text

Feature Toggleを使って 「安全に」消す

Slide 17

Slide 17 text

Feature Toggle “フィーチャートグル(Feature Toggle)とは、ソフトウェアの特定の機能のオンと オフを、プログラムのコードを変更したり、再デプロイしたりすることなく、動的に 切り替えるための技術です。フィーチャーフラグ(Feature Flag)やフリッパー (Flipper)とも呼ばれます” by Gemini

Slide 18

Slide 18 text

Feature Toggleによるリリース制御 Feature Toggleなし (デプロイとリリースが同時) サーバー サーバー サーバー ①デプロイ &リリース ②変更失敗⚠ ④再デプロイ ③ソースリバート⚠ サーバー Feature Toggleあり (デプロイとリリースが分離) サーバー サーバー サーバー ①デプロイ🔴 ②リリース🟢 ④トグルオフ🔴 ③変更失敗⚠ サーバー

Slide 19

Slide 19 text

Feature Toggleを使った安全な削除の手順 1. 画面側の動線に制御を追加 2. API側にロジックの制御を追加 3. Feature Toggleを埋め込んだコードをデプロイ 4. 機能廃止日にFeature ToggleをON 5. 問題なければ順次コードを削除

Slide 20

Slide 20 text

フロントエンドのコンポーネント制御イメージ

Slide 21

Slide 21 text

Feature Toggleを使った安全な削除手順 1. 画面側の動線に制御を追加 2. API側にロジックの制御を追加 3. Feature Toggleを埋め込んだコードをデプロイ 4. 機能廃止日にFeature ToggleをON 5. 問題なければ順次コードを削除

Slide 22

Slide 22 text

バックエンドのロジックの制御イメージ

Slide 23

Slide 23 text

Feature Toggleを使った安全な削除手順 1. 画面側の動線に制御を追加 2. API側にロジックの制御を追加 3. Feature Toggleを埋め込んだコードをデプロイ 4. 機能廃止日にFeature ToggleをON 5. 問題なければ順次コードを削除

Slide 24

Slide 24 text

Feature Toggleを使った安全な削除手順 1. 画面側の動線に制御を追加 2. API側にロジックの制御を追加 3. Feature Toggleを埋め込んだコードをデプロイ 4. 機能廃止日に Feature ToggleをON 5. 問題なければ順次コードを削除 ここが10分以内にできれば、提供価 値としてはビックバンリリースで消す のと変わらない

Slide 25

Slide 25 text

Feature Toggleを使った安全な削除手順 1. 画面側の動線に制御を追加 2. API側にロジックの制御を追加 3. Feature Toggleを埋め込んだコードをデプロイ 4. 機能廃止日にFeature ToggleをON 5. 問題なければ順次コードを削除

Slide 26

Slide 26 text

変更量とリードタイム - マージ回数:8回 - 合計ファイル数: 149 ファイル - 削除された行数: -20,488行 - 最初の削除マージ:10/14 13:29 - 最後の削除マージ:10/15 09:02 ※バックエンドのコードのみ

Slide 27

Slide 27 text

Feature Toggleで閉じていたので 自信を持って削除できた💪

Slide 28

Slide 28 text

うまくいかなかった事例

Slide 29

Slide 29 text

Feature Toggleは 「銀の弾丸」ではない🐺

Slide 30

Slide 30 text

FeatureToggleの外に機能が漏れてしまった ● フロントエンドのコンポーネントで FeatureToggleを追加 ● 対象のコンポーネントには後からカ スタムフックが追加 ● FeatureToggleのif文はカスタム フックの後に... 結果: ON/OFFにかかわらず、 Feature Toggleの裏側にある APIがコールされ てしまった ※イメージ

Slide 31

Slide 31 text

freeeのリリースフラグ誤操作による障害(2018) ● 原因 ○ 消されずに残っていたリリースフラグ( Feature Toggle)が負債化 ■ ”どのフラグがいつ・どう変更されたのかがわからなかった ” ■ ”数が多いことで正確に判断することが難しかった ” ● 対策 ○ フラグの削除を実施 ○ フラグ変更を通知する仕組み作り ○ 月次モニタリング運用 ■ リリースフラグの目的 ■ 残存期間の目安 ■ 期間を超過した場合のアクション ■ 残存させ続ける条件 システム障害のおわびとまなび

Slide 32

Slide 32 text

まとめ

Slide 33

Slide 33 text

「10分以内に機能を消せる状態」 の実現のためにやっていること PHPConference福岡2025

Slide 34

Slide 34 text

● 依存を管理して、コードの削除をしやすく ● デプロイ/リリース分離で素早く、安全に

Slide 35

Slide 35 text

言うは易く行うは難し (いうはやすくおこなうはかたし)

Slide 36

Slide 36 text

〜アジャイル宣言の背後にある原則より〜

Slide 37

Slide 37 text

その機能、 10分以内に 消せますか?

Slide 38

Slide 38 text

参考 ● 不要なコードを見極めて削除するポイント ● ソフトウェアは捨てやすく作ろう ● レガシー回避のPHP開発術 ● FeatureToggle戦略と運用方法 ● アジャイル宣言の背後にある原則 ● ご主人様、小難しいDDDやクリーンアーキテクチャはお忘れになって、”削除しやす い設計”から始められてはいかが? ● システム障害のおわびとまなび