༧๷ʹউΔ๷ޚͳ͠ ʢ೥൛ʣ ࿨ా୎ਓ rev.24 /PW


!
1)1ΧϯϑΝϨϯε෱Ԭ !U@XBEB !UXBEB 📷🙆 🙆 !UXBEB JEUXBEB #phpconfuk ݎ࿚ͳίʔυΛಋ༷͘ʑͳઃܭͷώϯτ #hall_hz 

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 

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
Ϋϥε͕ະఆٛ
ᶃ
ᶄ
ᶅ
్தͰσʔλϕʔε઀ଓΤϥʔ ຊ೔ͷߨԋ͸
͜ΕΒͷ໰୊ʹूத͠·͢ 👉 👉 👉 👉 

ෆ۩߹ͷൃݟ͕
஗ΕΕ͹஗ΕΔ΄Ͳ
ই͸ਂ͘ͳΔ IUUQTXXXBTURCPSHQSFTTSPPN*452#@$FSUJ fi DBUJPO@/FXT@@IUNM 

ݎ࿚ͳίʔυ΁ͷޡղ 

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"'); } ͨͩͻͨ͢ΒೖྗΛ๷ޚతνΣοΫͨ͠Γ # " % 

ෆਖ਼ͳೖྗ͕͋ͬͯ΋ࣗ෼ͰԿͱ͔͠Α͏ͱͨ͠Γ # " % $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); 

υΩϡϝϯτͰؒҧ͍΍͢͞Λิ͓͏ͱͨ͠Γ # " % /** * 指定した範囲の日時およびステータスに合致する Bug を検索し、ヒットした全件を Bug オブジェクトの配列として返す。 * * @param array $params 格納した検索条件の連想配列。キー "startAt" に検索範囲の 始点日時をstringで, キー "endAt" に検索範囲の終点日時をstringで, キー "status" にス テータス文字列をstringで指定すること。キー、値それぞれNULLは不可とする。 * @return Bug[] 検索結果を Bug オブジェクトにマッピングして返す。検索結果が0件 のときは空配列を返す。 */ public function findAll($params) { 

ݎ࿚ͳίʔυͱ͸
ѱ͍ίʔυʹឺ૑ߣΛ
͋ͯͨ΋ͷͰ͸ͳ͍ 

lݡ໌ͳιϑτ΢ΣΞٕज़ऀʹͳΔͨΊͷ ୈҰา͸ɺಈ͘ϓϩάϥϜΛॻ͘͜ͱͱ ਖ਼͍͠ϓϩάϥϜΛద੾ʹ࡞੒͢Δ͜ͱ ͷҧ͍Λೝࣝ͢Δ͜ͱz Š
."+BDLTPO
 

Agenda  ܕએݴ
 ྻڍܕ
 ੩తղੳ
 ܕͷϞσϦϯά
 ෆมੑ
 ׬શੑ
 ੹຿ͷ഑ஔ 👉 

औΓಘΔܕΛݮΒ͢ 

ΤοηΠ+
ݟ஌Β͵ਓͱ΋͏·͘΍Δʹ͸ lʮग़དྷͯ͸ͳΒ͵͜ͱΛې͡ ΔʯͷͰ͸ͳ͘ɺ͸͡Ί͔Β ʮग़དྷ͍͍ͯ͜ͱ͚ͩΛग़དྷΔ Α͏ʹ͢Δʯͱߟ͑ΔͷͰ͢z IUUQTXXXPSFJMMZDPKQCPPLT 

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"'); } ໰୊ͱͳ͍ͬͯΔ͜ͷ࿈૝഑ྻΛ ݱঢ় 

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"'); } ͦΕͧΕܕએݴ͞ΕͨҾ਺ʹ෼ղ͢Δ ܕએݴʹΑͬͯʮग़དྷ͍͍ͯ͜ͱ͚ͩΛग़དྷΔʯΑ͏ʹ 

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"'); } ๷ޚతνΣοΫ͕΄΅ෆཁʹ 

૝ఆ͠ͳ͚Ε͹ͳΒͳ͍ঢ়گ͕ݮͬͨ 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
ܕͷΧϥϜʹ֨ೲ͍ͯ͠Δͱߟ͍͑ͯͩ͘͞ 

Agenda  ܕએݴ
 ྻڍܕ
 ੩తղੳ
 ܕͷϞσϦϯά
 ෆมੑ
 ׬શੑ
 ੹຿ͷ഑ஔ 👉 

