予防に勝る防御なし（2025年版） - 堅牢なコードを導く様々な設計のヒント / Growing Reliable Code PHP Conference Fukuoka 2025

PHPカンファレンス福岡2025

2025/11/08 11:40〜
ホライズンテクノロジーホール
レギュラートーク(30分)

https://fortee.jp/phpcon-fukuoka-2025/proposal/cf0925df-c846-4774-b203-a111e57f1235

本講演は2016年から続けている「PHPで堅牢なコードを書く」シリーズの最新版です。

PHPはバージョンを追う毎に機能が強化され、堅牢なコードを書くための機能が充実してきました。本講演ではPHP 8.4（および 8.5）をベースにして、誤りを想定してチェックするのではなく、そもそも誤りにくい設計とはどのようなものか、つまり「予防」の観点を軸足に、堅牢なコードを導くための様々な設計のヒントをご紹介します。

Agenda
1. 型宣言
2. 列挙型
3. 静的解析
4. 型のモデリング
5. 不変性
6. 完全性
7. 責務の配置

Transcript

1. ༧๷ʹউΔ๷ޚͳ͠ ʢ೥൛ʣ ࿨ా୎ਓ rev.18 /PW
   
   
   !
   1)1ΧϯϑΝϨϯε෱Ԭ !U@XBEB !UXBEB 📷🙆 🙆 !UXBEB JEUXBEB #phpconfuk ݎ࿚ͳίʔυΛಋ༷͘ʑͳઃܭͷώϯτ #hall_hz
