搜索
首页php教程php手册PHP内核的学习--创建PHP扩展,php内核--扩展

PHP内核的学习--创建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写的例子:

<span>function</span> <span>util_str_repeat</span>(<span>$string</span>, <span>$n</span><span>){
    </span><span>$result</span> = ""<span>;
    </span><span>for</span>(<span>$i</span> = 0; <span>$i</span> < <span>$n</span>; <span>$i</span>++<span>){
        </span><span>$result</span> .= <span>$string</span><span>;
    }
    </span><span>return</span> <span>$result</span><span>;
}
 
</span><span>util_str_repeat</span>("One", 3);<span>//</span><span> returns "OneOneOne".</span>
<span>util_str_repeat</span>("One", 1);<span>//</span><span> returns "One".</span>

假设由于一些奇怪的原因,你需要时常调用这个函数,而且还要传给函数很长的字符串和大值n。这意味着在脚本里有相当巨大的字符串连接量和内存重新分配过程,以至显著地降低脚本执行速度。如果有一个函数能够更快地分配大量且足够的内存来存放结果字符串,然后把$string重复n次,就不需要在每次循环迭代中分配内存。

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

<span>string</span> util_str_repeat(<span>string</span> str, <span>int</span> 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: <span>1</span>: cd: can<span>'</span><span>t cd to /usr/lib/php5/skeleton</span>
<span>Creating directory util
</span><span>awk</span>: cannot open /create_stubs (No such <span>file</span><span> or directory)
Creating basic files: config.m4 config.w32 .svnignore util.c.</span>/ext_skel: <span>216</span>: ./ext_skel: cannot open /skeleton.c: No such <span>file</span><span>
 php_util.h.</span>/ext_skel: <span>234</span>: ./ext_skel: cannot open /php_skeleton.h: No such <span>file</span><span>
 CREDITS.</span>/ext_skel: <span>238</span>: ./ext_skel: cannot open /CREDITS: No such <span>file</span><span>
 EXPERIMENTAL.</span>/ext_skel: <span>242</span>: ./ext_skel: cannot open /EXPERIMENTAL: No such <span>file</span><span>
 tests</span>/<span>001</span>.phpt./ext_skel: <span>247</span>: ./ext_skel: cannot open /tests/<span>001</span>.phpt: No such <span>file</span><span>
 util.php.</span>/ext_skel: <span>251</span>: ./ext_skel: cannot open /skeleton.php: No such <span>file</span>
<span>rm</span>: cannot remove &lsquo;function_entries&rsquo;: No such <span>file</span><span> or directory
</span><span>rm</span>: cannot remove &lsquo;function_declarations&rsquo;: No such <span>file</span><span> or directory
</span><span>rm</span>: cannot remove &lsquo;function_stubs&rsquo;: No such <span>file</span><span> or directory
 [</span><span>done</span><span>].

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

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

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

很明显是/usr/lib/php5/skeleton路径的错误,编辑ext_skel文件,将/usr/lib/php5/skeleton修改为/usr/share/php5/skeleton,然后移除掉生成的util文件夹,再次执行之前的命令,成功后提示如下:

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

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

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

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

然后采用静态编译的方式编译扩展。为了使扩展能够被编译,需要修改扩展目录util/下的config.m4文件。扩展没有包裹任何外部的C库,你需要添加支持–enable-util配置开关到PHP编译系统里(–with-extension 开关用于那些需要用户指定相关C库路径的扩展)。找到如下内容:

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

将前面的dnl 去掉,修改为如下结果:

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

然后修改util.c文件,找到如下代码:

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

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

    php_error(E_WARNING, </span><span>"</span><span>util_str_repeat: not yet implemented</span><span>"</span><span>);
}</span>

将其修改为如下代码:

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

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

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

    </span><span>while</span> (n--<span>) {
        </span><span>/*</span><span> Copy str to the result </span><span>*/</span><span>
        memcpy(ptr, str, str_len);
        </span><span>/*</span><span> Increment ptr to point at the next position we want to write to </span><span>*/</span><span>
        ptr </span>+=<span> str_len;
    }<br />
    </span><span>/*</span><span> Null terminate the result. Always null-terminate your strings
    even if they are binary strings </span><span>*/</span>
    *ptr = <span>'</span><span>\0</span><span>'</span><span>;
    </span><span>/*</span><span> Return result to the scripting engine without duplicating it</span><span>*/</span><span>
    RETURN_STRINGL(result, result_length, </span><span>0</span><span>);
}</span>

里面的具体内容,就不在这里说了,之后会慢慢写到。

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

<span>phpize
.</span>/<span>configure
</span><span>make</span>
<span>make</span><span> test
</span><span>make</span> <span>install</span>

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

extension=util.so

然后enable util扩展

<span>sudo</span> php5enmod util

最后,重启php-fpm

<span>sudo</span> service php5-fpm restart

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

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

执行结果如下:

<span>CraryPrimitiveMan 
CraryPrimitiveMan CraryPrimitiveMan 
CraryPrimitiveMan CraryPrimitiveMan CraryPrimitiveMan</span>

