omines/directadmin

此软件包已被放弃,不再维护。未建议替代软件包。

PHP客户端库,用于管理DirectAdmin控制面板服务器。

v0.1.7 2020-10-07 18:21 UTC

README

Build Status Coverage Status Scrutinizer SensioLabs Insight GitHub license

由于我们不再使用DirectAdmin,原始作者不再支持此软件包。我们在离开时,该库仍然工作正常,使用时请自行承担风险。如果您想接管,只需将您的分支推送到Packagist,全程使用MIT协议。

这是一个PHP客户端库,用于管理DirectAdmin控制面板服务器。我们决定开发这个库,因为我们需要自动化我们的DirectAdmin服务器,现有的实现不受支持且不完整。

每个推送都会自动生成此项目的API文档.

安装

Packagist Packagist

推荐通过Composer安装此库

composer require omines/directadmin

如果您不熟悉composer,请按照Linux/Unix/MacWindows的安装说明进行操作,然后阅读基本使用介绍

依赖

该库使用Guzzle 6作为其HTTP通信层。支持的PHP版本是5.6、7.0、7.1和hhvm。

基本用法

要设置连接,请使用以下基本函数之一

use Omines\DirectAdmin\DirectAdmin;

$adminContext = DirectAdmin::connectAdmin('http://hostname:2222', 'admin', 'pass');
$resellerContext = DirectAdmin::connectReseller('http://hostname:2222', 'reseller', 'pass');
$userContext = DirectAdmin::connectUser('http://hostname:2222', 'user', 'pass');

这些函数分别返回一个AdminContextResellerContextUserContext,分别公开在给定级别上可用的功能。所有三个都相互扩展,因为DirectAdmin使用严格的is-a模型。要代表用户执行操作,您可以使用模拟调用

$resellerContext = $adminContext->impersonateReseller($resellerName);
$userContext = $resellerContext->impersonateUser($userName);

两者本质上相同,但映射到正确的返回类型。当管理用户的域名时,模拟也会隐式进行

$domain = $adminContext->getUser('user')->getDomain('example.tld');

如果域名存在,则返回一个Domain实例,允许您透明地管理其电子邮件帐户等。

贡献

由于DirectAdmin API不断扩展,欢迎提交拉取请求,也欢迎提出特定功能请求。拉取请求应包括为已实现或修复的功能编写适当的单元测试。

有关单元测试的更多信息,请参阅测试文件夹中的README.md

法律

本软件是在荷兰埃因霍温的Omines Full Service Internetbureau内部开发的。Omines Full Service Internetbureau。它在MIT许可下向公众开放,没有任何针对特定目的的适用性保证。有关更多详细信息,请参阅附带的LICENSE文件。

本项目与JBMC Software及其员工没有任何关联。