2. class BugRepository { private $pdo; public function __construct($pdo) { $this->pdo = $pdo; } public function findAll($params) { $sql = 'SELECT bug_id, summary, reported_at FROM Bugs WHERE reported_at >= :startAt AND reported_at < :endAt AND status = :status'; $stmt = $this->pdo->prepare($sql); $stmt->execute($params); return $stmt->fetchAll(\PDO::FETCH_CLASS, Bug::class); } ஫
   ॻ੶ʰ42-Ξϯνύλʔϯʢॳ൛ʣʱͷͻͲ͍ίʔυྫΛ͞ΒʹͻͲ͘ΞϨϯδͯ͠ॻ͍͍ͯ·͢ ͱ͋Δͱ͜Ζʹɺ͜Μͳίʔυ͕͋Γ·ͨ͠ # " % IUUQTXXXPSFJMMZDPKQCPPLT
3. public function findAll($params) { $sql = 'SELECT bug_id, summary, reported_at FROM Bugs WHERE reported_at >= :startAt AND reported_at < :endAt AND status = :status'; $stmt = $this->pdo->prepare($sql); $stmt->execute($params); return $stmt->fetchAll(\PDO::FETCH_CLASS, Bug::class); } ॲཧࣦഊͷݪҼʹͳΔՄೳੑ͕͋Δͷ͸Ͳͷߦʁ # " % ᶃ ᶄ ᶅ ᶃ
   ςʔϒϧ໊΍ΧϥϜ໊͕୭͔ʹมߋ͞Εͨ
   ᶄ
   QBSBNT
   ͕
   OVMM
   ᶄ
   QBSBNT
   ͷΩʔ໊΍਺ͷෆҰக
   ᶄ
   QBSBNT
   ͷ஋͕จࣈྻʹม׵ෆೳ
   ᶄ
   QBSBNT
   ͷ஋͕೔࣌ͱͯ͠ղऍͰ͖ͳ͍
   ᶅ
   #VH
   Ϋϥε͕ະఆٛ
   ᶃ
   ᶄ
   ᶅ
   ్தͰσʔλϕʔε઀ଓΤϥʔ ຊ೔ͷߨԋ͸
   ͜ΕΒͷ໰୊ʹूத͠·͢ 👉 👉 👉 👉
4. ෆ۩߹ͷൃݟ͕
   ஗ΕΕ͹஗ΕΔ΄Ͳ
   ই͸ਂ͘ͳΔ IUUQTXXXBTURCPSHQSFTTSPPN*452#@$FSUJ fi DBUJPO@/FXT@@IUNM
5. ݎ࿚ͳίʔυ΁ͷޡղ
6. public function findAll($params) { if (is_null($params)) { throw new \InvalidArgumentException('params should not be null'); } if (!is_array($params)) { throw new \InvalidArgumentException('params should be an array'); } if (count($params) !== 3) { throw new \InvalidArgumentException('params should have exact three items'); } if (!array_key_exists('startAt', $params) || !array_key_exists('endAt', $params) || !array_key_exists('status', $params)) { throw new \InvalidArgumentException('params should have keys "startAt", "endAt" and "status"'); } if (!is_string($params['startAt'])) { throw new \InvalidArgumentException('params["startAt"] should be a string'); } if (!is_string($params['endAt'])) { throw new \InvalidArgumentException('params["endAt"] should be a string'); } if (!is_string($params['status'])) { throw new \InvalidArgumentException('params["status"] should be a string'); } if (!in_array($params['status'], ['OPEN', 'NEW', 'FIXED'], true)) { throw new \InvalidArgumentException('params["status"] should be in "OPEN","NEW","FIXED"'); } ͨͩͻͨ͢ΒೖྗΛ๷ޚతνΣοΫͨ͠Γ # " %
7. ෆਖ਼ͳೖྗ͕͋ͬͯ΋ࣗ෼ͰԿͱ͔͠Α͏ͱͨ͠Γ # " % $sql = 'SELECT bug_id, summary, reported_at FROM Bugs WHERE reported_at >= :startAt AND reported_at < :endAt AND status = :status'; $stmt = $this->pdo->prepare($sql); $safeParams = [ 'startAt' => $params['startAt'] ?? $params['start_at'] ?? '1970-01-01', 'endAt' => $params['endAt'] ?? $params['end_at'] ?? 'now', 'status' => $params['status'] ?? 'OPEN', ]; $stmt->execute($safeParams); $className = class_exists('Bug') ? 'Bug' : 'BugModel'; return $stmt->fetchAll(\PDO::FETCH_CLASS, $className);
8. υΩϡϝϯτͰؒҧ͍΍͢͞Λิ͓͏ͱͨ͠Γ # " % /** * 指定した範囲の日時およびステータスに合致する Bug を検索し、ヒットした全件を Bug オブジェクトの配列として返す。 * * @param array $params 格納した検索条件の連想配列。キー "startAt" に検索範囲の 始点日時をstringで, キー "endAt" に検索範囲の終点日時をstringで, キー "status" にス テータス文字列をstringで指定すること。キー、値それぞれNULLは不可とする。 * @return Bug[] 検索結果を Bug オブジェクトにマッピングして返す。検索結果が0件 のときは空配列を返す。 */ public function findAll($params) {
9. ݎ࿚ͳίʔυͱ͸
   ѱ͍ίʔυʹឺ૑ߣΛ
   ͋ͯͨ΋ͷͰ͸ͳ͍
10. lݡ໌ͳιϑτ΢ΣΞٕज़ऀʹͳΔͨΊͷ ୈҰา͸ɺಈ͘ϓϩάϥϜΛॻ͘͜ͱͱ ਖ਼͍͠ϓϩάϥϜΛద੾ʹ࡞੒͢Δ͜ͱ ͷҧ͍Λೝࣝ͢Δ͜ͱz Š
    ."+BDLTPO
    
11. Agenda  ܕએݴ
     ྻڍܕ
     ੩తղੳ
     ܕͷϞσϦϯά
     ෆมੑ
     ׬શੑ
     ੹຿ͷ഑ஔ 👉
12. औΓಘΔܕΛݮΒ͢
13. ΤοηΠ+
    ݟ஌Β͵ਓͱ΋͏·͘΍Δʹ͸ lʮग़དྷͯ͸ͳΒ͵͜ͱΛې͡ ΔʯͷͰ͸ͳ͘ɺ͸͡Ί͔Β ʮग़དྷ͍͍ͯ͜ͱ͚ͩΛग़དྷΔ Α͏ʹ͢Δʯͱߟ͑ΔͷͰ͢z IUUQTXXXPSFJMMZDPKQCPPLT
14. public function findAll($params) { if (is_null($params)) { throw new \InvalidArgumentException('params should not be null'); } if (!is_array($params)) { throw new \InvalidArgumentException('params should be an array'); } if (count($params) !== 3) { throw new \InvalidArgumentException('params should have exact three items'); } if (!array_key_exists('startAt', $params) || !array_key_exists('endAt', $params) || !array_key_exists('status', $params)) { throw new \InvalidArgumentException('params should have keys "startAt", "endAt" and "status"'); } if (!is_string($params['startAt'])) { throw new \InvalidArgumentException('params["startAt"] should be a string'); } if (!is_string($params['endAt'])) { throw new \InvalidArgumentException('params["endAt"] should be a string'); } if (!is_string($params['status'])) { throw new \InvalidArgumentException('params["status"] should be a string'); } if (!in_array($params['status'], ['OPEN', 'NEW', 'FIXED'], true)) { throw new \InvalidArgumentException('params["status"] should be in "OPEN","NEW","FIXED"'); } ໰୊ͱͳ͍ͬͯΔ͜ͷ࿈૝഑ྻΛ ݱঢ়
15. public function findAll(\DateTime $startAt, \DateTime $endAt, string $status): array { if (is_null($params)) { throw new \InvalidArgumentException('params should not be null'); } if (!is_array($params)) { throw new \InvalidArgumentException('params should be an array'); } if (count($params) !== 3) { throw new \InvalidArgumentException('params should have exact three items'); } if (!array_key_exists('startAt', $params) || !array_key_exists('endAt', $params) || !array_key_exists('status', $params)) { throw new \InvalidArgumentException('params should have keys "startAt", "endAt" and "status"'); } if (!is_string($params['startAt'])) { throw new \InvalidArgumentException('params["startAt"] should be a string'); } if (!is_string($params['endAt'])) { throw new \InvalidArgumentException('params["endAt"] should be a string'); } if (!is_string($params['status'])) { throw new \InvalidArgumentException('params["status"] should be a string'); } if (!in_array($params['status'], ['OPEN', 'NEW', 'FIXED'], true)) { throw new \InvalidArgumentException('params["status"] should be in "OPEN","NEW","FIXED"'); } ͦΕͧΕܕએݴ͞ΕͨҾ਺ʹ෼ղ͢Δ ܕએݴʹΑͬͯʮग़དྷ͍͍ͯ͜ͱ͚ͩΛग़དྷΔʯΑ͏ʹ
16. public function findAll(\DateTime $startAt, \DateTime $endAt, string $status): array { if (is_null($params)) { throw new InvalidArgumentException('params should not be null'); } if (!is_array($params)) { throw new InvalidArgumentException('params should be an array'); } if (count($params) !== 3) { throw new InvalidArgumentException('params should be have exact three items'); } if (!array_key_exists('startAt', $params) || !array_key_exists('endAt', $params) || !array_key_exists('status', $params)) { throw new InvalidArgumentException('params should have key "startAt", "endAt" and "status" only'); } if (!is_string($params['startAt'])) { throw new InvalidArgumentException('params["startAt"] should be a string'); } if (!is_string($params['endAt'])) { throw new InvalidArgumentException('params["endAt"] should be a string'); } if (!is_string($params['status'])) { throw new InvalidArgumentException('params["status"] should be a string'); } if (!in_array($params['status'], ['OPEN', 'NEW', 'FIXED'], true)) { throw new \InvalidArgumentException('params["status"] should be in "OPEN","NEW","FIXED"'); } ๷ޚతνΣοΫ͕΄΅ෆཁʹ
17. ૝ఆ͠ͳ͚Ε͹ͳΒͳ͍ঢ়گ͕ݮͬͨ const TIMESTAMP_FORMAT = 'Y-m-d\TH:i:s.uP'; public function findAll(\DateTime $startAt, \DateTime $endAt, string $status): array { if (!in_array($status, ['OPEN', 'NEW', 'FIXED'], true)) { throw new \InvalidArgumentException('status should be in "OPEN","NEW","FIXED"'); } $sql = 'SELECT bug_id, summary, reported_at FROM Bugs WHERE reported_at >= :startAt AND reported_at < :endAt AND status = :status'; $stmt = $this->pdo->prepare($sql); $stmt->bindValue(':startAt', $startAt->format(self::TIMESTAMP_FORMAT), \PDO::PARAM_STR); $stmt->bindValue(':endAt', $endAt->format(self::TIMESTAMP_FORMAT), \PDO::PARAM_STR); $stmt->bindValue(':status', $status, \PDO::PARAM_STR); $stmt->execute(); return $stmt->fetchAll(\PDO::FETCH_CLASS, Bug::class); } ˞
    ຊߨԋͰ͸
    1PTUHSF42-
    ͷ
    UJNFTUBNQ
    XJUI
    UJNF
    [POF
    ܕͷΧϥϜʹ֨ೲ͍ͯ͠Δͱߟ͍͑ͯͩ͘͞
18. Agenda  ܕએݴ
     ྻڍܕ
     ੩తղੳ
     ܕͷϞσϦϯά
     ෆมੑ
     ׬શੑ
     ੹຿ͷ഑ஔ 👉
19. औΓಘΔ஋ΛݮΒ͢
20. wݴޠ૊ΈࠐΈͷܕʢJOU
    TUSJOH
    ౳ʣΛ࢖͏ ͱɺऔΓಘΔ஋ͷ૊Έ߹Θ͕ͤ๲େʹͳΔ
    w໰୊ྖҬͷ஌ࣝΛ׆༻ͯ͠ݻ༗ͷܕΛ࡞Δ ͜ͱͰɺऔΓಘΔ૊Έ߹ΘͤΛେ෯ʹݮΒ ͤΔ ΤοηΠ
    ؔ਺ͷʮαΠζʯΛখ͘͢͞Δ IUUQTXXXPSFJMMZDPKQCPPLT
21. ྻڍܕΛ࢖͓͏ 1 ) 1   enum Status: string { case Open = 'OPEN'; case New = 'NEW'; case Fixed = 'FIXED'; } IUUQTXXXQIQOFUNBOVBMKBMBOHVBHFFOVNFSBUJPOTQIQ
22. const TIMESTAMP_FORMAT = 'Y-m-d\TH:i:s.uP'; public function findAll(\DateTime $startAt, \DateTime $endAt, string $status): array { if (!in_array($status, ['OPEN', 'NEW', 'FIXED'], true)) { throw new \InvalidArgumentException('status should be in "OPEN","NEW","FIXED"'); } $sql = 'SELECT bug_id, summary, reported_at FROM Bugs WHERE reported_at >= :startAt AND reported_at < :endAt AND status = :status'; $stmt = $this->pdo->prepare($sql); $stmt->bindValue(':startAt', $startAt->format(self::TIMESTAMP_FORMAT), \PDO::PARAM_STR); $stmt->bindValue(':endAt', $endAt->format(self::TIMESTAMP_FORMAT), \PDO::PARAM_STR); $stmt->bindValue(':status', $status, \PDO::PARAM_STR); $stmt->execute(); return $stmt->fetchAll(\PDO::FETCH_CLASS, Bug::class); } ݱঢ়
23. const TIMESTAMP_FORMAT = 'Y-m-d\TH:i:s.uP'; public function findAll(\DateTime $startAt, \DateTime $endAt, Status $status): array { if (!in_array($status, ['OPEN', 'NEW', 'FIXED'], true)) { throw new \InvalidArgumentException('status should be in "OPEN","NEW","FIXED"'); } $sql = 'SELECT bug_id, summary, reported_at FROM Bugs WHERE reported_at >= :startAt AND reported_at < :endAt AND status = :status'; $stmt = $this->pdo->prepare($sql); $stmt->bindValue(':startAt', $startAt->format(self::TIMESTAMP_FORMAT), \PDO::PARAM_STR); $stmt->bindValue(':endAt', $endAt->format(self::TIMESTAMP_FORMAT), \PDO::PARAM_STR); $stmt->bindValue(':status', $status->value, \PDO::PARAM_STR); $stmt->execute(); return $stmt->fetchAll(\PDO::FETCH_CLASS, Bug::class); } Ҿ਺Λจࣈྻ͔Βྻڍܕʹม͑Δ จࣈྻ͔Βྻڍܕʹม͑Δ
24. const TIMESTAMP_FORMAT = 'Y-m-d\TH:i:s.uP'; public function findAll(\DateTime $startAt, \DateTime $endAt, Status $status): array { if (!in_array($status, ['OPEN', 'NEW', 'FIXED'], true)) { throw new \InvalidArgumentException('params["status"] should be in "OPEN","NEW","FIXED"'); } $sql = 'SELECT bug_id, summary, reported_at FROM Bugs WHERE reported_at >= :startAt AND reported_at < :endAt AND status = :status'; $stmt = $this->pdo->prepare($sql); $stmt->bindValue(':startAt', $startAt->format(self::TIMESTAMP_FORMAT), \PDO::PARAM_STR); $stmt->bindValue(':endAt', $endAt->format(self::TIMESTAMP_FORMAT), \PDO::PARAM_STR); $stmt->bindValue(':status', $status->value, \PDO::PARAM_STR); $stmt->execute(); return $stmt->fetchAll(\PDO::FETCH_CLASS, Bug::class); } ૝ఆ͠ͳ͚Ε͹ͳΒͳ͍ঢ়گ͕͞Βʹݮͬͨ
25. Agenda  ܕએݴ
     ྻڍܕ
     ੩తղੳ
     ܕͷϞσϦϯά
     ෆมੑ
     ׬શੑ
     ੹຿ͷ഑ஔ 👉
26. ίʔυΛಈ͔ͣ͞ʹ
    ݕࠪ͢Δ
27. wݱࡏɺݴޠ΍ίϯύΠϥɺ੩తղੳπʔϧΛΊ ͙Δঢ়گ͸౰࣌ͱ͸େ͖͘ҟͳ͍ͬͯ·͢ɻϝ ϞϦ΍$16࣌ؒ͸૬ରతʹʮ͍҆ʯ΋ͷʹͳ ΓɺίϯύΠϥࣗ਎͕νΣοΫͰ͖ΔΤϥʔ΋ େ෯ʹ૿͑·ͨ͠ɻ
    wίʔυͷ඼࣭޲্ʹ͋ͨͬͯ͸ɺςετ͚ͩʹ པΔͷͰ͸ͳ͘ɺղੳπʔϧ΋ੵۃతʹར༻͢ ΂͖Ͱ͠ΐ͏ɻ ΤοηΠ
    ίʔυ෼ੳπʔϧΛར༻͢Δ IUUQTXXXPSFJMMZDPKQCPPLT
28. ݱঢ়ͷίʔυʹ
    1)14UBO
    Λ͔͚ͯΈΔ IUUQTQIQTUBOPSH
29. 1)1͋Δ͋Δ
    ໭Γ஋͕ΦϒδΣΫτ·ͨ͸GBMTF public function findAll(\DateTime $startAt, \DateTime $endAt, Status $status): array { $sql = 'SELECT bug_id, summary, reported_at FROM Bugs WHERE reported_at >= :startAt AND reported_at < :endAt AND status = :status'; $stmt = $this->pdo->prepare($sql); $stmt->bindValue(':startAt', $startAt->format(self::TIMESTAMP_FORMAT), \PDO::PARAM_STR); $stmt->bindValue(':endAt', $endAt->format(self::TIMESTAMP_FORMAT), \PDO::PARAM_STR); $stmt->bindValue(':status', $status->value, \PDO::PARAM_STR); $stmt->execute(); return $stmt->fetchAll(\PDO::FETCH_CLASS, Bug::class); } $BOOPU
    DBMM
    NFUIPE
    FYFDVUF
    PO
    1%04UBUFNFOUcGBMTF $BOOPU
    DBMM
    NFUIPE
    CJOE7BMVF
    PO
    1%04UBUFNFOUcGBMTF $BOOPU
    DBMM
    NFUIPE
    GFUDI"MM
    PO
    1%04UBUFNFOUcGBMTF ੩తղੳΛߦΘͳ͍ͱؾ͖ͮʹ͍͘
30. 1%0QSFQBSF
    ͷ໭Γ஋ IUUQTXXXQIQOFUNBOVBMKBQEPQSFQBSFQIQ 1%0&33.0%&@&9$&15*0/
    ͕σϑΥϧτͳͷͰɺ
    
    GBMTF
    ͕ฦͬͯ͘Δͷ͸ઃఆϛε
31. BTTFSU
    ͰܕΛڱΊΔ IUUQTQIQTUBOPSHXSJUJOHQIQDPEFOBSSPXJOHUZQFT
32. BTTFSU
    ͰܕΛڱΊΔ public function findAll(\DateTime $startAt, \DateTime $endAt, Status $status): array { $sql = 'SELECT bug_id, summary, reported_at FROM Bugs WHERE reported_at >= :startAt AND reported_at < :endAt AND status = :status'; $stmt = $this->pdo->prepare($sql); assert($stmt !== false, 'PDO::ATTR_ERRMODE should be PDO::ERRMODE_EXCEPTION'); $stmt->bindValue(':startAt', $startAt->format(self::TIMESTAMP_FORMAT), \PDO::PARAM_STR); $stmt->bindValue(':endAt', $endAt->format(self::TIMESTAMP_FORMAT), \PDO::PARAM_STR); $stmt->bindValue(':status', $status->value, \PDO::PARAM_STR); $stmt->execute(); return $stmt->fetchAll(\PDO::FETCH_CLASS, Bug::class); } TUNU
    ͷܕ͕
    1%04UBUFNFOU
    ʹߜΒΕΔ ͜͜Ͱ͸
    TUNU
    ͷܕ͕
    1%04UBUFNFOUcGBMTF
33. 1)1
    ͷ
    BTTFSU IUUQQIQOFUNBOVBMKBGVODUJPOBTTFSUQIQ
34. Agenda  ܕએݴ
     ྻڍܕ
     ੩తղੳ
     ܕͷϞσϦϯά
     ෆมੑ
     ׬શੑ
     ੹຿ͷ഑ஔ 👉
35. ܕͷϞσϦϯάͰ
    ޡΓ΍͢͞ΛݮΒ͢
36. public function testFindAll(): void { $xmas2025 = new \DateTime('2025-12-25'); $xmas2026 = new \DateTime('2026-12-25'); $bugs = $this->repo->findAll( $xmas2025, $xmas2026, Status::New ); $this->assertCount(3, $bugs); } ར༻ଆͷίʔυ Ҿ਺͕ͭ͋ΔͷͰ
    ͦΕͧΕͷ໾ׂ͕Θ͔Γʹ͍͘
37. public function testFindAll(): void { $xmas2025 = new \DateTime('2025-12-25'); $xmas2026 = new \DateTime('2026-12-25'); $bugs = $this->repo->findAll( startAt: $xmas2025, endAt: $xmas2026, status: Status::New ); $this->assertCount(3, $bugs); } ໊લ෇͖Ҿ਺ͰՄಡੑ͸޲্͕ͨ͠ɺ
    ݕࡧൣғʹ
    FOE"U
    ؚ͕·ΕΔͷ͔
    ؚ·Εͳ͍ͷ͔͕఻ΘΒͳ͍ ໊લ෇͖Ҿ਺ͰՄಡੑΛ্͛Δ 1 ) 1 
38. public function testFindAll(): void { $xmas2025 = new \DateTime('2025-12-25'); $xmas2026 = new \DateTime('2026-12-25'); $bugs = $this->repo->findAll( startAt: $xmas2025, endAtExclusive: $xmas2026, status: Status::New ); $this->assertCount(3, $bugs); } FOE"U
    ؚ͕·ΕΔ͔Ͳ͏͔Λ໊લͰࣔͯ͠΋ͬ͘͠Γ͜ͳ͍ Ҿ਺ͷ໊લͰࣔͯ͠΋ྑ͍͕ɺ
    ͜ͷઃܭ͸ৗʹద੾ͩΖ͏͔ʁ
    TUBS"U
    ͷํ͸Ͳ͏ͳΔͩΖ͏͔ʁ
39. wྑ͍ΠϯλϑΣʔεͱ͸࣍ͷͭͷ৚݅Λຬͨ ͢ΠϯλϑΣʔε
    wਖ਼͘͠࢖༻͢Δํ͕ૢ࡞ϛεΛ͢ΔΑΓ؆୯
    wޡͬͨ࢖͍ํΛ͢Δ͜ͱ͕ࠔ೉ ΤοηΠ
    ਖ਼͍͠࢖͍ํΛ؆୯ʹɺޡͬͨ࢖͍ํΛࠔ೉ʹ IUUQTXXXPSFJMMZDPKQCPPLT ΋ͬͱޡΓ΍͢͞ΛݮΒ͢ઃܭΛ͍ͨ͠
40. ର৅ͷྖҬʢυϝΠϯʣ
    ʹֶ͍ͭͯͼɺ
    ܕͷϞσϦϯάʹΑͬͯ
    ޡΓ΍͢͞ΛݮΒ͢
41. ൣғʢ۠ؒʣʹֶ͍ͭͯͿ
    ୺఺ IUUQTKBXJLJQFEJBPSHXJLJ&$#"&@&#&"%"
42. ൣғʢ۠ؒʣʹֶ͍ͭͯͿ
    ด۠ؒɺ։۠ؒ IUUQTXFLBOB[BXBJUBDKQNBUIDBUFHPSZPUIFSTZVVHPVIFOLBOUFYDHJ UBSHFUNBUIDBUFHPSZPUIFSTZVVHPVLVLBOOIUNM
43. ൣғʢ۠ؒʣʹֶ͍ͭͯͿ
    ൒։۠ؒ IUUQTXFLBOB[BXBJUBDKQNBUIDBUFHPSZPUIFSTZVVHPVIFOLBOUFYDHJ UBSHFUNBUIDBUFHPSZPUIFSTZVVHPVLVLBOOIUNM
44. final readonly class DateTimeEndpoint { public function __construct( public \DateTime $value, public bool $inclusive, ) {} } final readonly class DateTimeRange { public function __construct( public DateTimeEndpoint $startAt, public DateTimeEndpoint $endAt, ) {} } fi OBM
    SFBEPOMZ
    DMBTT
    ͱ
    $POTUSVDUPS
    1SPQFSUZ
    1SPNPUJPO
    ͷ૊Έ߹Θͤ͸
    1)1
    ʹ͓͚Δ
    3FDPSE
    ܕͷ
    Α͏ͳ΋ͷͱݴ͑ͦ͏ লུͤ͞ͳ͍ʢσϑΥϧτ஋Λ༻ҙ͠ͳ͍ʣ͜ͱͰ
    ୺఺Λҙࣝ͠΍͘͢ͳΔ جૅͱͳΔܕΛ͍ͭͬͯ͘͘ 1 ) 1   fi OBM
    ͰܧঝΛېࢭ͢Δ
    SFBEPOMZ
    ͰϓϩύςΟมߋΛېࢭ͢Δ
45. ͜ΕͰؒҧ͍ʹ͘͘ͳ͕ͬͨɺࠓ౓͸࢖͏ͷ͕΍΍໘౗ʜʜ public function testFindAll(): void { $startAt = new DateTimeEndpoint( value: new \DateTime('2025-12-25'), inclusive: true ); $endAt = new DateTimeEndpoint( value: new \DateTime('2026-12-25'), inclusive: false ); $range = new DateTimeRange($startAt, $endAt); $bugs = $this->repo->findAll(searchRange: $range, status: Status::New); $this->assertCount(3, $bugs); }
46. wྑ͍ΠϯλϑΣʔεͱ͸࣍ͷͭͷ৚݅Λຬͨ ͢ΠϯλϑΣʔε
    wਖ਼͘͠࢖༻͢Δํ͕ૢ࡞ϛεΛ͢ΔΑΓ؆୯
    wޡͬͨ࢖͍ํΛ͢Δ͜ͱ͕ࠔ೉ ΤοηΠ
    ਖ਼͍͠࢖͍ํΛ؆୯ʹɺޡͬͨ࢖͍ํΛࠔ೉ʹ IUUQTXXXPSFJMMZDPKQCPPLT ݱঢ়Ͱ͸ਖ਼͘͠࢖͏ͷ͕΍΍໘౗
47. खݎ͞ͱॻ͖΍͢͞ͷཱ྆ΛࢼΈΑ͏ final readonly class DateTimeEndpoint { （中略） public static function including(string $dateTimeStr): DateTimeEndpoint { return new DateTimeEndpoint( value: new \DateTime($dateTimeStr), inclusive: true ); } public static function excluding(string $dateTimeStr): DateTimeEndpoint { return new DateTimeEndpoint( value: new \DateTime($dateTimeStr), inclusive: false ); } } ෼͔Γ΍໊͍͢લͷϑΝΫτϦʔϝιουΛఆٛ ෼͔Γ΍໊͍͢લͷϑΝΫτϦʔϝιουΛఆٛ
48. ͜ΕͰར༻ଆΛ୹͘ॻ͚ΔΑ͏ʹͳͬͨ public function testFindAll(): void { $range = new DateTimeRange( startAt: DateTimeEndpoint::including('2025-12-25'), endAt: DateTimeEndpoint::excluding('2026-12-25') ); $bugs = $this->repo->findAll(searchRange: $range, status: Status::New); $this->assertCount(3, $bugs); } ୹͘ॻ͚ΔΑ͏ʹͳͬͨ
49. Agenda  ܕએݴ
     ྻڍܕ
     ੩తղੳ
     ܕͷϞσϦϯά
     ෆมੑ
     ׬શੑ
     ੹຿ͷ഑ஔ 👉
50. ෆมੑ JNNVUBCJMJUZ 
    ঢ়ଶมԽΛഉআͯ͠
    ޡΓ΍͢͞ΛݮΒ͢
51. ผ໊ࢀর໰୊
    "MJBTJOH
52. 4VCTDSJQUJPO
    ΦϒδΣΫτΛྫʹผ໊ࢀর໰୊ΛֶͿ final readonly class Subscription implements \Stringable { public function __construct( private string $name, private DateTimeRange $range, ) { } public function __toString(): string { $startAt = $this->range->startAt->value; $endAt = $this->range->endAt->value; return $this->name . '(' . $startAt->format('Y-m-d') . ' -> ' . $endAt->format('Y-m-d') . ')'; } public function renew(): void { $oneYear = \DateInterval::createFromDateString('1 year'); $this->range->startAt->value->add($oneYear); $this->range->endAt->value->add($oneYear); } } ઌ΄Ͳ࡞੒ͨ͠
    %BUF5JNF3BOHF
    ΦϒδΣΫτΛ࢖ͬͯΈΔ # " % αϒεΫϦϓγϣϯܖ໿Λ೥ߋ৽͢Δϝιου
53. $year2025 = new DateTimeRange( startAt: DateTimeEndpoint::including('2025-01-01'), endAt: DateTimeEndpoint::excluding('2026-01-01') ); $phpstorm = new Subscription('PhpStorm', $year2025); echo $phpstorm, PHP_EOL; // PhpStorm(2025-01-01 -> 2026-01-01) $oreilly = new Subscription('O\'Reilly', $year2025); echo $oreilly, PHP_EOL; // O'Reilly(2025-01-01 -> 2026-01-01) $phpstorm->renew(); echo $phpstorm, PHP_EOL; // PhpStorm(2026-01-01 -> 2027-01-01) echo $oreilly, PHP_EOL; // O'Reilly(2026-01-01 -> 2027-01-01) echo $year2025->startAt->value->format('Y-m-d H:i:s'), PHP_EOL; // 2026-01-01 00:00:00 echo $year2025->endAt->value->format('Y-m-d H:i:s'), PHP_EOL; // 2027-01-01 00:00:00 ผ໊ࢀর໰୊ 03FJMMZ
    ͷܖ໿ظؒ΋
    ߋ৽͞Εͯ͠·͍ͬͯΔ  1IQ4UPSN
    ͷαϒεΫϦϓγϣϯܖ໿Λ೥ߋ৽͢Δ
54. fi OBM
    SFBEPOMZ
    એݴ͚ͩͰ͸
    μϝͩͬͨͷ͸ͳ͔ͥ
55. Կ͕ݪҼͩͬͨͷ͔ # " % ͕͜͜໰୊
    ࠶୅ೖͰ͸ͳ͘ͱ΋ഁյతมߋ͕ग़དྷͯ͠·͏ final readonly class Subscription implements \Stringable { public function __construct( private string $name, private DateTimeRange $range, ) { } public function __toString(): string { $startAt = $this->range->startAt->value; $endAt = $this->range->endAt->value; return $this->name . '(' . $startAt->format('Y-m-d') . ' -> ' . $endAt->format('Y-m-d') . ')'; } public function renew(): void { $oneYear = \DateInterval::createFromDateString('1 year'); $this->range->startAt->value->add($oneYear); $this->range->endAt->value->add($oneYear); } }
56. 1)1
    ͷ
    %BUF5JNF
    Ϋϥε͕ഁյతมߋΛڐͯ͠͠·͏ 1)1
    ͷ
    %BUF5JNF
    Ϋϥε͕ഁյతมߋΛ
    ڐͯ͠͠·͍ͬͯͨɻ
    ՄมΦϒδΣΫτ΁ͷࢀর͕औಘͰ͖Δͱ
    fi OBM
    SFBEPOMZ
    Ͱ͋ͬͯ΋ঢ়ଶΛมߋͰ͖ͯ͠·͏ # " % final readonly class DateTimeEndpoint { public function __construct( public \DateTime $value, public bool $inclusive, ) {} final readonly class DateTimeRange { public function __construct( public DateTimeEndpoint $startAt, public DateTimeEndpoint $endAt, ) {} (後略)
