PHP: デーツ地獄から脱出するための実践的な方法-PHPチュートリアル-php.cn

PHP: デーツ地獄から脱出するための実践的な方法

DDD

リリース： 2024-11-30 09:14:19

オリジナル

157 人が閲覧しました

企業にとって重要な機能は、サブスクリプション、定期的な支払い、予約などの日付に依存することがよくあります。

PHP プログラマーは、おそらく日付/時刻を操作する必要があるでしょう。

サードパーティのライブラリを使い始めますか?本当に？

技術を習得し、言語がどのように機能するかを理解するには、ネイティブ API を使い続けることが一般的に良い習慣ですが、現実的になってみましょう。

Carbon は、DateTimeInterface、JsonSerializable、およびその他のネイティブ PHP ツールを拡張する強力なライブラリです。

既存の日付オブジェクトと新しい日付オブジェクトの両方を操作するための便利なヘルパーを提供します。

// Tomorrow
CarbonImmutable::now()->add(1, 'day');

// Copy instance from another API
$dateTime = new \DateTime('first day of January 2025');
$carbon = Carbon::instance($dateTime);

// Parsing values
$date = Carbon::parse('2050-01-01 12:34:00', 'UTC');

ログイン後にコピー

基本に戻る

Carbon はネイティブ API を拡張しますが、DateTime オブジェクトは日付と時刻を計算するためのツールをすでに提供しています。

$date = new DateTime('2024-07-23');
$date->add(new DateInterval('P10D'));
echo $date->format('Y-m-d');

$date2 = new DateTime('2024-08-03');
$interval = $date->diff($date2);
echo $interval->format('%R%a days');

ログイン後にコピー

文字列を渡して特定の出力を取得したり、間隔や期間を計算したりできます。

では、なぜカーボンなどの追加レイヤーを使用するのでしょうか?

可読性の向上

$yesterday = Carbon::yesterday();
$today = Carbon::today();
$now = Carbon::now();
$tomorrow = Carbon::tomorrow();
$futureDate = Carbon::today()->addDays(21)->format('Y-m-d');

if ($now->isEndOfDay()) {
    // Some code
}

ログイン後にコピー

このライブラリは、さまざまなエラーが発生しやすい日付比較に便利で堅牢です。

簡単なローカリゼーション

Carbon はロケールを便利に処理します:

$now = Carbon::now()->locale('fr_FR');
echo $now->monthName;

ログイン後にコピー

オーバーフローの処理

デフォルトの PHP DateTime 動作は、月を加算または減算するときに誤解を招く可能性があります。オーバーフローする可能性があります！

そのような動作が必要な場合もありますが、Carbon ではより適切な制御が可能です。

Carbon::useMonthsOverflow(false);
Carbon::resetMonthsOverflow();

ログイン後にコピー

年または月を操作するときに各メソッドでオーバーフローを構成することもできます (例: subMonthsNoOverflow、addMonthsWithOverflow)。

単体テストの日付

日付は変動性があるため、単体テストでは問題になる可能性があります。

Carbon はモック用の高度な機能を提供し、テストの一貫性と信頼性を確保します。

これにより、CI/CD パイプラインを破壊する可能性のあるランダムなエラーが防止されます。

日付/時刻に関するよくある落とし穴を回避する方法

Carbon を使用するかどうかに関係なく、潜在的なバグや不整合を減らす実用的な方法があります。

エラーを黙らせないでください

PHP の最近のバージョンでは、より優れた日付/時刻例外が導入され、予期しない入力をより一貫してキャッチできるようになりました。

ただし、実装により悪質なエラーが抑制される場合があります。

$dateInput = '2dsds';
$timestamp = strtotime($dateInput);
echo date('Y-m-d', $timestamp); // Defaults back to 1970-01-01

ログイン後にコピー

次のコードは、DateTime オブジェクトを使用している場合でも、改善されていません:

$dateInput = '2024-02-30'; // Invalid date (February has 28 days, 29 at most)
$date = new DateTime($dateInput);
echo $date->format('l \t\h\e jS F'); // Outputs "Friday the 1st March"

ログイン後にコピー

したがって、常に日付/時刻を検証します:

$dateInput = '2dsds';
$timestamp = strtotime($dateInput);

if (false === $timestamp) {
    throw new InvalidArgumentException();
}

echo date('Y-m-d', $timestamp);

ログイン後にコピー

そして、入力を徹底的にチェックします:

$format = 'Y-m-d';
$dateInput = '2024-02-30';
$dateInfo = date_parse($dateInput);
if (!checkdate($dateInfo['day'], $dateInfo['month'], $dateInfo['year'])) {
    throw new InvalidArgumentException();
}

$date = DateTimeImmutable::createFromFormat($format, $dateInput);
echo $date->format('l \t\h\e jS F');

ログイン後にコピー