summaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-13 11:30:08 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-13 11:30:08 +0000
commit4ce65d59ca91871cfd126497158200a818720bce (patch)
treee277def01fc7eba7dbc21c4a4ae5576e8aa2cf1f /README.md
parentInitial commit. (diff)
downloadicinga-php-library-4ce65d59ca91871cfd126497158200a818720bce.tar.xz
icinga-php-library-4ce65d59ca91871cfd126497158200a818720bce.zip
Adding upstream version 0.13.1.upstream/0.13.1
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'README.md')
-rw-r--r--README.md49
1 files changed, 49 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d743380
--- /dev/null
+++ b/README.md
@@ -0,0 +1,49 @@
+# Icinga PHP Library - IPL
+
+This project bundles all Icinga PHP libraries into one piece and can be integrated as library into Icinga Web 2.
+
+## Requirements
+
+* [Icinga Web 2](https://github.com/Icinga/icingaweb2) (>= 2.9)
+* PHP (>= 7.2)
+
+## Bundled Parts
+
+* [ipl-html](https://github.com/Icinga/ipl-html)
+* [ipl-i18n](https://github.com/Icinga/ipl-i18n)
+* [ipl-orm](https://github.com/Icinga/ipl-orm)
+* [ipl-scheduler](https://github.com/Icinga/ipl-scheduler)
+* [ipl-sql](https://github.com/Icinga/ipl-sql)
+* [ipl-stdlib](https://github.com/Icinga/ipl-stdlib)
+* [ipl-validator](https://github.com/Icinga/ipl-validator)
+* [ipl-web](https://github.com/Icinga/ipl-web)
+
+## Installation
+
+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`
+
+Download or clone this repository there (e.g. `/usr/share/icinga-php/ipl`) and you're done.
+
+> **Note**: Do NOT use the default branch, it will not work! Checking out a
+> branch like `stable/0.10.1` or a tag like `v0.10.1` is fine.
+
+### Examples
+
+**Sample Tarball installation**
+
+```sh
+INSTALL_PATH="/usr/share/icinga-php/ipl"
+INSTALL_VERSION="v0.10.1"
+mkdir "$INSTALL_PATH" \
+&& wget -q "https://github.com/Icinga/icinga-php-library/archive/$INSTALL_VERSION.tar.gz" -O - \
+ | tar xfz - -C "$INSTALL_PATH" --strip-components 1
+```
+
+**Sample GIT installation**
+
+```
+INSTALL_PATH="/usr/share/icinga-php/ipl"
+INSTALL_VERSION="stable/0.10.1"
+git clone https://github.com/Icinga/icinga-php-library.git "$INSTALL_PATH" --branch "$INSTALL_VERSION"
+```