57. ෆมΦϒδΣΫτΛͭ͘Δ
58. %BUF5JNF
    ͱ
    %BUF5JNF*NNVUBCMF IUUQTXXXQIQOFUNBOVBMKBDMBTTEBUFUJNFQIQ
59. use PhpconFuk\PHP8_2\Immutable; #[Immutable] final readonly class DateTimeEndpoint { public function __construct( public \DateTime $value, public bool $inclusive, ) {} public static function including(string $dateTimeStr): DateTimeEndpoint { return new DateTimeEndpoint( value: new \DateTime($dateTimeStr), inclusive: true ); } public static function excluding(string $dateTimeStr): DateTimeEndpoint { return new DateTimeEndpoint( value: new \DateTime($dateTimeStr), inclusive: false ); } } .VUBCMF
    ͳ
    %BUF5JNF&OEQPJOU # " %
60. use PhpconFuk\Immutable; #[Immutable] final readonly class DateTimeEndpoint { public function __construct( public \DateTimeImmutable $value, public bool $inclusive, ) {} public static function including(string $dateTimeStr): DateTimeEndpoint { return new DateTimeEndpoint( value: new \DateTimeImmutable($dateTimeStr), inclusive: true ); } public static function excluding(string $dateTimeStr): DateTimeEndpoint { return new DateTimeEndpoint( value: new \DateTimeImmutable($dateTimeStr), inclusive: false ); } } *NNVUBCMF
    ͳ
    %BUF5JNF&OEQPJOU %BUF5JNF*NNVUBCMFΛ࢖͍ͬͯ͘ %BUF5JNF*NNVUBCMFΛ࢖͍ͬͯ͘
