README

AcmeCore是Acme PHP Core库的一个修改版本。Acme PHP Core。

何时使用AcmeCore

AcmeCore被设计为遵循库的最佳实践的Let's Encrypt/ACME协议的直接实现。没有任何文件系统依赖，集成调度器或其他类似的东西。您可以在自己的项目中集成它，并自行处理调度和持久化。

与Acme PHP Core的差异

Acme PHP Core是一个很好的库，但它假设“顺利的路径”总是可行的。也就是说，CA永远不会返回错误，快速执行所有任务，并且总是返回预期的数据。在Let's Encrypt中，这通常是真实的，但其他CA可能不太稳定。

此库与Acme PHP Core之间的主要差异如下

• 每个在AcmeClient上的函数都映射到ACME过程中的单个步骤。这样，您可以自由地以自己的节奏调用和重试步骤（例如，在再次调用finalze之前重试接收证书）。
• 不再有睡眠循环。按照您想要的方式安排任务，如果不想占用PHP进程，就别这样做。
• CertificateOrder现在包含订单的状态。使用reloadOrder函数加载订单，查看当前订单状态，并选择下一步要应用的步骤。

文档

官方的Acme PHP文档大部分仍然适用。但是，证书签发过程已经有所改变。

$secureHttpClientFactory = new SecureHttpClientFactory(
    new GuzzleHttpClient(),
    new Base64SafeEncoder(),
    new KeyParser(),
    new DataSigner(),
    new ServerErrorHandler()
);

// $accountKeyPair instance of KeyPair
$secureHttpClient = $secureHttpClientFactory->createSecureHttpClient($accountKeyPair);

// Important, change to production LE directory for real certs!
$acmeClient = new AcmeClient($secureHttpClient, 'https://acme-staging-v02.api.letsencrypt.org/directory');

// Request a certificate for mydomain.com.
$certificateOrder = $acmeClient->requestOrder('mydomain.com');

// Retrieve the challenges to complete for mydomain.com.
$challenges = $certificateOrder->getAuthorizationChallenges('mydomain.com');

// Now complete the challenge for the domain.
// Find the challenge object for the verification type you want to do, e.g. http-01, dns-01.
$challenge = $challenges[0];

// Ask the CA to confirm the authorization.
$challenge = $acmeClient->challengeAuthorization($dnsChallenge);

// Wait for the CA to complete the authorization.
// This example uses a sleep loop, but you can schedule your own.
while ($challenge->getStatus() != 'ready') {
    sleep(1);
    
    $challenge = $acmeClient->reloadAuthorization($challenge);
}

// Prepare the CSR
$dn = new DistinguishedName('mydomain.com');
$keyPairGenerator = new KeyPairGenerator();
// Make a new key pair. We'll keep the private key as our cert key
$domainKeyPair = $keyPairGenerator->generateKeyPair();

// This is the private key
echo $domainKeyPair->getPrivateKey()->getPem());

// Generate CSR
$csr = new CertificateRequest($dn, $domainKeyPair);

// Tell the CA to generate the certificate.
$certificateOrder = $acmeClient->finalizeOrder($certificateOrder, $csr);

// Wait for the CA to complete the issuance.
// This example uses a sleep loop, but you can schedule your own.
while ($certificateOrder->getStatus() != 'issued') {
    sleep(1);
    
    $certificateOrder = $acmeClient->reloadOrder($certificateOrder->getOrderEndpoint());
}

// Retrieve the generated certificate.
$certificate = $acmeClient->retrieveCertificate($certificateOrder);

// This is the generated certificate.
echo $certificate->getPem();

启动测试套件

Acme PHP测试套件位于主存储库中：https://github.com/acmephp/acmephp#launch-the-test-suite。