bcompiler_write_exe_footer(3) [php man page]

BCOMPILER_WRITE_EXE_FOOTER(3)						 1					     BCOMPILER_WRITE_EXE_FOOTER(3)

bcompiler_write_exe_footer - Writes the start pos, and sig to the end of a exe type file

SYNOPSIS

       bool bcompiler_write_exe_footer (resource  $filehandle, int  $startpos)

DESCRIPTION

	An EXE (or self executable) file consists of 3 parts:

	      o The
		stub  (executable code, e.g. a compiled C program) that loads PHP interpreter, bcompiler extension, stored Bytecodes and initiates
		a call for the specified function (e.g. main) or class method (e.g.  main::main)

	      oThe Bytecodes (uncompressed only for the moment)

	      oThe bcompiler EXE footer

	To obtain a suitable stub you can compile php_embed-based stub phpe.c located in the examples/embed directory on bcompiler's CVS.

PARAMETERS

	      o $filehandle
		- A file handle as returned by fopen(3).

	      o $startpos
		- The file position at which the Bytecodes start, and can be obtained using ftell(3).

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      bcompiler_write_exe_footer(3) example

	      <?php

	      /* creating the output file (example.exe) */
	      $fh = fopen("example.exe", "w");

	      /* 1) writing a stub (phpe.exe) */
	      $size = filesize("phpe.exe");
	      $fr = fopen("phpe.exe", "r");
	      fwrite($fh, fread($fr, $size), $size);
	      $startpos = ftell($fh);

	      /* 2) writing bytecodes */
	      bcompiler_write_header($fh);
	      bcompiler_write_class($fh, "myclass");
	      bcompiler_write_function($fh, "main");
	      bcompiler_write_footer($fh);

	      /* 3) writing EXE footer */
	      bcompiler_write_exe_footer($fh, $startpos);

	      /* closing the output file */
	      fclose($fh);
	      ?>

NOTES

       Warning

	      This function is EXPERIMENTAL. The behaviour of this function, its name, and surrounding documentation may change without notice	in
	      a future release of PHP. This function should be used at your own risk.

SEE ALSO

       bcompiler_write_header(3), bcompiler_write_class(3), bcompiler_write_footer(3).

PHP Documentation Group 											     BCOMPILER_WRITE_EXE_FOOTER(3)

STREAM_WRAPPER_REGISTER(3)						 1						STREAM_WRAPPER_REGISTER(3)

stream_wrapper_register - Register a URL wrapper implemented as a PHP class

SYNOPSIS

       bool stream_wrapper_register (string  $protocol, string	$classname, [int  $flags])

DESCRIPTION

	Allows you to implement your own protocol handlers and streams for use with all the other filesystem functions (such as fopen(3), fread(3)
       etc.).

PARAMETERS

	      o $protocol
		- The wrapper name to be registered.

	      o $classname
		- The classname which implements the $protocol.

	      o $flags
		- Should be set to STREAM_IS_URL if $protocol is a URL protocol. Default is 0, local stream.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

       stream_wrapper_register(3) will return FALSE if the $protocol already has a handler.

CHANGELOG

       +--------+------------------------------+
       |Version |			       |
       |	|			       |
       |	|	  Description	       |
       |	|			       |
       +--------+------------------------------+
       | 5.2.4	|			       |
       |	|			       |
       |	|  Added the $flags parameter. |
       |	|			       |
       +--------+------------------------------+
EXAMPLES

       Example #1

	      How to register a stream wrapper

	      <?php
	      $existed = in_array("var", stream_get_wrappers());
	      if ($existed) {
		  stream_wrapper_unregister("var");
	      }
	      stream_wrapper_register("var", "VariableStream");
	      $myvar = "";

	      $fp = fopen("var://myvar", "r+");

	      fwrite($fp, "line1
");
	      fwrite($fp, "line2
");
	      fwrite($fp, "line3
");

	      rewind($fp);
	      while (!feof($fp)) {
		  echo fgets($fp);
	      }
	      fclose($fp);
	      var_dump($myvar);

	      if ($existed) {
		  stream_wrapper_restore("var");
	      }

	      ?>

	      The above example will output:

	      line1
	      line2
	      line3
	      string(18) "line1
	      line2
	      line3
	      "

SEE ALSO

       The "streamWrapper" prototype class, "Example class registered as stream wrapper", stream_wrapper_unregister(3), stream_wrapper_restore(3),
       stream_get_wrappers(3).

PHP Documentation Group 												STREAM_WRAPPER_REGISTER(3)