61. namespace PhpconFuk; use Attribute; #[Attribute(Attribute::TARGET_CLASS | Attribute::IS_REPEATABLE)] class Immutable {} Ԡ༻
    ಠࣗͷ
    "UUSJCVUF
    Λఆٛͯ͠ҙຯ͚ͮΛ͠Α͏ IUUQTXXXBNB[PODPKQEQ *NNVUBCMF
    Ͱ͋Δ͜ͱΛࣔ͢
    ΞτϦϏϡʔτΛಠࣗఆٛ͢Δ
62. Ԡ༻
    ಠࣗͷ
    "UUSJCVUF
    Λఆٛͯ͠ҙຯ͚ͮΛ͠Α͏ IUUQTXXXBNB[PODPKQEQ
63. use PhpconFuk\Immutable; #[Immutable] final readonly class DateTimeEndpoint { public function __construct( public \DateTimeImmutable $value, public bool $inclusive, ) {} public static function including(string $dateTimeStr): DateTimeEndpoint { return new DateTimeEndpoint( value: new \DateTimeImmutable($dateTimeStr), inclusive: true ); } public static function excluding(string $dateTimeStr): DateTimeEndpoint { return new DateTimeEndpoint( value: new \DateTimeImmutable($dateTimeStr), inclusive: false ); } } *NNVUBCMF
    Ͱ͋Δͱʢ1)1Ͱ͸ͳ͘νʔϜʹʣ఻͑Δ ͖͞΄Ͳఆٛͨ͠
    *NNVUBCMF
    ΞτϦϏϡʔτΛ࢖͏
64. use PhpconFuk\Immutable; #[Immutable] final readonly class DateTimeEndpoint { public function __construct( public \DateTimeImmutable $value, public bool $inclusive, ) {} #[\NoDiscard] public function withValue(\DateTimeImmutable $newValue): DateTimeEndpoint { return clone($this, ["value" => $newValue]); } (後略) ෆมΦϒδΣΫτͷΫϩʔϯੜ੒ 1)1
    Ͱ͸ෆมΦϒδΣΫτͷҰ෦͚ͩͷ஋Λ
    มߋͨ͠ΫϩʔϯΛ࡞ΕΔΑ͏ʹͳͬͨ 1)1
    Ͱ௥Ճ͞Εͨ
    ໭Γ஋Λແࢹͤ͞ͳ͍
    /P%JTDBSE
    ΞτϦϏϡʔτΛ෇༩ 1 ) 1  
