PHPerKaigi 2021

17:30 [A]

PHP で AWS Lambda

Rails のプロジェクトを PHPer のメンバのみでメンテ →他のメンバもわかる PHP にリプレースを検討

• サーバレス
• サーバ・インフラの管理が不要
• アプリケーションコードの知識だけで保守可能

ゼロベースで作れる案件が (Railsの件とは別に) あるため、そちらで試験的に導入?

AWSの学習 AWS のドキュメント DevelopersIO

AWS Lambda のカスタムランタイムで PHP を動かす

サーバのセットアップや維持管理を気にしなくて良い サーバーレスで PHP を動かすツールがすでにある サーバーレス構築はすんなり

今は Laravel がルーティングしている Laravel Livewire を Lambda に載せられないか？ デプロイ方法は？ バッチ処理は？ (Lambda は 15分の制限)

Lambda でコンテナイメージがサポートされるように

抽象化されたもの「だけ」しか知らないよりも具象の理解は助けになる

AWS Lambda のような Function as a Service はマイクロサービス化における一つの到達点に思えるのだが、これを使って実際に web サービスを作る具体的なイメージがまだ見えない (注: すべて for me として書いている)。

PHP on AWS Lambda があれだけ簡単に動かせるのには驚いた。

勝手に AWS Lambda だとフットプリントの軽さが求められそう (= PHP + Laravel などでは動かなさそう) だという先入観を持っていたのだが、この発表のデモによればそうでもないらしい。

18:10 [A]

大規模サイトの SEO

大規模サイト (100万ページ以上) Google の基準

クロールバジェットを意識したSEO

大規模サイトでコンテンツが中頻度 (1回/週) で更新 OR 中規模サイト (10,000以上) でコンテンツが目まぐるしく変更される これを満たさないなら、クロールバジェットを考えなくてもいい

サーチコンソール 「カバレッジ」の「除外」 多すぎるのは問題→クロールバジェットを浪費している

• クエリの順番を決める
• 空の値のルールを決めておく
• リダイレクトすればインデックスはうまくいく
• リンクが存在する限りクロールはされる

リニューアル前のURL

インデックスは移行される リンクのURLが存在する限り、別のURLとしてクロールされる リダイレクトされるとはいえ、リニューアル前のURLは移行した方が良い リニューアルで無視されるようになったパラメータも注意

robotes.txt で拒否しているのにクロールされる 一時的に拒否を外して 404 や 301 を読ませる 内部リンクを確認する JS でのリンクに書き換え

クエリパラメータからURLのパスに /tokyo?area=HOGE → /tokyo/HOGE

URL 設計だいじ

SEO (Search Engine Optimization) は大して知らないので新鮮な話が多かった。その分語れることも少ない……。

18:50 [A]

知覚可能 操作可能 理解可能 堅牢 ちゃんとしたHTMLを書く (閉じタグ・入れ子構造など)

• 標準の HTML を適切に使う
• WAI-ARIA
• キーボードフレンドリー
• マシンフレンドリー
• SEOフレンドリー

button タグ →キーボード h1 タグ →スクリーンリーダー・クローラ a タグ

WAI-ARIA HTML では表現できないセマンティクスを追加する

• ロール
  • 何をするのか？
  • ユーザーアクションによって変化しない
• プロパティ
  • 関連づけられたデータ
• ステート
  • 現在の状態

まずは標準の HTML 要素で解決する 何でもかんでも WAI-ARIA を使えばいいというものではない

マウスホバーでツールチップが出てくるが、キーボード操作では出てこない

VoiceOver

全ての属性を使う必要はない あくまでアクセシビリティを上げるための方法の一つにすぎない

つい最近 WAI-ARIA についての記事を読んだばかりだったので個人的にタイムリーな話題だった。(あまりこの言葉を使いたくないのだが) いわゆる「健常者」にとって、こうした問題を普段の生活の中で意識するのは難しい。だからこそ情報へのアンテナは張っておくようにしたい。

19:30 [A]

PHP で FUSE

個人的に楽しみだった発表。

VFS (virtual filesystem) vs 具体的なファイルシステム

最適な実装方法は状況により異なる

アプリケーションに見せるAPIは変えずに実装を隠蔽する→VFS

カーネルのプログラムを作るのは難しい * 権限がデカすぎる * システム全体がクラッシュ * セキュリティリスク * 開発サイクルを回しづらい * ネイティブコードにコンパイルされる言語である必要がある

Filesystem in USEr space (FUSE)

• 特定の C の関数を呼ぶことで filesystem が作れる
• FFI を持つ言語なら FUSE が使える

SSHFS / s3fs / Docker Desktop

Linux 以外でも使える

• dokany (on Windows)
• osxfuse

VFS: システムコールが呼ばれると、ファイルシステムによってコール FUSE: カーネル空間からユーザ空間へ通信

高レベルなラッパで型をつける

