PHP内核的学习–创建PHP扩展

千帆竞发看PHP内核也产生一段时间了,现在起来止模仿边总结,今天便总结一下如何创建自己之PHP扩展。

我的环境如下:

系统:Ubuntu 14.04

php版本:5.5.19

参考摘录:据此C/C++扩展你的PHP

PHP取得成功之一个最主要缘由有是其拥有大量之可用扩展。web开发者无论发生何种需求,这种要求太有或以PHP发行包里找到。PHP发行包包括支持各种数据库,图形文件格式,压缩,XML技术扩展在内的多多扩展。

扩大API的引入使PHP3取得了宏伟的展开,扩展API机制而PHP开发社区大易之开销有几十种植扩大。现在,两个本子过去了,API仍然与PHP3时之生相似。扩展主要的琢磨是:尽可能的从扩大编写者那里隐藏PHP的中机制同剧本引擎本身,仅仅待开发者熟悉API。

起点儿独理由需自己编排PHP扩展。第一单理由是:PHP需要支持一起她还免支持之艺。这通常包括包裹有现的C函数库,以便提供PHP接口。例如,如果一个给FooBase的数据库已经出市场,你得建立一个PHP扩展帮助您打PHP里调用FooBase的C函数库。这个工作或独自出于一个人数完成,然后叫整个PHP社区共享(如果您肯的语句)。第二个未是异常广泛的理由是:你要由性能还是效益的因由考虑来编排一些买卖逻辑。

假定你在开发一个网站,需要一个拿字符串重复n次的函数。下面是故PHP写的例子:

function util_str_repeat($string, $n){
    $result = "";
    for($i = 0; $i < $n; $i++){
        $result .= $string;
    }
    return $result;
}

util_str_repeat("One", 3);// returns "OneOneOne".
util_str_repeat("One", 1);// returns "One".

要由于有的意外之缘由,你要时调用这个函数,而且还要传为函数很丰富的字符串和大值n。这意味着在剧本里有一定巨大的字符串连接量和内存重新分配过程,以至显著地回落脚本执行进度。如果产生一个函数能够再次快地分配大量都足够的内存来存放结果字符串,然后拿$string重复n次,就非需以每次循环迭代中分配内存。

为扩充建立函数的率先步是写一个函数定义文件,该函数定义文件定义了扩大对外提供的函数原形。该例中,定义函数只生一行函数原形util_str_repeat()
:

string util_str_repeat(string str, int n)

函数定义文件之形似格式是一个函数一行。你可以定义可选参数和采用大量底PHP类型,包括:
bool, float, int, array等。

保留也util.def文件及PHP原代码目录树下(即和ext_skel文件在同等目录下,我的目是/usr/share/php5/)。

下一场就是通过扩张骨架(skeleton)构造器运行函数定义文件之机会了。该构造器脚本就是ext_skel。假设你将函数定义保存在一个号称util.def的公文里,而且你期望将扩大取名为util,运行下面的通令来建扩展骨架:

sudo ./ext_skel --extname=util --proto=util.def

履下,我此报了如下错误:

./ext_skel: 1: cd: can't cd to /usr/lib/php5/skeleton
Creating directory util
awk: cannot open /create_stubs (No such file or directory)
Creating basic files: config.m4 config.w32 .svnignore util.c./ext_skel: 216: ./ext_skel: cannot open /skeleton.c: No such file
 php_util.h./ext_skel: 234: ./ext_skel: cannot open /php_skeleton.h: No such file
 CREDITS./ext_skel: 238: ./ext_skel: cannot open /CREDITS: No such file
 EXPERIMENTAL./ext_skel: 242: ./ext_skel: cannot open /EXPERIMENTAL: No such file
 tests/001.phpt./ext_skel: 247: ./ext_skel: cannot open /tests/001.phpt: No such file
 util.php./ext_skel: 251: ./ext_skel: cannot open /skeleton.php: No such file
rm: cannot remove ‘function_entries’: No such file or directory
rm: cannot remove ‘function_declarations’: No such file or directory
rm: cannot remove ‘function_stubs’: No such file or directory
 [done].

To use your new extension, you will have to execute the following steps:

1.  $ cd ..
2.  $ vi ext/util/config.m4
3.  $ ./buildconf
4.  $ ./configure --[with|enable]-util
5.  $ make
6.  $ ./php -f ext/util/util.php
7.  $ vi ext/util/util.c
8.  $ make

