Rumah pembangunan bahagian belakang tutorial php PHP内核的学习-创办PHP扩展

PHP内核的学习-创办PHP扩展

Jun 13, 2016 pm 12:18 PM
ext php str

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 style="color: #0000ff;">function</span> <span style="color: #008080;">util_str_repeat</span>(<span style="color: #800080;">$string</span>, <span style="color: #800080;">$n</span><span style="color: #000000;">){    </span><span style="color: #800080;">$result</span> = ""<span style="color: #000000;">;    </span><span style="color: #0000ff;">for</span>(<span style="color: #800080;">$i</span> = 0; <span style="color: #800080;">$i</span> $n; <span style="color: #800080;">$i</span>++<span style="color: #000000;">){        </span><span style="color: #800080;">$result</span> .= <span style="color: #800080;">$string</span><span style="color: #000000;">;    }    </span><span style="color: #0000ff;">return</span> <span style="color: #800080;">$result</span><span style="color: #000000;">;} </span><span style="color: #008080;">util_str_repeat</span>("One", 3);<span style="color: #008000;">//</span><span style="color: #008000;"> returns "OneOneOne".</span><span style="color: #008080;">util_str_repeat</span>("One", 1);<span style="color: #008000;">//</span><span style="color: #008000;"> returns "One".</span>
Salin selepas log masuk

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

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

<span style="color: #0000ff;">string</span> util_str_repeat(<span style="color: #0000ff;">string</span> str, <span style="color: #0000ff;">int</span> n)
Salin selepas log masuk

函数定义文件的一般格式是一个函数一行。你可以定义可选参数和使用大量的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
Salin selepas log masuk

执行之后,我这里报了如下错误:

./ext_skel: <span style="color: #800080;">1</span>: cd: can<span style="color: #800000;">'</span><span style="color: #800000;">t cd to /usr/lib/php5/skeleton</span><span style="color: #000000;">Creating directory util</span><span style="color: #0000ff;">awk</span>: cannot open /create_stubs (No such <span style="color: #0000ff;">file</span><span style="color: #000000;"> or directory)Creating basic files: config.m4 config.w32 .svnignore util.c.</span>/ext_skel: <span style="color: #800080;">216</span>: ./ext_skel: cannot open /skeleton.c: No such <span style="color: #0000ff;">file</span><span style="color: #000000;"> php_util.h.</span>/ext_skel: <span style="color: #800080;">234</span>: ./ext_skel: cannot open /php_skeleton.h: No such <span style="color: #0000ff;">file</span><span style="color: #000000;"> CREDITS.</span>/ext_skel: <span style="color: #800080;">238</span>: ./ext_skel: cannot open /CREDITS: No such <span style="color: #0000ff;">file</span><span style="color: #000000;"> EXPERIMENTAL.</span>/ext_skel: <span style="color: #800080;">242</span>: ./ext_skel: cannot open /EXPERIMENTAL: No such <span style="color: #0000ff;">file</span><span style="color: #000000;"> tests</span>/<span style="color: #800080;">001</span>.phpt./ext_skel: <span style="color: #800080;">247</span>: ./ext_skel: cannot open /tests/<span style="color: #800080;">001</span>.phpt: No such <span style="color: #0000ff;">file</span><span style="color: #000000;"> util.php.</span>/ext_skel: <span style="color: #800080;">251</span>: ./ext_skel: cannot open /skeleton.php: No such <span style="color: #0000ff;">file</span><span style="color: #0000ff;">rm</span>: cannot remove ‘function_entries’: No such <span style="color: #0000ff;">file</span><span style="color: #000000;"> or directory</span><span style="color: #0000ff;">rm</span>: cannot remove ‘function_declarations’: No such <span style="color: #0000ff;">file</span><span style="color: #000000;"> or directory</span><span style="color: #0000ff;">rm</span>: cannot remove ‘function_stubs’: No such <span style="color: #0000ff;">file</span><span style="color: #000000;"> or directory [</span><span style="color: #0000ff;">done</span><span style="color: #000000;">].To use your new extension, you will have to execute the following steps:</span><span style="color: #800080;">1</span><span style="color: #000000;">.  $ cd ..</span><span style="color: #800080;">2</span>.  $ <span style="color: #0000ff;">vi</span> ext/util/<span style="color: #000000;">config.m4</span><span style="color: #800080;">3</span>.  $ ./<span style="color: #000000;">buildconf</span><span style="color: #800080;">4</span>.  $ ./configure --[with|enable]-<span style="color: #000000;">util</span><span style="color: #800080;">5</span>.  $ <span style="color: #0000ff;">make</span><span style="color: #800080;">6</span>.  $ ./php -f ext/util/<span style="color: #000000;">util.php</span><span style="color: #800080;">7</span>.  $ <span style="color: #0000ff;">vi</span> ext/util/<span style="color: #000000;">util.c</span><span style="color: #800080;">8</span>.  $ <span style="color: #0000ff;">make</span><span style="color: #000000;">Repeat steps </span><span style="color: #800080;">3</span>-<span style="color: #800080;">6</span> <span style="color: #0000ff;">until</span> you are satisfied with ext/util/<span style="color: #000000;">config.m4 andstep </span><span style="color: #800080;">6</span><span style="color: #000000;"> confirms that your module is compiled into PHP. Then, start writingcode and repeat the </span><span style="color: #0000ff;">last</span> two steps as often as necessary.
Salin selepas log masuk

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