PHP 以外では Wordpress を FUSE にマウントする実装がある (C, Python など)

• grep できる
• sed できる
• 編集できる

期待通りの興味深い発表だった。FUSE 自体も今回の発表で知ったのだが、これ本体の実装を見るのも面白そうだ。この発表を聞きながらファイルシステムにマウントできそうなものを考えていたのだが、およそ木構造をしているものすべてと言えそうだ (ハンマーしか持っていないと云々)。何かできそうだがなかなか思いつかない。

10:50 [A]

ATDD

• ユーザーストーリー
• ユニットテスト
• CI/CD

ユーザストーリーの受け入れ条件が曖昧になりがち デグレチェックがユニットレベルでは収まらない場合、手動で同じシナリオをテストしている

Q2の強化 アジャイルテストの4象限

技術面/ビジネス面 開発チーム支援(コーディング前・コーディング中)/製品批評(コーディング後)

• Q1: 技術面 & チーム支援
  • TDD
  • ユニットテストなど
• Q2: ビジネス面 & チーム支援
  • ATDD
  • ビジネス面の受け入れテストで駆動する

Agile Alliance ユーザストーリーのスキルレベルを高める

テストピラミッド

• UI Tests
• Service Tests
• Unit Tests
• 異なる粒度のテストを書く
• 高レベルになるほど、持つべきテストは少なくなる
  • ピラミッド型になる

高レベルテストが多すぎる→アイスクリームコーン　アンチパターン

ATDD (Acceptance TDD) API経由・UI経由での高レベルテスト E2E test

ストーリ受け入れテスト

入れ子のフィードバックループ ATDD(外側) と TDD(内側)

外部品質・内部品質

バーティカルスライスのデリバリー

• cucumber
• gauge
• behat

ユビキタス言語 手動テストもspecに書く 自動化は可能だがコスパが悪い 失敗することがわかっているテスト(レッドテスト)はCIから外す 失敗時の原因究明が難しい 饒舌なエラーメッセージ 状況のスナップショット

Continuous Testing

User Acceptance Test (UAT) くらいの規模になると個人開発・趣味開発では触れない領域なので、大いに勉強になった。スライドに添付されている資料が相当に充実していたので、これを読むのが本番といった様相すら感じる。高レベルテストの自動化は現在のプロジェクトでも感じており、自動化のチャンスは伺っている。とはいえセッションでも指摘されているように自動化することにコストがかかりすぎる領域があるのも事実で、そのバランスが難しい。

11:50 [A]

型解析を用いたリファクタリング

型のある世界で生きてきた身として大いに楽しみにしていた発表。

• PHPStan
• Phan
• Psalm

autoload も認識できる bootstrapFiles

編集箇所と利用箇所を CI でチェック ルールレベルを徐々に引き上げていく 警告が多すぎると見落としてしまう・無視されやすくなる

型がついていないことによるエラーが多い

型よりも詳細な検査 Util_Assert::min

SQL を静的解析 placeholder の型付け

警告レベルを低いレベルから導入 タイプヒントを積極的に書いていく PHPStan の拡張を追加する

昨今、動的型付き言語での型宣言・型アノテーション・型ヒントの導入が相次いでいる。長らく静的型付き言語を書いてきた私からすると、ようやく気づいたかといったところだが、ともかく型を導入する言語が増えてきた。今のプロジェクトでも新しく追加するコードには型をつけるよう努めているが、どうしても古いコードには型がついていない。個人的には型のないコードに対してどう型を自動的に付けるかという点に興味があり、その点で Ruby の typeprof には注目している。

12:30 [A]

昼食をとっていた。事前に何か食料を買っておくべきだった。

13:10 [A]

Documentation as Code

この発表も以前から非常に楽しみにしていた。

開発開始までのオーバーヘッド 新規にチームにジョイン 担当範囲外の機能を理解 オンボーディングのコスト

PHPerKaigi 2020 で発表あり

継続的にシステムの理解を助けるドキュメント

継続的ドキュメンテーション システムとドキュメントの乖離

書いてあることが間違っている・足りない * 徐々にずれていく * システムの更新タイミングとドキュメントの更新タイミングに差がある

システムとドキュメントは対応関係がある * 間違ったドキュメント * 存在しないドキュメント

システムとドキュメントの乖離を定量化する 継続的に システムの更新に近いタイミングで ドキュメントを更新し続ける

Documentation as Code

コードと同じツールでドキュメントを書く * issue tracker * vcs * plain text markup * automation

開発者 システム ドキュメント 構造化データ ソフトウェア

システムから構造化データを抽出する PHPDoc OpenAPI

ビュー 関心ごとに合わせてアーキテクチャを一つ以上の側面(断面)で説明する

ビューの単位でドキュメントに

スタックトレースからのドキュメント生成

