davidbohn/holger

TR-064 API 客户端

0.8.1 2020-04-04 21:20 UTC

This package is auto-updated.

Last update: 2024-08-29 04:09:07 UTC


README

StyleCI

这个库是一个用于与支持 TR-064 标准的路由器交互的工具。它主要与 AVM 的 Fritz!Box 7360 进行了测试。

为什么?

使用 SOAP API 实际上非常痛苦。有许多晦涩的 URN、奇怪的 XML 描述文件以及大量的 XML 响应。尽管 PHP 提供了相当不错的 SOAPClient 类,但仍然几乎不可能看到代码的意图。

这个库旨在提供对 API 的友好接口。

安装

可以通过 composer 安装这个库。运行以下命令:

composer require davidbohn/holger

使用方法

通过传递主机名以及必要的用户名和密码(用于对路由器接口进行身份验证),实例化 Holger\Holger 类。然后您可以查询不同的端点,如下所示:

<?php

require_once "vendor/autoload.php";

$credentials = [
    'username' => 'user',
    'password' => 'password'
];

if (file_exists('config.php')) {
    $loadedCredentials = include 'config.php';

    $credentials = array_merge($credentials, $loadedCredentials);
}

$holger = new Holger\Holger('192.168.178.1', $credentials['password'], $credentials['username']);

var_dump($holger->ip->externalIP());

var_dump($holger->ip->externalIPv6());
var_dump($holger->ip->getIPv6Prefix());
var_dump($holger->ip->status());

贡献

  1. 进行分支操作!
  2. 创建您的功能分支:git checkout -b my-new-feature
  3. 提交您的更改:git commit -am '添加一些功能'
  4. 将分支推送到远程:git push origin my-new-feature
  5. 提交拉取请求!

历史

0.8

添加了功率线模块以获取由具有电源插口的功率线适配器测量的功耗。

0.6

添加了通过呼叫辅助添加网状列表和呼叫功能的获取功能。

0.5

引入了新的 API 结构,该结构使用中心 Holger 类来访问所有模块。破坏性更改!感谢 sbreiler 添加了 WANMonitor 模块。

0.3

添加了从 Fritz!Box 路由器检索答录机消息的功能。

0.2

本版本添加了一些新的端点,并为电话簿引入了新功能。

0.1

初始版本,虽然不完整,但展示了东西如何工作。目前是电话簿的基本读取、关于 DECT 手机信息的读取以及子站 ID 的解析(由呼叫监控器提供)。

致谢

此库目前主要由 David Bohn 开发。

欢迎贡献!

许可

MIT 许可证 (MIT)

版权所有 (c) 2016 David Bohn

在此特此授予任何获得此软件及其相关文档副本(“软件”)的人免费使用该软件的权利,不受限制,包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或出售软件副本的权利,并允许向提供软件的人提供使用该软件的权利,前提是遵守以下条件:

上述版权声明和本许可声明应包含在软件的副本或主要部分中。

软件按“现状”提供,不提供任何形式的保证,无论是明示的还是暗示的,包括但不限于适销性、特定用途适用性和非侵权性保证。在任何情况下,作者或版权所有者均不对任何索赔、损害或其他责任负责,无论此类索赔、损害或其他责任是基于合同、侵权或其他方式,源于、因之或与此软件或其使用或其他交易有关。