Gmail IMAP: Connect with an App Password
Authenticate to Gmail over implicit TLS on port 993, then open INBOX read-only and report its message count. No message is downloaded or changed. This replaces ordinary-password login and removes authentication-session logging.
Personal Gmail IMAP is always enabled. Workspace administrators can restrict IMAP access. For OAuth2, use Gmail IMAP token authentication.
Use an account-specific app password generated after enabling 2-Step Verification, loaded from protected configuration. A normal Google password will not work. App passwords may be unavailable under account or Workspace policy; OAuth2 is preferred. Changing the Google account password revokes app passwords. The obsolete less-secure-apps switch is not a setup option. Google app-password requirements.
See the Gmail SMTP, IMAP, and POP3 guide for current authentication choices and Gmail-specific examples.
Chilkat CkPerl Downloads
use chilkat();
$success = 0;
# Assumes Chilkat is unlocked. See Global Unlock Sample.
$mailbox = 'user@example.com';
$imap = chilkat::CkImap->new();
$imap->put_Ssl(1);
$imap->put_Port(993);
$imap->put_RequireSslCertVerify(1);
$success = $imap->Connect("imap.gmail.com");
if ($success != 1) {
print "Could not establish the Gmail IMAP TLS connection." . "\r\n";
exit;
}
$success = $imap->Login($mailbox,"YOUR_16_CHARACTER_APP_PASSWORD");
if ($success != 1) {
$imap->Disconnect();
print "IMAP authentication failed. Check the app password, mailbox, and account policy." . "\r\n";
exit;
}
# EXAMINE is read-only; no message is downloaded, marked read, moved, or deleted.
$success = $imap->ExamineMailbox("INBOX");
if ($success != 1) {
$imap->Logout();
$imap->Disconnect();
print "Could not examine INBOX." . "\r\n";
exit;
}
print "Messages in INBOX: " . $imap->get_NumMessages() . "\r\n";
$success = $imap->Logout();
$imap->Disconnect();
if ($success != 1) {
print "The read-only operation completed, but IMAP logout failed." . "\r\n";
}