Manuel PHP

Fonctions IMAP
PHP Manual

imap_open

(PHP 4, PHP 5)

imap_open — Ouvre un flux imap_utf7_encode().

L'adresse du serveur, mise entre accolades '{' et '}', est constituée du nom du serveur ou de son adresse IP, d'une spécification de protocole (commençant par '/') et d'un port optionnel (spécifié avec ':').

Cette partie est obligatoire dans les paramètres de la boîte aux lettres.

Tous les noms commençant par { sont des noms distants et sont sous la forme "{" nom_systeme_distant [":" port] [flags] "}" [nom_mailbox] où :

  • remote_system_name : Nom de domaine Internet ou une adresse IP de serveur entouré de guillemets.
  • port : numéro de port TCP (optionnel), la valeur par défaut est la valeur du port pour ce service.
  • flags : options, voir la table suivante.
  • mailbox_name : nom de la mailbox distante, par défaut : INBOX

Flags optionnels pour les noms
Flag Description
/service=service service pour l'accès à la mailbox, par défaut : "imap"
/user=user nom de l'utilisateur distant pour l'identification sur le serveur
/authuser=user utilisateur distance d'identification ; si spécifié, ce sera le nom de l'utilisateur dont le mot de passe est utilisé (e.g. administrator)
/anonymous accès distant en anonyme
/debug la télémétrie d'enregistrement du protocole dans les logs de déboguage de l'application
/secure ne transmet pas un mot de passe en clair à travers le réseau
/imap, /imap2, /imap2bis, /imap4, /imap4rev1 équivalent de /service=imap
/pop3 équivalent de /service=pop3
/nntp équivalent de /service=nntp
/norsh ne pas utiliser rsh ou ssh pour établir une session de pré identification IMAP
/ssl utilise Secure Socket Layer pour crypter la session
/validate-cert valide les certificats depuis le serveur TLS/SSL (c'est le comportement par défaut)
/novalidate-cert ne pas valider les certificats depuis le serveur TLS/SSL, nécessaire si le serveur utilise des certificats auto-signés
/tls force l'utilisation de start-TLS pour chiffrer la session et rejette les connexions aux serveurs qui ne le supporte pas
/notls n'utilise pas start-TLS pour chiffrer la session, y compris avec les serveurs qui le supporte
/readonly demande un accès en lecture seule sur mailbox (IMAP uniquement ; ignoré sous NNTP, et une erreur avec SMTP et POP3)

username

Le nom d'utilisateur

password

Le mot de passe associé avec l'utilisateur username

options

options est un masque de bit, qui peut prendre une ou plusieurs des valeurs suivantes :

  • OP_READONLY : Ouvre une boîte aux lettres en lecture seule
  • OP_ANONYMOUS : Ne pas utiliser, ou modifier le fichier .newsrc pour les news (NNTP uniquement)
  • OP_HALFOPEN : Pour les noms imap_delete() and imap_expunge())
  • OP_DEBUG : négociations de déboguage du protocole
  • OP_SHORTCACHE : Cache court (elt uniquement)
  • OP_SILENT : Ne pas transmettre les événements (utilisation interne)
  • OP_PROTOTYPE : Retourne le prototype du driver
  • OP_SECURE : Ne pas effectuer des identifications non sécurisées

n_retries

Le nombre maximal de tentatives de connexion

Valeurs de retour

Retourne un flux IMAP en cas de succès, ou FALSE si une erreur survient.

Historique

Version Description
5.2.0 Le paramètre n_retries a été ajouté.

Exemples

Exemple #1 Différentes utilisations de imap_open()

  1. <?php
  2. // Pour se connecter à un serveur IMAP fonctionnant sur le port 143 de la
  3. // machine locale, faites ceci :
  4. $mbox = imap_open("{localhost:143}INBOX", "user_id", "password");  
  5.  
  6. // Pour se connecter à un serveur POP3 fonctionnant sur le port 110 du
  7. // serveur local, faites ceci :
  8. $mbox = imap_open ("{localhost:110/pop3}INBOX", "user_id", "password");  
  9.  
  10. // Pour se connecter à un serveur SSL IMAP ou POP3, ajoutez /ssl
  11. // après la spécification du protocole :
  12. $mbox = imap_open ("{localhost:993/imap/ssl}INBOX", "user_id", "password");  
  13.  
  14. // Pour se connecter à un serveur SSL IMAP ou POP3 avec un certificat auto-signé
  15. // ajoutez /ssl/novalidate-cert après le protocole :
  16. $mbox = imap_open ("{localhost:995/pop3/ssl/novalidate-cert}", "user_id", "password");  
  17.  
  18. // Pour se connecter à un serveur NNTP qui fonctionne sur
  19. // le port 119 de la machine locale on peut utiliser la commande:
  20. $nntp = imap_open ("{localhost:119/nntp}comp.test", "", "");  
  21.  
  22. // Pour se connecter à un serveur distant, remplacez "localhost" par
  23. // le nom ou l'adresse IP de la machine.
  24. ?> 

Exemple #2 Exemple avec imap_open()

  1. <?php
  2. $mbox = imap_open("{imap.example.org:143}", "username", "password");  
  3.  
  4. echo "<h1>Mailboxes</h1>\n";  
  5. $folders = imap_listmailbox($mbox, "{imap.example.org:143}", "*");  
  6.  
  7. if ($folders == false) { 
  8.    echo "Appel échoué<br />\n";  
  9. } else { 
  10.    foreach ($folders as $val) { 
  11.       echo $val . "<br />\n"; 
  12.    }  
  13. }  
  14.  
  15. echo "<h1>en-têtes dans INBOX</h1>\n";  
  16. $headers = imap_headers($mbox);  
  17.  
  18. if ($headers == false) { 
  19.    echo "Appel échoué<br />\n";  
  20. } else { 
  21.    foreach ($headers as $val) { 
  22.       echo $val . "<br />\n"; 
  23.    }  
  24. }  
  25.  
  26. imap_close($mbox);  
  27. ?> 

Voir aussi

Fonctions IMAP
PHP Manual

Remonter Remonter
L'éditeur javascript - CSS - Gentoo - Tutoriaux PHP - Tutoriels PHP - Bretagne - php - Moto - Kit graphique