Composer Repository Mirror

Setup

Scripted Setup

• See https://github.com/peter279k/mirror-kickstarter if you are looking for automated scripts dealing with the setup of mirrors.

Manual Setup

• git clone https://github.com/composer/mirror mirror
• cd mirror
• composer install
• cp mirror.config.php.dist mirror.config.php
• Edit mirror.config.php to fit your needs, and mind the TODO entries which MUST be filled-in.
• Run it using supervisord or similar, it is made to shutdown regularly to avoid leaks or getting stuck for any reason. There are 3 scripts you should run:
  • ./mirror.php --v1 should be run permanently to sync Composer 1 metadata (if you do not need Composer 1 metadata, you don't have to run this, but then you must set has_v1_mirror to false in the config)
  • ./mirror.php --v2 should be run permanently to sync Composer 2 metadata
  • ./mirror.php --gc should be run once an hour or so with a cron job to clean up old v1 files (if you do not need Composer 1 metadata, you don't need to run this)

Debugging and force-resync of v2 metadata

In case the v2 metadata gets very outdated because you did not update the mirror for a while, this will be detected and a resync will happen automatically.

However, if you want to run a resync manually to see what is going on you can use:

./mirror.php --resync -v

This will make sure the v2 metadata is in sync again (wait for the script to complete which may take a while) and then running ./mirror.php --v2 regularly again should get you back on regular updates.

Requirements

• PHP 7.3+
• A web server configured:
  • to send Last-Modified headers, and respond correctly to If-Modified-Since requests with 304 Not Modified
  • to allow HTTP/2 if possible as HTTP/1 performance will be much reduced
  • to respond correctly with 404s for missing files

Update

In your mirror dir:

• git pull origin master
• composer install

Then restart the workers