Laravelのプロジェクト作成時に、下記エラーが出た場合の対策を解説します。In
C:\xampp\phpの中のphp.iniファイルを開きます。
extension=zipを検索します。
;extension=zipとなっていたら、先頭のセミコロンを削除し、有効にします。
エラーの理由
エラーの理由は、プロジェクト作成時に、「–prefer-dist」を使ったことが考えられます。
このオプションは、Composerがパッケージをダウンロードする際に圧縮されたディストリビューションファイル(distファイル)を優先的に使用するよう指示します。--prefer-dist
を使用することでインストールプロセスが通常より速く進行することが多いですが、このメソッドはPHPのZIP拡張機能とunzipまたは7zのような外部コマンドに依存しています。
これらのツールがシステム上で利用可能でない場合、Composerはエラーを返し、プロジェクトの作成が失敗することがあります。
そのため、エラーが発生したら、使用しているシステムのphp.ini
ファイルを開き、「extension=zip」という行がコメントアウトされている場合(行の前に;
が付いている場合)、このセミコロンを削除して拡張機能を有効にします。
エラーが解消しない場合
もしエラーが解消しない場合は、詳細なエラーメッセージを確認して原因を特定する必要があります。下記に一般的に有効なエラー対策方法をいくつかご紹介します。
—-
・XAMPP のコントロールパネルで Apache を再起動
まずはXAMPPを起動しなおしてみましょう。
・ZIP拡張モジュールの有効性チェック
XAMPPを起動し、Laravelプロジェクトの中でコマンドラインを起動します。
以下を実行して、zip 拡張が有効になっているか確認します。
1 |
php -m | findstr zip |
下記のようにzip と表示されれば有効です。表示されない場合は、再度php.iniの設定を確認してくだい。
・PHPバージョンの確認
php -v コマンドで確認できます。Laravel11は8.2以上必要なので、バージョンが違う場合は対応版を入れる必要があります。
・Composer更新
composer self-update で最新版をいれます。