औΓಘΔ஋ΛݮΒ͢ 

wݴޠ૊ΈࠐΈͷܕʢJOU
TUSJOH
౳ʣΛ࢖͏ ͱɺऔΓಘΔ஋ͷ૊Έ߹Θ͕ͤ๲େʹͳΔ
w໰୊ྖҬͷ஌ࣝΛ׆༻ͯ͠ݻ༗ͷܕΛ࡞Δ ͜ͱͰɺऔΓಘΔ૊Έ߹ΘͤΛେ෯ʹݮΒ ͤΔ ΤοηΠ
ؔ਺ͷʮαΠζʯΛখ͘͢͞Δ IUUQTXXXPSFJMMZDPKQCPPLT 

ྻڍܕΛ࢖͓͏ 1 ) 1   enum Status: string { case Open = 'OPEN'; case New = 'NEW'; case Fixed = 'FIXED'; } IUUQTXXXQIQOFUNBOVBMKBMBOHVBHFFOVNFSBUJPOTQIQ 

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); } ݱঢ় 

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); } Ҿ਺Λจࣈྻ͔Βྻڍܕʹม͑Δ จࣈྻ͔Βྻڍܕʹม͑Δ 

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); } ૝ఆ͠ͳ͚Ε͹ͳΒͳ͍ঢ়گ͕͞Βʹݮͬͨ 

Agenda  ܕએݴ
 ྻڍܕ
 ੩తղੳ
 ܕͷϞσϦϯά
 ෆมੑ
 ׬શੑ
 ੹຿ͷ഑ஔ 👉 

ίʔυΛಈ͔ͣ͞ʹ
ݕࠪ͢Δ 

wݱࡏɺݴޠ΍ίϯύΠϥɺ੩తղੳπʔϧΛΊ ͙Δঢ়گ͸౰࣌ͱ͸େ͖͘ҟͳ͍ͬͯ·͢ɻϝ ϞϦ΍$16࣌ؒ͸૬ରతʹʮ͍҆ʯ΋ͷʹͳ ΓɺίϯύΠϥࣗ਎͕νΣοΫͰ͖ΔΤϥʔ΋ େ෯ʹ૿͑·ͨ͠ɻ
wίʔυͷ඼࣭޲্ʹ͋ͨͬͯ͸ɺςετ͚ͩʹ པΔͷͰ͸ͳ͘ɺղੳπʔϧ΋ੵۃతʹར༻͢ ΂͖Ͱ͠ΐ͏ɻ ΤοηΠ
ίʔυ෼ੳπʔϧΛར༻͢Δ IUUQTXXXPSFJMMZDPKQCPPLT 

ݱঢ়ͷίʔυʹ
1)14UBO
Λ͔͚ͯΈΔ IUUQTQIQTUBOPSH 

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 ੩తղੳΛߦΘͳ͍ͱؾ͖ͮʹ͍͘ 

1%0QSFQBSF
ͷ໭Γ஋ IUUQTXXXQIQOFUNBOVBMKBQEPQSFQBSFQIQ ܕఆ্ٛ͸ԼҐޓ׵ੑͷͨΊ
GBMTF
ͷՄೳੑ΋දݱ͞Ε͍ͯΔ͕
1)1

Ҏ߱͸
1%0&33.0%&@&9$&15*0/
͕σϑΥϧτͳͷͰ

GBMTF
͕ฦͬͯ͘Δ͜ͱ͸ݱ࣮తʹ͸ߟ͑ʹ͍͘ 

1)1
ͷ
BTTFSU
ͰܕΛڱΊΔ IUUQTQIQTUBOPSHXSJUJOHQIQDPEFOBSSPXJOHUZQFT 

1)1
ͷ
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 

1)1
ͷ
BTTFSU IUUQQIQOFUNBOVBMKBGVODUJPOBTTFSUQIQ 

Agenda  ܕએݴ
 ྻڍܕ
 ੩తղੳ
 ܕͷϞσϦϯά
 ෆมੑ
 ׬શੑ
 ੹຿ͷ഑ஔ 👉 

