icinga-php-thirdparty/README.md

40 lines
1.2 KiB
Markdown
Raw Normal View History

2021-05-28 11:02:26 +02:00
# Icinga PHP Thirdparty
2021-05-28 11:02:26 +02:00
This project bundles all 3rd party PHP libraries used by Icinga Web products into one piece,
which can be integrated as library into Icinga Web 2.
2021-05-28 11:02:26 +02:00
## Requirements
2018-11-09 21:33:43 +01:00
2021-05-28 11:02:26 +02:00
* [Icinga Web 2](https://github.com/Icinga/icingaweb2) (>= 2.9)
2021-12-15 15:53:23 +01:00
* PHP (>= 7.1.3)
2018-11-09 21:33:43 +01:00
2021-05-28 11:02:26 +02:00
## Installation
2018-11-09 21:33:43 +01:00
2021-05-28 11:02:26 +02:00
Please download the latest release and install it in one of your configured library paths. The default library
path for Icinga Web 2 installations is: `/usr/share/icinga-php`
2018-11-09 21:33:43 +01:00
2021-05-28 11:02:26 +02:00
Download or clone this repository there (e.g. `/usr/share/icinga-php/vendor`) and you're done.
2017-10-27 14:41:48 +02:00
2021-05-28 11:02:26 +02:00
> **Note**: Do NOT install the GIT master, it will not work! Checking out a
> branch like `stable/0.10.0` or a tag like `v0.10.0` is fine.
2017-10-27 14:41:48 +02:00
2021-05-28 11:02:26 +02:00
### Examples
2017-10-27 14:41:48 +02:00
2021-05-28 11:02:26 +02:00
**Sample Tarball installation**
2017-10-27 14:41:48 +02:00
2021-05-28 11:02:26 +02:00
```sh
INSTALL_PATH="/usr/share/icinga-php/vendor"
INSTALL_VERSION="v0.10.0"
2021-11-12 13:09:50 +01:00
mkdir "$INSTALL_PATH" \
2021-05-28 11:02:26 +02:00
&& wget -q "https://github.com/Icinga/icinga-php-thirdparty/archive/$INSTALL_VERSION.tar.gz" -O - \
| tar xfz - -C "$INSTALL_PATH" --strip-components 1
```
2017-10-27 14:41:48 +02:00
2021-05-28 11:02:26 +02:00
**Sample GIT installation**
2017-10-27 14:41:48 +02:00
2021-05-28 11:02:26 +02:00
```
INSTALL_PATH="/usr/share/icinga-php/vendor"
INSTALL_VERSION="stable/0.10.0"
2021-05-28 11:02:26 +02:00
git clone https://github.com/Icinga/icinga-php-thirdparty.git "$INSTALL_PATH" --branch "$INSTALL_VERSION"
```