PHP内核的就学–创立PHP扩大

开班看PHP内核也有一段时间了,今后起先边学边计算,明日就总括一下哪些成立自身的PHP扩大。

自家的条件如下:

系统:Ubuntu 14.04

php版本:5.5.19

参考摘录:用C/C++扩大你的PHP

PHP取得成功的3个生死攸关缘由之一是它具有大量的可用扩张。web开发者无论有何种须求,那种供给最有可能在PHP发行包里找到。PHP发行李包裹包涵帮衬种种数据库,图形文件格式,压缩,XML技术增添在内的好多恢弘。

恢宏API的引入使PHP3取得了伟大的实行,增加API机制使PHP开发社区很不难的支出出几十种扩张。现在,三个版本过去了,API依然和PHP3时的那么些相似。扩大首要的考虑是:尽只怕的从扩展编写者那里隐藏PHP的中间机制松阳高腔本引擎自身,仅仅必要开发者掌握API。

有七个理由须要团结编写PHP扩张。第一个理由是:PHP供给帮衬一项她还未协理的技巧。那平日包蕴包裹一些现成的C函数库,以便提供PHP接口。例如,假如一个叫FooBase的数据库已推出市镇,你供给建立四个PHP扩充援助你从PHP里调用FooBase的C函数库。那几个工作或然仅由一人达成,然后被全体PHP社区共享(要是您愿意的话)。第一个不是很广阔的理由是:你要求从性质或效益的原由考虑来编排一些买卖逻辑。

如果你正在开发贰个网站,必要1个把字符串重复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。这代表在本子里有12分巨大的字符串连接量和内部存款和储蓄器重新分配进程,以至分明地降落脚本执行进程。假设有一个函数能够更快地分配多量且丰裕的内部存款和储蓄器来存放在结果字符串,然后把$string重复n次,就不须要在每一回循环迭代中分配内部存款和储蓄器。

为增添建立函数的首先步是写3个函数定义文件,该函数定义文件定义了扩充对外提供的函数原形。该例中,定义函数唯有一行函数原形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

如此那般我们就成功成立了1个带有简单的PHP函数的扩大。

盗图一张~~

图片 1

明天就先到那边~~

 

相关文章