This is not just a version bump. Raising the PHP floor allowed us to modernize the IPL codebase in ways that were not possible before: strict type declarations throughout, and a cleaner, more predictable API surface. We are also introducing two new packages: icinga/zf1, our own lean fork of the Zend Framework 1 tailored to what the Icinga ecosystem actually needs for compatibility with newer PHP versions, and icinga-php-legacy, a new home for the gipfl libraries under official Icinga maintenance, which replaces the incubator module.
Additionally, with this release, we are raising the license across the affected modules to GPL-3.0.
This time, we release the icinga-php-library and icinga-php-thirdparty meta-packages in two tracks. Version 0.19.1 / 0.15.2Â covers the PHP 8.5 compatibility and strict typing work, PHP 8.2 is now the minimum required version. Version 1.0.0 additionally adopts react/promise v3, which carries its own breaking changes. react/promise is a PHP library that handles asynchronous operations (background tasks, daemon processes, and non-blocking I/O). The v3 release changed its core API in incompatible ways, meaning any module that schedules or runs async work needs to be updated to the new interface. This is why the version bump to 1.0.0 exists as a separate track rather than being folded into the regular compatibility update. Modules that use async or daemon functionality require the 1.0.0 track. All others only need 0.19.1 / 0.15.2.
Please note that you might be prompted to install a v0.19.0 or v0.15.0/v0.15.1 of icinga-php-library and icinga-php-thirdparty, respectively. Do not install these if you also happen to use Icinga Director. Also, if you are prompted to install Icinga Director v1.11.7, skip directly to v1.11.8. Sorry for the fuss.
If you maintain a custom Icinga Web module or extend any IPL interface, you need to be aware of breaking changes. Please read the “Upgrading” section carefully before updating.
Icinga Web v2.13
We have separated the monitoring module from the Icinga Web repository, it enters maintenance mode and ships as a standalone package. The recommended migration path is Icinga DB Web.
On the UI side, collapsed sidebar flyout menus now show their section title, and teams can configure a default acknowledgement comment text via acknowledge_comment_text. We also resolved several smaller visual inconsistencies and a browser timezone handling bug.
Icinga DB Web v1.4.0
State pictograms cover additional states and include tooltips, and plugin output indicators now render as proper visual state indicators. History queries can optionally disable the MySQL/MariaDB query optimizer for setups where it produces poor plans. Additionally, exported SQL queries are easier to copy from the interface.
Fixes include correct handling of incomplete custom variable objects, removal of spurious monitoring module integration errors, and valid JSON output for paginated exports.
Icinga Business Process Modeling v2.6.0
We removed the monitoring module dependency. Migrate to the Icinga DB Web integration if you haven’t already. Navigation menu items now have configurable visibility options.
Compatibility Updates
The following modules receive no significant new features in this bundle beyond PHP 8.5 compatibility. They require icinga-php-library >=0.19.0 and icinga-php-thirdparty >=0.15.0.
- Icinga Cube v1.4.0
- Director Fileshipper Import Source v1.3.0
- Icinga Web Graphite Integration v1.3.0
- Icinga Web JIRA Integration v1.5.0
- Icinga Web NagVis Integration v1.3.0
- Icinga Dependencies Web v1.0.3
Upgrading
As described above, icinga-php-library and icinga-php-thirdparty ship in two tracks: 0.19.0 / 0.15.0 and 1.0.0. The 0.x track is a non-breaking update that covers PHP 8.5 compatibility and strict typing, most modules only need this track. The 1.0.0 track additionally adopts react/promise v3 and introduces breaking changes for modules that use async or daemon functionality.
Non-breaking changes (0.19.0 / 0.15.0 track)
PHP requirement: PHP 8.2 is the new minimum version.
IPL interface changes: We added strict type declarations to several core IPL interfaces. If your module implements or extends any of the following, you must update your method signatures:
- Translator (ipl-i18n) affects
GettextTranslatorandNoopTranslator - Paginatable (ipl-sql) affects
CursorandLimitOffset Messages::addMessage()(ipl-html)Properties::getProperty()(ipl-orm)- Connection interface (ipl-sql)
lastInsertId()is now required Databases::databases()is now a static method
Zend Framework 1: ipl-web now depends on icinga/zf1 instead of shardj/zf1-future. Update your composer.json if you have a direct dependency on the old package.
Breaking changes (1.0.0 track)
react/promise v3: The 1.0.0 releases pull in react/promise v3. As a result, modules that use async or daemon functionality (such as Reporting, PDF Export, vSphereDB, Certificate Monitoring and Director) require this track and must update their promise handling to the v3 API. Modules with no async dependencies only need the 0.19.0 / 0.15.0 track and remain unaffected by this change.
General changes
Monitoring module: We removed it from the Icinga Web core. It ships as a standalone package in maintenance mode. Migrate to Icinga DB Web for active development and support.
More Updates will Follow
We’ve been super busy building the updates for Icinga Web and all of our modules, but we’re not done yet! The following modules will receive updates within the next couple of weeks as well to get PHP 8.5 support:
- Icinga Director
- Icinga vSphere® Integration
- Icinga Certificate Monitoring
- Icinga Reporting
Stay tuned and follow our blogposts and announcements to get the latest news about upcoming upgrades. Subscribe to our newsletter to receive all information directly to your inbox.
