.. title:: Installation

Installation
############

.. sidebar:: Table of Contents
  .. contents::

Composer
========

The intended and recommended way of using this package is via `Composer <https://getcomposer.org/>`_. The following
command will get you the latest version and make it a dependency of your project. It will also register all classes and
traits with the autoloader to make them available inside the application.

.. code-block:: shell

  # This will install the latest stable version suitable for your project
  composer require "opencultureconsulting/basics"

If you want to use a specific version other than the latest available for your environment, you can do so by appending
the desired version constraint:

.. code-block:: shell

  # This will install the latest patch level version of 2.1 (i. e. >=2.1.0 && <2.2.0)
  composer require "opencultureconsulting/basics:~2.1"

All available versions as well as further information about :doc:`requirements` and dependencies can be found on
`Packagist <https://packagist.org/packages/opencultureconsulting/basics>`_.

Git
===

Alternatively, you can fetch the files from `GitHub <https://github.com/opencultureconsulting/php-basics>`_ and add
them to your project manually. The best way is by cloning the repository, because then you can easily update to a newer
version by just pulling the changes and checking out a different version tag.

.. code-block:: shell

  # This will clone the repository into the "basics" directory
  git clone https://github.com/opencultureconsulting/php-basics.git basics

If you want to use a specific version other than the latest development state, you have to specify the desired tag as
well:

.. code-block:: shell

  # This will clone the repository state at version "2.1.1" into the "basics" directory
  git clone --branch=v2.1.1 https://github.com/opencultureconsulting/php-basics.git basics

Be aware that you also need to make the classes and traits available in your application by either adding them to your
autoloader or by including all files individually in PHP.

Download
========

As a last resort you can also just download the files. You can find all available versions as well as the current
development state on the `GitHub release page <https://github.com/opencultureconsulting/php-basics/releases>`_.