<span style="color: #000000;">Creating directory utilCreating basic files: config.m4 config.w32 .svnignore util.c php_util.h CREDITS EXPERIMENTAL tests</span>/<span style="color: #800080;">001</span>.phpt util.php [<span style="color: #0000ff;">done</span><span style="color: #000000;">].To use your new extension, you will have to execute the following steps:</span><span style="color: #800080;">1</span><span style="color: #000000;">.  $ cd ..</span><span style="color: #800080;">2</span>.  $ <span style="color: #0000ff;">vi</span> ext/util/<span style="color: #000000;">config.m4</span><span style="color: #800080;">3</span>.  $ ./<span style="color: #000000;">buildconf</span><span style="color: #800080;">4</span>.  $ ./configure --[with|enable]-<span style="color: #000000;">util</span><span style="color: #800080;">5</span>.  $ <span style="color: #0000ff;">make</span><span style="color: #800080;">6</span>.  $ ./php -f ext/util/<span style="color: #000000;">util.php</span><span style="color: #800080;">7</span>.  $ <span style="color: #0000ff;">vi</span> ext/util/<span style="color: #000000;">util.c</span><span style="color: #800080;">8</span>.  $ <span style="color: #0000ff;">make</span><span style="color: #000000;">Repeat steps </span><span style="color: #800080;">3</span>-<span style="color: #800080;">6</span> <span style="color: #0000ff;">until</span> you are satisfied with ext/util/<span style="color: #000000;">config.m4 andstep </span><span style="color: #800080;">6</span><span style="color: #000000;"> confirms that your module is compiled into PHP. Then, start writingcode and repeat the </span><span style="color: #0000ff;">last</span> two steps as often as necessary.
Salin selepas log masuk

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

<span style="color: #000000;">dnl PHP_ARG_ENABLE(util, whether to enable util support,dnl Make sure that the comment </span><span style="color: #0000ff;">is</span><span style="color: #000000;"> aligned:dnl [  </span>--enable-util           Enable util support])
Salin selepas log masuk

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

<span style="color: #000000;">PHP_ARG_ENABLE(util, whether to enable util support,Make sure that the comment </span><span style="color: #0000ff;">is</span><span style="color: #000000;"> aligned:[  </span>--enable-util           Enable util support])
Salin selepas log masuk

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

