在使用 stripe sdk 進行 php 開發時，常常會遇到一個棘手的問題：phpstan 無法正確識別 stripe 對象的屬性類型。stripe sdk 中的許多類和屬性都繼承自 stripestripeobject，而 phpstan 會對此類動態屬性的訪問發出警告。這不僅讓代碼檢查過程變得繁瑣，還可能導致開發人員忽視真正的錯誤。
為了解決這一問題，我嘗試了多種方法，但最終發現 spaze/phpstan-stripe 這個擴展庫能夠完美解決這一難題。spaze/phpstan-stripe 是一個專門為 Stripe SDK 設計的 PHPStan 擴展，它能為 Stripe 對象的許多屬性提供具體的類型聲明，從而讓 PHPStan 能夠正確識別這些屬性。
安裝這個擴展庫非常簡單，只需使用 composer 即可：
composer require --dev spaze/phpstan-stripe
如果你使用了 phpstan/extension-installer，那么安裝后無需額外配置。如果是手動安裝，則需要在 phpstan.neon 文件中添加以下配置：
includes: - vendor/spaze/phpstan-stripe/extension.neon
通過這個擴展庫，PHPStan 能夠識別 Stripe SDK 中許多類和屬性的具體類型，從而避免了不必要的警告。具體來說，spaze/phpstan-stripe 會替換 StripeStripeObject 類型聲明，提供更精確的類型檢查。此外，它還為對象更新時使用的屬性添加了類型信息，這些屬性通常不會在類上使用 @Property 標簽進行文檔化。
立即學習“PHP免費學習筆記（深入）”；
使用 spaze/phpstan-stripe 后，我的開發效率顯著提高，代碼質量也得到了提升。PHPStan 不再因為 Stripe SDK 的動態屬性而發出大量警告，使得我能夠更專注于代碼的邏輯和功能。
總的來說，spaze/phpstan-stripe 通過 Composer 安裝非常方便，能夠有效解決 Stripe SDK 在 PHPStan 中的類型問題，提升開發效率和代碼質量。如果你也在使用 Stripe SDK 進行開發，不妨嘗試一下這個擴展庫。
