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

奈良市を拠点に、26年以上の経験を持つフリーランス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向けインストーラーを使ったシンプルなインストール方法を解説します。
OpenAI API 実践例:Chat Completions API で JSON形式レスポンスを取得する方法
2025.06.04
OpenAI API の Chat Completions API を用いて、レスポンス形式を JSON に固定する実装手法を紹介します。PHP を使った具体的なコード例を通じ、response_format パラメータの設定方法や利用シーン、最新モデルでのオプション利用まで解説しています。