<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>Compilador de PHP bytecode</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="Manual do PHP"
HREF="index.html"><LINK
REL="UP"
TITLE="Referência das Funções"
HREF="funcref.html"><LINK
REL="PREVIOUS"
TITLE="bcsub"
HREF="function.bcsub.html"><LINK
REL="NEXT"
TITLE="bcompiler_load_exe"
HREF="function.bcompiler-load-exe.html"><META
HTTP-EQUIV="Content-type"
CONTENT="text/html; charset=UTF-8"></HEAD
><BODY
CLASS="reference"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>Manual do PHP</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="function.bcsub.html"
ACCESSKEY="P"
>Anterior</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.bcompiler-load-exe.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="reference"
><A
NAME="ref.bcompiler"
></A
><DIV
CLASS="TITLEPAGE"
><H1
CLASS="title"
>VIII. Compilador de PHP bytecode</H1
><DIV
CLASS="PARTINTRO"
><A
NAME="AEN13827"
></A
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="bcompiler.intro"
>Introdução</A
></H1
><DIV
CLASS="warning"
><P
></P
><TABLE
CLASS="warning"
BORDER="1"
WIDTH="100%"
><TR
><TD
ALIGN="CENTER"
><B
>Atenção</B
></TD
></TR
><TR
><TD
ALIGN="LEFT"
><P
>Este módulo é
<SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>EXPERIMENTAL</I
></SPAN
>. Isso quer dizer que o comportamento neste módulo ---
incluindo suas funções e seus nomes, e TUDO mais que está documentado
sobre esse módulo --- poderá mudar em futuras versões do PHP, SEM QUALQUER NOTIFICAÇÃO.
Esteja avisado, e use este módulo por sua própria conta e risco.</P
></TD
></TR
></TABLE
></DIV
><P
> Bcompiler foi escrito por várias razões:
<P
></P
><TABLE
BORDER="0"
><TBODY
><TR
><TD
>Para codificar script em uma aplicação PHP proprietária</TD
></TR
><TR
><TD
>Para codificar algumas classes e/ou funções em uma aplicação PHP proprietária</TD
></TR
><TR
><TD
> Para disponibilizar a produção de aplicações php-gtk que poderiam ser usadas em
clientes desktops, sem precisa do php.exe.
</TD
></TR
><TR
><TD
>Para estudar a possibilidade de fazer um conversor de PHP para C</TD
></TR
></TBODY
></TABLE
><P
></P
>
O primeiro desses objetivos é alcançado usando as funções
<A
HREF="function.bcompiler-write-header.html"
><B
CLASS="function"
>bcompiler_write_header()</B
></A
>,
<A
HREF="function.bcompiler-write-file.html"
><B
CLASS="function"
>bcompiler_write_file()</B
></A
> e
<A
HREF="function.bcompiler-write-footer.html"
><B
CLASS="function"
>bcompiler_write_footer()</B
></A
>
Os arquivos bytecode podem ser
escritos ou como não-compactados ou planos.
Para usar o bytecode gerado, você pode simplesmente incluí-lo
com instruções include ou require.
</P
><P
> O segundo desses objetivos é alcançado usando as funções
<A
HREF="function.bcompiler-write-header.html"
><B
CLASS="function"
>bcompiler_write_header()</B
></A
>,
<A
HREF="function.bcompiler-write-class.html"
><B
CLASS="function"
>bcompiler_write_class()</B
></A
>,
<A
HREF="function.bcompiler-write-footer.html"
><B
CLASS="function"
>bcompiler_write_footer()</B
></A
>,
<A
HREF="function.bcompiler-read.html"
><B
CLASS="function"
>bcompiler_read()</B
></A
>,
e <A
HREF="function.bcompiler-load.html"
><B
CLASS="function"
>bcompiler_load()</B
></A
>. Os arquivos bytecode podem
ser escritos ou como não-compactados ou planos. O
<A
HREF="function.bcompiler-load.html"
><B
CLASS="function"
>bcompiler_load()</B
></A
> lê um arquivo compactador bzip que contem bytecodes,
o que tende a ser 1/3 do tamanho original do arquivo.
</P
><P
> Para criar arquivos do tipo EXE, bcompiler tem que ser usado com um arquivo de SAPI
modificado ou uma versão do PHP que tenha sido compilada como uma biblioteca compartilhada. Nesse
cenário, bcompiler ler o bytecode compactador do fim do arquivo
executável.
</P
><P
> bcompiler pode aumentar performance em volta de 30% quando usado com bytecodes
não-compactados apenas. Mas lembre-se que bytecode não-compactado pode ser até
5 vezes maior que o código-fonte original. Usar compactação de bytecode
pode evitar gasto de espaço, mas descompactar requer muito mais
tempo do que avaliar um fonte. bcompiler também não faz nenhuma otimização
de bytecode, isso pode ser acrescentado no futuro...
</P
><P
> Em termos de proteção de código, é seguro dizer que é seria impossível
recriar o código-fonte exato do qual ele foi criado, e sem os
comentários acompanhando o código-font. Seria efetivamente inútil usar
o bcompiler para recriar ou modificar uma classe. No entanto, é
possível recuperar dados de um arquivo bytecode compactado - então não ponha
suas senhas pessoais ou coisa do tipo nele.
</P
></DIV
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="bcompiler.installation"
>Instalação</A
></H1
><P
> Nota curta de instalação:
<P
></P
><UL
><LI
><P
>Você precisa de pelo menos o PHP 4.3. para a compressão funcionar</P
></LI
><LI
><P
> Para instalar no PHP 4.3 e superior no shell do unix digite
<B
CLASS="command"
>pear install bcompiler</B
>
</P
></LI
><LI
><P
> Para instalar no Windows, até o mecanismo de distribuíção de pacotes
binários estiver completo, favor procure os arquivos da lista de discussão
pear-general pelos pacotes pré-compilados. (ou mande um e-mail para a lista de
você não conseguir achar uma referência).
</P
></LI
><LI
><P
> Para instalar em versões mais antigas, você precisa fazer algumas pequenas alterações
ao binário compilado.
</P
></LI
><LI
><P
> untar o arquivo <TT
CLASS="filename"
>bcompiler.tgz</TT
> no diretório
<TT
CLASS="filename"
>php4/ext</TT
>.(Pegue o diretamente da
PECL <A
HREF="http://pecl.php.net/get/bcompiler"
TARGET="_top"
>http://pecl.php.net/get/bcompiler</A
>)
</P
></LI
><LI
><P
> Se o novo diretório for chamado algo como bcompiler-0.x, então você
deve renomeá-lo para bcompiler (exceto se você só quiser compilá-lo como
um módulo do php auto-contido).
</P
></LI
><LI
><P
> Se você estiver usando versões anteriores ao PHP 4.3, você terá que copiar os arquivos
<TT
CLASS="filename"
>Makefile.in.old</TT
> para <TT
CLASS="filename"
>Makefile.in</TT
>
e <TT
CLASS="filename"
>config.m4.old</TT
> para <TT
CLASS="filename"
>config.m4</TT
>.
</P
></LI
><LI
><P
> execute <B
CLASS="command"
>phpize</B
> no diretório <TT
CLASS="filename"
> ext/bcompiler</TT
>
</P
></LI
><LI
><P
> execute <B
CLASS="command"
>./buildconf</B
> no diretório <TT
CLASS="filename"
>php4
</TT
>
</P
></LI
><LI
><P
> execute o script <B
CLASS="command"
>configure</B
> com a opção <CODE
CLASS="option"
> --enable-bcompiler</CODE
> e as suas outras opções
</P
></LI
><LI
><P
> <B
CLASS="command"
>make; make install</B
>
</P
></LI
><LI
><P
>E por hoje é só pessoal.</P
></LI
></UL
>
</P
></DIV
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="bcompiler.contact"
>Informação para contatos</A
></H1
><P
> Se você tiver comentários, resoluções de bugs, melhoramentos ou quer ajudar
a desenvolver essa fera, você pode me enviar um e-mail para <A
HREF="mailto:alan_k@php.net"
TARGET="_top"
>alan_k@php.net</A
>. Qualquer ajuda é muito
bem-vinda.
</P
></DIV
></DIV
><DIV
CLASS="TOC"
><DL
><DT
><B
>Índice</B
></DT
><DT
><A
HREF="function.bcompiler-load-exe.html"
>bcompiler_load_exe</A
> -- Lê e cria classes a partir de um arquivo exe do bcompiler</DT
><DT
><A
HREF="function.bcompiler-load.html"
>bcompiler_load</A
> -- Lê e cria classes a partir de um arquivo compactado pelo bzip</DT
><DT
><A
HREF="function.bcompiler-parse-class.html"
>bcompiler_parse_class</A
> -- Lê o bytecode de uma classe e chama para uma função do usuário</DT
><DT
><A
HREF="function.bcompiler-read.html"
>bcompiler_read</A
> -- Lê e cria uma classe a partir de um handle de arquivo</DT
><DT
><A
HREF="function.bcompiler-write-class.html"
>bcompiler_write_class</A
> -- Escreve uma classe definida como bytecode</DT
><DT
><A
HREF="function.bcompiler-write-constant.html"
>bcompiler_write_constant</A
> -- Escreve uma constante definida como bytecodes</DT
><DT
><A
HREF="function.bcompiler-write-exe-footer.html"
>bcompiler_write_exe_footer</A
> -- Escreve na posição de início e continua até o fim do arquivo de tipo EXE</DT
><DT
><A
HREF="function.bcompiler-write-file.html"
>bcompile_write_file</A
> -- Escreve um arquivo-fonte do PHP como bytecodes</DT
><DT
><A
HREF="function.bcompiler-write-footer.html"
>bcompiler_write_footer</A
> -- Escreve o caracter \x00 para indicar o Fim dos dados compilados</DT
><DT
><A
HREF="function.bcompiler-write-function.html"
>bcompiler_write_function</A
> -- Escreve uma função definida como bytecodes</DT
><DT
><A
HREF="function.bcompiler-write-functions-from-file.html"
>bcompiler_write_functions_from_file</A
> -- Escreve todas as funções definidas em um arquivo como bytecodes</DT
><DT
><A
HREF="function.bcompiler-write-header.html"
>bcompiler_write_header</A
> -- Escreve o cabeçalho do bcompiler</DT
><DT
><A
HREF="function.bcompiler-write-included-filename.html"
>bcompiler_write_included_filename</A
> -- Writes an included file as bytecodes</DT
></DL
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="function.bcsub.html"
ACCESSKEY="P"
>Anterior</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Principal</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="function.bcompiler-load-exe.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>bcsub</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="funcref.html"
ACCESSKEY="U"
>Acima</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>bcompiler_load_exe</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