ܕͷϞσϦϯάͰ
ޡΓ΍͢͞ΛݮΒ͢ 

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); } ར༻ଆͷίʔυ Ҿ਺͕ͭ͋ΔͷͰ
ͦΕͧΕͷ໾ׂ͕Θ͔Γʹ͍͘ 

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  

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
ؚ͕·ΕΔ͔Ͳ͏͔Λ໊લͰࣔͯ͠΋ͬ͘͠Γ͜ͳ͍ Ҿ਺ͷ໊લͰࣔͯ͠΋ྑ͍͕ɺ
͜ͷઃܭ͸ৗʹద੾ͩΖ͏͔ʁ
TUBSU"U
ͷํ͸Ͳ͏ͳΔͩΖ͏͔ʁ 

wྑ͍ΠϯλϑΣʔεͱ͸࣍ͷͭͷ৚݅Λຬͨ ͢ΠϯλϑΣʔε
wਖ਼͘͠࢖༻͢Δํ͕ૢ࡞ϛεΛ͢ΔΑΓ؆୯
wޡͬͨ࢖͍ํΛ͢Δ͜ͱ͕ࠔ೉ ΤοηΠ
ਖ਼͍͠࢖͍ํΛ؆୯ʹɺޡͬͨ࢖͍ํΛࠔ೉ʹ IUUQTXXXPSFJMMZDPKQCPPLT ΋ͬͱޡΓ΍͢͞ΛݮΒ͢ઃܭΛ͍ͨ͠ 

ର৅ͷྖҬʢυϝΠϯʣ
ʹֶ͍ͭͯͼɺ
ܕͷϞσϦϯάʹΑͬͯ
ޡΓ΍͢͞ΛݮΒ͢ 

ൣғʢ۠ؒʣʹֶ͍ͭͯͿ
୺఺ IUUQTKBXJLJQFEJBPSHXJLJ&$#"&@&#&"%" 

ൣғʢ۠ؒʣʹֶ͍ͭͯͿ
ด۠ؒɺ։۠ؒ IUUQTXFLBOB[BXBJUBDKQNBUIDBUFHPSZPUIFSTZVVHPVIFOLBOUFYDHJ UBSHFUNBUIDBUFHPSZPUIFSTZVVHPVLVLBOOIUNM 

ൣғʢ۠ؒʣʹֶ͍ͭͯͿ
൒։۠ؒ IUUQTXFLBOB[BXBJUBDKQNBUIDBUFHPSZPUIFSTZVVHPVIFOLBOUFYDHJ UBSHFUNBUIDBUFHPSZPUIFSTZVVHPVLVLBOOIUNM 

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
ͰϓϩύςΟมߋΛېࢭ͢Δ 

͜ΕͰؒҧ͍ʹ͘͘ͳ͕ͬͨɺࠓ౓͸࢖͏ͷ͕΍΍໘౗ʜʜ 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); } 

wྑ͍ΠϯλϑΣʔεͱ͸࣍ͷͭͷ৚݅Λຬͨ ͢ΠϯλϑΣʔε
wਖ਼͘͠࢖༻͢Δํ͕ૢ࡞ϛεΛ͢ΔΑΓ؆୯
wޡͬͨ࢖͍ํΛ͢Δ͜ͱ͕ࠔ೉ ΤοηΠ
ਖ਼͍͠࢖͍ํΛ؆୯ʹɺޡͬͨ࢖͍ํΛࠔ೉ʹ IUUQTXXXPSFJMMZDPKQCPPLT ݱঢ়Ͱ͸ਖ਼͘͠࢖͏ͷ͕΍΍໘౗ 

खݎ͞ͱॻ͖΍͢͞ͷཱ྆ΛࢼΈΑ͏ 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 ); } } ෼͔Γ΍໊͍͢લͷϑΝΫτϦʔϝιουΛఆٛ ෼͔Γ΍໊͍͢લͷϑΝΫτϦʔϝιουΛఆٛ ʢ ෬ ઢ ʣ 

͜ΕͰར༻ଆΛ୹͘ॻ͚ΔΑ͏ʹͳͬͨ 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); } ୹͘ॻ͚ΔΑ͏ʹͳͬͨ ʢ ෬ ઢ ʣ 

Agenda  ܕએݴ
 ྻڍܕ
 ੩తղੳ
 ܕͷϞσϦϯά
 ෆมੑ
 ׬શੑ
 ੹຿ͷ഑ஔ 👉 

ෆมੑ JNNVUBCJMJUZ 
ঢ়ଶมԽΛഉআͯ͠
ޡΓ΍͢͞ΛݮΒ͢ 