<span style="color: #000000;">PHP_FUNCTION(util_str_repeat){    </span><span style="color: #0000ff;">char</span> *str =<span style="color: #000000;"> NULL;    </span><span style="color: #0000ff;">int</span> argc =<span style="color: #000000;"> ZEND_NUM_ARGS();    </span><span style="color: #0000ff;">int</span><span style="color: #000000;"> str_len;    </span><span style="color: #0000ff;">long</span><span style="color: #000000;"> n;    </span><span style="color: #0000ff;">if</span> (zend_parse_parameters(argc TSRMLS_CC, <span style="color: #800000;">"</span><span style="color: #800000;">sl</span><span style="color: #800000;">"</span>, &str, &str_len, &n) ==<span style="color: #000000;"> FAILURE)         </span><span style="color: #0000ff;">return</span><span style="color: #000000;">;    php_error(E_WARNING, </span><span style="color: #800000;">"</span><span style="color: #800000;">util_str_repeat: not yet implemented</span><span style="color: #800000;">"</span><span style="color: #000000;">);}</span>
Salin selepas log masuk

将其修改为如下代码:

<span style="color: #000000;">PHP_FUNCTION(util_str_repeat){    </span><span style="color: #0000ff;">char</span> *str =<span style="color: #000000;"> NULL;    </span><span style="color: #0000ff;">int</span> argc =<span style="color: #000000;"> ZEND_NUM_ARGS();    </span><span style="color: #0000ff;">int</span><span style="color: #000000;"> str_len;    </span><span style="color: #0000ff;">long</span><span style="color: #000000;"> n;    </span><span style="color: #0000ff;">char</span> *result; <span style="color: #008000;">/*</span><span style="color: #008000;"> Points to resulting string </span><span style="color: #008000;">*/</span>    <span style="color: #0000ff;">char</span> *ptr; <span style="color: #008000;">/*</span><span style="color: #008000;"> Points at the next location we want to copy to </span><span style="color: #008000;">*/</span>    <span style="color: #0000ff;">int</span> result_length; <span style="color: #008000;">/*</span><span style="color: #008000;"> Length of resulting string </span><span style="color: #008000;">*/</span>    <span style="color: #0000ff;">if</span> (zend_parse_parameters(argc TSRMLS_CC, <span style="color: #800000;">"</span><span style="color: #800000;">sl</span><span style="color: #800000;">"</span>, &str, &str_len, &n) ==<span style="color: #000000;"> FAILURE)        </span><span style="color: #0000ff;">return</span><span style="color: #000000;">;    </span><span style="color: #008000;">/*</span><span style="color: #008000;"> Calculate length of result </span><span style="color: #008000;">*/</span><span style="color: #000000;">    result_length </span>= (str_len *<span style="color: #000000;"> n);    </span><span style="color: #008000;">/*</span><span style="color: #008000;"> Allocate memory for result </span><span style="color: #008000;">*/</span><span style="color: #000000;">    result </span>= (<span style="color: #0000ff;">char</span> *) emalloc(result_length + <span style="color: #800080;">1</span><span style="color: #000000;">);    </span><span style="color: #008000;">/*</span><span style="color: #008000;"> Point at the beginning of the result </span><span style="color: #008000;">*/</span><span style="color: #000000;">    ptr </span>=<span style="color: #000000;"> result;    </span><span style="color: #0000ff;">while</span> (n--<span style="color: #000000;">) {        </span><span style="color: #008000;">/*</span><span style="color: #008000;"> Copy str to the result </span><span style="color: #008000;">*/</span><span style="color: #000000;">        memcpy(ptr, str, str_len);        </span><span style="color: #008000;">/*</span><span style="color: #008000;"> Increment ptr to point at the next position we want to write to </span><span style="color: #008000;">*/</span><span style="color: #000000;">        ptr </span>+=<span style="color: #000000;"> str_len;    }<br>    </span><span style="color: #008000;">/*</span><span style="color: #008000;"> Null terminate the result. Always null-terminate your strings    even if they are binary strings </span><span style="color: #008000;">*/</span>    *ptr = <span style="color: #800000;">'</span><span style="color: #800000;">\0</span><span style="color: #800000;">'</span><span style="color: #000000;">;    </span><span style="color: #008000;">/*</span><span style="color: #008000;"> Return result to the scripting engine without duplicating it</span><span style="color: #008000;">*/</span><span style="color: #000000;">    RETURN_STRINGL(result, result_length, </span><span style="color: #800080;">0</span><span style="color: #000000;">);}</span>
Salin selepas log masuk

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

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

<span style="color: #000000;">phpize.</span>/<span style="color: #000000;">configure</span><span style="color: #0000ff;">make</span><span style="color: #0000ff;">make</span><span style="color: #000000;"> test</span><span style="color: #0000ff;">make</span> <span style="color: #0000ff;">install</span>
Salin selepas log masuk

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

extension=util.so
Salin selepas log masuk

然后enable util扩展

<span style="color: #0000ff;">sudo</span> php5enmod util
Salin selepas log masuk

最后,重启php-fpm

<span style="color: #0000ff;">sudo</span> service php5-fpm restart
Salin selepas log masuk

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

<span style="color: #000000;">php</span><span style="color: #0000ff;">for</span> (<span style="color: #800080;">$i</span> = 1; <span style="color: #800080;">$i</span> $i++<span style="color: #000000;">) {    </span><span style="color: #0000ff;">print</span> util_str_repeat("CraryPrimitiveMan ", <span style="color: #800080;">$i</span><span style="color: #000000;">);    </span><span style="color: #0000ff;">print</span> "\n"<span style="color: #000000;">;}</span>?>
Salin selepas log masuk

执行结果如下:

<span style="color: #000000;">CraryPrimitiveMan CraryPrimitiveMan CraryPrimitiveMan CraryPrimitiveMan CraryPrimitiveMan CraryPrimitiveMan</span>
Salin selepas log masuk

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

盗图一张~~

今天就先到这里~~

 

1楼吉编辑
很不错,感谢分享,有兴趣写书出书吗?
Re: 疯狂的原始人
@吉编辑,水平不够啊。。。
Kenyataan Laman Web ini
Kandungan artikel ini disumbangkan secara sukarela oleh netizen, dan hak cipta adalah milik pengarang asal. Laman web ini tidak memikul tanggungjawab undang-undang yang sepadan. Jika anda menemui sebarang kandungan yang disyaki plagiarisme atau pelanggaran, sila hubungi admin@php.cn

Alat AI Hot

Undresser.AI Undress

Undresser.AI Undress

Apl berkuasa AI untuk mencipta foto bogel yang realistik

AI Clothes Remover

AI Clothes Remover

Alat AI dalam talian untuk mengeluarkan pakaian daripada foto.

Undress AI Tool

Undress AI Tool

Gambar buka pakaian secara percuma

Clothoff.io

Clothoff.io

Penyingkiran pakaian AI

AI Hentai Generator

AI Hentai Generator

Menjana ai hentai secara percuma.

Alat panas

Notepad++7.3.1

Notepad++7.3.1

Editor kod yang mudah digunakan dan percuma

SublimeText3 versi Cina

SublimeText3 versi Cina

Versi Cina, sangat mudah digunakan

Hantar Studio 13.0.1

Hantar Studio 13.0.1

Persekitaran pembangunan bersepadu PHP yang berkuasa

Dreamweaver CS6

Dreamweaver CS6

Alat pembangunan web visual

SublimeText3 versi Mac

SublimeText3 versi Mac

Perisian penyuntingan kod peringkat Tuhan (SublimeText3)

Panduan Pemasangan dan Naik Taraf PHP 8.4 untuk Ubuntu dan Debian Panduan Pemasangan dan Naik Taraf PHP 8.4 untuk Ubuntu dan Debian Dec 24, 2024 pm 04:42 PM

PHP 8.4 membawa beberapa ciri baharu, peningkatan keselamatan dan peningkatan prestasi dengan jumlah penamatan dan penyingkiran ciri yang sihat. Panduan ini menerangkan cara memasang PHP 8.4 atau naik taraf kepada PHP 8.4 pada Ubuntu, Debian, atau terbitan mereka

Cara Menyediakan Kod Visual Studio (Kod VS) untuk Pembangunan PHP Cara Menyediakan Kod Visual Studio (Kod VS) untuk Pembangunan PHP Dec 20, 2024 am 11:31 AM

Kod Visual Studio, juga dikenali sebagai Kod VS, ialah editor kod sumber percuma — atau persekitaran pembangunan bersepadu (IDE) — tersedia untuk semua sistem pengendalian utama. Dengan koleksi sambungan yang besar untuk banyak bahasa pengaturcaraan, Kod VS boleh menjadi c

7 Fungsi PHP Saya Menyesal Saya Tidak Tahu Sebelum ini 7 Fungsi PHP Saya Menyesal Saya Tidak Tahu Sebelum ini Nov 13, 2024 am 09:42 AM

Jika anda seorang pembangun PHP yang berpengalaman, anda mungkin merasakan bahawa anda telah berada di sana dan telah melakukannya. Anda telah membangunkan sejumlah besar aplikasi, menyahpenyahpepijat berjuta-juta baris kod dan mengubah suai sekumpulan skrip untuk mencapai op

Bagaimana anda menghuraikan dan memproses HTML/XML dalam PHP? Bagaimana anda menghuraikan dan memproses HTML/XML dalam PHP? Feb 07, 2025 am 11:57 AM

Tutorial ini menunjukkan cara memproses dokumen XML dengan cekap menggunakan PHP. XML (bahasa markup extensible) adalah bahasa markup berasaskan teks yang serba boleh yang direka untuk pembacaan manusia dan parsing mesin. Ia biasanya digunakan untuk penyimpanan data

Jelaskan JSON Web Tokens (JWT) dan kes penggunaannya dalam PHP API. Jelaskan JSON Web Tokens (JWT) dan kes penggunaannya dalam PHP API. Apr 05, 2025 am 12:04 AM

JWT adalah standard terbuka berdasarkan JSON, yang digunakan untuk menghantar maklumat secara selamat antara pihak, terutamanya untuk pengesahan identiti dan pertukaran maklumat. 1. JWT terdiri daripada tiga bahagian: header, muatan dan tandatangan. 2. Prinsip kerja JWT termasuk tiga langkah: menjana JWT, mengesahkan JWT dan muatan parsing. 3. Apabila menggunakan JWT untuk pengesahan di PHP, JWT boleh dijana dan disahkan, dan peranan pengguna dan maklumat kebenaran boleh dimasukkan dalam penggunaan lanjutan. 4. Kesilapan umum termasuk kegagalan pengesahan tandatangan, tamat tempoh, dan muatan besar. Kemahiran penyahpepijatan termasuk menggunakan alat debugging dan pembalakan. 5. Pengoptimuman prestasi dan amalan terbaik termasuk menggunakan algoritma tandatangan yang sesuai, menetapkan tempoh kesahihan dengan munasabah,

Program PHP untuk mengira vokal dalam rentetan Program PHP untuk mengira vokal dalam rentetan Feb 07, 2025 pm 12:12 PM

Rentetan adalah urutan aksara, termasuk huruf, nombor, dan simbol. Tutorial ini akan mempelajari cara mengira bilangan vokal dalam rentetan yang diberikan dalam PHP menggunakan kaedah yang berbeza. Vokal dalam bahasa Inggeris adalah a, e, i, o, u, dan mereka boleh menjadi huruf besar atau huruf kecil. Apa itu vokal? Vokal adalah watak abjad yang mewakili sebutan tertentu. Terdapat lima vokal dalam bahasa Inggeris, termasuk huruf besar dan huruf kecil: a, e, i, o, u Contoh 1 Input: String = "TutorialSpoint" Output: 6 menjelaskan Vokal dalam rentetan "TutorialSpoint" adalah u, o, i, a, o, i. Terdapat 6 yuan sebanyak 6

Terangkan pengikatan statik lewat dalam php (statik: :). Terangkan pengikatan statik lewat dalam php (statik: :). Apr 03, 2025 am 12:04 AM

Mengikat statik (statik: :) Melaksanakan pengikatan statik lewat (LSB) dalam PHP, yang membolehkan kelas panggilan dirujuk dalam konteks statik dan bukannya menentukan kelas. 1) Proses parsing dilakukan pada masa runtime, 2) Cari kelas panggilan dalam hubungan warisan, 3) ia boleh membawa overhead prestasi.

Apakah kaedah Magic PHP (__construct, __destruct, __call, __get, __set, dll) dan menyediakan kes penggunaan? Apakah kaedah Magic PHP (__construct, __destruct, __call, __get, __set, dll) dan menyediakan kes penggunaan? Apr 03, 2025 am 12:03 AM

Apakah kaedah sihir PHP? Kaedah sihir PHP termasuk: 1. \ _ \ _ Membina, digunakan untuk memulakan objek; 2. \ _ \ _ Destruct, digunakan untuk membersihkan sumber; 3. \ _ \ _ Call, mengendalikan panggilan kaedah yang tidak wujud; 4. \ _ \ _ Mendapatkan, melaksanakan akses atribut dinamik; 5. \ _ \ _ Set, melaksanakan tetapan atribut dinamik. Kaedah ini secara automatik dipanggil dalam situasi tertentu, meningkatkan fleksibiliti dan kecekapan kod.

See all articles