omines / directadmin
PHP客户端库,用于管理DirectAdmin控制面板服务器。
Requires
- php: >=5.6.0
- guzzlehttp/guzzle: ^6.1|^7.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^2.0
- php-coveralls/php-coveralls: ^2.1
- phpunit/phpunit: ^5.7 || ^7.3
This package is auto-updated.
Last update: 2023-03-18 18:04:09 UTC
README
由于我们不再使用DirectAdmin,原始作者不再支持此软件包。我们在离开时,该库仍然工作正常,使用时请自行承担风险。如果您想接管,只需将您的分支推送到Packagist,全程使用MIT协议。
这是一个PHP客户端库,用于管理DirectAdmin控制面板服务器。我们决定开发这个库,因为我们需要自动化我们的DirectAdmin服务器,现有的实现不受支持且不完整。
安装
推荐通过Composer安装此库
composer require omines/directadmin
如果您不熟悉composer
,请按照Linux/Unix/Mac或Windows的安装说明进行操作,然后阅读基本使用介绍。
依赖
该库使用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');
这些函数分别返回一个AdminContext
、ResellerContext
和UserContext
,分别公开在给定级别上可用的功能。所有三个都相互扩展,因为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及其员工没有任何关联。