PHP EPP客户端使用手册

PHP EPP客户端使用手册

php-epp-clientObject-oriented PHP EPP Client项目地址:https://gitcode.com/gh_mirrors/ph/php-epp-client

欢迎阅读关于metaregistrar/php-epp-client的详细使用指南。本手册旨在帮助开发者快速理解和应用此对象导向的PHP扩展域名注册协议（EPP）客户端。

1. 项目目录结构及介绍

该项目基于Git管理，其主要目录结构如下：

• .gitignore: 控制哪些文件不应被Git版本控制。
• LICENSE.md: 许可证文件，声明了MIT许可条款。
• README.md: 项目简介，快速入门指导。
• autoloader.php: 自动加载类文件，用于简化PHP类的引入。
• composer.json 和 composer.lock: Composer配置文件，定义依赖和锁定依赖版本。
• params.json: 示例配置文件，展示如何设置连接参数。

在 Registries 目录下，包含了特定于不同域名注册局的示例配置和扩展代码，如SIDN、dotAmsterdam等。Examples 文件夹中提供了一些实用脚本，如checkdomain.php，展示了如何进行基本操作。此外，还有Tests 目录用于存放单元测试代码。

2. 项目的启动文件介绍

尽管该项目没有传统意义上的单一“启动”文件，但开发工作通常从调用或修改示例开始，比如 Examples/checkdomain.php。这个文件是演示如何创建一个到您所选择的注册局的连接并执行基础查询的理想起点。您需要按需定制其中的连接参数，或者通过创建.ini配置文件来间接设置这些参数。

要开始使用，您可以复制或借鉴checkdomain.php，然后实例化适合您的注册局的EPP连接对象，并进行相应设置。

// 示例代码片段，非直接运行代码
require 'vendor/autoload.php';
use Metaregistrar\EPP\metaregEppConnection;

$conn = new metaregEppConnection();
// 或者通过ini文件设置
$conn = Metaregistrar\EPP\eppConnection::create('path-to-settings.ini');

3. 项目的配置文件介绍

INI配置文件方式

项目推荐使用.ini文件来集中管理EPP客户端的连接设置。一个典型的settings.ini示例如下：

interface=eppConnection
hostname=ssl://epp-ote.metaregistrar.com
port=7000
userid=your_username
password=your_password
logging=true
certificatefile=/path/to/your/certificate.pem
certificatepassword=optional_password
verifypeer=true/false
verifypeername=true/false
allowselfsigned=true/false

该配置文件允许您设置包括服务器的主机名、端口、认证凭证以及是否验证服务器证书等关键连接信息。这使得在不修改源代码的情况下能够灵活地配置不同的注册局连接参数。

程序内设置

除了 ini 文件，也可以直接在代码中通过方法调用来设定这些参数：

$conn = new Metaregistrar\EPP\eppConnection();
$conn->setHostname('ssl://your-registry-endpoint.com');
$conn->setPort(7000);
$conn->setUsername('username');
$conn->setPassword('password');
// 设置其他相关属性...

通过上述说明和示例，您可以有效地理解和配置此PHP EPP客户端，以适应各种域名注册操作需求。记住，在实际部署前，确保遵循最佳安全实践，特别是处理敏感数据和证书时。

php-epp-clientObject-oriented PHP EPP Client项目地址:https://gitcode.com/gh_mirrors/ph/php-epp-client