ผ໊ࢀর໰୊
"MJBTJOH 

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
ΦϒδΣΫτΛ࢖ͬͯΈΔ # " % αϒεΫϦϓγϣϯܖ໿Λ೥ߋ৽͢Δϝιου 

$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 ผ໊ࢀর໰୊ʢ"MJBTJOHʣ ͳ͔ͥΦϥΠϦʔֶशϓϥοτϑΥʔϜͷ
ܖ໿ظؒ΋ߋ৽͞Εͯ͠·͍ͬͯΔ  1IQ4UPSN
ͷαϒεΫϦϓγϣϯܖ໿Λ೥ߋ৽͢Δ 

fi OBM
SFBEPOMZ
એݴ͚ͩͰ͸
μϝͩͬͨͷ͸ͳ͔ͥ 

Կ͕ݪҼͩͬͨͷ͔ # " % ͕͜͜໰୊
࠶୅ೖ͠ͳ͘ͱ΋ഁյతมߋ͕Ͱ͖ͯ͠·͏ 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); } } 

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, ) {} (後略) 

ෆมΦϒδΣΫτΛͭ͘Δ 

%BUF5JNF
ͱ
%BUF5JNF*NNVUBCMF IUUQTXXXQIQOFUNBOVBMKBDMBTTEBUFUJNFQIQ 

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 # " % 

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Λ࢖͍ͬͯ͘ %BUF5JNF*NNVUBCMFΛ࢖͍ͬͯ͘ 

