imap_reopen(3) [php man page]

IMAP_REOPEN(3)								 1							    IMAP_REOPEN(3)

imap_reopen - ReopenIMAPstream to new mailbox

SYNOPSIS

       bool imap_reopen (resource  $imap_stream, string  $mailbox, [int  $options], [int  $n_retries])

DESCRIPTION

	Reopens the specified stream to a new $mailbox on an IMAP or NNTP server.

PARAMETERS

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

	      o $mailbox
		- The mailbox name, see imap_open(3) for more information

	      o $options
		- The $options are a bit mask with one or more of the following:

		     o OP_READONLY - Open mailbox read-only

		     o OP_ANONYMOUS - Don't use or update a .newsrc for news (NNTP only)

		     o OP_HALFOPEN - For IMAP and NNTP names, open a connection but don't open a mailbox.

		     o OP_EXPUNGE - Silently expunge recycle stream

		     o CL_EXPUNGE - Expunge mailbox automatically upon mailbox close (see also imap_delete(3) and imap_expunge(3))

	      o $n_retries
		- Number of maximum connect attempts

RETURN VALUES

	Returns TRUE if the stream is reopened, FALSE otherwise.

CHANGELOG

       +--------+------------------+
       |Version |		   |
       |	|		   |
       |	|   Description    |
       |	|		   |
       +--------+------------------+
       | 5.2.0	|		   |
       |	|		   |
       |	| $n_retries added |
       |	|		   |
       +--------+------------------+
EXAMPLES

       Example #1

	      imap_reopen(3) example

	      <?php
	      $mbox = imap_open("{imap.example.org:143}INBOX", "username", "password") or die(implode(", ", imap_errors()));
	      // ...
	      imap_reopen($mbox, "{imap.example.org:143}INBOX.Sent") or die(implode(", ", imap_errors()));
	      // ..
	      ?>

PHP Documentation Group 													    IMAP_REOPEN(3)

IMAP_CREATEMAILBOX(3)							 1						     IMAP_CREATEMAILBOX(3)

imap_createmailbox - Create a new mailbox

SYNOPSIS

       bool imap_createmailbox (resource  $imap_stream, string	$mailbox)

DESCRIPTION

	Creates a new mailbox specified by $mailbox.

PARAMETERS

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

	      o $mailbox
		-  The	mailbox  name,	see  imap_open(3)  for	more  information.  Names containing international characters should be encoded by
		imap_utf7_encode(3)

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      imap_createmailbox(3) example

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

	      $name1 = "phpnewbox";
	      $name2 = imap_utf7_encode("phpnewbox"); // phpnewb&w7Y-x

	      $newname = $name1;

	      echo "Newname will be '$name1'<br />
";

	      // we will now create a new mailbox "phptestbox" in your inbox folder,
	      // check its status after creation and finally remove it to restore
	      // your inbox to its initial state

	      if (@imap_createmailbox($mbox, imap_utf7_encode("{imap.example.org}INBOX.$newname"))) {
		  $status = @imap_status($mbox, "{imap.example.org}INBOX.$newname", SA_ALL);
		  if ($status) {
		      echo "your new mailbox '$name1' has the following status:<br />
";
		      echo "Messages:	" . $status->messages	 . "<br />
";
		      echo "Recent:	" . $status->recent	 . "<br />
";
		      echo "Unseen:	" . $status->unseen	 . "<br />
";
		      echo "UIDnext:	" . $status->uidnext	 . "<br />
";
		      echo "UIDvalidity:" . $status->uidvalidity . "<br />
";

		      if (imap_renamemailbox($mbox, "{imap.example.org}INBOX.$newname", "{imap.example.org}INBOX.$name2")) {
			  echo "renamed new mailbox from '$name1' to '$name2'<br />
";
			  $newname = $name2;
		      } else {
			  echo "imap_renamemailbox on new mailbox failed: " . imap_last_error() . "<br />
";
		      }
		  } else {
		      echo "imap_status on new mailbox failed: " . imap_last_error() . "<br />
";
		  }

		  if (@imap_deletemailbox($mbox, "{imap.example.org}INBOX.$newname")) {
		      echo "new mailbox removed to restore initial state<br />
";
		  } else {
		      echo "imap_deletemailbox on new mailbox failed: " . implode("<br />
", imap_errors()) . "<br />
";
		  }

	      } else {
		  echo "could not create new mailbox: " . implode("<br />
", imap_errors()) . "<br />
";
	      }

	      imap_close($mbox);
	      ?>

SEE ALSO

       imap_renamemailbox(3), imap_deletemailbox(3).

PHP Documentation Group 												     IMAP_CREATEMAILBOX(3)