|  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #73640 imap_search can't search HEADER
Submitted: 2016-12-02 08:51 UTC Modified: 2020-10-08 14:49 UTC
Avg. Score:4.7 ± 0.6
Reproduced:10 of 10 (100.0%)
Same Version:5 (50.0%)
Same OS:3 (30.0%)
From: sistemisti-posta at csi dot it Assigned: cmb (profile)
Status: Closed Package: IMAP related
PHP Version: 7.0.13 OS:
Private report: No CVE-ID: None
View Add Comment Developer Edit
Welcome! If you don't have a Git account, you can't do anything here.
You can add a comment by following this link or if you reported this bug, you can edit this bug over here.
Block user comment
Status: Assign to:
Bug Type:
From: sistemisti-posta at csi dot it
New email:
PHP Version: OS:


 [2016-12-02 08:51 UTC] sistemisti-posta at csi dot it
imap_search can't search all headers released by IMAP protocol (RFC 3501).
See at
You can perform the following command:

  HEADER <field-name> <string>

But this option is not allowed from PHP imap_search.

Expected result:
Something like:

$string = sprintf('HEADER "%s" "%s"','Message-ID', '');
imap_search($imapconn, $string, SE_UID);

This should return the uid of message with the Message-ID found.

Actual result:
At the moment, to search an header I can use this workaround:

$string = sprintf('%s "Message-ID: <%s>"','TEXT', '');
imap_search($imapconn, $string, SE_UID);

But it's not safe, because with TEXT I find all occurrences of string

  "Message-ID: <>"

in headers or body too.


Add a Patch

Pull Requests

Add a Pull Request


AllCommentsChangesGit/SVN commitsRelated reports
 [2016-12-02 09:12 UTC] sistemisti-posta at csi dot it
Ps: the current error returned with

$string = sprintf('%s %s "%s"','HEADER', 'Message-ID', '');
imap_search($imapconn, $string, SE_UID);


 PHP Notice:  Unknown: Unknown search criterion: HEADER (errflg=2) in Unknown
 [2020-10-08 14:49 UTC]
-Status: Open +Status: Verified -Type: Bug +Type: Documentation Problem -Assigned To: +Assigned To: cmb
 [2020-10-08 14:49 UTC]
> imap_search can't search all headers released by IMAP protocol
> (RFC 3501).

That is correct, because imap is built on top of libc-client,
which still only supports IMAP2-format search criteria.  Thus,
changing to doc problem.
 [2020-10-08 14:54 UTC]
Automatic comment on behalf of cmb
Log: Fix #73640: imap_search can't search HEADER
 [2020-10-08 14:54 UTC]
-Status: Verified +Status: Closed
PHP Copyright © 2001-2020 The PHP Group
All rights reserved.
Last updated: Tue Nov 24 21:01:23 2020 UTC