namespace PhpconFuk; use Attribute; #[Attribute(Attribute::TARGET_CLASS | Attribute::IS_REPEATABLE)] class Immutable {} Ԡ༻
ಠࣗͷ
"UUSJCVUF
Λఆٛͯ͠ҙຯ͚ͮΛ͠Α͏ IUUQTXXXBNB[PODPKQEQ *NNVUBCMF
Ͱ͋Δ͜ͱΛࣔ͢
ΞτϦϏϡʔτΛಠࣗఆٛ͢Δ 

Ԡ༻
ಠࣗͷ
"UUSJCVUF
Λఆٛͯ͠ҙຯ͚ͮΛ͠Α͏ IUUQTXXXBNB[PODPKQEQ 

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
ΞτϦϏϡʔτΛ࢖͏ 

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   

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
ͩͬͨ # " % 

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   ্୺఺ɺԼ୺఺͸ઌ΄Ͳఆٛͨ͠
XJUI7BMVF
ϝιουͰ
ෆมΫϩʔϯΛ࡞੒ 

ෆมΦϒδΣΫτͰͷ
໰୊ղܾ 

$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(); // 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 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
ΞτϦϏϡʔτʹΑͬͯܯࠂ͕ग़Δ 

$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 ෆมΦϒδΣΫτʹΑͬͯผ໊ࢀর໰୊Λղܾ 👍 ৽ͨͳαϒεΫϦϓγϣϯظؒΛ൐͏৽ͨͳΦϒδΣΫτΛฦ͢ ݩͷΦϒδΣΫτͨͪ͸ෆมͷ·· ৽ͨͳαϒεΫϦϓγϣϯظؒΛ൐͏৽ͨͳΦϒδΣΫτΛฦ͢ 

Agenda  ܕએݴ
 ྻڍܕ
 ੩తղੳ
 ܕͷϞσϦϯά
 ෆมੑ
 ׬શੑ
 ੹຿ͷ഑ஔ 👉 

׬શੑ JOUFHSJUZ 
ଘࡏ͢ΔͳΒ͹ৗʹਖ਼͍͠
ʢෆม৚͕݅ৗʹ੒Γཱͭʣ
ঢ়ଶͱͳΔઃܭΛߦ͍
ޡΓ΍͢͞ΛݮΒ͢ 

ݕࡧ։࢝೔࣌ͱ
ݕࡧऴྃ೔࣌ͷ
੔߹ੑΛ୲อ͢Δͷ͸ ୭ͷ੹೚ 

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
ͷೖΓޱͰߦ͏ͷ͸ے͕ѱ͍ 

ଘࡏ͢ΔͳΒ͹طʹਖ਼͍͠ઃܭΛ࡞Δώϯτ 
.BLF
JMMFHBM
TUBUFT
VOSFQSFTFOUBCMF

%F fi OF
FSSPST
PVU
PG
FYJTUFODF

'BJM
GBTU ͭͷҟͳΔߟ͑ํ͕͋Δ
ʢ˞Ұൠతʹɺ
%F fi OF
FSSPST
PVU
PG
FYJTUFODF
ͱ
'BJM
GBTU
͸ཱ྆Ͱ͖ͳ͍ঢ়گ͕ଟ͍ʣ 

.BLF
JMMFHBM
TUBUFT
VOSFQSFTFOUBCMF
ෆਖ਼ͳঢ়ଶ͸
දݱͰ͖ͳ͍Α͏ʹ͢Δ 

.BLF
JMMFHBM
TUBUFT
VOSFQSFTFOUBCMF ͜Ε͸ɺʮෆਖ਼ͳঢ়ଶ͸දݱͰ͖ͳ͍Α͏ʹ͢Δʯͱ͍͏ॏཁͳઃܭΨΠυ ϥΠϯͷҰྫͰ͢ɻࢲͨͪ͸ϏδωεϧʔϧΛܕγεςϜͰදݱ͠Α͏ͱ͠ ͍ͯ·͢ɻ͜Ε͕ద੾ʹߦΘΕ͍ͯΕ͹ɺෆਖ਼ͳঢ়ଶ͕ίʔυʹଘࡏ͢Δ͜ ͱ͸ͳ͘ɺͦͷͨΊͷϢχοτςετΛॻ͘ඞཁ͸͋Γ·ͤΜɻͦͷ୅ΘΓ ʹͳΔͷ͕ɺʮίϯύΠϧ࣌ʯͱ͍͏ϢχοτςετͳͷͰ͢ɻ IUUQTXXXBNB[PODPKQEQ#%%#1/#7+ 

.BLF
JMMFHBM
TUBUFT
VOSFQSFTFOUBCMF w ܕͷઃܭʹΑͬͯɺෆਖ਼ͳঢ়ଶͰ͸ͦ΋ͦ΋ίϯύΠϧʢ1)1
ͷ৔߹͸ ੩తղੳʣ͕௨Βͳ͍Α͏ʹ͍ͨ͠
w ࠓճͷ৔߹͸Ҿ਺
TUBSU"U
ΑΓҾ਺
FOE"U
ͷํ͕େ͖͍ʢະདྷ೔ʣ ͜ͱΛܕͰදݱ͍͕ͨ͠ʜʜ
w 3F fi OFNFOU
5ZQFT
΍
%FQFOEFOU
5ZQFT
ͷΑ͏ͳܕͷදݱྗ͕ඞཁ ͳͷͰɺকདྷͷ
1)1
ʹظ଴
w ʢࠓճͷαϯϓϧʹ͸͏·͘߹க͠·ͤΜͰͨ͠ʣ 

%F fi OF
FSSPST
PVU
PG
FYJTUFODF
ΤϥʔΛఆٛͰফ͠ڈΔ 

ྫ֎ॲཧͷෳࡶ͞Λഉআ͢Δ࠷ྑͷํ๏͸ɺॲཧ͢΂͖ྫ֎͕ଘࡏ͠ͳ͍Α ͏ʹ"1*Λఆٛ͢Δ͜ͱͰ͢ɻ
ͭ·ΓɺΤϥʔΛఆٛͰফ͠ڈΔͷͰ͢ɻ͜Ε͸๯ಚతʹฉ͑͜Δ͔΋͠Ε ·ͤΜ͕ɺ࣮ફʹ͓͍ͯ͸ඇৗʹޮՌతͰ͢ɻ %F fi OF
FSSPST
PVU
PG
FYJTUFODF IUUQTXXXBNB[PODPKQEQ9 

খ͍͞ํͷ஋ΛԼ୺఺ɺେ͖͍ํͷ஋Λ্୺఺ʹ͢Ε͹͔֬ʹΤϥʔ৚݅͸ͳ͘ͳΔ 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); } } Ҿ਺ͷେখؔ܎Λ൑ఆ͠ɺ
খ͍͞ํΛԼ୺఺ʹ͢Δ
ϑΝΫτϦʔϝιουΛఆٛ ෆ੔߹ͳঢ়ଶΛ࡞Βͳ͍ͨΊ
ίϯετϥΫλͷՄࢹੑΛ
QSJWBUF
ʹͯ͠
௚઀ݺ΂ͳ͍Α͏ʹ͢Δ ˞͜ͷΑ͏ͳઃܭ͸ࢍ൱྆࿦ ͋Δͱࢥ͍·͢ɻٞ࿦ͷ͖ͬ ͔͚ʹ͍ͯͩ͘͠͞ 