65. final readonly class Subscription implements \Stringable { public function __construct( private string $name, private DateTimeRange $range, ) { } (中略) public function renew(): void { $oneYear = \DateInterval::createFromDateString('1 year'); $this->range->startAt->value->add($oneYear); $this->range->endAt->value->add($oneYear); } .VUBCMF
    ͳ
    4VCTDSJQUJPO %BUF5JNF
    ΦϒδΣΫτͷ
    ഁյతมߋΛલఏʹ͍ͯͨ͠ มߋલ͸
    %BUF5JNF3BOHF
    ͕อ࣋͢Δ
    %BUF5JNF&OEQPJOU
    ͕
    NVUBCMF
    ͩͬͨ # " %
66. use PhpconFuk\Immutable; #[Immutable] final readonly class Subscription implements \Stringable { public function __construct( private string $name, private DateTimeRange $range, ) { } (中略) #[\NoDiscard] public function renew(): Subscription { $oneYear = \DateInterval::createFromDateString('1 year'); $startAt = $this->range->startAt; $endAt = $this->range->endAt; return new Subscription( name: $this->name, range: new DateTimeRange( startAt: $startAt->withValue($startAt->value->add($oneYear)), endAt: $endAt->withValue($endAt->value->add($oneYear)) ) ); } *NNVUBCMF
    ͳ
    4VCTDSJQUJPO ࣗ਎ͷঢ়ଶΛมߋͤͣɺ
    ৽͍͠ঢ়ଶΛอ࣋ͨ͠ෆมΦϒδΣΫτΛฦ͢ %BUF5JNF3BOHF
    ͕อ࣋͢Δ
    %BUF5JNF&OEQPJOU
    ͕อ࣋͢Δ೔෇ܕ͕
    %BUF5JNF*NNVUBCMF
    ʹมߋ͞Εͨ ໭Γ஋Λແࢹͤ͞ͳ͍
    /P%JTDBSE
    ΞτϦϏϡʔτΛ෇༩ 1 ) 1  
67. ෆมΦϒδΣΫτͰͷ
    ໰୊ղܾ
68. $year2025 = new DateTimeRange( startAt: DateTimeEndpoint::including('2025-01-01'), endAt: DateTimeEndpoint::excluding('2026-01-01') ); $phpstorm = new Subscription('PhpStorm', $year2025); echo $phpstorm, PHP_EOL; // PhpStorm(2025-01-01 -> 2026-01-01) $oreilly = new Subscription('O\'Reilly', $year2025); echo $oreilly, PHP_EOL; // O'Reilly(2025-01-01 -> 2026-01-01) // Warning: The return value of method PhpconFuk\Subscription::renew() should either be used or intentionally ignored by casting it as (void) in /path/to/demo_aliasing.php $phpstorm->renew(); echo $oreilly, PHP_EOL; // O'Reilly(2025-01-01 -> 2026-01-01) echo $year2025->startAt->value->format('Y-m-d H:i:s'), PHP_EOL; // 2025-01-01 00:00:00 echo $year2025->endAt->value->format('Y-m-d H:i:s'), PHP_EOL; // 2026-01-01 00:00:00 ෆมΦϒδΣΫτʹΑͬͯผ໊ࢀর໰୊Λղܾ ໭Γ஋Λແࢹ͢Δͱ
    /P%JTDBSE
    ΞτϦϏϡʔτʹΑͬͯܯࠂ͕ग़Δ
69. $year2025 = new DateTimeRange( startAt: DateTimeEndpoint::including('2025-01-01'), endAt: DateTimeEndpoint::excluding('2026-01-01') ); $phpstorm = new Subscription('PhpStorm', $year2025); echo $phpstorm, PHP_EOL; // PhpStorm(2025-01-01 -> 2026-01-01) $oreilly = new Subscription('O\'Reilly', $year2025); echo $oreilly, PHP_EOL; // O'Reilly(2025-01-01 -> 2026-01-01) $phpstorm2026 = $phpstorm->renew(); echo $phpstorm2026, PHP_EOL; // PhpStorm(2026-01-01 -> 2027-01-01) echo $phpstorm, PHP_EOL; // PhpStorm(2025-01-01 -> 2026-01-01) echo $oreilly, PHP_EOL; // O'Reilly(2025-01-01 -> 2026-01-01) echo $year2025->startAt->value->format('Y-m-d H:i:s'), PHP_EOL; // 2025-01-01 00:00:00 echo $year2025->endAt->value->format('Y-m-d H:i:s'), PHP_EOL; // 2026-01-01 00:00:00 ෆมΦϒδΣΫτʹΑͬͯผ໊ࢀর໰୊Λղܾ 👍 ৽ͨͳαϒεΫϦϓγϣϯظؒΛ൐͏৽ͨͳΦϒδΣΫτΛฦ͢
70. Agenda  ܕએݴ
     ྻڍܕ
     ੩తղੳ
     ܕͷϞσϦϯά
     ෆมੑ
     ׬શੑ
     ੹຿ͷ഑ஔ 👉
