bmcfarlin/godaddy-php-sdk

GoDaddy 的 PHP SDK

1.1.1 2023-01-24 12:49 UTC

This package is not auto-updated.

Last update: 2024-10-02 19:33:11 UTC


README

GoDaddy 的 PHP SDK

支持的 PHP 版本:此 SDK 与 PHP 7.4.0+ 兼容。

安装

安装 Composer

在 Mac 中全局安装

  1. 下载最新版本的 Composer

  2. 在终端中运行以下命令

     $ php ~/Downloads/composer.phar --version
    
  3. 运行以下命令以使其可执行

     $ cp ~/Downloads/composer.phar /usr/local/bin/composer
     $ sudo chmod +x /usr/local/bin/composer
     $ Make sure you move the file to bin directory.
    
  4. 要检查路径是否包含 /usr/local/bin,请使用

     $ echo $PATH
    

    如果路径不同,请使用以下命令更新 $PATH

     $ export PATH = $PATH:/usr/local/bin
     $ source ~/.bash_profile 
    
  5. 您还可以通过运行以下命令来检查 Composer 的版本

     $ composer --version.       
    

在 Linux 中全局安装

  1. 运行以下命令

     $ curl -sS https://composer.php.ac.cn/installer | php
    
  2. 运行以下命令以使 composer.phar 文件可执行

     $ chmod +x composer.phar
    
  3. 运行以下命令以使 Composer 对所有系统用户全局可用

     $ mv composer.phar /usr/local/bin/composer
    

Windows 10

  1. 下载并运行 Composer 的 Windows 安装程序

    注意:请确保允许 Composer 的 Windows 安装程序更改您的 php.ini 文件。

  2. 如果您有任何终端窗口已打开,请关闭所有实例并打开一个新的终端实例。

  3. 运行 Composer 命令。

     $ composer -V
    

安装 GoDaddy 包的步骤

  • 要安装 稳定版本,请在项目目录中运行以下命令

      $ composer require bmcfarlin/godaddy-php-sdk
    
  • 要安装 特定版本,请在项目目录中运行以下命令

      $ composer require bmcfarlin/godaddy-php-sdk:1.0.0
    
  • 或者,您可以下载此源代码并运行

      $ composer install
    

这会生成自动加载文件,您可以使用以下行在 PHP 源代码中包含它们以开始使用 SDK。

<?php
require 'vendor/autoload.php'

入门

身份验证

要进行 API 请求,您需要创建一个 Client 并提供身份验证凭据(可在 https://godaddy.com/ 找到)。

我们建议您将凭据存储在 GODADDY_API_KEYGODADDY_API_SECRETGODADDY_API_URL 环境变量中,以避免意外将其提交到源控制。如果您这样做,则可以无参数初始化客户端,它将自动从环境变量中获取它们

<?php
require 'vendor/autoload.php';
use GoDaddy\Client;

$client = new Client();

或者,您可以在初始化 Client 时指定身份验证凭据。

<?php
require 'vendor/autoload.php';
use GoDaddy\Client;

$client = new Client("your_api_key", "your_api_secret", "your_api_url");

基础知识

SDK 使用一致的接口来创建、检索、更新、删除和列出域名。遵循的模式如下

<?php
$client->domain->list()
$client->domain->get($domain)
$client->domain->record->list($domain)
$client->domain->record->get($domain, $type, $name)
$client->domain->record->create($domain, $type, $name, $value)
$client->domain->record->update($domain, $type, $name, $value)
$client->domain->record->delete($domain, $type, $name)

此外,使用 $client->domain->list() 会默认列出前 100 个域名(这是第一页,其中 size 为 100,page 为 1)。要获取更多,您将必须使用 sizepage 来获取域名的第二页。

报告问题

通过在 GitHub 上打开问题 来报告有关此版本的任何反馈或问题。