60 lines
2.3 KiB
ReStructuredText
60 lines
2.3 KiB
ReStructuredText
.. 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.0" into the "basics" directory
|
|
git clone --branch=v2.1.0 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>`_.
|