71. ׬શੑ JOUFHSJUZ 
    ଘࡏ͢ΔͳΒ͹ৗʹਖ਼͍͠
    ʢෆม৚͕݅ৗʹ੒Γཱͭʣ
    ঢ়ଶͱͳΔઃܭΛߦ͍
    ޡΓ΍͢͞ΛݮΒ͢
72. ݕࡧ։࢝೔࣌ͱ
    ݕࡧऴྃ೔࣌ͷ
    ੔߹ੑΛ୲อ͢Δͷ͸ ୭ͷ੹೚
73. public function findAll(DateTimeRange $searchRange, Status $status): array { $startAt = $searchRange->startAt->value; $endAt = $searchRange->endAt->value; if ($endAt < $startAt) { throw new \InvalidArgumentException('endAt < startAt'); } $startAtOp = $searchRange->startAt->inclusive ? '<=' : '<'; $endAtOp = $searchRange->endAt->inclusive ? '<=' : '<'; $sql = "SELECT bug_id, summary, reported_at FROM Bugs WHERE status = :status AND :startAt ${startAtOp} reported_at AND reported_at ${endAtOp} :endAt"; $stmt = $this->pdo->prepare($sql); $stmt->bindValue(':status', $status->value, \PDO::PARAM_STR); $stmt->bindValue(':startAt', $startAt->format(self::TIMESTAMP_FORMAT), \PDO::PARAM_STR); $stmt->bindValue(':endAt', $endAt->format(self::TIMESTAMP_FORMAT), \PDO::PARAM_STR); $stmt->execute(); return $stmt->fetchAll(\PDO::FETCH_CLASS, Bug::class); } ͜͜Ͱ΍Δͷ͸ے͕ѱ͍ fi OE"MM
    ͷೖΓޱͰߦ͏ͷ͸ے͕ѱ͍
74. ଘࡏ͢ΔͳΒ͹طʹਖ਼͍͠ઃܭΛ࡞Δώϯτ w.BLF
    JMMFHBM
    TUBUFT
    VOSFQSFTFOUBCMF
    w%F fi OF
    FSSPST
    PVU
    PG
    FYJTUFODF
    w'BJM
    GBTU ͭͷҟͳΔߟ͑ํ͕͋Γ·͢
75. .BLF
    JMMFHBM
    TUBUFT
    VOSFQSFTFOUBCMF
    ෆਖ਼ͳঢ়ଶ͸
    දݱͰ͖ͳ͍Α͏ʹ͢Δ
76. .BLF
    JMMFHBM
    TUBUFT
    VOSFQSFTFOUBCMF ͜Ε͸ɺʮෆਖ਼ͳঢ়ଶ͸දݱͰ͖ͳ͍Α͏ʹ͢Δʯͱ͍͏ॏཁͳઃܭΨΠυ ϥΠϯͷҰྫͰ͢ɻࢲͨͪ͸ϏδωεϧʔϧΛܕγεςϜͰදݱ͠Α͏ͱ͠ ͍ͯ·͢ɻ͜Ε͕ద੾ʹߦΘΕ͍ͯΕ͹ɺෆਖ਼ͳঢ়ଶ͕ίʔυʹଘࡏ͢Δ͜ ͱ͸ͳ͘ɺͦͷͨΊͷϢχοτςετΛॻ͘ඞཁ͸͋Γ·ͤΜɻͦͷ୅ΘΓ ʹͳΔͷ͕ɺʮίϯύΠϧ࣌ʯͱ͍͏ϢχοτςετͳͷͰ͢ɻ IUUQTXXXBNB[PODPKQEQ#%%#1/#7+
77. .BLF
    JMMFHBM
    TUBUFT
    VOSFQSFTFOUBCMF w ܕͷઃܭʹΑͬͯɺෆਖ਼ͳঢ়ଶͰ͸ͦ΋ͦ΋ίϯύΠϧʢ1)1
    ͷ৔߹͸ ੩తղੳʣ͕௨Βͳ͍Α͏ʹ͍ͨ͠
    w ࠓճͷ৔߹͸Ҿ਺
    TUBSU"U
    ΑΓҾ਺
    FOE"U
    ͷํ͕େ͖͍ʢະདྷ೔ʣ ͜ͱΛܕͰදݱ͍͕ͨ͠ʜʜ
    w 3F fi OFNFOU
    5ZQFT
    ΍
    %FQFOEFOU
    5ZQFT
    ͷΑ͏ͳܕͷදݱྗ͕ඞཁ ͳͷͰɺকདྷͷ
    1)1
    ʹظ଴
    w ʢࠓճͷαϯϓϧʹ͸͏·͘߹க͠·ͤΜͰͨ͠ʣ
78. %F fi OF
    FSSPST
    PVU
    PG
    FYJTUFODF
    ΤϥʔΛఆٛͰফ͠ڈΔ
