imap_timeout

(PHP 4 >= 4.3.3, PHP 5, PHP 7, PHP 8)

imap_timeoutSet or fetch imap timeout

Description

imap_timeout(int $timeout_type, int $timeout = -1): int|bool

Sets or fetches the imap timeout.

Parameters

timeout_type

One of the following: IMAP_OPENTIMEOUT, IMAP_READTIMEOUT, IMAP_WRITETIMEOUT, or IMAP_CLOSETIMEOUT.

timeout

The timeout, in seconds.

Return Values

If the timeout parameter is set, this function returns true on success and false on failure.

If timeout is not provided or evaluates to -1, the current timeout value of timeout_type is returned as an integer.

Examples

Example #1 imap_timeout() example

<?php

echo "The current read timeout is " . imap_timeout(IMAP_READTIMEOUT) . "\n";

?>

add a note add a note

User Contributed Notes 1 note

up
0
bwgraham at vt dot edu
20 years ago
We looked into the source to find out what this function actually does and how to use it. The function overrides the default_socket_timeout setting from your php.ini file 

You can retrieve the current timeout length for each timeout type by calling the function as:

  imap_timeout(timeout_type);
     or
  imap_timeout(timeout_type,-1);

You can set the timeout length for any of the timeout types by setting the timeout value to a number of seconds.

  imap_timeout(timeout_type,<number of seconds>);

The timeout types are as follows:

1: Open
2: Read
3: Write
4: Close

It does not appear that the close type has been implemented.
To Top