imap_set_quota(3) [php man page]

IMAP_SET_QUOTA(3)							 1							 IMAP_SET_QUOTA(3)

imap_set_quota - Sets a quota for a given mailbox

SYNOPSIS

       bool imap_set_quota (resource  $imap_stream, string  $quota_root, int  $quota_limit)

DESCRIPTION

	Sets an upper limit quota on a per mailbox basis.

PARAMETERS

	      o $
		imap_stream -An IMAP stream returned by imap_open(3).

	      o $quota_root
		- The mailbox to have a quota set. This should follow the IMAP standard format for a mailbox: user.name.

	      o $quota_limit
		- The maximum size (in KB) for the $quota_root

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      imap_set_quota(3) example

	      <?php
	      $mbox = imap_open("{imap.example.org:143}", "mailadmin", "password");

	      if (!imap_set_quota($mbox, "user.kalowsky", 3000)) {
		  echo "Error in setting quota
";
		  return;
	      }

	      imap_close($mbox);
	      ?>

NOTES

	This function is currently only available to users of the c-client2000 or greater library.

	The given $imap_stream must be opened as the mail administrator, other wise this function will fail.

SEE ALSO

       imap_open(3), imap_get_quota(3).

PHP Documentation Group 													 IMAP_SET_QUOTA(3)

IMAP_GET_QUOTAROOT(3)							 1						     IMAP_GET_QUOTAROOT(3)

imap_get_quotaroot - Retrieve the quota settings per user

SYNOPSIS

       array imap_get_quotaroot (resource  $imap_stream, string  $quota_root)

DESCRIPTION

	Retrieve  the  quota  settings per user. The limit value represents the total amount of space allowed for this user's total mailbox usage.
       The usage value represents the user's current total mailbox capacity.

PARAMETERS

	      o $
		imap_stream -An IMAP stream returned by imap_open(3).

	      o $quota_root
		-$quota_root should normally be in the form of which mailbox (i.e. INBOX).

RETURN VALUES

	Returns an array of integer values pertaining to the specified user mailbox. All values contain a key based upon the resource name, and  a
       corresponding array with the usage and limit values within.

	This function will return FALSE in the case of call failure, and an array of information about the connection upon an un-parsable response
       from the server.

EXAMPLES

       Example #1

	      imap_get_quotaroot(3) example

	      <?php
	      $mbox = imap_open("{imap.example.org}", "kalowsky", "password", OP_HALFOPEN)
		    or die("can't connect: " . imap_last_error());

	      $quota = imap_get_quotaroot($mbox, "INBOX");
	      if (is_array($quota)) {
		 $storage = $quota['STORAGE'];
		 echo "STORAGE usage level is: " .  $storage['usage'];
		 echo "STORAGE limit level is: " .  $storage['limit'];

		 $message = $quota['MESSAGE'];
		 echo "MESSAGE usage level is: " .  $message['usage'];
		 echo "MESSAGE limit level is: " .  $message['limit'];

		 /* ...  */

	      }

	      imap_close($mbox);
	      ?>

NOTES

	This function is currently only available to users of the c-client2000 or greater library.

	The $imap_stream should be opened as the user whose mailbox you wish to check.

SEE ALSO

       imap_open(3), imap_set_quota(3), imap_get_quota(3).

PHP Documentation Group 												     IMAP_GET_QUOTAROOT(3)