Prerequisite packages are:
- PHP >= 5.3 development resources
- GCC compiler (Linux/Solaris)
- Git (if not already installed in your system - unless you download the package from GitHub and upload it on your server via FTP/SFTP)
Specific packages for common platforms:
#Ubuntu
sudo apt-get install php5-dev libpcre3-dev gcc make php5-mysql
# Suse
sudo yast -i gcc make autoconf2.13 php5-devel php5-pear php5-mysql
# CentOS/RedHat/Fedora
sudo yum install php-devel pcre-devel gcc make
# Solaris
pkg install gcc-45 php-53 apache-php53
Creating the extension:
git clone --depth=1 git://github.com/phalcon/cphalcon.git
cd cphalcon/build
sudo ./install
Add extension to your php configuration:
# Suse: Add this line in your php.ini
extension=phalcon.so
# Centos/RedHat/Fedora: Add a file called phalcon.ini in /etc/php.d/ with this content:
extension=phalcon.so
# Ubuntu/Debian: Add a file called 30-phalcon.ini in /etc/php5/conf.d/ with this content:
extension=phalcon.so
# Debian with php5-fpm: Add a file called 30-phalcon.ini in /etc/php5/fpm/conf.d/30-phalcon.ini with this content:
extension=phalcon.so
安装phalcon之前必须安装php5-dev、libpcre3-dev、gcc、make、php5-mysql这几个库，用于编译phalcon以及phalcon的扩展依赖。
然后，从github上clone代码到本地，进入编译目录bulid，然后开始安装phalcon的扩展。下面就是安装的细节。
$ sudo ./install
find . -name \*.gcno -o -name \*.gcda | xargs rm -ffind . -name \*.lo -o -name \*.o | xargs rm -f
find . -name \*.la -o -name \*.a | xargs rm -f
find . -name \*.so | xargs rm -f
find . -name .libs -a -type d|xargs rm -rf
rm -f libphp.la modules/* libs/*
Cleaning..
Configuring for:
PHP Api Version: 20121113
Zend Module Api No: 20121212
Zend Extension Api No: 220121212
checking for grep that handles long lines and -e... /bin/grep
checking for egrep... /bin/grep -E
checking for a sed that does not truncate output... /bin/sed
checking whether the C compiler works... yes
checking for C compiler default output file name... a.out
checking for suffix of executables...
checking whether we are cross compiling... no
checking for suffix of object files... o
checking whether we are using the GNU C compiler... yes
checking whether gcc accepts -g... yes
checking for gcc option to accept ISO C89... none needed
checking how to run the C preprocessor... gcc -E
checking for icc... no
checking for suncc... no
checking whether gcc and cc understand -c and -o together... yes
checking for system library directory... lib
checking if compiler supports -R... no
checking if compiler supports -Wl,-rpath,... yes
checking build system type... i686-pc-linux-gnu
checking host system type... i686-pc-linux-gnu
checking target system type... i686-pc-linux-gnu
checking for PHP prefix... /usr
checking for PHP includes... -I/usr/include/php5 -I/usr/include/php5/main -I/usr/include/php5/TSRM -I/usr/include/php5/Zend -I/usr/include/php5/ext -I/usr/include/php5/ext/date/lib -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64
checking for PHP extension directory... /usr/lib/php5/20121212+lfs
checking for PHP installed headers prefix... /usr/include/php5
checking if debug is enabled... no
checking if zts is enabled... no
checking for re2c... no
configure: WARNING: You will need re2c 0.13.4 or later if you want to regenerate PHP parsers.
checking for gawk... no
checking for nawk... nawk
checking if nawk is broken... no
checking whether to enable phalcon... yes, shared
checking whether HAVE_BUNDLED_PCRE is declared... no
checking whether HAVE_JSON is declared... no
checking how to print strings... printf
checking for a sed that does not truncate output... (cached) /bin/sed
checking for fgrep... /bin/grep -F
checking for ld used by gcc... /usr/bin/ld
checking if the linker (/usr/bin/ld) is GNU ld... yes
checking for BSD- or MS-compatible name lister (nm)... /usr/bin/nm -B
checking the name lister (/usr/bin/nm -B) interface... BSD nm
checking whether ln -s works... yes
checking the maximum length of command line arguments... 1572864
checking whether the shell understands some XSI constructs... yes
checking whether the shell understands "+="... yes
checking how to convert i686-pc-linux-gnu file names to i686-pc-linux-gnu format... func_convert_file_noop
checking how to convert i686-pc-linux-gnu file names to toolchain format... func_convert_file_noop
checking for /usr/bin/ld option to reload object files... -r
checking for objdump... objdump
checking how to recognize dependent libraries... pass_all
checking for dlltool... no
checking how to associate runtime and link libraries... printf %s\n
checking for ar... ar
checking for archiver @FILE support... @
checking for strip... strip
checking for ranlib... ranlib
checking for gawk... (cached) nawk
checking command to parse /usr/bin/nm -B output from gcc object... ok
checking for sysroot... no
checking for mt... mt
checking if mt is a manifest tool... no
checking for ANSI C header files... yes
checking for sys/types.h... yes
checking for sys/stat.h... yes
checking for stdlib.h... yes
checking for string.h... yes
checking for memory.h... yes
checking for strings.h... yes
checking for inttypes.h... yes
checking for stdint.h... yes
checking for unistd.h... yes
checking for dlfcn.h... yes
checking for objdir... .libs
checking if gcc supports -fno-rtti -fno-exceptions... no
checking for gcc option to produce PIC... -fPIC -DPIC
checking if gcc PIC flag -fPIC -DPIC works... yes
checking if gcc static flag -static works... yes
checking if gcc supports -c -o file.o... yes
checking if gcc supports -c -o file.o... (cached) yes
checking whether the gcc linker (/usr/bin/ld) supports shared libraries... yes
checking whether -lc should be explicitly linked in... no
checking dynamic linker characteristics... GNU/Linux ld.so
checking how to hardcode library paths into programs... immediate
checking whether stripping libraries is possible... yes
checking if libtool supports shared libraries... yes
checking whether to build shared libraries... yes
checking whether to build static libraries... no
configure: creating ./config.status
config.status: creating config.h
config.status: executing libtool commands
/bin/bash /var/www/phalcon/build/32bits/libtool --mode=compile gcc -I. -I/var/www/phalcon/build/32bits -DPHP_ATOM_INC -I/var/www/phalcon/build/32bits/include -I/var/www/phalcon/build/32bits/main -I/var/www/phalcon/build/32bits -I/usr/include/php5 -I/usr/include/php5/main -I/usr/include/php5/TSRM -I/usr/include/php5/Zend -I/usr/include/php5/ext -I/usr/include/php5/ext/date/lib -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -DPHALCON_RELEASE -DHAVE_CONFIG_H -march=native -mtune=native -O2 -fomit-frame-pointer -fvisibility=hidden -c /var/www/phalcon/build/32bits/phalcon.zep.c -o phalcon.lo
libtool: compile: gcc -I. -I/var/www/phalcon/build/32bits -DPHP_ATOM_INC -I/var/www/phalcon/build/32bits/include -I/var/www/phalcon/build/32bits/main -I/var/www/phalcon/build/32bits -I/usr/include/php5 -I/usr/include/php5/main -I/usr/include/php5/TSRM -I/usr/include/php5/Zend -I/usr/include/php5/ext -I/usr/include/php5/ext/date/lib -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -DPHALCON_RELEASE -DHAVE_CONFIG_H -march=native -mtune=native -O2 -fomit-frame-pointer -fvisibility=hidden -c /var/www/phalcon/build/32bits/phalcon.zep.c -fPIC -DPIC -o .libs/phalcon.o
/bin/bash /var/www/phalcon/build/32bits/libtool --mode=link gcc -DPHP_ATOM_INC -I/var/www/phalcon/build/32bits/include -I/var/www/phalcon/build/32bits/main -I/var/www/phalcon/build/32bits -I/usr/include/php5 -I/usr/include/php5/main -I/usr/include/php5/TSRM -I/usr/include/php5/Zend -I/usr/include/php5/ext -I/usr/include/php5/ext/date/lib -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -DPHALCON_RELEASE -DHAVE_CONFIG_H -march=native -mtune=native -O2 -fomit-frame-pointer -fvisibility=hidden -o phalcon.la -export-dynamic -avoid-version -prefer-pic -module -rpath /var/www/phalcon/build/32bits/modules phalcon.lo
libtool: link: gcc -shared -fPIC -DPIC .libs/phalcon.o -march=native -mtune=native -O2 -Wl,-soname -Wl,phalcon.so -o .libs/phalcon.so
libtool: link: ( cd ".libs" && rm -f "phalcon.la" && ln -s "../phalcon.la" "phalcon.la" )
/bin/bash /var/www/phalcon/build/32bits/libtool --mode=install cp ./phalcon.la /var/www/phalcon/build/32bits/modules
libtool: install: cp ./.libs/phalcon.so /var/www/phalcon/build/32bits/modules/phalcon.so
libtool: install: cp ./.libs/phalcon.lai /var/www/phalcon/build/32bits/modules/phalcon.la
libtool: finish: PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/sbin" ldconfig -n /var/www/phalcon/build/32bits/modules
----------------------------------------------------------------------
Libraries have been installed in:
/var/www/phalcon/build/32bits/modules
If you ever happen to want to link against installed libraries
in a given directory, LIBDIR, you must either use libtool, and
specify the full pathname of the library, or use the `-LLIBDIR'
flag during linking and do at least one of the following:
- add LIBDIR to the `LD_LIBRARY_PATH' environment variable
during execution
- add LIBDIR to the `LD_RUN_PATH' environment variable
during linking
- use the `-Wl,-rpath -Wl,LIBDIR' linker flag
- have your system administrator add LIBDIR to `/etc/ld.so.conf'
See any operating system documentation about shared libraries for
more information, such as the ld(1) and ld.so(8) manual pages.
----------------------------------------------------------------------
Build complete.
Don't forget to run 'make test'.
Installing shared extensions: /usr/lib/php5/20121212+lfs/
Installing header files: /usr/include/php5/
Thanks for compiling Phalcon!
Build succeed: Please restart your web server to complete the installation
从上面我们可以得知上那个信息：
1、安装目录以及安装的是多少位的：
Libraries have been installed in:
/var/www/phalcon/build/32bits/modules
本次安装在 /var/www/phalcon/下面了，是32位。
2、扩展文件在哪里：
Installing shared extensions: /usr/lib/php5/20121212+lfs/
这个路径下放着php所有的扩展包文件（.so）
3、header文件在哪里：
Installing header files: /usr/include/php5/
该路径下放着ext 、include、 main 、 sapi 、TSRM、 Zend等接口。
最后，根据上面的信息，我们还必须将这个扩展文件配置到php的环境中，如果你希望配置到php.ini文件，就打开 /etc/php5/fpm/php.ini文件，将
extension=phalcon.so添加到该文件即可，重启php5-fpm.
这里我不推荐直接编辑到php.ini文件，可以在/etc/php5/mods-available下面城建一个phalcon.ini文件，内容为extension=phalcon.so，然后建立软链接。
:/etc/php5/cli/conf.d# ln -s ../../mods-available/phalcon.ini 20-phalcon.ini
:/etc/php5/fpm/conf.d# ln -s ../../mods-available/phalcon.ini 20-phalcon.ini
注意，路径已经在php5的安装路径下了。
