VIII. Compilador Bytecode de PHP

IntroducciÃ³n

Aviso

Esta extensiÃ³n es EXPERIMENTAL. Esto significa que el comportamiento de esta extensiÃ³n, los nombre de sus funciones y en definitiva TODO lo documentado sobre esta extensiÃ³n, puede cambiar en una futura versiÃ³n de PHP SIN AVISO. La advertencia queda hecha, y utilizar esta extensiÃ³n queda bajo su propia responsabilidad.

Bcompiler fue escrito por varias razones:

Para codificar un script entero en una aplicaciÃ³n propietaria escrita en PHP.

Para codificar algunas clases y/o funciones en una aplicaciÃ³n propietaria escrita en PHP.

Para permitir la producciÃ³n de aplicaciones PHP-GTK que puedan ser usadas del lado del cliente, sin necesidad de un php.exe.

Para hacer viable el estudio de un convertidor PHP al lenguaje de programaciÃ³n C.

La primera de estas metas se pueden alcanzar usando las funciones bcompiler_write_header(), bcompiler_write_file() y bcompiler_write_footer(). Las funciones de bytecode pueden estar escritas tanto descomprimidas, como en texto plano. Para usar el bytecode generado, simplemente puede incluirlo con sentencias include o require.

La segunda de estas metas se pueden alcanzar usando las funciones bcompiler_write_header(), bcompiler_write_class(), bcompiler_write_footer(), bcompiler_read(), y bcompiler_load(). Los archivos bytecode pueden estar escritos tanto descomprimidos, como en texto plano. La funciÃ³n bcompiler_load() lee un archivo bytecode comprimido con bzip, el cual suele ser 1/3 del tamaÃ±o original del archivo.

Para crear archivos del tipo exe, bcompiler tiene que ser usado con un archivo sapi modificado o una versiÃ³n de PHP que haya sido compilada como una librerÃa compartida. En este escenario, bcompiler lee el bytecode comprimido desde el final del archivo exe.

bcompiler puede mejorar su desempeÃ±o cerca del 30% cuando sÃ³lo se usa con bytecodes descomprimidos. Pero tenga presente que un bytecode descomprimido puede ser hasta 5 veces mÃ¡s grande que el cÃ³digo fuente original. Usando la compresiÃ³n bytecode puede ahorrarle espacio, pero la descompresiÃ³n requiere mucho mÃ¡s tiempo que analizar un cÃ³digo. AdemÃ¡s, bcompiler no lleva a cabo alguna optimizaciÃ³n bytecode; esto pudiera ser agregado en el futuro...

En cuanto a la protecciÃ³n del cÃ³digo, es seguro decir que serÃa imposible recrear el cÃ³digo fuente exacto desde el cual se construyÃ³, y sin la compaÃ±Ãa de comentarios en el cÃ³digo fuente. Efectivamente serÃa inÃºtil usar los bytecodes de bcompiler para recrear y modificar una clase. Sin embargo, es posible recuperar informaciÃ³n desde un archivo bytecode de bcompiler - asÃ que no coloque sus contraseÃ±as o cualquier otra cosa privada en Ã©l.

InstalaciÃ³n

Nota de instalaciÃ³n corta:

NecesitarÃ¡ tener al menos PHP 4.3 para que la compresiÃ³n funcione.
Para instalar en PHP 4.3 o mayor, escriba en el intÃ©rprete de comandos de UNIX pear install bcompiler.
Para instalar en Windows, hasta que estÃ© listo el mecanismo para el paquete de distribuciÃ³n binario, por favor busque los paquetes pre-construidos en la lista de correo pear-general. (o envÃeles un correo electrÃ³nico si no pudo hallar una referencia).
Para instalar en versiones anteriores, necesita hacer algunos cambios ligeros al paquete.
extraer el archivo bcompiler.tgz en el directorio php4/ext. (ObtÃ©ngalo directamente desde PECL http://pecl.php.net/get/bcompiler).
Si el nombre del nuevo directorio no es similar a bcompiler-0.x, deberÃa cambiarle el nombre a bcompiler (a menos que sÃ³lo desee construirlo como un mÃ³dulo PHP contenido desde de sÃ mismo).
Si estÃ¡ usando versiones anteriores a PHP 4.3, entonces necesitarÃ¡ copiar el archivo Makefile.in.old a Makefile.in, y config.m4.old a config.m4.
ejecute phpize en ext/bcompiler.
ejecute ./buildconf en php4.
ejecute configure con --enable-bcompiler (y otras opciones que use).
make; make install
eso es todo.

InformaciÃ³n de contacto

Si tiene comentarios, soluciones a fallos, mejoras o quiere ayudar a desarrollar esta bestia, puede enviarme un correo-e a alan_k@php.net. Cualquier ayuda es bienvenida.

Tabla de contenidos
bcompiler_load_exe -- Lee y crea clases desde un archivo exe de bcompiler
bcompiler_load -- Lee y crea clases desde un archivo comprimido bz
bcompiler_parse_class -- Lee los bytecodes de una clase y genera una llamada a una funciÃ³n definida por el usuario
bcompiler_read -- Lee y crea clases desde un gestor de archivo
bcompiler_write_class -- Escribe una clase determinada como bytecodes
bcompiler_write_constant -- Lee una constante definida como bytecodes
bcompiler_write_exe_footer -- Writes the start pos, and sig to the end of a exe type file
bcompiler_write_file -- Writes a php source file as bytecodes
bcompiler_write_footer -- Writes the single character \x00 to indicate End of compiled data
bcompiler_write_function -- Writes an defined function as bytecodes
bcompiler_write_functions_from_file -- Writes all functions defined in a file as bytecodes
bcompiler_write_header -- Writes the bcompiler header

add a note User Contributed Notes
Compilador Bytecode de PHP

cdsheen+bencoder at gmail dot com
25-Jul-2006 05:58


Here's a script to act as a front-end for bcompiler, which may be very similar to the eA ones:



http://bbs.giga.net.tw/bencoder.php



BENCODER v1.1 - Encode your PHP script using bcompiler



Usage: bencoder [-f] -o FILE    file1.php

       bencoder [-f] -o OUTDIR  file1.php file2.php ...

       bencoder [-f] -o OUTDIR  -a SRCDIR  [-s SUFFIX] [-c] [-r]



  -f        : force overwriting even if the target exists

  -o FILE   : the file name to write the encoded script

              (default to '-encoded.php' suffix)

  -o OUTDIR : the directory to write all encoded files



  -a SRCDIR : encode all files in this source directory

  -s SUFFIX : encode the files with the SUFFIX extension only (default: php)

  -c        : copy files those shouldn't be encoded (no by default)

shannah at sfu dot ca
23-May-2006 03:44


>the special constant __FILE__ cannot be handled correctly by bcompiler

> (it will always contain the name of the original file that was compiled).



I would think that this is the preferred behavior anyways since the compilation should be independent from the source code.  I would want to be able to compile any part of my source code without having to worry if any constants will change as a result of it.  Hence it is better for __FILE__ to contain the name of the original file that was compiled.

arplynn at gmail dot com
28-Apr-2006 08:49


PHP seems to choke on trying to compile PHP5 classes with the private, protected or public modifiers. Additionally, when including files with properly compiled classes on PHP5, it works fine but when php tries to exit it throws a segmentation fault.



It's just not a great idea to use bcompiler for anything other than functions on PHP5, at least for now.

tda at example dot com
07-Feb-2006 05:50


Creating a function after checking if a function exists using function_exists will result in a "Zero Sized Reply" error.



this does NOT work any longer:

if (!function_exists("file_get_contents")) {

        function file_get_contents($filename, $use_include_path = 0)

        { ...define your own function here... }

}



Apache returns: "Zero Sized Reply" after compilation.

alan at akbkhome dot com
27-Oct-2005 07:32


Note: 

the special constant __FILE__ cannot be handled correctly by bcompiler (it will always contain the name of the original file that was compiled). There is no known way around this, as it is converted to a string by the Zend engine.

val at php dot net
07-Feb-2005 12:08


Compiled win32 DLLs for PHP 5.0 and 5.1 are also available now at http://snaps.php.net/win32/PECL_5_0/php_bcompiler.dll and http://snaps.php.net/win32/PECL_UNSTABLE/php_bcompiler.dll

dscharrer at gmail dot com
05-Jan-2005 04:37


You can find windows stable at http://snaps.php.net/win32/PECL_STABLE/php_bcompiler.dll

add a note

MANUAL DE PHP

windsurf mercedes camper

VIII. Compilador Bytecode de PHP

IntroducciÃ³n

InstalaciÃ³n

InformaciÃ³n de contacto