20230315のPHP勉強会(Slimをオススメしてみる)

Transcript

1. Slimをオススメしてみる by がる
2. 自己紹介  古庄と申します  「がる(gallu)」というハンドルでふらついております  本職は技術者です。現役プログラマーやってます  バックエンド系なので、インフラとかDBとかも一通り  最近はPM業も多いですねぇ  あわせて、教育とか色々
3. Slimいいよ!!  https://www.slimframework.com/  Slim is a PHP micro framework that helps you quickly write simple yet powerful web applications and APIs.  Slim は、シンプルかつ強力な Web アプリケーションと API をすばやく作 成するのに役立つ PHP マイクロ フレームワークです。(Google)  Slimは、シンプルかつパワフルなWebアプリケーションやAPIを素早く作 成できるPHPマイクロフレームワークです。(DeepL)  Slimいいです!!  micro framework いいです!!  シンプルでいいです!!  っていう個人の感想と妄想を垂れ流してみます(笑
4. 実際どんな所が好きなのか?  軽量(なので早い)  メモリは、なんだかんだ無視しにくいリソースです  手元で var_dump(memory_get_peak_usage(true)) 仕込んだ結果  Slim: 2,097,152 / Laravel: 16,777,216  学習コストが(とりあえず)低い  「とりあえず」(笑  「素のPHPのみ」でWebアプリ書ければ大体なんとかなる!!  柔軟性と拡張性がある(というか全部自力で書け)  「全部自分で書け」なので「実装箇所がわかりやすい」(笑  「FWが何をやっているか」が理解しやすい  FWのコードもコンパクトなので、読みやすいです  「コンパクトだから読みやすいのか?」って欺瞞は棚の上にｗ
5. なにはともあれ  Slimの魅力が十分に伝わったところで(強引)  installと実装の基本を見ていきましょう!!
6. 素install  公式に出している「slim-skeleton」ってのもあるのですが  Slim3の頃とSlim4の時で、色々ごっそり違うんですよねぇ  好み的にはSlim3の頃のほうが好きだったかも  ただSlim4のSkeleton、DDDとか意識しているっぽいんですよね  今回は「できるだけすっぴん」で導入していきます
7.  まずは適当なディレクトリで最低限をinstall  composer require slim/slim  composer require slim/psr7  公開用ディレクトリ作成  mkdir public  index.phpを書く(公式サイトのコピペ)  次のページに記載  動かしてみる  php -S 0.0.0.0:8080 -t public public/index.php  http://ドメイン名/hello/gallu
8.  public/index.php <?php use Psr¥Http¥Message¥ResponseInterface as Response; use Psr¥Http¥Message¥ServerRequestInterface as Request; use Slim¥Factory¥AppFactory; require __DIR__ . '/../vendor/autoload.php'; $app = AppFactory::create(); $app->get('/hello/{name}', function (Request $request, Response $response, array $args) { $name = $args['name']; $response->getBody()->write("Hello, $name"); return $response; }); $app->run();
9.  これでとりあえず「 /hello/適当な名前 」のURLでSlimが 動くようになります!!  とってもシンプル!!!!  https://github.com/gallu/Slim- SimpleSkeleton/tree/less_than_minimum
10. 流石にルーティングくらいは別ファイルに  「全部index.phpに書く」とか色々正気ではないので、切り 分けます  まずは「ルーティングを書くファイルを入れるためのディ レクトリ」を作成します。なんでもよいですが、今回は(後 で色々な設定も入れようかと思ってるので)configって名 前に  mkdir config  index.phpの一部をconfig内のファイル(routes.php)に切り 出します
11.  元のpublic/index.php <?php use Psr¥Http¥Message¥ResponseInterface as Response; use Psr¥Http¥Message¥ServerRequestInterface as Request; use Slim¥Factory¥AppFactory; require __DIR__ . '/../vendor/autoload.php'; $app = AppFactory::create(); $app->get('/hello/{name}', function (Request $request, Response $response, array $args) { $name = $args['name']; $response->getBody()->write("Hello, $name"); return $response; }); $app->run();
12.  public/index.php <?php use Slim¥Factory¥AppFactory; require __DIR__ . '/../vendor/autoload.php'; $app = AppFactory::create(); // ルーティングの読み込み require __DIR__ . '/../config/routes.php'; $app->run();
13.  config/routes.php <?php declare(strict_types=1); use Psr¥Http¥Message¥ResponseInterface as Response; use Psr¥Http¥Message¥ServerRequestInterface as Request; // 初期に書いてあるルーティング $app->get('/hello/{name}', function (Request $request, Response $response, array $args) { $name = $args['name']; $response->getBody()->write("Hello, $name"); return $response; });
14.  同じように「 /hello/適当な名前 」のURLでSlimが動くよう になります!!  https://github.com/gallu/Slim- SimpleSkeleton/tree/cut_out_of_routing
15. ルーティングを追加してみる  現状、 /hello/名前 以外のURLは動かないので。  まぁとりあえず / くらいは追加してみましょう。
16.  元 config/routes.php <?php declare(strict_types=1); use Psr¥Http¥Message¥ResponseInterface as Response; use Psr¥Http¥Message¥ServerRequestInterface as Request; // 初期に書いてあるルーティング $app->get('/hello/{name}', function (Request $request, Response $response, array $args) { $name = $args['name']; $response->getBody()->write("Hello, $name"); return $response; });
17.  config/routes.php <?php declare(strict_types=1); use Psr¥Http¥Message¥ResponseInterface as Response; use Psr¥Http¥Message¥ServerRequestInterface as Request; // 初期に書いてあるルーティング $app->get('/hello/{name}', function (Request $request, Response $response, array $args) { $name = $args['name']; $response->getBody()->write("Hello, $name"); return $response; }); // 追加のルーティング $app->get('/', function (Request $request, Response $response, array $args) { $response->getBody()->write("Top Page"); return $response; });
18.  「 / 」のURLでもSlimが動くようになります!!  https://github.com/gallu/Slim- SimpleSkeleton/tree/add_routing
19. Controllerを切り出してみる  普通に考えて「routingん中にコードを書く」とか、常軌を 逸脱しているので  いわゆる「Controller」的なクラスを切り出してみましょう  まず「Controllerクラスを入れる」ディレクトリを作ります。 これもまぁどこでもよいのですが、慣習も考えてこんな風 にしてみましょう  mkdir -p app/Controller  autoloaderとかないと色々面倒なので設定しましょう  composer.jsonに追記します(コードは次のページで)  requireのバージョンとかちょっと違ってもキニシナイ!!  composer dump-autoload
20.  composer.json { "require": { "slim/slim": "^4.11", "slim/psr7": "^1.6" }, "autoload": { "psr-4": { "App¥¥": "app/" } } }
21.  んじゃ、コードを書いていきましょう!!
22.  元 config/routes.php <?php declare(strict_types=1); use Psr¥Http¥Message¥ResponseInterface as Response; use Psr¥Http¥Message¥ServerRequestInterface as Request; // 初期に書いてあるルーティング $app->get('/hello/{name}', function (Request $request, Response $response, array $args) { $name = $args['name']; $response->getBody()->write("Hello, $name"); return $response; }); // 追加のルーティング $app->get('/', function (Request $request, Response $response, array $args) { $response->getBody()->write("Top Page"); return $response; });
23.  config/routes.php <?php declare(strict_types=1); use Psr¥Http¥Message¥ResponseInterface as Response; use Psr¥Http¥Message¥ServerRequestInterface as Request; // 初期に書いてあるルーティング $app->get('/hello/{name}', ¥App¥Controller¥HelloController::class . ':index'); // 追加のルーティング $app->get('/', ¥App¥Controller¥HomeController::class);
24.  app/Controller/HelloController.php <?php declare(strict_types=1); namespace App¥Controller; use Psr¥Http¥Message¥ServerRequestInterface as Request; use Psr¥Http¥Message¥ResponseInterface as Response; class HelloController { // 多分「よくある」系の書き方 public function index(Request $request, Response $response, $args) { $name = $args['name']; $response->getBody()->write("Hello, $name"); return $response; } }
25.  app/Controller/HomeController.php <?php declare(strict_types=1); namespace App¥Controller; use Psr¥Http¥Message¥ServerRequestInterface as Request; use Psr¥Http¥Message¥ResponseInterface as Response; class HomeController { // XXX 1クラスに「1つしかメソッドを書くつもりがない」場合、こういった書き方もできる public function __invoke(Request $request, Response $response, $args) { // 出力 $response->getBody()->write("Top Page"); return $response; } }
26.  おんなじように動きます!!  これで「ふつーのフレームワーク」と大体一緒!!  まだ足りない過ぎるけど  https://github.com/gallu/Slim- SimpleSkeleton/tree/cut_out_of_controller
27. Controllerとして許容される形式は?  https://www.slimframework.com/docs/v4/objects/routi ng.html#container-resolution 以降に大体書いてあるの ですが  $app->get('/', '¥HomeController:home');  $app->get('/', ¥HomeController::class . ':home');  $app->get('/', [¥HomeController::class, 'home']);  $app->get('/', ¥HomeAction::class);  __invoke() メソッドがある場合  となります  あと実際には「関数」も通りますね
28. その辺のコードをざっくり見てみましょう  vendor/slim/slim/Slim/CallableResolver.phpの超訳 private function resolveSlimNotation(string $toResolve): array { [$class, $method] = :で文字列をsplit(:なかったらmethodには null) if (containerがclassを持ってたら) { $instance = containerからclassのインスタンスをげと インスタンスがげとれなければ例外を投げて終了 } else { if (クラスが存在していなかったら) { if (メソッドがnullじゃなければ) { $class .= '::' . $method . '()'; } $classないよ～、って例外をぶん投げて終了 } $instance = new $class($this->container); } return [$instance, $method]; }
29. で……  vendor/slim/slim/Slim/CallableResolver.php public function resolve($toResolve): callable { $toResolve = $this->prepareToResolve($toResolve); if (is_callable($toResolve)) { return $this->bindToContainer($toResolve); } $resolved = $toResolve; if (is_string($toResolve)) { $resolved = $this->resolveSlimNotation($toResolve); $resolved[1] ??= '__invoke'; } $callable = $this->assertCallable($resolved, $toResolve); return $this->bindToContainer($callable); }
30.  なんてあたりで色々やってる感じです。  「配列でも受け入れる」あたりは prepareToResolve()に実 装があります  なんていう風に、入り口あたりから軽く「フレームワーク のコードを読む」事を時々すると、良い勉強になるんじゃ ないか、と!!
31. 一区切り  まだまだ序の口ですが、しばらくシリーズもの的に「Slim の使い方」をLTしつつ育てていければ、と思います!!  感想とか要望とか突っ込みとか、いただければ幸いで す!!  さて、LTの枠内に収まっているのか?(笑