PHP Fatal error: Cannot redeclare function/class ...」というエラーに遭遇し、困惑していませんか？ご安心ください。このエラーはPHP開発では非常によくあるもので、解決策も明確です。この記事では、このエラーの原因から、WindowsユーザーがPowerShellやCmdを使って今すぐ解決できる具体的な手順、そして再発防止策までを詳しく解説します。
目次
1. PHP Fatal error: Cannot redeclare とは？（概要と緊急度）
PHP Fatal error: Cannot redeclare ...は、その名の通り、「関数 (function)」または「クラス (class)」がPHPスクリプト内で複数回定義されている場合に発生する致命的なエラーです。PHPは同じ名前の関数やクラスが2つ以上存在することを許しません。このエラーが発生すると、それ以降のスクリプトの実行は完全に停止してしまいます。
緊急度：高。このエラーはPHPの実行を中断させるため、ウェブサイトやアプリケーションが機能しなくなります。迅速な対処が必要です。
2. 【最速】今すぐ試すべき解決策
このエラーの最も一般的な原因は、同じファイルが複数回読み込まれているか、または複数のファイルに同じ名前の関数/クラスが誤って定義されていることです。以下の手順で問題の箇所を特定し、修正しましょう。
解決策1：ファイルインクルード方法の見直し（最も一般的な原因と対策）
PHPで外部ファイルを読み込む際には、requireやincludeを使用しますが、これらの代わりにrequire_onceやinclude_onceを使用することで、同じファイルが二度読み込まれることを防ぎ、結果として関数やクラスの再定義エラーを回避できます。
手順：
- エラーメッセージに記載されているファイル名と、再定義されている関数またはクラスの名前を確認します。
- その関数またはクラスが定義されている可能性のあるファイルを特定します。
- そのファイルが他のPHPファイルからどのように読み込まれているかを確認します。
- もし
requireまたはincludeが使用されている場合、それらをrequire_onceまたはinclude_onceに置き換えます。
Windowsでのファイル検索と内容確認のヒント：
問題の関数名やクラス名がわかっている場合、PowerShellを使ってプロジェクト全体から該当する定義を探すことができます。
# 例: 「MyFunction」という関数が再定義されている場合
# 現在のディレクトリ以下で「function MyFunction」という文字列を含むPHPファイルを検索します。
Get-ChildItem -Path . -Recurse -Filter "*.php" | Select-String -Pattern "function MyFunction"
# 例: 「MyClass」というクラスが再定義されている場合
# 現在のディレクトリ以下で「class MyClass」という文字列を含むPHPファイルを検索します。
Get-ChildItem -Path . -Recurse -Filter "*.php" | Select-String -Pattern "class MyClass"
# 結果として表示されるファイルパスを基に、エディタでファイルを開き、
# そのファイルがどのようにインクルードされているか（または二重に定義されていないか）を確認してください。
# 必要に応じて、`require` や `include` を `require_once` や `include_once` に変更します。
この作業により、同じファイルが複数回読み込まれることによる再定義エラーは解消されるはずです。
3. PHP Fatal error: Cannot redeclare が発生する主要な原因（複数）
「Cannot redeclare」エラーは、上記で述べたファイルインクルードの問題以外にも、いくつかの原因で発生することがあります。
- 同じファイルを複数回読み込んでいる: 最も一般的な原因です。
requireやincludeを意図せず複数回使用してしまい、同じ関数やクラスの定義を重複して読み込んでしまうケースです。 - 異なるファイルに同じ名前の関数/クラスが存在する: コピー＆ペーストのミスや、異なる開発者が同じ名前で独立した関数/クラスを定義してしまった場合に発生します。特に大規模プロジェクトや古いコードベースで起こりやすいです。
- フレームワークやライブラリのオートローダー設定ミス: Composerなどのオートローダーを使用している場合、設定が誤っていると、意図せず同じクラスが複数回ロードされることがあります。
- 名前空間（Namespace）の不適切な使用または未使用: PHPの名前空間は、クラスや関数の名前の衝突を防ぐために設計されています。名前空間を適切に使用していない、または異なる名前空間に同じ名前のクラスがあると誤解している場合にエラーが発生します。
- 開発環境のキャッシュの問題: まれに、OPcacheなどのPHPキャッシュが古いファイルを保持しており、新しい変更が反映されないことで、一時的にこのようなエラーが発生することがあります。PHPの再起動やキャッシュのクリアで解決することがあります。
4. PHPで恒久的に再発を防ぐには
一時的な解決だけでなく、将来的にこの種のエラーを再発させないための開発習慣を身につけることが重要です。
- 常に
require_onceやinclude_onceを使用する: ファイルインクルードの際には、原則として_onceが付くバージョンを使用することを習慣化しましょう。これにより、ファイルの二重読み込みによる再定義エラーを未然に防ぎます。 - PHPのオートロード機能を活用する: クラスの読み込みにはPSR-4などの標準に準拠したオートロード（特にComposerのオートロード機能）を積極的に利用しましょう。これにより、手動での
require_onceの記述が減り、クラスの読み込みがより堅牢になります。 - 名前空間（Namespace）を適切に活用する: クラスには常に名前空間を定義し、関数も可能な限りクラス内にメソッドとしてカプセル化するか、名前空間を持つ関数として定義することを検討しましょう。これにより、グローバルスコープでの名前の衝突を回避できます。
- 静的解析ツールを導入する: PHPStanやPsalmのような静的解析ツールを開発フローに組み込むことで、コードを実行する前に潜在的な問題（再定義エラーを含む）を早期に発見できます。
- IDEの活用: PhpStormなどの高機能IDEは、コードの重複や命名規則の違反をリアルタイムで警告してくれます。
- コードレビューの徹底: チーム開発では、コードレビューを通じて他の開発者が誤って同じ名前の関数やクラスを定義していないかを確認する機会を設けましょう。
これらの対策を講じることで、PHP開発における「Cannot redeclare」エラーの発生を大幅に減らし、より安定したコードベースを維持することができます。