Share
Embed
予防に勝る防御なし(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. 責務の配置
Takuto WADA PRO
November 08, 2025
Transcript
107 slides
-
༧ʹউΔޚͳ͠ ʢ൛ʣ ాਓ 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Ϋϥε͕ະఆٛ ᶃᶄᶅ్தͰσʔλϕʔεଓΤϥʔ ຊͷߨԋ ͜ΕΒͷʹूத͠·͢ 👉 👉 👉 👉 -
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) { -
Agenda ܕએݴ ྻڍܕ ੩తղੳ ܕͷϞσϦϯά
ෆมੑ શੑ ͷஔ 👉 -
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-ͷUJNFTUBNQXJUIUJNF[POFܕͷΧϥϜʹ֨ೲ͍ͯ͠Δͱߟ͍͑ͯͩ͘͞ -
Agenda ܕએݴ ྻڍܕ ੩తղੳ ܕͷϞσϦϯά
ෆมੑ શੑ ͷஔ 👉 -
ྻڍܕΛ͓͏ 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 ܕએݴ ྻڍܕ ੩తղੳ ܕͷϞσϦϯά
ෆมੑ શੑ ͷஔ 👉 -
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); } $BOOPUDBMMNFUIPEFYFDVUF PO1%04UBUFNFOUcGBMTF $BOOPUDBMMNFUIPECJOE7BMVF PO1%04UBUFNFOUcGBMTF $BOOPUDBMMNFUIPEGFUDI"MM PO1%04UBUFNFOUcGBMTF ੩తղੳΛߦΘͳ͍ͱؾ͖ͮʹ͍͘ -
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 -
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ͷํͲ͏ͳΔͩΖ͏͔ʁ -
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 OBMSFBEPOMZDMBTTͱ $POTUSVDUPS1SPQFSUZ1SPNPUJPO ͷΈ߹Θͤ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); } -
खݎ͞ͱॻ͖͢͞ͷཱ྆ΛࢼΈΑ͏ 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 ܕએݴ ྻڍܕ ੩తղੳ ܕͷϞσϦϯά
ෆมੑ શੑ ͷஔ 👉 -
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ͷαϒεΫϦϓγϣϯܖΛߋ৽͢Δ -
Կ͕ݪҼͩͬͨͷ͔ # " % ͕͜͜ ࠶ೖ͠ͳ͘ͱഁյతมߋ͕Ͱ͖ͯ͠·͏ 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 OBMSFBEPOMZͰ͋ͬͯঢ়ଶΛมߋͰ͖ͯ͠·͏ # " % 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, ) {} (後略) -
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Ͱ͋Δ͜ͱΛࣔ͢ ΞτϦϏϡʔτΛಠࣗఆٛ͢Δ -
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 ܕએݴ ྻڍܕ ੩తղੳ ܕͷϞσϦϯά
ෆมੑ શੑ ͷஔ 👉 -
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ͷೖΓޱͰߦ͏ͷے͕ѱ͍ -
.BLFJMMFHBMTUBUFTVOSFQSFTFOUBCMF w ܕͷઃܭʹΑͬͯɺෆਖ਼ͳঢ়ଶͰͦͦίϯύΠϧʢ1)1ͷ߹ ੩తղੳʣ͕௨Βͳ͍Α͏ʹ͍ͨ͠ w ࠓճͷ߹ҾTUBSU"UΑΓҾFOE"Uͷํ͕େ͖͍ʢະདྷʣ ͜ͱΛܕͰදݱ͍͕ͨ͠ʜʜ w 3F fi
OFNFOU5ZQFT%FQFOEFOU5ZQFTͷΑ͏ͳܕͷදݱྗ͕ඞཁ ͳͷͰɺকདྷͷ1)1ʹظ w ʢࠓճͷαϯϓϧʹ͏·͘߹க͠·ͤΜͰͨ͠ʣ -
খ͍͞ํͷΛԼɺେ͖͍ํͷΛ্ʹ͢Ε͔֬ʹΤϥʔ݅ͳ͘ͳΔ 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ʹͯ͠ ݺͳ͍Α͏ʹ͢Δ ˞͜ͷΑ͏ͳઃܭࢍ൱྆ ͋Δͱࢥ͍·͢ɻٞͷ͖ͬ ͔͚ʹ͍ͯͩ͘͠͞ -
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( '上端点は下端点以上である必要があります'); } } ར༻ଆͷޡΓͰ͋Δࢫͷྫ֎Λൃੜͤ͞Δ ࣄલ݅Λ͖ͪΜͱ͑Δ͜ͱ ࣄલ݅ʢར༻ଆͷʣͰ͋Δ߹ɺද໌Λ͏͔ɺར༻ଆͷͰ͋Δ͜ͱΛࣔ͢ܕͷྫ֎Λ͏ -
Agenda ܕએݴ ྻڍܕ ੩తղੳ ܕͷϞσϦϯά
ෆมੑ શੑ ͷஔ 👉 -
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ͷίϯτϩʔϥͰλΠϜκʔϯΛҙࣝͯ͠ݫີʹѻ͍͍ͨɻ ςετίʔυͻͱͭͷίϯςΫετɻ ςετ͔ΒઃܭΛۦಈ͢Δͱ͖ʹ͜ͷόΠΞεʹҙ͢Δඞཁ͕͋Δɻ # " % -
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Λ߹ྲྀͤ͞Δɻ ͜͏ॻ͚Εेͩͬͨɻ -
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 ઃܭͱͷ࠷దஔΛٻΊଓ͚Δ͜ͱɻ୭͕ԿΛ͍ͬͯͯԿΛΔ͖Ͱͳ͍͔ɺԿΛ Δ͖ͰԿΛΔ͖Ͱͳ͍͔Λৗʹߟ͑ଓ͚Δ͜ͱ