Download the PHP package rconfig/laravel-zabbix without Composer

Laravel Zabbix by rConfig

A Laravel-first, developer-friendly client for the Zabbix JSON-RPC API that makes monitoring integrations a breeze, developed by rConfig.

✨ Features

• 🎯 Intuitive fluent API with chainable query methods ending in .get()
• 🚀 First-class developer experience with expressive, readable syntax
• ⚡ No double method calls - just chain directly: hosts()->limit(5)->get()
• 🧪 Local testing without a live Zabbix server via HTTP fakes
• 🔧 Optional real server integration for end-to-end testing
• 📦 Laravel package best practices with auto-discovery
• 🔌 Extensible design for additional Zabbix endpoints

📦 Installation

Install via Composer:

The service provider will be auto-discovered. Optionally publish the config:

⚙️ Configuration

Environment Variables

Config File

The config file at config/zabbix.php provides sensible defaults:

🚀 Quick Start

🔍 Fluent Queries

Build complex queries with an intuitive fluent interface:

Hosts

Host Groups

Advanced Query Builder (Alternative)

For complex queries, you can still use the explicit query builder:

📊 Version Matrix & Compatibility

We recommend running your integration tests against both LTS and current major to catch method or parameter changes early.

🚫 Unsupported Operations

Some Zabbix API resources do not implement all CRUD operations.
For example, certain system resources cannot be created or deleted.

In these cases:

• Methods like create(), update(), or delete() will throw an UnsupportedOperationException
• This makes it clear the operation isn’t available for that resource, rather than failing silently.

Example:

env ZABBIX_PARAM_VALIDATION=true env ZABBIX_BASE_URL=https://zabbix.example.com ZABBIX_API_TOKEN=your_api_token_here ZABBIX_USERNAME=Admin ZABBIX_PASSWORD=zabbix

/code ├─ myapp/ # Your Laravel app └─ rconfig-laravel-zabbix/ # This package json { "repositories": [ { "type": "path", "url": "../rconfig-laravel-zabbix", "options": { "symlink": true } } ] } bash cd myapp composer require rconfig/laravel-zabbix:"dev-main" php artisan vendor:publish --tag=zabbix-config bash php artisan tinker

use Rconfig\Zabbix\Facades\ZabbixApi; $zabbix = ZabbixApi::login('fake://localhost'); $zabbix->apiVersion() // "7.0.0" (fake) $zabbix->hosts()->all() // Mock data md

[0.1.0] - 2025-08-09

Added

• Initial public release of the Laravel Zabbix client. bash git add CHANGELOG.md git commit -m "docs: update changelog for v0.1.0" git push origin main bash git tag -a v0.1.0 -m "v0.1.0 initial public release" git push origin v0.1.0 bash composer install bash vendor/bin/pest bash vendor/bin/pint bash

  Run all tests with fakes

  vendor/bin/pest

Run integration tests (requires real Zabbix server)

RUN_ZABBIX_INTEGRATION=1 \ ZABBIX_BASE_URL=https://your-zabbix.com \ ZABBIX_API_TOKEN=your_token \ vendor/bin/pest

## 📄 License

This package is open-sourced software licensed under the [MIT license](LICENSE).

## Code of Conduct

While we aren't directly affiliated with Zabbix or Laravel, but we follow their respective Codes of Conduct. We expect you to abide by these guidelines as well.

## Authors

This library is created by rConfig Developers for the Zabbix and Laravel communities.

## License

The MIT License (MIT). Please see [License File](LICENSE) for more information.

<div align="center">
<strong>Built with ❤️ by rConfig for the Zabbix and Laravel communities</strong>
</div>