PHP コアの学習 - PHP 拡張機能の作成-PHPチュートリアル-php.cn

ホームページ

バックエンド開発

PHPチュートリアル

PHP コアの学習 - PHP 拡張機能の作成

WBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWB

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> < <span style="color: #800080;">$n</span>; <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>

ログイン後にコピー

假设由于一些奇怪的原因，你需要时常调用这个函数，而且还要传给函数很长的字符串和大值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)

ログイン後にコピー

函数定义文件的一般格式是一个函数一行。你可以定义可选参数和使用大量的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 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 &lsquo;function_entries&rsquo;: No such <span style="color: #0000ff;">file</span><span style="color: #000000;"> or directory</span><span style="color: #0000ff;">rm</span>: cannot remove &lsquo;function_declarations&rsquo;: No such <span style="color: #0000ff;">file</span><span style="color: #000000;"> or directory</span><span style="color: #0000ff;">rm</span>: cannot remove &lsquo;function_stubs&rsquo;: 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.

ログイン後にコピー

很明显是/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.

ログイン後にコピー

然后采用静态编译的方式编译扩展。为了使扩展能够被编译，需要修改扩展目录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])

ログイン後にコピー

将前面的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])

ログイン後にコピー

然后修改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>

ログイン後にコピー

将其修改为如下代码：

<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>

ログイン後にコピー

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

然后就是编译，安装。在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>

ログイン後にコピー

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

extension=util.so

ログイン後にコピー

然后enable util扩展

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

ログイン後にコピー

最后，重启php-fpm

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

ログイン後にコピー

创建一个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> <= 3; <span style="color: #800080;">$i</span>++<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>?>

ログイン後にコピー

执行结果如下：

<span style="color: #000000;">CraryPrimitiveMan CraryPrimitiveMan CraryPrimitiveMan CraryPrimitiveMan CraryPrimitiveMan CraryPrimitiveMan</span>

ログイン後にコピー

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

盗图一张～～

今天就先到这里～～

1F編集者 Ji: とてもよかったです。本を書くことに興味がありますか?

このウェブサイトの声明

この記事の内容はネチズンが自主的に寄稿したものであり、著作権は原著者に帰属します。このサイトは、それに相当する法的責任を負いません。盗作または侵害の疑いのあるコンテンツを見つけた場合は、admin@php.cn までご連絡ください。

ホットAIツール

Undresser.AI Undress

リアルなヌード写真を作成する AI 搭載アプリ

AI Clothes Remover

写真から衣服を削除するオンライン AI ツール。

Undress AI Tool

脱衣画像を無料で

Clothoff.io

AI衣類リムーバー

Video Face Swap

完全無料の AI 顔交換ツールを使用して、あらゆるビデオの顔を簡単に交換できます。

ホットツール

メモ帳++7.3.1

使いやすく無料のコードエディター

SublimeText3 中国語版

中国語版、とても使いやすい

ゼンドスタジオ 13.0.1

強力な PHP 統合開発環境

ドリームウィーバー CS6

ビジュアル Web 開発ツール

SublimeText3 Mac版

神レベルのコード編集ソフト（SublimeText3）

ホットトピック

Java チュートリアル

1672

CakePHP チュートリアル

1428

Laravel チュートリアル

1332

PHP チュートリアル

1277

C# チュートリアル

1256

Related knowledge

PHP対Python：違いを理解します Apr 11, 2025 am 12:15 AM

PHP and Python each have their own advantages, and the choice should be based on project requirements. 1.PHPは、シンプルな構文と高い実行効率を備えたWeb開発に適しています。 2。Pythonは、簡潔な構文とリッチライブラリを備えたデータサイエンスと機械学習に適しています。

PHP：Web開発の重要な言語 Apr 13, 2025 am 12:08 AM

PHPは、サーバー側で広く使用されているスクリプト言語で、特にWeb開発に適しています。 1.PHPは、HTMLを埋め込み、HTTP要求と応答を処理し、さまざまなデータベースをサポートできます。 2.PHPは、ダイナミックWebコンテンツ、プロセスフォームデータ、アクセスデータベースなどを生成するために使用され、強力なコミュニティサポートとオープンソースリソースを備えています。 3。PHPは解釈された言語であり、実行プロセスには語彙分析、文法分析、編集、実行が含まれます。 4.PHPは、ユーザー登録システムなどの高度なアプリケーションについてMySQLと組み合わせることができます。 5。PHPをデバッグするときは、error_reporting（）やvar_dump（）などの関数を使用できます。 6. PHPコードを最適化して、キャッシュメカニズムを使用し、データベースクエリを最適化し、組み込み関数を使用します。 7

PHPとPython：2つの一般的なプログラミング言語を比較します Apr 14, 2025 am 12:13 AM

PHPとPythonにはそれぞれ独自の利点があり、プロジェクトの要件に従って選択します。 1.PHPは、特にWebサイトの迅速な開発とメンテナンスに適しています。 2。Pythonは、データサイエンス、機械学習、人工知能に適しており、簡潔な構文を備えており、初心者に適しています。

アクション中のPHP：実際の例とアプリケーション Apr 14, 2025 am 12:19 AM

PHPは、電子商取引、コンテンツ管理システム、API開発で広く使用されています。 1）eコマース：ショッピングカート機能と支払い処理に使用。 2）コンテンツ管理システム：動的コンテンツの生成とユーザー管理に使用されます。 3）API開発：RESTFUL API開発とAPIセキュリティに使用されます。パフォーマンスの最適化とベストプラクティスを通じて、PHPアプリケーションの効率と保守性が向上します。

PHPの永続的な関連性：それはまだ生きていますか？ Apr 14, 2025 am 12:12 AM

PHPは依然として動的であり、現代のプログラミングの分野で重要な位置を占めています。 1）PHPのシンプルさと強力なコミュニティサポートにより、Web開発で広く使用されています。 2）その柔軟性と安定性により、Webフォーム、データベース操作、ファイル処理の処理において顕著になります。 3）PHPは、初心者や経験豊富な開発者に適した、常に進化し、最適化しています。

PHPおよびPython：さまざまなパラダイムが説明されています Apr 18, 2025 am 12:26 AM

PHPは主に手順プログラミングですが、オブジェクト指向プログラミング（OOP）もサポートしています。 Pythonは、OOP、機能、手続き上のプログラミングなど、さまざまなパラダイムをサポートしています。 PHPはWeb開発に適しており、Pythonはデータ分析や機械学習などのさまざまなアプリケーションに適しています。

PHP対その他の言語：比較 Apr 13, 2025 am 12:19 AM

PHPは、特に迅速な開発や動的なコンテンツの処理に適していますが、データサイエンスとエンタープライズレベルのアプリケーションには良くありません。 Pythonと比較して、PHPはWeb開発においてより多くの利点がありますが、データサイエンスの分野ではPythonほど良くありません。 Javaと比較して、PHPはエンタープライズレベルのアプリケーションでより悪化しますが、Web開発により柔軟性があります。 JavaScriptと比較して、PHPはバックエンド開発により簡潔ですが、フロントエンド開発のJavaScriptほど良くありません。