The imap_server parameter in IMP 4.1+'s servers.php file

As mentioned in ther servers.php file, the Horde Project does not officialy support this parameter. Use at your own risk.

This documentation is also valid for MIMP 1.0.

---

Why use this parameter?

1. The IMAP_Client:: library does not currently support logins for your IMAP authentication type (i.e. kerberos, NTLM).
   1. You both know what you are doing and you want to save a single login to the server at the beginning of a session. (i.e. you are implementing IMP in a large environment, know what these IMAP configuration items are, and want to save a bit of bandwith/CPU cycles for each session by eliminating a server access needed to obtain the IMAP server information). Quite honestly, if the auto-detect method of IMP - the default - correctly detects the IMAP server information, you really shouldn't be messing with this configuration option.

---

Why is IMAP_Client needed at all? Or, why don't you guys just use the c-client library to get this information?

Simple. The php imap_*() functions don't provide a way for us to get this information. Trust us, we would gladly use those functions if they existed.

---

What is the format of the 'namespace' parameter?

Please see the documentation for the namespace function in imp/lib/IMAP/Client.php. Or you can try going to our API Documentation. (No guarantees this link will remain correct).

---

What does an example 'imap_server' entry in servers.php look like for IMP?

Thanks for asking. It looks like the following (this is an example of a dovecot-1.0 IMAP server):

'imap_config' => array(

    'children' => true,

    'namespace' => array(

        '' => array(

            'name' => '',

            'delimiter' => '.',

            'type' => 'personal',

            'hidden' => false

        ),

        '#foo.' => array(

            'name' => '#foo.',

            'delimiter' => '.',

            'type' => 'shared',

            'hidden' => false

        )

    ),

    'search_charset' => true

)

This is an example of an UW-IMAP server:

'imap_config' => array(

    'children' => false,

    'namespace' => array(

        'INBOX/' => array(

            'name' => 'INBOX/',

            'delimiter' => '/',

            'type' => 'personal',

            'hidden' => false,

        ),

    ),

    'search_charset' => true

)

Obviously, don't copy this code directly into servers.php and expect it to work! This is merely an example. Your IMAP server configuration is almost certainly different. Note: MIMP does not require the 'search_charset' value.