xref: /PHP-7.4/ext/imap/tests/README.md (revision 83e565e2)
1# The imap extension tests
2
3Many of the tests in this directory require a mail server to be running, if
4there is no mail server the test will skip and warn, see skipif.inc for details.
5
6To make the tests run parameters in the `skipif.inc` and `imap_include.inc`
7files will need to be changed to match the local mailserver configuration.
8
9The tests have been checked using dovecot (on Linux 32 and 64 bit systems) and
10hMailServer on Windows. The tests are intended to be mailserver agnostic.
11
12The tests can be run without modification with a fairly minimal dovecot
13installation. For information, the dovecot.conf file used in running the tests
14is given below. The dovecot password file (dovecotpass) requires a password for
15one user, `webmaster@something.com`. It's also necessary to set up one
16additional user ID (vmail) to own the mail directory.
17
18```txt
19protocols = imap imaps
20
21listen = *
22
23ssl_disable = yes
24
25disable_plaintext_auth=yes
26
27## Mailbox locations and namespaces
28
29mail_location = maildir:/home/vmail/mail/%d/%n/Maildir
30
31auth_verbose = yes
32
33auth_debug = yes
34
35auth default {
36  mechanisms = login
37
38  passdb passwd-file {
39    args = /etc/dovecot/dovecotpass
40  }
41
42  userdb static {
43    args = uid=11459 gid=1002 home=/home/vmail/dovecot/mail/%d/%n
44  }
45
46  user = root
47}
48```
49