%F fi OF
FSSPST
PVU
PG
FYJTUFODF ΤϥʔΛଟ༻͢ΔΞϓϩʔν͸͍͔ͭ͘ͷόάΛัଊͰ͖Δ͔΋͠Ε·ͤΜ ͕ɺಉ࣌ʹෳࡶ͞΋૿େͤ͞ɺͦΕ͕ଞͷόάΛੜΈग़݁͢ՌͱͳΓ·͢ɻ
ΤϥʔΛଟ༻͢ΔΞϓϩʔνͰ͸ɺ։ൃऀ͸ΤϥʔΛճආ·ͨ͸ແࢹ͢Δͨ Ίͷ௥ՃίʔυΛॻ͔ͳ͚Ε͹ͳΒͣɺ͜Ε͕όάͷՄೳੑΛߴΊ·͢ɻ͋ Δ͍͸ɺ௥ՃίʔυΛॻ͘͜ͱΛ๨Εͯ͠·͍ɺͦͷ৔߹͸࣮ߦ࣌ʹ༧ظ͠ ͳ͍Τϥʔ͕౤͛ΒΕΔՄೳੑ͕͋Γ·͢ɻ IUUQTXXXBNB[PODPKQEQ9 

%F fi OF
FSSPST
PVU
PG
FYJTUFODF ରরతʹɺΤϥʔΛఆٛͰফ͠ڈΔΞϓϩʔν͸"1*Λ؆ܿʹ͠ɺॻ͔ͳ͚ Ε͹ͳΒͳ͍ίʔυͷྔΛݮΒ͠·͢ɻ
શମͱͯ͠ɺόάΛݮΒ͢࠷ྑͷํ๏͸ιϑτ΢ΣΞΛΑΓγϯϓϧʹ͢Δ ͜ͱͰ͢ɻ IUUQTXXXBNB[PODPKQEQ9 

'BJM
GBTU
ෆਖ਼ͳঢ়ଶͳΒ͹
଎΍͔ʹࣦഊͤ͞Δ 

ୡਓϓϩάϥϚʔ
5JQ

ૣΊʹΫϥογϡͤ͞Δ͜ͱ ʮ͋Γಘͳ͍ʯͱࢥΘΕΔࣄ৅͕ίʔυͷ࣮ߦதʹൃੜͨ͠৔߹ɺͦͷ࣌ ఺ͰϓϩάϥϜ͸΋͸΍࣮ߦՄೳͳ΋ͷͱ͸ͳ͍ͬͯͳ͍ͷͰ͢ɻͦͷ࣌ ఺Ҏ߱ʹॲཧ͞Εͨ಺༰͸ٙΘ͍͠΋ͷͰ͋ΔͨΊɺ଎΍͔ʹఀࢭͤͯ͞ ͍ͩ͘͞ɻ
௨ৗͷ৔߹ɺఀࢭͨ͠ϓϩάϥϜͷ΄͏͕ɺো֐ʹΑͬͯத్൒୺ʹಈ࡞ ͍ͯ͠ΔϓϩάϥϜΑΓ΋μϝʔδ͸গͳ͍͸ͣͰ͢ IUUQTXXXPINTIBDPKQCPPL 

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
ৗʹ੒Γཱͭ΂͖ෆม৚݅ ΛࣜͰॻ͘ ࣄલ৚݅Λ͖ͪΜͱ఻͑Δ͜ͱ ࣄલ৚݅ʢར༻ଆͷ੹೚ʣͰ͋Δ৔߹ɺද໌Λ࢖͏͔ɺར༻ଆͷ੹೚Ͱ͋Δ͜ͱΛࣔ͢ܕͷྫ֎Λ࢖͏ 

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( '上端点は下端点以上である必要があります'); } } ར༻ଆͷޡΓͰ͋Δࢫͷྫ֎Λൃੜͤ͞Δ ࣄલ৚݅Λ͖ͪΜͱ఻͑Δ͜ͱ ࣄલ৚݅ʢར༻ଆͷ੹೚ʣͰ͋Δ৔߹ɺද໌Λ࢖͏͔ɺར༻ଆͷ੹೚Ͱ͋Δ͜ͱΛࣔ͢ܕͷྫ֎Λ࢖͏ 

