北京
用Claude寫PHP的人，大概都見過這種場景：AI生成的代碼能跑，但風格像是穿越來的——沒有類型聲明、用著mysql_*函數、全局變量滿天飛、出錯就die()。這不是AI故意偷懶，是訓練數據的問題。PHP 8.x已經完全是另一門語言了，union types、枚舉、纖程、具名參數、match表達式、只讀屬性……這些新特性在舊代碼庫里根本找不到。
解決辦法很簡單：在倉庫根目錄放一個CLAUDE.md文件，明確告訴AI你在哪個年代寫代碼。以下是13條高影響力規則。
規則1：每個文件強制嚴格類型
每個PHP文件必須在開頭標簽后立即加上declare(strict_types=1);，沒有例外——腳本、控制器、輔助函數、測試文件全部適用。不開嚴格類型，PHP會靜默強制轉換值：期望int的函數接收"42"也不報錯。開了之后，類型錯誤在調用時直接拋TypeError，而不是在下游某個莫名其妙的地方爆雷。AI默認會省略這個聲明，必須明確要求。
規則2：PHP 8.x起步，用現代語法
目標PHP 8.2+，具體用這些：
? 具名參數代替位置猜測
? match表達式代替switch/case+break
? 空安全運算符?->代替嵌套null檢查
? 只讀屬性保證數據不可變
? 枚舉代替類常量表示有限值集合
? 一等可調用語法提升可讀性
AI經常該用match的地方生成switch，該用?->的地方寫一堆isset()，該用枚舉的地方用類常量數組。必須指定PHP版本和預期語法。
規則3：到處加類型提示，拒絕mixed
所有函數參數、返回值、類屬性必須有類型聲明。union types(int|string)好過省略；intersection types用于多接口約束；never返回類型給必拋異常或退出的函數；除了真正的邊界（序列化輸入、外部API負載），不用mixed；void給無意義返回值的方法。PHP 8的類型系統很豐富，function process($data)毫無信息量，function process(array $data): ProcessedResult才鎖定契約和形狀。
規則4：禁用遺留數據庫模式
數據庫訪問只用PDO+預處理語句。mysql_*函數（PHP 7已移除）、mysqli_*過程式API、SQL字符串插值全部禁止——"SELECT * FROM users WHERE id = $id"這種寫法絕不允許。只用?占位符或具名:param占位符，PDO要包裝在倉儲類里，禁止控制器或視圖直接調PDO。SQL注入至今仍是PHP最常見漏洞，不明確禁止，AI就會生成原始插值查詢。
特別聲明：以上內容(如有圖片或視頻亦包括在內)為自媒體平臺“網易號”用戶上傳并發布，本平臺僅提供信息存儲服務。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.
