hosterra/netbox

NetBox PHP

3.1.4 2024-03-30 14:17 UTC

README

netbox php license

NetBox PHP

A PHP "SDK" to use NetBox APIs.

>Note: this package is a fork of the Christian Bönning NetBox PHP package wich is itself a fork of the Wicked Software Corp. "Laravel NetBox" package; original credits go to them.

Installation

composer require hosterra/netbox-php

Environment Variables

The package requires 2 environment variables being set accessible through getenv()

VariableTypeDefaultDescription
NETBOX_APIstring""the NetBox API Endpoint (e.g. http://localhost:8080/api)
NETBOX_API_KEYstring""The NetBox API Key created from eg http://127.0.0.1:8080/user/api-tokens/

Example Usage

$api = new \Hosterra\NetBox\Api\IPAM\IpAddresses(new \Hosterra\NetBox\Client());
$result = $api->add([
    'address'  => '11.22.33.44/32',
    'dns_name' => 'foo.example.com'
]);

$result = $api->list(['address' => '11.22.33.44/32'])

Supported NetBox APIs