成人免费xxxxx在线视频软件_久久精品久久久_亚洲国产精品久久久_天天色天天色_亚洲人成一区_欧美一级欧美三级在线观看

如何編寫一個獨立的PHP擴展

開發 后端
有時候獨立擴展需要是共享的已供其他模塊加載。文中會解釋如何給已經創建好的 foo 模塊添加共享支持。

獨立的 PHP 擴展可以獨立于 PHP 源碼之外進行分發。要創建一個這樣的擴展,需要準備好兩樣東西:

  • 配置文件 (config.m4)

  • 你的模塊源碼

接下來我們來描述一下如果創建這些文件并組合起來。

[[161405]]

準備好系統工具

想要擴展能夠在系統上編譯并成功運行,需要準備轉以下工具:

  • GNU autoconf

  • GNU automake

  • GNU libtool

  • GNU m4

以上這些都可以從 ftp://ftp.gnu.org/pub/gnu/ 獲取。

注:以上這些都是類 Unix 環境下才能使用的工具。

改裝一個已經存在的擴展

為了顯示出創建一個獨立的擴展是很容易的事情,我們先將一個已經內嵌到 PHP 的擴展改成獨立擴展。安裝 PHP 并且執行以下命令:

$ mkdir /tmp/newext
$ cd /tmp/newext

現在你已經有了一個空目錄。我們將 mysql 擴展目錄下的文件復制過來:

