Changes between Initial Version and Version 1 of ZooKernel/Embed/PHP

Timestamp:

Aug 21, 2009, 2:08:44 PM (15 years ago)

Author:

djay

Comment:

Early beta version of this page :)

ZooKernel/Embed/PHP

@@ +1 @@
+= ZooKernel/Embed/PHP description page =
+
+You get lot of allready existing php code and need to use this code with the less modifications possible ? Then this page was made for you :)
+
+On this page you will find everything you have to know to be able to implement your services directly in PHP.
+
+== Configure and Install PHP Embed library ==
+
+First thing you have to get is a fresh and independant php library installed on your system.
+
+Here is a sample configure call to ensure to be able to use the PHP support on your platform :
+
+{{{
+#!sh
+./configure' '--prefix=/usr/lib/php5.2.10' \
+             '--host=i686-pc-linux-gnu'\
+             '--mandir=/usr/lib/php5.2.10/man'\
+             '--infodir=/usr/lib/php5.2.10/info'\
+             '--sysconfdir=/etc'\
+             '--cache-file=./config.cache'\
+             '--with-pcre-regex=/usr'\
+             '--enable-maintainer-zts'\
+             '--with-config-file-path=/etc/php/apache2-php5.2.10'\
+             '--with-config-file-scan-dir=/etc/php/apache2-php5.2.10/ext-active'\
+             '--without-pear'\
+             '--disable-bcmath'\
+             '--with-bz2'\
+             '--disable-calendar'\
+             '--with-curl'\
+             '--without-curlwrappers'\
+             '--disable-dbase'\
+             '--enable-exif'\
+             '--without-fbsql'\
+             '--without-fdftk'\
+             '--disable-filter'\
+             '--enable-ftp'\
+             '--with-gettext'\
+             '--without-gmp'\
+             '--disable-hash'\
+             '--without-kerberos'\
+             '--enable-mbstring'\
+             '--with-mcrypt'\
+             '--without-mhash'\
+             '--without-msql'\
+             '--without-mssql'\
+             '--with-ncurses'\
+             '--with-openssl'\
+             '--with-openssl-dir=/usr'\
+             '--disable-pcntl'\
+             '--disable-pdo'\
+             '--with-pgsql'\
+             '--disable-posix'\
+             '--without-pspell'\
+             '--without-recode'\
+             '--disable-shmop'\
+             '--without-snmp'\
+             '--enable-soap'\
+             '--enable-sockets'\
+             '--without-sybase'\
+             '--without-sybase-ct'\
+             '--disable-sysvmsg'\
+             '--disable-sysvsem'\
+             '--disable-sysvshm'\
+             '--without-tidy'\
+             '--enable-wddx'\
+             '--with-xmlrpc'\
+             '--with-xsl'\
+             '--enable-zip'\
+             '--with-zlib'\
+             '--disable-debug'\
+             '--enable-dba'\
+             '--without-cdb'\
+             '--with-db4'\
+             '--disable-flatfile'\
+             '--with-gdbm'\
+             '--disable-inifile'\
+             '--without-qdbm'\
+             '--with-freetype-dir=/usr'\
+             '--with-t1lib=/usr'\
+             '--disable-gd-jis-conv'\
+             '--with-jpeg-dir=/usr'\
+             '--with-png-dir=/usr'\
+             '--with-xpm-dir=/usr'\
+             '--with-gd'\
+             '--without-mysqli'\
+             '--with-readline'\
+             '--without-libedit'\
+             '--without-mm'\
+             '--with-sqlite=/usr'\
+             '--enable-sqlite-utf8'\
+             '--with-pic'\
+             '--enable-embed'
+}}}
+
+As you could seen above, there are lot of configure options used. Lots options are not required. Nevertheless, two configure options are required to get a full PHP support in your ZooKernel : '''--enable-embed''' and ''''--enable-maintainer-zts'''. You should also note that the php library will be installed in the {{{/usr/lib/php5.2.10}}} directory, as we need a well sperated installation of php to not interfere with your possibly allready installed PHP version.
+
+Once your configure script end with success, you're now ready to compile and install the php embed library, using the following commands :
+
+{{{
+#!sh
+make 
+make test
+make install
+}}}
+
+== Simple PHP scripts loader ==
+
+Here is the simplest code snipest ever shared. It was provided here as a sample to load and run php script from a C program :
+
+{{{
+#!c
+/**
+  * Filename : test_phpembed.c
+  */ 
+#include <stdio.h>
+#include <sapi/embed/php_embed.h>
+#include <zend_stream.h>
+
+int main(int argc,char*argv[]){
+  zend_file_handle script;
+  if(argc<=1){
+    fprintf(stderr,"Usage: embed filename.php <arguments>\n");
+    return -1;
+  }
+
+  script.type=ZEND_HANDLE_FP;
+  script.filename=argv[1];
+  script.opened_path=NULL;
+  script.free_filename=0;
+  if(!(script.handle.fp=fopen(script.filename,"rb"))){
+    fprintf(stderr,"Unable to open : %s\n",argv[1]);
+    return -1;
+  }
+  
+  argc--;
+  argv++;
+
+  PHP_EMBED_START_BLOCK(argc,argv)
+    php_execute_script(&script TSRMLS_CC);
+  PHP_EMBED_END_BLOCK()
+
+  return 0;
+}
+}}}
+
+== Compile the code snipest == 
+
+Now that you get the file test_phpembed.c, you have to compile it before trying to run. You could use the following commands to  achieve that compilation process :
+
+{{{
+#!sh
+gcc -o test_phpembeded.o test_phpembeded.c -c $(/usr/lib/php5.2.10/bin/php-config --includes)
+gcc -o test_phpembeded test_phpembeded.o $(/usr/lib/php5.2.10/bin/php-config --ldflags) $(/usr/lib/php5.2.10/bin/php-config --libs) -L /usr/lib/php5.2.10/lib/ -lphp5
+}}}
+
+You should succeed runing the command above, else open a ticket please to inform us that there is issue following those instructions :)
+
+== Run the code snipest ==
+
+The last step to get your PHP embeded in yoru C program is to write a small php piece a .... code :)
+
+
+{{{
+#!sh
+cat > info.php <<EOF
+<? phpinfo(); ?>
+EOF
+}}}
+
+Here we are, we now run the test_phpembed program to see if it was able to load and run the php script called info.php :
+
+{{{
+#!sh
+LD_LIBRARY_PATH="/usr/lib/php5.2.10/lib/" ./test_phpembeded /var/www/localhost/htdocs/info.php | less
+}}}
+
+Note that we have to set the LD_LIBRARY_PATH at runtime as we didn't install the php embed library in a stadard fashion (not in the standard search path - /usr/lib or /usr/local/lib- to ensure that we don't interfer with your allready installed php library). Neevertheless, when ZooKernel will be compiled you only have  ot run it once, so you could use a small batch file including this LD_LIBRARY_PATH and other required parameters when you launch your ZooKernel instance (note that firefox do something like that also).
+