As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Verificar identidades de e-mail usando a API do Amazon SES e o AWS SDK for PHP versão 3

Quando você começar a usar sua conta do Amazon Simple Email Service (Amazon SES), todos os remetentes e destinatários devem ser verificados na mesma região da AWS para a qual seus e-mails são enviados. Para obter mais informações sobre o envio de e-mails, consulte Envio de e-mail com o Amazon SES.

Os exemplos a seguir mostram como:

Todo o código de exemplo para o AWS SDK for PHP está disponível aqui em GitHub.

Credenciais

Antes de executar o código de exemplo, configure suas credenciais da AWS, conforme descrito em Credenciais. Em seguida, importe o AWS SDK for PHP, conforme descrito em Uso básico.

Para obter mais informações sobre o uso do Amazon SES, consulte o Guia do desenvolvedor do Amazon SES.

Verificar endereços de e-mail

O Amazon SES somente pode enviar e-mails de endereços ou domínios de e-mail verificados. Ao verificar um endereço de e-mail, demonstre que é o proprietário desse endereço e deseja conceder permissão ao Amazon SES para enviar e-mails desse endereço.

Ao executar o exemplo de código a seguir, o Amazon SES envia um e-mail para o endereço especificado. Quando você (ou o destinatário do e-mail) clicar no link do e-mail, o endereço será verificado.

Para adicionar um endereço de e-mail à sua conta do Amazon SES, use a VerifyEmailIdentityoperação.

Importações

require 'vendor/autoload.php';

use Aws\Exception\AwsException;

Código de exemplo

$SesClient = new Aws\Ses\SesClient([
    'profile' => 'default',
    'version' => '2010-12-01',
    'region' => 'us-east-2'
]);

$email = 'email_address';

try {
    $result = $SesClient->verifyEmailIdentity([
        'EmailAddress' => $email,
    ]);
    var_dump($result);
} catch (AwsException $e) {
    // output error message if fails
    echo $e->getMessage();
    echo "\n";
}

Verificar um domínio de e-mail

O Amazon SES somente pode enviar e-mails de endereços ou domínios de e-mail verificados. Ao verificar um domínio, demonstre que é o proprietário desse domínio. Ao verificar um domínio, você permite que o Amazon SES envie e-mails de qualquer endereço nesse domínio.

Ao executar o exemplo de código a seguir, o Amazon SES fornece um token de verificação. É necessário adicionar o token para configuração de DNS do seu domínio. Para obter mais informações, consulte Verificar um domínio com o Amazon SES no Guia do desenvolvedor do Amazon Simple Email Service.

Para adicionar um domínio de envio à sua conta do Amazon SES, use a VerifyDomainIdentityoperação.

Importações

require 'vendor/autoload.php';

use Aws\Exception\AwsException;

Código de exemplo

$SesClient = new Aws\Ses\SesClient([
    'profile' => 'default',
    'version' => '2010-12-01',
    'region' => 'us-east-2'
]);

$domain = 'domain.name';

try {
    $result = $SesClient->verifyDomainIdentity([
        'Domain' => $domain,
    ]);
    var_dump($result);
} catch (AwsException $e) {
    // output error message if fails
    echo $e->getMessage();
    echo "\n";
}

Listar endereços de e-mail

Para recuperar uma lista de endereços de e-mail enviados na AWS região atual, independentemente do status da verificação, use a ListIdentitiesoperação.

Importações

require 'vendor/autoload.php';

use Aws\Exception\AwsException;

Código de exemplo

$SesClient = new Aws\Ses\SesClient([
    'profile' => 'default',
    'version' => '2010-12-01',
    'region' => 'us-east-2'
]);

try {
    $result = $SesClient->listIdentities([
        'IdentityType' => 'EmailAddress',
    ]);
    var_dump($result);
} catch (AwsException $e) {
    // output error message if fails
    echo $e->getMessage();
    echo "\n";
}

Listar domínios de e-mail

Para recuperar uma lista de domínios de e-mail enviados na AWS região atual, independentemente do status da verificação, use a ListIdentitiesoperação.

Importações

require 'vendor/autoload.php';

use Aws\Exception\AwsException;

Código de exemplo

$SesClient = new Aws\Ses\SesClient([
    'profile' => 'default',
    'version' => '2010-12-01',
    'region' => 'us-east-2'
]);

try {
    $result = $SesClient->listIdentities([
        'IdentityType' => 'Domain',
    ]);
    var_dump($result);
} catch (AwsException $e) {
    // output error message if fails
    echo $e->getMessage();
    echo "\n";
}

Excluir um endereço de e-mail

Para excluir um endereço de e-mail verificado da lista de identidades, use a DeleteIdentityoperação.

Importações

require 'vendor/autoload.php';

use Aws\Exception\AwsException;

Código de exemplo

$SesClient = new Aws\Ses\SesClient([
    'profile' => 'default',
    'version' => '2010-12-01',
    'region' => 'us-east-2'
]);

$email = 'email_address';

try {
    $result = $SesClient->deleteIdentity([
        'Identity' => $email,
    ]);
    var_dump($result);
} catch (AwsException $e) {
    // output error message if fails
    echo $e->getMessage();
    echo "\n";
}

Excluir um domínio de e-mail

Para excluir um domínio de e-mail verificado da lista de identidades verificadas, use a DeleteIdentityoperação.

Importações

require 'vendor/autoload.php';

use Aws\Exception\AwsException;

Código de exemplo

$SesClient = new Aws\Ses\SesClient([
    'profile' => 'default',
    'version' => '2010-12-01',
    'region' => 'us-east-2'
]);

$domain = 'domain.name';

try {
    $result = $SesClient->deleteIdentity([
        'Identity' => $domain,
    ]);
    var_dump($result);
} catch (AwsException $e) {
    // output error message if fails
    echo $e->getMessage();
    echo "\n";
}