$ cp -rp php-4.0.X/ext/mysql/* .
# 注:看來這篇 README 真的需要更新一下了
# PHP7 中已經移除了 mysql 擴展部分

到這里擴展就完成了,執行:

$ phpize

現在你可以獨立存放這個目錄下的文件到任何地方,這個擴展可以完全獨立存在了。

用戶在編譯時需要使用以下命令

$ ./configure
       [--with-php-config=/path/to/php-config]
       [--with-mysql=MYSQL-DIR]
$ make install

這樣 MySQL 模塊就可以使用內嵌的 MySQL 客戶端庫或者已安裝的位于 MySQL 目錄中的 MySQL。

注:意思是說想要編寫 PHP 擴展,你既需要已經安裝了 PHP,也需要下載一份 PHP 源碼。

定義一個新擴展

我們給示例擴展命名為 “foobar”。

新擴展包含兩個資源文件:foo.c 和 bar.c(還有一些頭文件,但這些不只重要)。

示例擴展不引用任何外部的庫(這點很重要,因為這樣用戶就不需要特別指定一些編譯選項了)。

LTLIBRARY_SOURCES 選項用于指定資源文件的名字,你可以有任意數量的資源文件。

注:上面說的是 Makefile.in 文件中的配置選項,可以參考 xdebug

修改 m4 后綴的配置文件

m4 配置文件可以指定一些額外的檢查。對于一個獨立擴展來說,你只需要做一些宏調用即可。

PHP_ARG_ENABLE(foobar,whether to enable foobar,
[  --enable-foobar            Enable foobar])

if test "$PHP_FOOBAR" != "no"; then
  PHP_NEW_EXTENSION(foobar, foo.c bar.c, $ext_shared)
fi

PHP_ARG_ENABLE 會自動設置好正確的變量以保證擴展能夠被 PHP_NEW_EXTENSION 以共享模式啟動。

PHP_NEW_EXTENSION 的***個參數是擴展的名稱,第二個參數是資源文件。第三個參數 $ext_shared 是由 PHP_ARG_ENABLE/WITHPHP_NEW_EXTENSION 設定的。

請始終使用 PHP_ARG_ENABLEPHP_ARG_WITH 進行設置。即使你不打算發布你的 PHP 模塊,這些設置也可以保證讓你的模塊和 PHP 主模塊的接口保持一體。

注:PHP_ARG_ENABLEPHP_ARG_WITH 應該是用于定義模塊是動態擴展還是靜態編譯進 PHP 中,就跟編譯 PHP 時使用的 --enable-xxx--with-xxx 一樣。

創建資源文件

ext_skel 可以為你的 PHP 模塊創建一些通用的代碼,你也可以編寫一些基本函數定義和 C 代碼來處理函數的參數。具體信息可以查看 READNE.EXT_SKEL

不要擔心沒有范例,PHP 中有很多模塊供你參考,選擇一個簡單的點開始,添加你自己的代碼。

注:ext_skel 可以生成好基本模塊需要的資源文件和配置文件,不需要自己創建。

修改自定義模塊

將 config.m4 文件和資源文件放到同一個目錄中,然后執行 phpize (PHP 4.0 以上的版本編譯 PHP 的時候都安裝了 phpize)。

如果你的 phpize 不在系統環境變量中,你需要指定絕對路徑,例如:

$ /php/bin/phpize

這個命令會自動復制必需的構建文件到當前目錄并根據 config.m4 創建配置文件。

通過以上的步驟,你已經有了一個獨立的擴展了。

安裝擴展

擴展可以通過以下命令編譯安裝:

$ ./configure
            [--with-php-config=/path/to/php-config]
$ make install

給模塊添加共享支持

有時候獨立擴展需要是共享的已供其他模塊加載。接下來我會解釋如何給已經創建好的 foo 模塊添加共享支持。

  1. 在 config.m4 文件中,使用 PHP_ARG_WITH/PHP_ARG_ENABLE 來設定擴展,這樣就可以自動使用 --with-foo=shared[,..]--enable-foo=shared[,..] 這樣的指令作為編譯參數了。

  2. 在 config.m4 文件中,使用 PHP_NEW_EXTENSION(foo,.., $ext_shared) 使擴展可以被構建。

  3. 添加以下代碼到你的 C 語言資源文件中:

   #ifdef COMPILE_DL_FOO
   ZEND_GET_MODULE(foo)
   #endif

這一段講的上面都提到過了,這里只是又強調了一下。

PECL 網站約定

如果你打算發布你的擴展到 PECL 的網站,需要考慮以下幾點:

  1. 添加 LICENSE 或 COPYING 到 package.xml

  2. 需要在擴展頭文件中定義好版本信息,這個宏會被 foo_module_entry 調用來聲明擴展版本:

   #define PHP_FOO_VERSION "1.2.3"

責任編輯:王雪燕 來源: Scholer's Blog
相關推薦

2019-06-05 13:05:47

PHP語法糖編碼

2009-10-16 09:42:06

2024-11-20 13:18:21

2015-08-19 09:29:35

Git協議編寫

2024-04-16 08:09:36

JavapulsarAPI

2009-10-01 09:19:45

PHP框架ZendFramewoCake

2016-09-21 12:34:10

Chrome瀏覽器插件

2015-07-28 14:35:40

2023-12-12 08:08:17

插件PRPulsar

2020-01-11 17:00:07

DjangoPythonWeb API

2021-07-06 14:36:05

RustLinux內核模塊

2017-01-12 22:36:30

2024-08-12 08:33:05

2023-02-01 16:36:31

GNOMEChatGPTLinux

2014-02-27 09:39:30

PHP技巧

2021-01-01 19:30:21

Python編程語言

2021-02-05 16:03:48

JavaScript游戲學習前端

2009-04-03 15:21:37

2017-12-27 09:49:35

HTTP服務器反向

2024-08-07 08:14:26

點贊
收藏

51CTO技術棧公眾號

主站蜘蛛池模板: 一级毛片黄片 | 国产一区二区三区免费 | 亚洲自拍偷拍欧美 | 又爽又黄axxx片免费观看 | 国产在线视频一区二区 | 日本网站免费在线观看 | 日韩精品| 视频在线一区 | 欧美精品一区二区三区四区五区 | 欧美一区二区三区在线观看视频 | 久久久精品视 | 综合久久久久 | 中文字幕精品一区二区三区精品 | 91精品国产色综合久久不卡蜜臀 | 亚洲伦理自拍 | 91影院| 中文字幕加勒比 | 色婷婷综合久久久中字幕精品久久 | 国产精品日产欧美久久久久 | 成人欧美一区二区 | 日韩不卡视频在线 | 日韩精品一区二区不卡 | 一本大道久久a久久精二百 国产成人免费在线 | 中文字幕一区二区三区乱码图片 | 五月激情婷婷六月 | 日本精品视频在线观看 | 国产亚洲精品美女久久久久久久久久 | 成人午夜激情 | 精品欧美乱码久久久久久1区2区 | 日韩视频在线观看中文字幕 | 日韩精品一区二区三区在线观看 | 国产成人一区二区 | 欧美a在线观看 | 免费不卡视频 | 欧美日韩理论 | 激情免费视频 | 夜色www国产精品资源站 | 午夜av成人 | 国产精品免费一区二区三区 | 国产精品99久久久精品免费观看 | 黄色av一区 |