Composer – using a local repository

Autoload local package using composer (without going to packagist every time you change).

There are many ways to do so, I will be covering 2 of them:

In all cases we have 2 main parties:
– the local package (the code that we do not want to publish on packagist to be able to autoload it in our project composer).
– the main project (the code base that needs to use the local package code, can be another package and or any project).

---

Method 1: (direct namespace)

Open the main project composer.json file and autoload the local package namespaces using any method (PSR-4, PSR-0, …).

example:

if in the composer.json of the local package we have:

  "autoload": {
    "psr-4": {
      “Local\\Pack\\": "library"
    }
  },
  "autoload-dev": {
    "psr-4": {
      "Local\\Pack\\Tests\\": "tests"
    }
  },

then in the composer.json of the main project we should have:

  "autoload": {
    "psr-4": {
      "Mahmoudz\\Project\\": "src",
      "Local\\Pack\\": "../path/to/local/pack/library”                   << referencing the other local package
    }
  },
  "autoload-dev": {
    "psr-4": {
      "Mahmoudz\\Project\\Tests\\": "tests"
    }
  },

Advantages:
– you don’t touche the vendor directory (running composer update by mistake will not override your local changes)
– you don’t need your package to be on packagist to use it
– you work in one place (the local package) and the changes are automatically loaded in the main project
Disadvantages:
– you cannot publish the composer.json on production (needs editing before publishing to require the real package)

Method 2: (local repository)

Download the local package from a local repository.

local package:
1. initialize git in the package (even if you don’t want to use it – no need to commit anything)
2. add composer.json file. In the file make sure you have the following:

"name": "vendor-name/package-name",  

"autoload": { …   // use whichever method you prefer, but make sure it’s being loaded correctly

"minimum-stability": "dev"  

3. composer dump-autoload

main project:
1. edit your composer.json to contain the following:

  "repositories": [
    {
      "type": "vcs",
      "url": "/full/path/to/the/local/package/package-name"
    }
  ],
  "require": {
    "vendor-name/package-name": "dev-master"
  },

2. composer update vendor-name/package-name
3. now check your vendor directory you should see the vendor-name/package- name

NOTE: whenever you make change in the local package (not the vendor) you need to git commit then you can composer update the main project, it will get the latest copy of the repo to the main project vendor directory.

Advantage:
– you don’t touch the vendor directory (running composer update by mistake will not override your local changes) – you don’t need your package to be on packagist to use it
Disadvantage:
– you have to keep committing your changes (in the local package) and then running composer update in the main project
– you cannot publish the composer.json on production (needs editing before publishing to require the real package)