Using bcomipler to compile (encode) your PHP script (in FreeBSD)

eAccelerator 的 encoder 在 PHP 5.1 以後就無法運作了，使是最新的版本 0.9.5 也不行，因此如果您還想用 eAccelerator 的 encoder，乖乖待在 PHP 4.x or PHP 5.0 吧，相關資訊可參考之前的兩篇文章：

• eAccelerator 無法使用於 PHP 5.1
• 將 PHP 從 5.1 降至 5.0 (with portdowngrade)

根據 mailing list 上面作者最新的說法，短期內應該都還不會修復，甚至有可能還會放棄支援 encoder 部份，作者還推薦大家改用 bcompiler … orz
所以如果你跟我一樣必須要用 PHP 5.1 的話，就跟我一起來玩看看 bcompiler 囉

附帶一提，原本是要買 ionCube 公司開發的 PHP Encoder 的，這看來是目前編譯（加密）PHP 原始碼最好的選擇，價格也不算貴，而且花的是公司的錢，不過還是先試用看看 bcompiler 好了，真的不好用的話，再來買囉

以下的安裝與使用說明均以 FreeBSD 為範例，其他作業系統應該也差不多，請自己試看看吧

在正式安裝之前提醒你，bcompiler 會用到 bzip2 這個 extension，所以先安裝一下 php5-bz2：

# cd /usr/ports/archivers/php5-bz2
# make install clean

bcompiler 是一個收容於 PECL 的 PHP extension，您可以直接使用 pecl 這個命令來安裝，而 pecl 的使用方法與 pear 相同，因此你必須先安裝 pear :

# cd /usr/ports/devel/pear
# make install clean

pear 安裝好後，同時會有一個 pecl 命令可用 (/usr/locel/bin/pecl)，可用它來安裝 bcompiler

pecl install channel://pecl.php.net/bcompiler-0.8

不過呢，我發現直接執行 pecl 會發生錯誤（至少在 FreeBSD 下是如此）：

# pecl
Fatal error: Call to undefined function preg_match() in ...

問題出在 /usr/local/bin/pecl 這個 script 的最後一行：

exec $PHP -C -n -q $INCARG -d output_buffering=1 -d safe_mode=0 ...

這一行的 -n 這個選項代表不載入 php.ini 設定檔，因此 pcre.so 就沒有被載入，
然後你就看到上面的錯誤了，所以自己去改一下程式把 -n 拿掉吧….

拿掉之後，安裝程式應該就可以正常運作了了：

pecl install channel://pecl.php.net/bcompiler-0.8

安裝好後，記得要改設定把 bcompiler 這個 extension 載入

# echo "extension=bcompiler.so" >> /usr/local/etc/php/extensions.ini

bcompiler 全名是 PHP bytecode Compiler，詳細的使用方法可以參考 PHP 網站上的詳細說明： PHP bytecode Compiler: http://www.php.net/manual/en/ref.bcompiler.php

看不懂的話，bcompiler_write_file() 這個 function 的說明裡面有範例：

$fh = fopen("example.phb", "w");
bcompiler_write_header($fh);
bcompiler_write_file($fh, "example.php");
bcompiler_write_footer($fh);
fclose($fh);

為了易於使用，我寫了一個簡單的 script，使用方法如下：

BENCODER v1.3 - Encode your PHP script using bcompiler

Usage: bencoder [-f] [-q] -o FILE    file1.php
       bencoder [-f] [-q] -o OUTDIR  file1.php file2.php ...
       bencoder [-f] [-q] -o OUTDIR  -s SRCDIR  [-e SUFFIX] [-r] [-c] [-l]

  -o FILE   : the file name to write the encoded script
              (default to '-encoded.XXX' suffix)
  -o OUTDIR : the directory to write all encoded files

  -a SRCDIR
  -s SRCDIR : encode all files in this source directory

  -r        : encode directories recursively (no by default)
  -f        : force overwriting even if the target exists
  -e SUFFIX : encode the files with the SUFFIX extension only (default: php)
              (regular expression allowed, ex: "php|inc")
  -c        : copy files those shouldn't be encoded (no by default)
  -l        : follow symbolic link (no by default)
  -q        : do not print the file name while encoding or copying
  -b
  -bz2      : compress the encoded files with bz2 (needs bzip2-extension)

想用的人到 這邊 自己抓回去玩玩看吧

# wget http://bencoder.urdada.net/bencoder
# chmod 755 bencoder
# mv bencoder /usr/local/bin/

在把程式使用 bcompiler 編碼之後，執行的時候發覺 $_SERVER 以及 $_ENV 的變數都不見了，後來查了資料，才發現要把 auto_globals_jit 關掉 (Off) 才行，請直接修改您的 php.ini ：

; When enabled, the SERVER and ENV variables are created when they're first
; used (Just In Time) instead of when the script starts. If these variables
; are not used within a script, having this directive on will result in a
; performance gain. The PHP directives register_globals, register_long_arrays,
; and register_argc_argv must be disabled for this directive to have any affect.
auto_globals_jit = Off

上個月 PHP 5.1 正式發表了

昨天一時興起，把 PHP 5.0 利用 portupgrade 升級成 PHP 5.1，過程沒遇到什麼阻礙
安裝完後也覺得應該沒什麼問題，但是後來卻發現 eAccelerator 無法使用了

不管是 eAccelerator 0.9.3 或者 0.9.4-rc1 都一樣不能使用（連編譯都會發生錯誤）

根據 討論區 上面的說法，要修復這個問題似乎還需要一段時間

即使是將要發表的 0.9.4 版本，也不會支援 PHP 5.1

因此，有重度依賴 eAccelerator 的使用者，請乖乖先待在 PHP 4.4 或者 PHP 5.0 吧

Ref: eAccelerator – PHP 網頁加速及編碼