ドキュメントの管理は現プロジェクトでも課題と感じている。作られた当初は正しくても、実態と乖離していくのを止めるのは困難を極める。全体的に興味深い発表だったが、特にスタックトレースからのドキュメント生成というアイデアに惹かれるものを感じた。スタックトレースという実態と不可分な (乖離しない) 情報を起点にするのは理にかなっている。問題はトレースをいつ、どう取るかだろうか。それを自動化しなければ、実態との乖離が避けられないだろう。

14:10 [A]

cookie による session 管理

全体的に基本的な話だったので特に触れない。Cookie やセッションの話としては非常に分かりやすくまとめられていたので、知らない人が学ぶにはいい教材だろう。

14:50 [A]

PHP のエラーと例外

エラー PHPエンジンがエラーを通知する 例外 プログラムが投げる

PHP7-8とエラー

PHPエンジンのエラーの一部が に変換されるようになった → try-catch で捕捉できる

は例外とは異なる

PHP8 でエラーレベルの引き上げ

• 捕捉すべきもの
  • recoverable
• 捕捉すべきでないもの
  • unrecoverable
  • 開発時に対処できるもの

例外 * 捕捉して事後処理 * 捕捉せず(or 捕捉した上で)さらに上に是非を問う

開発段階で例外を把握し、ハンドリングを考えておく

と

はキャッチすべきでない

• • 本番で起きてはいけない

• • 本番で起きてはいけない →生じないのだから捕捉もしない

• • 起こるかもしれないので本番環境でも考慮する

捕捉して対応するのではなく、未然に防ぐ

独自例外を使う を投げてしまうと、 catch ()せざるを得ない →catch 範囲が広すぎる

SPL の例外を使う

例外翻訳 上位のレイヤが下位のレイヤの例外を捕捉し、上位レイヤのAPIに「翻訳」する 下位レイヤの知識に依存させない

@throws 捕捉してほしい例外を書き連ねておく

呼び出しもとに負わせたい責任

PHP を学んでいる途中の私としては、今まさに聞きたい発表だった (現時点で PHP を書き始めてから 4ヶ月ほどになる)。

個人的に例外やエラーを最もうまく扱っているのは Go、Swift、Rust、Haskell などのエラーを「値として」扱う言語だと思っている。try-catch は通常の処理フローを完全に壊してしまう上、構文としても重すぎる。値としてのエラー通知は C言語時代への回帰ともいえるが、その頃と異なるのはエラーを暗黙のうちに握り潰すことがないということだ。これらの言語は型を持っており、静的に検証ができる (C のそれはまともな型付けではない。念のため)。

PHP のように、すでに例外が言語システムに根ざしている言語ではどうすればよいか。この場合も同じく静的検証の力を借りることになるだろう。

15:30 [A]

Laravel のメール認証

Laravel の知識がない私にはまったくついていけなかった。また、個人的にタイトルがややミスリーディングに感じた。

16:10 [A]

gRPC

Unary RPCs Server streaming RPCs Client streaming RPCs Bidirectional streaming RPCs

Protobuf

実装とAPIが乖離しにくい 自動生成 複数言語でも相互に使える

マイクロサービスのサービス通信 スマホアプリ ゲームサーバ

PHP では？

PHP ではストリーミングが難しい リクエストごとにプロセスが使い捨て

PHP ではgRPCのクライアントしか対応していない

gRPC-Web ブラウザで扱うためのJSライブラリ+プロトコル

HTTP/1.1 でも使える Unary RPC と Server streaming RPC のみ

Envoy Nginx などで相互に gRPC と gRPC-Web で変換

Amp イベント駆動な並行処理のフレームワーク

HTTP/2 対応

C#のgRPC-Webが楽

(発表の中でもまさに同じことをおっしゃっていたが) PHP 以外の方が向いているだろう、というのが第一の感想である。gRPC はそれ自体というよりも Protobuf というエコシステムに乗れることのメリットが大きいと感じる。そのエコシステムにうまく乗れない時点で、うーんという感じ。

16:50 [A]

アーキテクチャテスト

Independent Core Layer Pattern

開発初期のアーキテクチャが崩れる アーキテクチャ観点のコードレビューができない

どこにクラスを置けばよいか？ ドキュメントがない

アーキテクチャ設計に関する知識が属人化・暗黙知化

ガイドライン * 最初にルールを決めるのは簡単 * ルール通り作り始めるのも簡単 * →維持するのが難しい、人が決めたものゆえ壊れやすい

PHP の特性 * クラスは public * 可視性の制御が public / protected / private のみ * 依存関係の制御が困難

アーキテクチャテスト クラスの依存関係や実装ルールをコードとして表現し、自動テスト化する

• deptrac
• phpat

Independent Core Layer Pattern

アーキテクチャテストの失敗 * 実装誤り * or アーキテクチャが適切でない * 開発の過程でフィードバックしていく

モジュラーモノリス→マイクロサービスへ