Composerのタイムアウト問題を解決する方法:設定変更でライブラリのダウンロードをスムーズに
作成日:2025.01.25
Composerでライブラリのインストール中に発生するタイムアウトエラーに対処する方法を解説します。タイムアウト設定の変更手順を紹介し、スムーズなダウンロードを実現するためのポイントを整理しました。
ComposerでPHPのライブラリをインストールする際に、ダウンロードに時間がかかり過ぎて、以下のようなエラーでタイムアウトしてしまうことがあります。
The process "git clone --mirror -- https://github.com/phpstan/phpstan.git C:/Users/info/AppData/Local/Composer/vcs/
https---github.com-phpstan-phpstan.git/" exceeded the timeout of 300 seconds.
上記の例は、 phpstan/phpstan のダウンロード中に git clone コマンドがタイムアウト(デフォルト300秒)しています。
タイムアウト設定(デフォルト300秒)の時間を長く設定することで、上記のようなエラーを解決することができます。
composer config --global process-timeout 1200
上記の例では、タイムアウト設定を1200秒(20分)に変更しています。
この後に再度ライブラリのインストールを試してみて、まだタイムアウトするようならさらに時間を伸ばしてみましょう。
タイムアウトが解決しないようなら、Composer のキャッシュのクリアを試してみるのもお勧めです。
composer clear-cache

奈良市を拠点に、25年以上の経験を持つフリーランスWebエンジニア、阿部辰也です。
これまで、ECサイトのバックエンド開発や業務効率化システム、公共施設の予約システムなど、多彩なプロジェクトを手がけ、企業様や制作会社様のパートナーとして信頼を築いてまいりました。
【制作会社・企業様向けサポート】
Webシステムの開発やサイト改善でお困りの際は、どうぞお気軽にご相談ください。小さな疑問から大規模プロジェクトまで、最適なご提案を心を込めてさせていただきます。
ぜひ、プロフィールやWeb制作会社様向け業務案内、一般企業様向け業務案内もご覧くださいね。
composerでライブラリを後から追加する基本の使い方
2023.09.25
composerを使ったPHPプロジェクトで、新しいライブラリを追加する方法をご紹介します。
ComposerでPhpSpreadsheetのインストール手順
2023.04.29
Composerを使ってPhpSpreadsheetライブラリをインストールする方法を解説します。
XAMPP環境にComposerをインストールする方法
2023.04.26
XAMPP環境にComposerを簡単にインストールする手順を紹介します。Windows向けインストーラーを使ったシンプルなインストール方法を解説します。
CodeIgniter 4 フォーム入力バリデーション入門 ― 基本操作とカスタマイズ手法
2025.04.06
CodeIgniter 4でのフォーム入力値取得とバリデーション処理を、シンプルな実装例を通して解説します。基本的なルール設定から、エラーメッセージの出力、フォームラベルの日本語化やローカライズ方法まで、実践的なテクニックをコンパクトにまとめています。