্୺఺ͱԼ୺఺͕౳͍͠ͱ͖͸ʁ IUUQTKBXJLJQFEJBPSHXJLJ&$#"&@&#&"%" େࣄͳΤοδέʔεͳͷͰ͕͢ɺࠓճͷߨԋͰ͸࣌ؒͷؔ܎ͰׂѪ͠·͢ 

Agenda  ܕએݴ
 ྻڍܕ
 ੩తղੳ
 ܕͷϞσϦϯά
 ෆมੑ
 ׬શੑ
 ੹຿ͷ഑ஔ 👉 

ద੾ͳ৔ॴͰ
ద੾ͳ࢓ࣄΛߦ͏ 

w จࣈྻ͔Β
%BUF5JNF*NNVUBCMF
ʹม׵͢Δͷ͸୭ͷ੹೚
Ͳ͜Ͱ΍Δ
w %BUF5JNF*NNVUBCMF
͔Βจࣈྻʹม׵͢Δͷ͸୭ͷ੹೚
Ͳ͜Ͱ΍Δ
w ʢ͍··Ͱݟͯݟ͵ৼΓΛ͍ͯͨ͠ʣλΠϜκʔϯΛѻ͏ͷ͸୭ͷ੹೚
Ͳ͜Ͱ΍Δ ੹຿ʹؔ͢Δઃܭͷٙ໰఺Λ·ͱΊ͍ͯ͜͏ 

จࣈྻ͔Β
%BUF5JNF*NNVUBCMF
΁ͷม׵Λ
ෆద੾ͳ৔ॴͰߦ͍ͬͯΔ͜ͱʹؾ͍ͮͯ͠·ͬͨ 

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
΁ͷม׵ʹ͸
๲େͳ૊Έ߹Θ͕ͤ͋Δ͠ɺ
λΠϜκʔϯͷѻ͍΋ෆे෼ʹͳͬͯ͠·͍ͬͯΔɻ
จࣈྻҾ਺ʹλΠϜκʔϯͷΦϑηοτදهΛؚΊ ͳ͍ͱσϑΥϧτͷλΠϜκʔϯʹͳͬͯ͠·͏
ͭ·Γ͜͜Ͱߦ͏ͷ͸ෆద੾ɻ 

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ʣدΓʹόΠΞε͕͔͔ͬͯ͠·ͬͨɻ
ςετίʔυͷେ෦෼Ͱ͸ಛʹλΠϜκʔϯΛҙࣝͤͣ୹͘ॻ͍͍͖͍͕ͯͨɺ
ྫ͑͹
8FC
ͷίϯτϩʔϥͰ͸λΠϜκʔϯΛҙࣝͯ͠ݫີʹѻ͍͍ͨɻ
ςετίʔυ΋ͻͱͭͷίϯςΫετɻ
ςετ͔ΒઃܭΛۦಈ͢Δͱ͖ʹ͜ͷόΠΞεʹ஫ҙ͢Δඞཁ͕͋Δɻ # " % 

wྑ͍ΠϯλϑΣʔεͱ͸࣍ͷͭͷ৚݅Λຬͨ ͢ΠϯλϑΣʔε
wਖ਼͘͠࢖༻͢Δํ͕ૢ࡞ϛεΛ͢ΔΑΓ؆୯
wޡͬͨ࢖͍ํΛ͢Δ͜ͱ͕ࠔ೉ ΤοηΠ
ਖ਼͍͠࢖͍ํΛ؆୯ʹɺޡͬͨ࢖͍ํΛࠔ೉ʹ IUUQTXXXPSFJMMZDPKQCPPLT ༰қ͞ΛٻΊͨ݁Ռɺ
ޡͬͨ࢖͍ํΛ͢Δͷ΋༰қʹͳͬͯ͠·ͬͨ ༰қ͞ΛٻΊͨ݁Ռɺ
ޡͬͨ࢖͍ํΛ͢Δͷ΋༰қʹͳͬͯ͠·ͬͨ 

4JNQMF
ͱ
&BTZ
͸ࠞͥΔͳةݥ IUUQTUXJUUFSDPNU@XBEBTUBUVT
IUUQTUXJUUFSDPNU@XBEBTUBUVT 

4JNQMF
ͱ
&BTZ
Λ ࠞͥͳ͍
&BTZ
͞͸
ঢ়گʹΑΓҟͳΔ 

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 # " % 

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 

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 

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
Λ߹ྲྀͤ͞Δɻ
͜͏ॻ͚Ε͹े෼ͩͬͨɻ 

