社群 學習 工具庫 休閒
搜尋
繁体中文
首頁 > 後端開發 > php教程 > PHP内核的学习--创建PHP扩展，php内核--扩展_PHP教程

PHP内核的学习--创建PHP扩展，php内核--扩展_PHP教程

WBOY
發布： 2016-07-13 09:57:22
原創
983 人瀏覽過

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函数的扩展。

盗图一张～～

今天就先到这里～～

 

www.bkjia.comtruehttp://www.bkjia.com/PHPjc/983853.htmlTechArticlePHP内核的学习--创建PHP扩展，php内核--扩展 开始看PHP内核也有一段时间了，现在开始边学边总结，今天就总结一下如何创建自己的PHP扩展。...
相關標籤：
php 核心 創建 學習 開始 擴充 現 的 看
來源：php.cn
上一篇：适配器模式，适配器模式java_PHP教程 下一篇：php计算到指定日期还有多少天的方法_PHP教程
本網站聲明
本文內容由網友自願投稿，版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容，請聯絡admin@php.cn
作者最新文章
最新問題
PHP數組從URL參數中取得的行為不如預期 我有一個包含類別ID的URL參數，我想將其視為一個數組，如下所示：http://example.com?cat[]=3,9,13在PHP中，我使用它從URL參數取得數組：$catI...
來自於 2024-04-06 22:09:02
0
1
1428
我應該在 apache 中哪裡放置 CustomLog 指令 我正在使用php:7.2-apachedocker。我需要禁用運行狀況檢查url登入訪問日誌。基於此鏈接，他們提到了有關修改Customlog指令的資訊。我不是關於需要更改Cust...
來自於 2024-04-06 22:03:59
0
1
990
傳回值中變數的格式是什麼？ 我是php的新學習者。我發現有一段程式碼：if($x<time()){return[false,'error'];}邏輯或變數並不重要，但我不明白[false,'error'...
來自於 2024-04-06 21:55:20
0
1
778
使用opentbs產生odt檔案時遇到的問題：相同key的值顯示在同一行而不是單獨的欄位中。 我正在使用一個名為OpenTbs的庫來使用PHP建立odt，我使用它是因為動態生成列和行。我知道如何建立行和列，但我不知道如何組織它們。讓我加入一個例子：所以首先我會將其添加到我的...
來自於 2024-04-06 20:18:18
0
1
483
依照ID對MySQL結果進行分組以便循環遍歷 我有一個表，其中有mysql中的航班資料。我正在編寫一個php程式碼，它將使用codeigniter3對資料進行分組和顯示journey_idair_idFlightDuratio...
來自於 2024-04-06 17:27:56
0
1
406
相關專題
更多>
熱門推薦
熱門教學
更多>
相關教學
熱門推薦
最新課程
最新下載
更多>
網站特效
網站源碼
網站素材
前端模板