这样我们就成功创建了一个包含简单的PHP函数的扩展。

盗图一张~~

今天就先到这里~~

 

声明
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
php怎么把负数转为正整数php怎么把负数转为正整数Apr 19, 2022 pm 08:59 PM

php把负数转为正整数的方法:1、使用abs()函数将负数转为正数,使用intval()函数对正数取整,转为正整数,语法“intval(abs($number))”;2、利用“~”位运算符将负数取反加一,语法“~$number + 1”。

php怎么实现几秒后执行一个函数php怎么实现几秒后执行一个函数Apr 24, 2022 pm 01:12 PM

实现方法:1、使用“sleep(延迟秒数)”语句,可延迟执行函数若干秒;2、使用“time_nanosleep(延迟秒数,延迟纳秒数)”语句,可延迟执行函数若干秒和纳秒;3、使用“time_sleep_until(time()+7)”语句。

php怎么除以100保留两位小数php怎么除以100保留两位小数Apr 22, 2022 pm 06:23 PM

php除以100保留两位小数的方法:1、利用“/”运算符进行除法运算,语法“数值 / 100”;2、使用“number_format(除法结果, 2)”或“sprintf("%.2f",除法结果)”语句进行四舍五入的处理值,并保留两位小数。

php怎么根据年月日判断是一年的第几天php怎么根据年月日判断是一年的第几天Apr 22, 2022 pm 05:02 PM

判断方法:1、使用“strtotime("年-月-日")”语句将给定的年月日转换为时间戳格式;2、用“date("z",时间戳)+1”语句计算指定时间戳是一年的第几天。date()返回的天数是从0开始计算的,因此真实天数需要在此基础上加1。

php怎么替换nbsp空格符php怎么替换nbsp空格符Apr 24, 2022 pm 02:55 PM

方法:1、用“str_replace("&nbsp;","其他字符",$str)”语句,可将nbsp符替换为其他字符;2、用“preg_replace("/(\s|\&nbsp\;||\xc2\xa0)/","其他字符",$str)”语句。

php怎么判断有没有小数点php怎么判断有没有小数点Apr 20, 2022 pm 08:12 PM

php判断有没有小数点的方法:1、使用“strpos(数字字符串,'.')”语法,如果返回小数点在字符串中第一次出现的位置,则有小数点;2、使用“strrpos(数字字符串,'.')”语句,如果返回小数点在字符串中最后一次出现的位置,则有。

php字符串有没有下标php字符串有没有下标Apr 24, 2022 am 11:49 AM

php字符串有下标。在PHP中,下标不仅可以应用于数组和对象,还可应用于字符串,利用字符串的下标和中括号“[]”可以访问指定索引位置的字符,并对该字符进行读写,语法“字符串名[下标值]”;字符串的下标值(索引值)只能是整数类型,起始值为0。

php怎么查找字符串是第几位php怎么查找字符串是第几位Apr 22, 2022 pm 06:48 PM

查找方法:1、用strpos(),语法“strpos("字符串值","查找子串")+1”;2、用stripos(),语法“strpos("字符串值","查找子串")+1”。因为字符串是从0开始计数的,因此两个函数获取的位置需要进行加1处理。

See all articles

热AI工具

Undresser.AI Undress

Undresser.AI Undress

人工智能驱动的应用程序,用于创建逼真的裸体照片

AI Clothes Remover

AI Clothes Remover

用于从照片中去除衣服的在线人工智能工具。

Undress AI Tool

Undress AI Tool

免费脱衣服图片

Clothoff.io

Clothoff.io

AI脱衣机

AI Hentai Generator

AI Hentai Generator

免费生成ai无尽的。

热门文章

R.E.P.O.能量晶体解释及其做什么(黄色晶体)
2 周前By尊渡假赌尊渡假赌尊渡假赌
仓库:如何复兴队友
4 周前By尊渡假赌尊渡假赌尊渡假赌
Hello Kitty Island冒险:如何获得巨型种子
4 周前By尊渡假赌尊渡假赌尊渡假赌

热工具

禅工作室 13.0.1

禅工作室 13.0.1

功能强大的PHP集成开发环境

记事本++7.3.1

记事本++7.3.1

好用且免费的代码编辑器

SecLists

SecLists

SecLists是最终安全测试人员的伙伴。它是一个包含各种类型列表的集合,这些列表在安全评估过程中经常使用,都在一个地方。SecLists通过方便地提供安全测试人员可能需要的所有列表,帮助提高安全测试的效率和生产力。列表类型包括用户名、密码、URL、模糊测试有效载荷、敏感数据模式、Web shell等等。测试人员只需将此存储库拉到新的测试机上,他就可以访问到所需的每种类型的列表。

ZendStudio 13.5.1 Mac

ZendStudio 13.5.1 Mac

功能强大的PHP集成开发环境

EditPlus 中文破解版

EditPlus 中文破解版

体积小,语法高亮,不支持代码提示功能