Repeat steps 3-6 until you are satisfied with ext/util/config.m4 and
step 6 confirms that your module is compiled into PHP. Then, start writing
code and repeat the last two steps as often as necessary.

万分显著是/usr/lib/php5/skeleton路径的错,编辑ext_skel文件,将/usr/lib/php5/skeleton修改也/usr/share/php5/skeleton,然后移除掉生成的util文件夹,再次实施前的命令,成功后提醒如下:

Creating directory util
Creating basic files: config.m4 config.w32 .svnignore util.c php_util.h CREDITS EXPERIMENTAL tests/001.phpt util.php [done].

To use your new extension, you will have to execute the following steps:

1.  $ cd ..
2.  $ vi ext/util/config.m4
3.  $ ./buildconf
4.  $ ./configure --[with|enable]-util
5.  $ make
6.  $ ./php -f ext/util/util.php
7.  $ vi ext/util/util.c
8.  $ make

Repeat steps 3-6 until you are satisfied with ext/util/config.m4 and
step 6 confirms that your module is compiled into PHP. Then, start writing
code and repeat the last two steps as often as necessary.

下一场使静态编译的法门编译扩展。为了要扩展能够让编译,需要改扩展目录util/下的config.m4文件。扩展没有包装任何外部的C库,你需要加上支持–enable-util配置开关到PHP编译系统里(–with-extension
开关用于那些急需用户指定相关C库路径的恢弘)。找到如下内容:

dnl PHP_ARG_ENABLE(util, whether to enable util support,
dnl Make sure that the comment is aligned:
dnl [  --enable-util           Enable util support])

拿前方的dnl 去丢,修改为如下结果:

PHP_ARG_ENABLE(util, whether to enable util support,
Make sure that the comment is aligned:
[  --enable-util           Enable util support])

接下来修改util.c文件,找到如下代码:

PHP_FUNCTION(util_str_repeat)
{
    char *str = NULL;
    int argc = ZEND_NUM_ARGS();
    int str_len;
    long n;

    if (zend_parse_parameters(argc TSRMLS_CC, "sl", &str, &str_len, &n) == FAILURE) 
        return;

    php_error(E_WARNING, "util_str_repeat: not yet implemented");
}

将该修改为如下代码:

PHP_FUNCTION(util_str_repeat)
{
    char *str = NULL;
    int argc = ZEND_NUM_ARGS();
    int str_len;
    long n;
    char *result; /* Points to resulting string */
    char *ptr; /* Points at the next location we want to copy to */
    int result_length; /* Length of resulting string */

    if (zend_parse_parameters(argc TSRMLS_CC, "sl", &str, &str_len, &n) == FAILURE)
        return;

    /* Calculate length of result */
    result_length = (str_len * n);
    /* Allocate memory for result */
    result = (char *) emalloc(result_length + 1);
    /* Point at the beginning of the result */
    ptr = result;

    while (n--) {
        /* Copy str to the result */
        memcpy(ptr, str, str_len);
        /* Increment ptr to point at the next position we want to write to */
        ptr += str_len;
    }

    /* Null terminate the result. Always null-terminate your strings
    even if they are binary strings */
    *ptr = '\0';
    /* Return result to the scripting engine without duplicating it*/
    RETURN_STRINGL(result, result_length, 0);
}

里头的具体内容,就无以这边说了,之后会日渐写及。

接下来就是编译,安装。在util目录下,命令如下(命令可能都急需加sudo):

phpize
./configure
make
make test
make install

下一场配置生成的扩张文件,在php5.5版本中,进入到/etc/php5/mods-available目录下,创建util.ini文件,写副如下内容:

extension=util.so

然后enable util扩展

sudo php5enmod util

最后,重启php-fpm

sudo service php5-fpm restart

开创一个php文件,测试一下,测试文件如下:

<?php
for ($i = 1; $i <= 3; $i++) {
    print util_str_repeat("CraryPrimitiveMan ", $i);
    print "\n";
}
?>

推行结果如下:

CraryPrimitiveMan 
CraryPrimitiveMan CraryPrimitiveMan 
CraryPrimitiveMan CraryPrimitiveMan CraryPrimitiveMan

诸如此类咱们就打响创建了一个蕴含简单的PHP函数的壮大。

盗窃图一律摆设~~

图片 1

今即先到此处~~