79. %F fi OF
    FSSPST
    PVU
    PG
    FYJTUFODF ྫ֎ॲཧͷෳࡶ͞Λഉআ͢Δ࠷ྑͷํ๏͸ɺॲཧ͢΂͖ྫ֎͕ଘࡏ͠ͳ͍Α ͏ʹ"1*Λఆٛ͢Δ͜ͱͰ͢ɻ
    ͭ·ΓɺΤϥʔΛఆٛͰফ͠ڈΔͷͰ͢ɻ͜Ε͸๯ಚతʹฉ͑͜Δ͔΋͠Ε ·ͤΜ͕ɺ࣮ફʹ͓͍ͯ͸ඇৗʹޮՌతͰ͢ɻ IUUQTXXXBNB[PODPKQEQ9
80. খ͍͞ํͷ஋ΛԼ୺఺ɺେ͖͍ํͷ஋Λ্୺఺ʹ͢Ε͹Τϥʔ৚݅͸ͳ͍ final readonly class DateTimeRange { private function __construct( public DateTimeEndpoint $startAt, public DateTimeEndpoint $endAt, ) { } public static function createFromEndpoints( DateTimeEndpoint $endpoint1, DateTimeEndpoint $endpoint2 ): self { return $endpoint1->value <= $endpoint2->value ? new self($endpoint1, $endpoint2) : new self($endpoint2, $endpoint1); } }
81. %F fi OF
    FSSPST
    PVU
    PG
    FYJTUFODF ΤϥʔΛଟ༻͢ΔΞϓϩʔν͸͍͔ͭ͘ͷόάΛัଊͰ͖Δ͔΋͠Ε·ͤΜ ͕ɺಉ࣌ʹෳࡶ͞΋૿େͤ͞ɺͦΕ͕ଞͷόάΛੜΈग़݁͢ՌͱͳΓ·͢ɻ
    ΤϥʔΛଟ༻͢ΔΞϓϩʔνͰ͸ɺ։ൃऀ͸ΤϥʔΛճආ·ͨ͸ແࢹ͢Δͨ Ίͷ௥ՃίʔυΛॻ͔ͳ͚Ε͹ͳΒͣɺ͜Ε͕όάͷՄೳੑΛߴΊ·͢ɻ͋ Δ͍͸ɺ௥ՃίʔυΛॻ͘͜ͱΛ๨Εͯ͠·͍ɺͦͷ৔߹͸࣮ߦ࣌ʹ༧ظ͠ ͳ͍Τϥʔ͕౤͛ΒΕΔՄೳੑ͕͋Γ·͢ɻ IUUQTXXXBNB[PODPKQEQ9
82. %F fi OF
    FSSPST
    PVU
    PG
    FYJTUFODF ରরతʹɺΤϥʔΛఆٛͰফ͠ڈΔΞϓϩʔν͸"1*Λ؆ܿʹ͠ɺॻ͔ͳ͚ Ε͹ͳΒͳ͍ίʔυͷྔΛݮΒ͠·͢ɻ
    શମͱͯ͠ɺόάΛݮΒ͢࠷ྑͷํ๏͸ιϑτ΢ΣΞΛΑΓγϯϓϧʹ͢Δ ͜ͱͰ͢ɻ IUUQTXXXBNB[PODPKQEQ9
83. 'BJM
    GBTU
    ෆਖ਼ͳঢ়ଶͳΒ͹
    ଎΍͔ʹࣦഊͤ͞Δ
84. ୡਓϓϩάϥϚʔ
    5JQ
    
    ૣΊʹΫϥογϡͤ͞Δ͜ͱ ʮ͋Γಘͳ͍ʯͱࢥΘΕΔࣄ৅͕ίʔυͷ࣮ߦதʹൃੜͨ͠৔߹ɺͦͷ࣌ ఺ͰϓϩάϥϜ͸΋͸΍࣮ߦՄೳͳ΋ͷͱ͸ͳ͍ͬͯͳ͍ͷͰ͢ɻͦͷ࣌ ఺Ҏ߱ʹॲཧ͞Εͨ಺༰͸ٙΘ͍͠΋ͷͰ͋ΔͨΊɺ଎΍͔ʹఀࢭͤͯ͞ ͍ͩ͘͞ɻ
    ௨ৗͷ৔߹ɺఀࢭͨ͠ϓϩάϥϜͷ΄͏͕ɺো֐ʹΑͬͯத్൒୺ʹಈ࡞ ͍ͯ͠ΔϓϩάϥϜΑΓ΋μϝʔδ͸গͳ͍͸ͣͰ͢ IUUQTXXXPINTIBDPKQCPPL
85. ࣄલ৚݅
    
    ར༻ଆͷ੹೚Ͱ͋Δ৔߹͸ද໌Λ࢖͏ final readonly class DateTimeRange { /** * 与えられた下端点と上端点からDateTimeRangeを生成します。 * 上端点は下端点以上である必要があります。 * @param DateTimeEndpoint $startAt 下端点 * @param DateTimeEndpoint $endAt 上端点 */ public function __construct( public DateTimeEndpoint $startAt, public DateTimeEndpoint $endAt, ) { assert($startAt->value <= $endAt->value, '上端点は下端点以上である必要があります'); } JOWBSJBOU
    ৗʹ੒Γཱͭ΂͖ෆม৚݅ ΛࣜͰॻ͘ ࣄલ৚݅Λ͖ͪΜͱ఻͑Δ͜ͱ
86. ද໌Λ࢖Θͳ͍৔߹͸ɺར༻ଆͷ੹೚Ͱ͋Δ͜ͱΛࣔ͢ྫ֎Λ࢖͏ final readonly class DateTimeRange { /** * 与えられた下端点と上端点からDateTimeRangeを生成します。 * @param DateTimeEndpoint $startAt 下端点 * @param DateTimeEndpoint $endAt 上端点 * @throws \InvalidArgumentException 下端点が上端点より大きい場合 */ public function __construct( public DateTimeEndpoint $startAt, public DateTimeEndpoint $endAt, ) { if ($startAt->value > $endAt->value) { throw new \InvalidArgumentException('startAt > endAt'); } ར༻ଆͷޡΓͰ͋Δࢫͷྫ֎Λൃੜͤ͞Δ ࣄલ৚݅Λ͖ͪΜͱ఻͑Δ͜ͱ
87. ্୺఺ͱԼ୺఺͕౳͍͠ͱ͖͸ʁ IUUQTKBXJLJQFEJBPSHXJLJ&$#"&@&#&"%" େࣄͳΤοδέʔεͳͷͰ͕͢ɺࠓճͷߨԋͰ͸࣌ؒͷؔ܎ͰׂѪ͠·͢
88. Agenda  ܕએݴ
     ྻڍܕ
     ੩తղੳ
     ܕͷϞσϦϯά
     ෆมੑ
     ׬શੑ
     ੹຿ͷ഑ஔ 👉
89. ద੾ͳ৔ॴͰ
    ద੾ͳ࢓ࣄΛߦ͏
90. w จࣈྻ͔Β
    %BUF5JNF*NNVUBCMF
    ʹม׵͢Δͷ͸୭ͷ੹೚
    Ͳ͜Ͱ΍Δ
    w %BUF5JNF*NNVUBCMF
    ͔Βจࣈྻʹม׵͢Δͷ͸୭ͷ੹೚
    Ͳ͜Ͱ΍Δ
    w ʢ͍··Ͱݟͯݟ͵ৼΓΛ͍ͯͨ͠ʣλΠϜκʔϯΛѻ͏ͷ͸୭ͷ੹೚
    Ͳ͜Ͱ΍Δ ੹຿ʹؔ͢Δઃܭͷٙ໰఺Λ·ͱΊ͍ͯ͜͏
91. จࣈྻ͔Β
    %BUF5JNF*NNVUBCMF
    ΁ͷม׵Λ
    ෆద੾ͳ৔ॴͰߦ͍ͬͯΔ͜ͱʹؾ͍ͮͯ͠·ͬͨ
92. final readonly class DateTimeEndpoint { public function __construct( public \DateTimeImmutable $value, public bool $inclusive, ) {} (中略) public static function including(string $dateTimeStr): DateTimeEndpoint { return new DateTimeEndpoint( value: new \DateTimeImmutable($dateTimeStr), inclusive: true ); } public static function excluding(string $dateTimeStr): DateTimeEndpoint { return new DateTimeEndpoint( value: new \DateTimeImmutable($dateTimeStr), inclusive: false ); } } ઃܭͷෆ٢ͳष͍ʹؾ͍ͮͯ͠·ͬͨ # " % จࣈྻ͔Β
    %BUF5JNF*NNVUBCMF
    ΁ͷม׵ʹ͸
    ๲େͳ૊Έ߹Θ͕ͤ͋Δ͠ɺ
    λΠϜκʔϯͷѻ͍΋ෆे෼ʹͳͬͯ͠·͍ͬͯΔɻ
    จࣈྻҾ਺ʹλΠϜκʔϯͷΦϑηοτදهΛؚΊ ͳ͍ͱσϑΥϧτͷλΠϜκʔϯʹͳͬͯ͠·͏
    ͭ·Γ͜͜Ͱߦ͏ͷ͸ෆద੾ɻ จࣈྻ͔Β
    %BUF5JNF*NNVUBCMF
    ΁ͷม׵ʹ͸
    ๲େͳ૊Έ߹Θ͕ͤ͋Δ͠ɺ
    λΠϜκʔϯͷѻ͍΋ෆे෼ʹͳͬͯ͠·͍ͬͯΔɻ
    จࣈྻҾ਺ʹλΠϜκʔϯͷΦϑηοτදهΛؚΊ ͳ͍ͱσϑΥϧτͷλΠϜκʔϯʹͳͬͯ͠·͏
    ͭ·Γ͜͜Ͱߦ͏ͷ͸ෆద੾ɻ
93. public function testFindAll(): void { $range = new DateTimeRange( startAt: DateTimeEndpoint::including('2025-12-25'), endAt: DateTimeEndpoint::excluding('2026-12-25') ); $bugs = $this->repo->findAll(searchRange: $range, status: Status::New); $this->assertCount(3, $bugs); }
    ࢖͏ͷ͕΍΍໘౗ͩͬͨͷͰɺ୹͘ॻ͚ΔศརͳϝιουΛఏڙ͔ͨͬͨ͠ͷͩͬͨ ༰қ͞ʹدΓ͗ͯ͢ɺ
    ँΓ΍͢͞΋্͕ͬͯ͠·͍ͬͯͳ͍ͩΖ͏͔ ςετίʔυͰ୹͘ॻ͖͍ͨͷͰ༰қ͞ʢ&BTZʣدΓʹόΠΞε͕͔͔ͬͯ͠·ͬͨɻ
    ςετίʔυͷେ෦෼Ͱ͸ಛʹλΠϜκʔϯΛҙࣝͤͣ୹͘ॻ͍͍͖͍͕ͯͨɺ
    ίϯτϩʔϥͰ͸λΠϜκʔϯΛҙࣝͯ͠ݫີʹѻ͍͍ͨɻ
    ςετίʔυ΋ͻͱͭͷίϯςΫετɻ
    ςετ͔ΒઃܭΛۦಈ͢Δͱ͖ʹ͜ͷόΠΞεʹ஫ҙ͢Δඞཁ͕͋Δɻ # " %
94. wྑ͍ΠϯλϑΣʔεͱ͸࣍ͷͭͷ৚݅Λຬͨ ͢ΠϯλϑΣʔε
    wਖ਼͘͠࢖༻͢Δํ͕ૢ࡞ϛεΛ͢ΔΑΓ؆୯
    wޡͬͨ࢖͍ํΛ͢Δ͜ͱ͕ࠔ೉ ΤοηΠ
    ਖ਼͍͠࢖͍ํΛ؆୯ʹɺޡͬͨ࢖͍ํΛࠔ೉ʹ IUUQTXXXPSFJMMZDPKQCPPLT ༰қ͞ΛٻΊͨ݁Ռɺ
    ޡͬͨ࢖͍ํΛ͢Δͷ΋༰қʹͳͬͯ͠·ͬͨ ༰қ͞ΛٻΊͨ݁Ռɺ
    ޡͬͨ࢖͍ํΛ͢Δͷ΋༰қʹͳͬͯ͠·ͬͨ
95. 4JNQMF
    ͱ
    &BTZ
    ͸ࠞͥΔͳةݥ IUUQTUXJUUFSDPNU@XBEBTUBUVT
    IUUQTUXJUUFSDPNU@XBEBTUBUVT
96. 4JNQMF
    ͱ
    &BTZ
    Λ ࠞͥͳ͍
    &BTZ
    ͞͸
    ঢ়گʹΑΓҟͳΔ
97. final readonly class DateTimeEndpoint { public function __construct( public \DateTimeImmutable $value, public bool $inclusive, ) {} (中略) public static function including(string $dateTimeStr): DateTimeEndpoint { return new DateTimeEndpoint( value: new \DateTimeImmutable($dateTimeStr), inclusive: true ); } public static function excluding(string $dateTimeStr): DateTimeEndpoint { return new DateTimeEndpoint( value: new \DateTimeImmutable($dateTimeStr), inclusive: false ); } } 4JNQMF
    ͱ
    &BTZ
    ͕ࠞͬͯ͟͠·͍ͬͯͨ Simple Easy # " %
98. final readonly class DateTimeEndpoint { public function __construct( public \DateTimeImmutable $value, public bool $inclusive, ) {} (中略) public static function including(\DateTimeImmutable $value): DateTimeEndpoint { return new DateTimeEndpoint( value: $value, inclusive: true ); } public static function excluding(\DateTimeImmutable $value): DateTimeEndpoint { return new DateTimeEndpoint( value: $value, inclusive: false ); } }
    
    
    جૅͱͳΔܕ͸
    4JNQMF
    ͞Λอͭ
    จࣈྻ͔Βͷม׵ΛѻΘͳ͍ Simple 4 JN Q MF Simple
99. final class DateTimeShorthandHelper { public static function jst(string $dateTimeStr): \DateTimeImmutable { return new \DateTimeImmutable($dateTimeStr, new \DateTimeZone('Asia/Tokyo')); } public static function utc(string $dateTimeStr): \DateTimeImmutable { return new \DateTimeImmutable($dateTimeStr, new \DateTimeZone('UTC')); } }
    
    
    &BTZ
    ͞͸ผͷϨΠϠʔͰఏڙ͢Δɻྫ͑͹ςετ༻ͷϔϧύʔ &BTZ
100. use PHPUnit\Framework\TestCase; use PHPUnit\Framework\Attributes\Test; use PhpconFuk\DateTimeShorthandHelper as DT; class DateTimeRangeTest extends TestCase { #[Test] public function dateTimeShorthand(): void { $range = new DateTimeRange( startAt: DateTimeEndpoint::including(DT::jst('2025-12-25')), endAt: DateTimeEndpoint::excluding(DT::jst('2026-12-25')) ); $this->assertSame('2025-12-25', $range->startAt->value->format('Y-m-d')); $this->assertSame('2026-12-25', $range->endAt->value->format('Y-m-d')); } } &BTZ
     ͞͸ผͷϨΠϠʔͰఏڙ͢Δɻྫ͑͹ςετ༻ͷϔϧύʔ ςετίʔυ্Ͱ
     4JNQMF
     ͱ
     &BTZ
     Λ߹ྲྀͤ͞Δɻ
     ͜͏ॻ͚Ε͹े෼ͩͬͨɻ
101. 1BSTF
     EPOU
     KVTU
     WBMJEBUF IUUQTMFYJMBNCEBHJUIVCJPCMPHQBSTFEPOUWBMJEBUF
102. ΈΜͳେ޷͖
     $MFBO
     "SDIJUFDUVSF
     ͷ
     ಉ৺ԁΛྫʹͯ͠ߟ͑ͯΈΔ
103. ੺ͱ੨ͷք໘ɺ૚ͷք໘͕͋Δ
     ੨͸֎քͱͷγϦΞϥΠθʔγϣϯڥք
104. 1BSTF
     ݕূࡁΈͷ஋Λܕͱͯ͠දݱ͠ɺ
     ͦͷޙ͸ܕͷอূʹཔΔ 7BMJEBUF
     ֎ք͔Βͷ༷ʑͳೖྗΛɺ
     ίϯςΫετʹԠͯ͡ద੾ʹݕূ͢Δ
105. DateTimeZone DateTimeImmutable string 8FC
     ͔ΒདྷͨจࣈྻΛόϦσʔγϣϯͭ͠ ͭɺʢΞϓϦέʔγϣϯͰద੾ʹอ࣋͠ ͨʣλΠϜκʔϯΛ൐ͬͯ
     %BUF5JNF*NNVUBCMF
     ʹม׵͠ɺͦΕΛ͞ Βʹ
     %BUF5JNF&OEQPJOU
     ΍
     %BUF5JNF3BOHF
     ʹม׵͢Δ %BUF5JNF&OEQPJOU
     ͔Βऔಘͨ͠
     %BUF5JNF*NNVUBCMF
     Λ
     λΠϜκʔϯΦϑηοτΛ൐ͬͨ
     λΠϜελϯϓจࣈྻͱͯ͠
     %#ʹ౉͢ DateTimeRange DateTimeEndpoint string DateTimeImmutable DateTimeZone
106. 
     ͝ਗ਼ௌ͋Γ͕ͱ͏͍͟͝·ͨ͠ w ݎ࿚ͳίʔυͱ͸ѱ͍ίʔυʹឺ૑ߣΛ͋ͯΔ͜ͱͰ͸ͳ͍
     w ܕએݴͰ૝ఆ͢΂͖ೖྗͷܕΛߜΓɺ๷ޚతνΣοΫΛେ෯ʹݮΒ͢
     w ྻڍܕͰऔΓಘΔ஋ΛߜΓɺ๷ޚతνΣοΫΛେ෯ʹݮΒ͢
     w ੩తղੳπʔϧΛ࢖͍ɺίʔυΛಈ͔ͣ͞ͱ΋ݕূͰ͖ΔΑ͏ʹ͢Δ
     w جૅͱͳΔܕΛϞσϦϯά͠ɺᐆດ͞΍ؒҧ͍΍͢͞Λ࡟ݮ͢Δ
     w جૅͱͳΔܕΛෆมΦϒδΣΫτʹ͠ɺঢ়ଶมԽ΍෭࡞༻ʹىҼ͢ΔόάΛ༧๷͢Δ
     w ΦϒδΣΫτੜ੒࣌ʹෆม৚݅Λ੒ཱͤ͞ɺ͔ͭͦͷΦϒδΣΫτ͕ෆมΦϒδΣΫτͰ͋Δͳ Β͹ɺੜ੒͞ΕͨΦϒδΣΫτ͸ৗʹਖ਼͍͠ʢ׬શੑʣ
     w 4JNQMF
     ͞ʢ֓೦ͱͯ͠ͷཁૉͷগͳ͞ʣͱ
     &BTZ
     ͞ʢख਺ͷগͳ͞ʣΛෆ༻ҙʹࠞͥͳ͍
     w ݕূࡁΈͷ஋Λܕͱͯ͠දݱ͠ɺͦͷޙ͸ܕͷอূʹཔΔ
     w ઃܭͱ͸੹຿ͷ࠷ద഑ஔΛٻΊଓ͚Δ͜ͱɻ୭͕ԿΛ஌͍ͬͯͯԿΛ஌Δ΂͖Ͱͳ͍͔ɺԿΛ΍ Δ΂͖ͰԿΛ΍Δ΂͖Ͱͳ͍͔Λৗʹߟ͑ଓ͚Δ͜ͱ
107. ࢀߟจݙ