我們的項目需要一個功能，計算兩個日期之間實際的工作日天數，這需要排除周末以及一些不固定的節假日。起初，我嘗試使用 php 內置的 datetime 函數進行計算，但很快發現處理周末和節假日邏輯過于復雜，代碼變得難以維護且容易出錯。例如，判斷一個日期是星期幾，以及處理各種不同的節假日日期，都需要大量的 if-else 語句，代碼可讀性差，且容易出現邏輯錯誤。
為了解決這個問題，我開始尋找合適的 PHP 庫，最終找到了 johncorrelli/php-daydifference。這個庫提供了簡潔的 API，能夠輕松地排除周末和自定義的節假日。
安裝也非常簡單，只需要使用 composer：
composer require johncorrelli/php-daydifference
使用方法也很直觀：
<?php</p><p>require 'vendor/autoload.php';</p><p><span>立即學習</span>“<a href="https://pan.quark.cn/s/7fc7563c4182" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">PHP免費學習筆記（深入）</a>”；</p><p>use JohnCorrelliDayDifferenceDayDifference;</p><p>$startDate = new DateTime('2024-01-01');<br>$endDate = new DateTime('2024-02-29');<br>$workDays = [1, 2, 3, 4, 5]; // 0 = Sunday, 1 = Monday, etc.<br>$holidays = [</p><pre class="brush:php;toolbar:false">'*-01-01', // 新年 (每年1月1日) '2024-01-05', // 自定義節假日 '2024-02-14', // 情人節
];
$dayDifference = new DayDifference($startDate, $endDate, $workDays, $holidays);
$workDayCount = $dayDifference->difference();
echo “工作日數量: ” . $workDayCount;
?>
這段代碼首先定義了起始日期和結束日期，然后定義了工作日數組（1-5代表周一到周五）和節假日數組。 *-01-01 表示每年1月1日都是節假日，你也可以添加其他固定的節假日日期。 DayDifference 類會自動計算排除周末和節假日后的工作日數量。
使用 johncorrelli/php-daydifference 庫后，我的代碼簡潔明了，可讀性大大提高，并且避免了復雜的日期計算邏輯。 它支持多種排除日期方式，包括星期幾、具體日期和重復日期（例如每年同一天），非常靈活。
總而言之，johncorrelli/php-daydifference 庫極大地簡化了日期計算的復雜性，提高了代碼的可維護性和可讀性，對于需要處理工作日計算的項目來說，是一個非常有用的工具。 它讓我能夠專注于業務邏輯，而不是被復雜的日期計算細節所困擾。
