cvs: phpdoc /en/reference/bcompiler/functions bcompiler-write-exe-footer.xml

val Mon Jan 17 10:26:06 2005 EDT Modified files: /phpdoc/en/reference/bcompiler/functions bcompiler-write-exe-footer.xml Log: docs update http://cvs.php.net/diff.php/phpdoc/en/reference/bcompiler/functions/bcompiler-write-exe-footer.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc/en/reference/bcompiler/functions/bcompiler-write-exe-footer.xml diff -u phpdoc/en/reference/bcompiler/functions/bcompiler-write-exe-footer.xml:1.1 phpdoc/en/reference/bcompiler/functions/bcompiler-write-exe-footer.xml:1.2 --- phpdoc/en/reference/bcompiler/functions/bcompiler-write-exe-footer.xml:1.1 Fri Aug 13 10:26:44 2004 +++ phpdoc/en/reference/bcompiler/functions/bcompiler-write-exe-footer.xml Mon Jan 17 10:26:06 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <!-- splitted from ./en/functions/bcompiler.xml, last change in rev 1.5 --> <refentry id="function.bcompiler-write-exe-footer"> <refnamediv> @@ -20,36 +20,41 @@ <para> <simplelist> <member> - The Executable code (eg. a compiled C program that can initiate call - the PHP bcompiler) + 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) </member> - <member>The Bzip encoded Bytecodes</member> - <member>The bcompiler exe footer</member> + <member>The Bytecodes (uncompressed only for the moment)</member> + <member>The bcompiler EXE footer</member> </simplelist> - The <parameter>startpos</parameter> is the position of in the file at - which the Bzip encoded bytecodes start, and can be obtained using - ftell($fh). + The <parameter>startpos</parameter> is the file position at + which the Bytecodes start, and can be obtained using ftell($fh). + </para> + <para> + To obtain a suitable stub you can compile php_embed-based stub phpe.c + located in the examples/embed directory on bcompiler's CVS. </para> <example> <title><function>bcompiler_write_footer</function> example</title> <programlisting role="php"> <![CDATA[ <?php -$fh = fopen("/tmp/example.exe","w"); -$size = filesize("/tmp/base.exe"); -$fr = fopen("/tmp/base.exe","r"); -fwrite($fh,fread($fr,$size),$size); +/* 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); -/* write bytecodes compressed */ -$fz = bzopen($fh,"w"); -bcompiler_write_header($fz); -bcompiler_write_class($fz,"DB"); -bcompiler_write_class($fz,"DB_common"); -bcompiler_write_footer($fz); -/* write footer exe uncompressed */ -bcompiler_write_exe_footer($fh,$startpos); +/* 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); - ?> ]]> </programlisting>