PSRで世界が変わる

2019/9/28に行った社内勉強会で発表したスライドです。

Transcript

1. PSRで世界が変わる 2019.9.28 技術い勉強会 @tsyama
2. @tsyama_desu 自己紹介 @tsyama
3. PSRとは？
4. PHP Standards Recommendations （PHP標準勧告）
6. - PHP-FIGという団体が作成 - 「PHP書くときのルール決めてみたんだけど」 - 現在PSR-0からPSR-19まである - 既存のものは三種に大別できる
7. - PHP-FIGという団体が作成 - 「PHP書くときのルール決めてみたんだけど」 - 現在PSR-0からPSR-19まである - 既存のものは三種に大別できる
8. 1. コーディングスタイル 2. オートローディング規約 3. インターフェース よくわかるPSRのすべて
9. 1. コーディングスタイル 2. オートローディング規約 3. インターフェース よくわかるPSRのすべて
10. - PSR-1 - PSR-2 (ABANDONED) - PSR-12 1. コーディングスタイル
11. PSR-1 基本コーディング規約 - ファイルは `<?php`もしくは`<?=`で始める - 文字コードはUTF-8（BOM無し）を使用する - クラス名はStudlyCapsで定義する … ※StudlyCaps: 先頭大文字、単語区切り大文字
12. - インデントには、Tabではなく4 Spaceを使用する - 関数やクラス定義の `{` や `}` を独立した行にする - コンマの前にSpaceを入れず、後に1 Spaceを入れる … PSR-2 コーディングスタイルガイド
13. public function hoge () { $hoge = “hoge”; echo $hoge; return $hoge; } PSR-2 コーディングスタイルガイド
14. public function hoge () { $hoge = “hoge”; echo $hoge; return $hoge; } PSR-2 コーディングスタイルガイド
15. ABANDONED （放棄）
16. - プロパティ／メソッドのアクセス修飾子は必ず明記する - スカラータイプヒンティングは小文字で書く - 無名クラスの書き方とか … PSR-12 拡張コーディングスタイルガイド 新たにPHP7向けに対応したコーディングスタイルガイド
17. これを受けて我々はどうするべきか
18. PSR-12 拡張コーディングスタイルガイド PSR-2と同様に、この仕様の目的は、さまざまな著者のコードを 認知摩耗を減らすことです。… したがって、このガイドの利点はルール自体ではなく、それらの ルールの共有にあります。 PSR-12 Overviewより引用（翻訳）
19. PSR-12 拡張コーディングスタイルガイド PSR-2と同様に、この仕様の目的は、さまざまな著者のコードを 認知摩耗を減らすことです。… したがって、このガイドの利点はルール自体ではなく、それらの ルールの共有にあります。 PSR-12 Overviewより引用（翻訳）
20. PSR-12 拡張コーディングスタイルガイド 「このコーディングスタイルガイドを厳守しろ」 と言っているわけではない
21. PSR-12 拡張コーディングスタイルガイド プロジェクト内でコーディングスタイルを 統一するということが何よりも重要 （PHPだけじゃない！）
22. PSR-12 拡張コーディングスタイルガイド コーディングスタイルを統一しないと起こること - Gitに余計な差分ができる - 見た目に統一感がなく、汚い - 争いが生まれる
23. PSR-12 拡張コーディングスタイルガイド コーディングスタイル、統一しましょう
24. 1. コーディングスタイル 2. オートローディング規約 3. インターフェース よくわかるPSRのすべて
25. - PSR-0 (DEPRECATED) - PSR-4 2. オートローディング規約
26. 2. オートローディング規約 オートローディングとは？
27. 2. オートローディング規約 ライブラリを使いやすくする仕組み
28. 2. オートローディング規約
29. 2. オートローディング規約 オートローディングの仕組みを活用して PHPライブラリの管理を担う （npmとかと同じようなもの）
30. 2. オートローディング規約 どうやって？
31. PSR-4 オートローダ - ライブラリファイルの置き場とそれに対応する クラス名を定義している
32. 2. オートローディング規約 vendor
33. 2. オートローディング規約 use \Hoge\Huga
34. 2. オートローディング規約 require_once(‘../../../hoge/huga.php’)
35. 2. オートローディング規約 require_once(‘../../../hoge/huga.php’)
36. 2. オートローディング規約 composerで世界はどう変わったか
37. 2. オートローディング規約 ライブラリ同士が 依存し、依存されやすい世界に
38. 2. オートローディング規約 例えばLaravel
39. 2. オートローディング規約 - doctrine/inflector - dragonmantank/cron-expression - egulias/email-validator - erusev/parsedown - league/flysystem - monolog/monolog - nesbot/carbon - opis/closure - psr/container - psr/simple-cache - ramsey/uuid - swiftmailer/swiftmailer - symfony/console - symfony/debug - symfony/finder - symfony/http-foundation - symfony/http-kernel - symfony/process - symfony/routing - symfony/var-dumper - tijsverkoyen/css-to-inline-styles - vlucas/phpdotenv
40. 2. オートローディング規約 ライブラリ同士が互いに助け合う 生態系がPHPの中に生まれた
41. 2. オートローディング規約 エコシステム
42. 2. オートローディング規約 ちなみに
43. 2. オートローディング規約 エコシステムを体感するの めっちゃ大事
44. 2. オートローディング規約
45. 2. オートローディング規約 世界のプログラマの生態系の中に 組み込まれている…！
46. 2. オートローディング規約 うれしい
47. 2. オートローディング規約 楽しい
48. 2. オートローディング規約 大好き
49. 2. オートローディング規約 PSRが作り、composerが育てた エコシステムに乗っかってみよう
50. 1. コーディングスタイル 2. オートローディング規約 3. インターフェース よくわかるPSRのすべて
51. 3. インターフェース ここからちょっと難しい話
52. 3. インターフェース インターフェースってなに？
53. 3. インターフェース インターフェース (英: interface) はインタフェース、インタ フェイス、インターフェイスとも書き、英語で界面や接触面、 中間面などといった意味を持ち、転じてコンピュータと周辺機 器の接続部分を表すようになった。さらに、ユーザーインター フェースなどのように、人間と自動機械との間の複雑な操作 をする手順・規則との意味にも使われる。
54. 3. インターフェース
55. 3. インターフェース 「インターフェース」は「実装」するもの
56. 3. インターフェース 例えばUSB「インターフェース」
57. 3. インターフェース
58. 3. インターフェース これらはすべてUSBの「実装」
59. 3. インターフェース なぜインターフェースが必要なのか？
60. 3. インターフェース 同一のインターフェースを実装すると 制御（ホスト）側が助かる
61. 3. インターフェース USBホスト
62. 3. インターフェース PHPでインターフェースはこう書く
63. 3. インターフェース interface USB { public function plug(); public function unplug(); }
64. 3. インターフェース 実装はこう
65. 3. インターフェース class Mouse implements USB { public function plug() { ... } public function unplug() { ... } }
66. 3. インターフェース 本題
67. 3. インターフェース 一部のPSRでは インターフェースを定義している
68. - PSR-3 - PSR-6 - PSR-7 - PSR-11 - PSR-14 - PSR-15 - PSR-16 - PSR-17 - PSR-18 3. インターフェース
69. - PSR-3 - PSR-6 - PSR-7 - PSR-11 - PSR-14 - PSR-15 - PSR-16 - PSR-17 - PSR-18 3. インターフェース
70. - MessageInterfaceとそれに付随するインターフェースを定 義している - 超重要 PSR-7 HTTP message interfaces
71. PSR-7 HTTP message interfaces interface MessageInterface { public function getProtocolVersion(); public function getHeaders(); public function getBody(); ... }
72. PSR-7 HTTP message interfaces interface MessageInterface 　→HTTPメッセージを下記のように定義する { public function getProtocolVersion(); 　→プロトコルバージョンを取れる（HTTP/1.1とかHTTP/2とか） public function getHeaders(); 　→ヘッダーを取れる public function getBody(); 　→本文を取れる ... }
73. PSR-7 HTTP message interfaces で？
74. - そもそもPHPはHTTPリクエストを入力として、HTTPレスポン スを出力とする言語 - HTTPリクエストもHTTPレスポンスも「HTTPメッセージ」であ る PSR-7 HTTP message interfaces
75. すべてのPHPスクリプトは HTTPメッセージを扱う ※cliとかは別 PSR-7 HTTP message interfaces
76. すべてのPHPスクリプトはPSR-7に準拠できる （しようと思えば） ※cliとかは別 PSR-7 HTTP message interfaces
77. すべてのPHPスクリプトでHTTPメッセージを 同じように扱うことができる PSR-7 HTTP message interfaces
78. PSR-7 HTTP message interfaces すごい
79. PSR-7 HTTP message interfaces これをUSBで例えるなら すべての電化製品から USBケーブルが出てる みたいな
80. PSR-7 HTTP message interfaces 便利そう
81. PSR-7 HTTP message interfaces すばらしい
82. PSR-7 HTTP message interfaces 世界平和につながる
83. PSR-7 HTTP message interfaces しかし現実はそううまくいかない…
84. PSR-7 HTTP message interfaces 世界 ＜ PSR-7ってちょっと使いづらいから 　 独自で定義するわ
85. PSR-7 HTTP message interfaces 世界 ＜ もっとはやく言ってくれれば… わざわざ既存のコードをPSR-7準拠に 書き直すメリットは小さいし…
86. PSR-7 HTTP message interfaces 世界 ＜ PSR-7ってなに？
87. PSR-7 HTTP message interfaces 世界平和は遠い
88. PSR-7 HTTP message interfaces PSR側の意見
89. PSR-7 HTTP message interfaces この提案は、すべてのHTTPクライアントライブラリまたはサー バー側フレームワークが、準拠するようにインターフェースを変更 することを期待していません。厳密には相互運用性を目的として います。 PSR-7 Meta Documentより引用（翻訳）
90. PSR-7 HTTP message interfaces PSR ＜ 無理にPSRに準拠しなくていいよ！ 　 目指すのは相互運用性だから！
91. PSR-7 HTTP message interfaces 懐が深い
92. これを受けて我々はどうするべきか PSR-7 HTTP message interfaces
93. PSR-7 HTTP message interfaces 特にやるべきことはない
94. PSR-7 HTTP message interfaces が
95. PSR-7 HTTP message interfaces 平和な世界のため、 みんなが少しずつPSRに寄り添っていく 未来はありかもしれない
96. 3. インターフェース PSRは他にもPHPでよく使われるものの インターフェース化を進めている
97. - PSR-3 ログ出力 - PSR-6 キャッシュ - PSR-7 HTTPメッセージ - PSR-11 コンテナ - PSR-14 イベントディスパッチャ - PSR-15 HTTPハンドラ - PSR-16 キャッシュ - PSR-17 HTTPファクトリ - PSR-18 HTTPクライアント 3. インターフェース
98. 3. インターフェース みんなが使うものは できるだけ同じインターフェースを使いたいよね
99. 3. インターフェース すべてのPHPスクリプトから 同じケーブルが出ているような世界にしよう
100. まとめ
101. 1. コーディングスタイル 2. オートローディング規約 3. インターフェース まとめ
102. 1. →コーディングスタイル統一しようね 2. オートローディング規約 3. インターフェース まとめ
103. 1. →コーディングスタイル統一しようね 2. →ライブラリを使いやすくするためのルール 3. インターフェース まとめ
104. 1. →コーディングスタイル統一しようね 2. →ライブラリを使いやすくするためのルール 3. →インターフェースが共通化された世界 まとめ
105. まとめ 世界に開けたPHPスクリプトを
106. まとめ 開発は自分一人でするものではない
107. まとめ 世界の誰かが作ったライブラリに お世話になる
108. まとめ 世界の誰かが自分のライブラリを 使うかもしれない
109. まとめ みんなのためのPHPを書こう
110. ありがとうございました