PHP コアの学習 - PHP 拡張機能の作成
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 ‘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.
ログイン後にコピー
很明显是/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
- とてもよかったです。本を書くことに興味がありますか?
- Re: 狂った原始人
- @吉Editor、私のレベルは十分ではありません。 。 。
このウェブサイトの声明
この記事の内容はネチズンが自主的に寄稿したものであり、著作権は原著者に帰属します。このサイトは、それに相当する法的責任を負いません。盗作または侵害の疑いのあるコンテンツを見つけた場合は、admin@php.cn までご連絡ください。
ホットAIツール
Undresser.AI Undress
リアルなヌード写真を作成する AI 搭載アプリ
AI Clothes Remover
写真から衣服を削除するオンライン AI ツール。
Undress AI Tool
脱衣画像を無料で
Clothoff.io
AI衣類リムーバー
AI Hentai Generator
AIヘンタイを無料で生成します。
人気の記事
アサシンのクリードシャドウズ：シーシェルリドルソリューション
3週間前
By DDD
Windows11 KB5054979の新しいものと更新の問題を修正する方法
2週間前
By DDD
Atomfallのクレーンコントロールキーカードを見つける場所
3週間前
By DDD
R.E.P.O.で節約説明した（そしてファイルを保存）
1 か月前
By 尊渡假赌尊渡假赌尊渡假赌
アサシンクリードシャドウ - 鍛冶屋を見つけて武器と鎧のカスタマイズを解除する方法
4週間前
By DDD
ホットツール
メモ帳++7.3.1
使いやすく無料のコードエディター
SublimeText3 中国語版
中国語版、とても使いやすい
ゼンドスタジオ 13.0.1
強力な PHP 統合開発環境
ドリームウィーバー CS6
ビジュアル Web 開発ツール
SublimeText3 Mac版
神レベルのコード編集ソフト（SublimeText3）
ホットトピック
Gmailメールのログイン入り口はどこですか？
7564
15
7564
15
CakePHP チュートリアル
1386
52
1386
52
Steamのアカウント名の形式は何ですか
86
11
86
11
NYTの接続はヒントと回答です
28
99
28
99
Ubuntu および Debian 用の PHP 8.4 インストールおよびアップグレード ガイド
Dec 24, 2024 pm 04:42 PM
PHP 8.4 では、いくつかの新機能、セキュリティの改善、パフォーマンスの改善が行われ、かなりの量の機能の非推奨と削除が行われています。 このガイドでは、Ubuntu、Debian、またはその派生版に PHP 8.4 をインストールする方法、または PHP 8.4 にアップグレードする方法について説明します。
PHP 開発用に Visual Studio Code (VS Code) をセットアップする方法
Dec 20, 2024 am 11:31 AM
Visual Studio Code (VS Code とも呼ばれる) は、すべての主要なオペレーティング システムで利用できる無料のソース コード エディター (統合開発環境 (IDE)) です。 多くのプログラミング言語の拡張機能の大規模なコレクションを備えた VS Code は、
今まで知らなかったことを後悔している 7 つの PHP 関数
Nov 13, 2024 am 09:42 AM
あなたが経験豊富な PHP 開発者であれば、すでにそこにいて、すでにそれを行っていると感じているかもしれません。あなたは、運用を達成するために、かなりの数のアプリケーションを開発し、数百万行のコードをデバッグし、大量のスクリプトを微調整してきました。
PHPでHTML/XMLを解析および処理するにはどうすればよいですか？
Feb 07, 2025 am 11:57 AM
このチュートリアルでは、PHPを使用してXMLドキュメントを効率的に処理する方法を示しています。 XML（拡張可能なマークアップ言語）は、人間の読みやすさとマシン解析の両方に合わせて設計された多用途のテキストベースのマークアップ言語です。一般的にデータストレージに使用されます
JSON Web Tokens（JWT）とPHP APIでのユースケースを説明してください。
Apr 05, 2025 am 12:04 AM
JWTは、JSONに基づくオープン標準であり、主にアイデンティティ認証と情報交換のために、当事者間で情報を安全に送信するために使用されます。 1。JWTは、ヘッダー、ペイロード、署名の3つの部分で構成されています。 2。JWTの実用的な原則には、JWTの生成、JWTの検証、ペイロードの解析という3つのステップが含まれます。 3. PHPでの認証にJWTを使用する場合、JWTを生成および検証でき、ユーザーの役割と許可情報を高度な使用に含めることができます。 4.一般的なエラーには、署名検証障害、トークンの有効期限、およびペイロードが大きくなります。デバッグスキルには、デバッグツールの使用とロギングが含まれます。 5.パフォーマンスの最適化とベストプラクティスには、適切な署名アルゴリズムの使用、有効期間を合理的に設定することが含まれます。
母音を文字列にカウントするPHPプログラム
Feb 07, 2025 pm 12:12 PM
文字列は、文字、数字、シンボルを含む一連の文字です。このチュートリアルでは、さまざまな方法を使用してPHPの特定の文字列内の母音の数を計算する方法を学びます。英語の母音は、a、e、i、o、u、そしてそれらは大文字または小文字である可能性があります。 母音とは何ですか？ 母音は、特定の発音を表すアルファベットのある文字です。大文字と小文字など、英語には5つの母音があります。 a、e、i、o、u 例1 入力：string = "tutorialspoint" 出力：6 説明する 文字列「TutorialSpoint」の母音は、u、o、i、a、o、iです。合計で6元があります
PHPでの後期静的結合を説明します（静的：:)。
Apr 03, 2025 am 12:04 AM
静的結合（静的：:) PHPで後期静的結合（LSB）を実装し、クラスを定義するのではなく、静的コンテキストで呼び出しクラスを参照できるようにします。 1）解析プロセスは実行時に実行されます。2）継承関係のコールクラスを検索します。3）パフォーマンスオーバーヘッドをもたらす可能性があります。
PHPマジックメソッド（__construct、__destruct、__call、__get、__setなど）とは何ですか？
Apr 03, 2025 am 12:03 AM
PHPの魔法の方法は何ですか？ PHPの魔法の方法には次のものが含まれます。1。\ _ \ _コンストラクト、オブジェクトの初期化に使用されます。 2。\ _ \ _リソースのクリーンアップに使用される破壊。 3。\ _ \ _呼び出し、存在しないメソッド呼び出しを処理します。 4。\ _ \ _ get、dynamic属性アクセスを実装します。 5。\ _ \ _セット、動的属性設定を実装します。これらの方法は、特定の状況で自動的に呼び出され、コードの柔軟性と効率を向上させます。