1BSTF
EPOU

KVTU

WBMJEBUF IUUQTMFYJMBNCEBHJUIVCJPCMPHQBSTFEPOUWBMJEBUF 

1BSTF
EPOU

KVTU

WBMJEBUF
ͷઆ໌ͷͨΊʹ
ΈΜͳେ޷͖ʰ$MFBO
"SDIJUFDUVSFʱͷ
ಉ৺ԁΛྫʹઆ໌͢Δ 

੺ͱ੨ͷք໘ɺ૚ͷք໘͕͋Δ
੨͸֎քͱͷγϦΞϥΠθʔγϣϯڥք 

1BSTF
ݕূࡁΈͷ஋Λܕͱͯ͠දݱ͠ɺ
ͦͷޙ͸ܕͷอূʹཔΔ 7BMJEBUF
֎ք͔Βͷ༷ʑͳೖྗΛɺ
ίϯςΫετʹԠͯ͡ద੾ʹݕূ͢Δ 

DateTimeZone DateTimeImmutable string 8FC
͔ΒདྷͨจࣈྻΛόϦσʔγϣϯͭͭ͠ɺ ʢΞϓϦέʔγϣϯͰద੾ʹอ࣋ͨ͠ʣλΠϜ κʔϯΛ൐ͬͯ
%BUF5JNF*NNVUBCMF
ʹม׵͠ɺ ͦΕΛ͞Βʹ
%BUF5JNF&OEQPJOU
΍
%BUF5JNF3BOHF
ʹม׵͢Δ %BUF5JNF&OEQPJOU
͔Βऔಘͨ͠
%BUF5JNF*NNVUBCMF
Λ
λΠϜκʔϯΦϑηοτΛ൐ͬͨ
λΠϜελϯϓจࣈྻͱͯ͠
%#ʹ౉͢ DateTimeRange DateTimeEndpoint string DateTimeImmutable DateTimeZone 

͝ਗ਼ௌ͋Γ͕ͱ͏͍͟͝·ͨ͠ w ݎ࿚ͳίʔυͱ͸ѱ͍ίʔυʹឺ૑ߣΛ͋ͯΔ͜ͱͰ͸ͳ͍
w ܕએݴͰ૝ఆ͢΂͖ೖྗͷܕΛߜΓɺ๷ޚతνΣοΫΛେ෯ʹݮΒ͢
w ྻڍܕͰऔΓಘΔ஋ΛߜΓɺ๷ޚతνΣοΫΛେ෯ʹݮΒ͢
w ੩తղੳπʔϧΛ࢖͍ɺίʔυΛಈ͔ͣ͞ͱ΋ݕূͰ͖ΔΑ͏ʹ͢Δ
w جૅͱͳΔܕΛϞσϦϯά͠ɺᐆດ͞΍ؒҧ͍΍͢͞Λ࡟ݮ͢Δ
w جૅͱͳΔܕΛෆมΦϒδΣΫτʹ͠ɺঢ়ଶมԽ΍෭࡞༻ʹىҼ͢ΔόάΛ༧๷͢Δ
w ΦϒδΣΫτੜ੒࣌ʹෆม৚݅Λ੒ཱͤ͞ɺ͔ͭͦͷΦϒδΣΫτ͕ෆมΦϒδΣΫτͰ͋Δͳ Β͹ɺੜ੒͞ΕͨΦϒδΣΫτ͸ৗʹਖ਼͍͠ʢ׬શੑʣ
w 4JNQMF
͞ʢ֓೦ͱͯ͠ͷཁૉͷগͳ͞ʣͱ
&BTZ
͞ʢख਺ͷগͳ͞ʣΛෆ༻ҙʹࠞͥͳ͍
w ݕূࡁΈͷ஋Λܕͱͯ͠දݱ͠ɺͦͷޙ͸ܕͷอূʹཔΔ
w ઃܭͱ͸੹຿ͷ࠷ద഑ஔΛٻΊଓ͚Δ͜ͱɻ୭͕ԿΛ஌͍ͬͯͯԿΛ஌Δ΂͖Ͱͳ͍͔ɺԿΛ΍ Δ΂͖ͰԿΛ΍Δ΂͖Ͱͳ͍͔Λৗʹߟ͑ଓ͚Δ͜ͱ 

ࢀߟจݙ