Skip to content

lamoni/netconf

Repository files navigation

NETCONF

This is a vendor-agnostic PHP implementation of NETCONF. I developed this so I could extend a Junos (Juniper) specific NETCONF API off of it, and decided to share it publicly.

Targeted RFCs

Dependencies

To Do

Examples

Initializing NETCONF using password authentication and then sending a custom RPC call

$netConf = new NetConf(
    "192.168.0.100",
    new NetConfAuthPassword(
        [
            "username" => "lamoni",
            "password" => "phpsux"
        ]
    )
);

echo $netConf->sendRPC(
    "<get-config>".
        "<source>".
            "<running/>".
        "</source>".
    "</get-config>"
);

Editing the configuration of a Junos device and committing the changes

$netConf->editConfig(
    "<configuration>
        <interfaces>
            <interface>
                <name>fe-0/0/0</name>
                <description>Testing netconf</description>
            </interface>
        </interfaces>
    </configuration>",
    'candidate',
    ['custom-param' => 'custom-value']
);


if ($netConf->commit()->isRPCReplyOK()) {
    echo "Successfully committed, dude!";
}
else {
    echo "Something's wrong, man.";
}

Using NETCONF's subtree filters to get certain config

$getUsersNames = $netConf->getConfig(
    [
       "configuration/system/login/user" => [
           [
               "name"=>"user"
           ]
       ]
    ]
);

Considerations

  • Namespaces?
  • Heavier use of Exceptions?
  • test-option: The element MAY be specified only if the device advertises the :validate:1.1 capability (Section 8.6).
  • Should I be implicitly locking/unlocking the config for editConfig() () and commit() () calls?
  • Should I remove the long list of arguments for argument-heavy methods and replace them with a single array?
    • Pros
      • it looks nicer
      • allows for extension in the future without requiring heavy refactoring
    • Cons
      • Methods will require some extract() type code at the top, along with validation of keys passed through (abstract class that?)
      • IDEs argument suggestion won't work(?)
  • XPath capability in filter?

About

A vendor-agnostic PHP NETCONF implementation

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages