深度解析 PHP strtotime() 函數：原理、陷阱與最佳實踐

strtotime() 是 PHP 中最強大也最容易誤用的日期時間解析函數。本文從底層實現原理出發，深度剖析其解析機制，重點解釋為什麼 strtotime("-1 month") 在月末會「失效」，並提供避坑指南。

一、常用特殊關鍵字與語法

二、底層實現原理

strtotime() 位於 ext/date/lib/parse_date.re，使用 re2c 詞法分析器 生成解析器。核心流程：

1. 詞法掃描：輸入字符串按規則（如 reltextunit、relnumber）分解為 Token
2. 語義動作：每個 Token 觸發對應 C 代碼填充 timelib_time 結構體
   結構體關鍵字段：y,m,d,h,i,s（日期時間）、relative（相對調整量）、have_relative 標志
3. 計算歸一化：將相對調整量應用到基準時間，產生最終 Unix 時間戳

以 yesterday 為例，對應動作：

// parse_date.re 片段
'yesterday' {
    TIMELIB_INIT;
    TIMELIB_HAVE_RELATIVE();
    s->time->relative.d = -1; // 相對天數 -1
    return TIMELIB_RELATIVE;
}

三、strtotime("-1 month") 失效的根本原因

當解析 -1 month 時：

1. 識別出 relnumber = -1、reltextunit = month
2. 觸發 TIMELIB_MONTH 動作：s->time->relative.m += -1（月份相對值 -1）
3. 關鍵點：僅修改月份字段，不調整日期字段
4. 歸一化階段：2011-03-31 月份 -1 → 2011-02-31
5. 2月無 31 日，PHP 日期邏輯自動順延 → 2011-03-03

這不是 Bug，是設計決策：strtotime 僅做字段級相對運算，不承擔「業務語義上的上個月同一天」邏輯。開發者需自行處理月末邊界。

四、最佳實踐建議

1. 月份運算優先用 mktime() 或 DateTime：
   mktime(0,0,0, date("n")-1, date("j"), date("Y")) 配合 date("t") 判斷天數
2. 相對日期表達式盡量具體：
   優先用 first day of last month、last day of -1 month 等 PHP 5.3+ 支持的明確語法
3. 避免在業務關鍵邏輯直接用 strtotime("-1 month")：
   封裝為 getLastMonthSameDay($time) 統一處理邊界
4. 時區一致性：確保 date_default_timezone_set() 與服務器/數據庫時區一致

五、性能提示

• strtotime() 解析開銷較大（詞法分析+正則匹配），高頻調用（如循環中）建議緩存結果或改用 mktime()
• 靜態日期字符串（如配置文件）可在部署階段預計算為時間戳