PHPackages                             bricev/compolab - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. bricev/compolab

ActiveLibrary

bricev/compolab
===============

Composer Repository for GitLab

1.0.1(6y ago)6241[2 issues](https://github.com/bricev/CompoLab/issues)[3 PRs](https://github.com/bricev/CompoLab/pulls)proprietaryPHPPHP &gt;=7.1.0, &lt;7.2.0

Since Jan 29Pushed 3y ago1 watchersCompare

[ Source](https://github.com/bricev/CompoLab)[ Packagist](https://packagist.org/packages/bricev/compolab)[ RSS](/packages/bricev-compolab/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (4)Dependencies (10)Versions (8)Used By (0)

CompoLab
========

[](#compolab)

[![Scrutinizer Code Quality](https://camo.githubusercontent.com/8393ae7accd6e8c746444946f3ce715e41269dfcce27658d4707a83e624ab0b7/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6272696365762f436f6d706f4c61622f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/bricev/CompoLab/?branch=master)[![Code Coverage](https://camo.githubusercontent.com/0eed1429087d058398c0b5b9c42f061063cd3a61dca23cfbbab71d31ab99a798/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6272696365762f436f6d706f4c61622f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/bricev/CompoLab/?branch=master)[![Build Status](https://camo.githubusercontent.com/bea46ae727af9a2ebc8b997643edff70600c6d8e89e88f3a6a4b185db57190b2/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6272696365762f436f6d706f4c61622f6261646765732f6275696c642e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/bricev/CompoLab/build-status/master)

CompoLab is a PHP package repository server that makes all your GitLab compliant repositories available as Composer dependencies.

In order to be registered by CompoLab, your GitLab repository must contain a valid `composer.json` file in the root directory.

### Security disclaimer

[](#security-disclaimer)

By default, CompoLab is not secured and will let anyone access your packages. In order to secure access to your packages, you must configure your web server any way you want. Eg. you may filter with an IP whitelist, or require the use of your own self-signed SSL certificate.

### Requirements

[](#requirements)

A (preferably unix) server configured with:

- PHP 7.1 (A PHP component encounters an issue with PHP 7.2, making this code only compliant with 7.1)
- Git / Composer
- A web server (Nginx or Apache)
- A working instance of GitLab (with an admin user account)

### Installation

[](#installation)

1. From your GitLab instance, edit your own profile, then go to `Access Tokens` and create a token with the name of your choice (eg. CompoLab), no expiration date, and check only `api` and `sudo` scopes. If you are not an admin with a `sudo`token, you may be restricted in term of the groups and projects you'll be able to cache in your CompoLab repository.
2. Run the following composer command on the server you want to use as a Composer repository: `composer create-project bricev/compolab --no-dev --keep-vcs /var/www/compolab` (where the last command argument is the path where you want to install CompoLab).
3. Execute the installation script by running the command: `php bin/install` (from CompoLab directory). Get ready to register your GitLab URL and token during this step. Settings will be persisted in the `config/settings.yml` file (which is not versioned). You may use the `config/settings.yml.example` template to create this manually if you prefer.
4. The web server must be properly configured to receive GitLab webhooks and receive `GET /packages.json` requests. The main concern is to make `public/packages.json` and `public/archives` accessible from the root of your domain (eg. ). All other queries must be forwarded to `public/index.php`. A documented Nginx configuration example can be found here: `config/templates/nginx.conf`.
5. Use the `cli` application from your server and run the following command `php bin/cli sync` : this will fully synchronize your GitLab server with your CompoLab repository. Once executed, all distribution archives will be stored in the CompoLab cache and the `packages.json` index will be up to date.
6. From your GitLab instance, go to the `Admin Area` &gt; `System hooks` and configure a system hook with URL `https://composer.my-website.com/gitlab` (where `composer.my-website.com` is the domain or IP you want to use with your CompoLab instance), no secret token as you are advised to insure security at the web server level, and check only `Push events`, `Tag push events` and `Enable SSL verification` (if your web server is properly configured to accept SSL requests).

You're all set: your repository is complete and any future push/tag made to GitLab will be registred by CompoLab.

### Usage

[](#usage)

In order to let your local Composer installation know where to find your CompoLab repository, you need to add some configuration. You may configure your repository from your machine or directly from your package.

##### Local setting

[](#local-setting)

You may execute the following command on your local computer/server to let Composer knows about the existance of CompoLab:

```
composer config -g repositories.compolab composer https://composer.my-website.com

```

This command should add a `~/.composer/config.json` (on Unix systems) file containing the following lines:

```
{
    "repositories": {
        "compolab": {
            "type": "composer",
            "url": "https://composer.my-website.com"
        }
    }
}
```

##### Package setting

[](#package-setting)

OR you may set the repository address directly in your package's composer.json file:

```
{
    "repositories": [
        {
            "type": "composer",
            "url": "https://composer.my-website.com"
        }
    ]
}
```

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance13

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~40 days

Total

4

Last Release

2540d ago

Major Versions

0.1.1 → 1.0.02019-01-31

PHP version history (2 changes)0.1.0PHP ^7.1

1.0.1PHP &gt;=7.1.0, &lt;7.2.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/148a43ea1996ff017ce021a6e9e515ab3b2ca729c1ad2fdb84c59a8db78ef5aa?d=identicon)[bricev](/maintainers/bricev)

---

Top Contributors

[![bricev](https://avatars.githubusercontent.com/u/4078270?v=4)](https://github.com/bricev "bricev (37 commits)")

---

Tags

compolabcomposercomposer-repositorygitlabpackage-managerphpphp7

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/bricev-compolab/health.svg)

```
[![Health](https://phpackages.com/badges/bricev-compolab/health.svg)](https://phpackages.com/packages/bricev-compolab)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[simplesamlphp/simplesamlphp

A PHP implementation of a SAML 2.0 service provider and identity provider.

1.1k12.4M193](/packages/simplesamlphp-simplesamlphp)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)[drupal/core

Drupal is an open source content management platform powering millions of websites and applications.

19462.3M1.3k](/packages/drupal-core)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
