PHP 扩展开发环境搭建

环境搭建步骤:

  1. 创建 docker 容器
    (原因:①. Mac下环境配置有坑,不好弄(其实就是搞不定-_-||);②. 不想搞乱 Mac 环境;③. docker 容器可以随时删除和重建)
  2. 下载PHP源码,并源码安装 PHP(源码必须下,后面扩展开发还有用)
  3. 通过ext目录下ext_skel脚本生成扩展的基本框架:./ext_skel --extname;

1.环境配置说明:

我的环境:Mac + Docker + Ubuntu + PHP7.1.26 + bg-sync
Mac、Docker、Ubuntu 这三个不用解释,php 版本这个没有限制,只是需要注意,生成扩展基本框架的脚本 7.1 版本跟 7.3 的有点区别。
重点说这个 bg-sync ,这是我用到的一个 Docker 容器,用来同步容器内和宿主机(Mac)的文件,否则只能用 vim 在容器中进行编辑。(说白了就是技术渣,用不惯 vim .

2.创建 Docker 容器

因为这里会用到 2 个容器,一个是 Ubuntu 容器,一个是用于同步文件的 bg-sync 容器,所以用 docker-compose 去组织容器
目录结构:

|---php-ext
|   |---build 
|       |---Dockerfile //用于生成 Ubuntu 镜像
|   |---php-src     //php 源码
|       |---...
|   |--- docker-compose 

docker-compose.yml 文件:

version: '3'

# 挂载数据卷
volumes:
  php-ext:

services:
  ubuntu-php-ext:
    build: ./build/
    volumes:
      - php-ext:${EXTSPACES}
    stdin_open: true
    tty: true

  # this service sync a local dir in your computer with a dir on the app server side
  bg-sync:
    image: cweagans/bg-sync
    volumes:
      - ${WORKSPACES}:/source
      - php-ext:${EXTSPACES}
    environment:
      SYNC_VERBOSE: 1
      SYNC_DESTINATION: ${EXTSPACES}
      SYNC_MAX_INOTIFY_WATCHES: 40000
    privileged: true

./build/Dockerfile 文件

FROM ubuntu
# install compile tool
RUN apt-get update && apt-get install -y \
    libxml2 \
    libxml2-dev \
    autoconf

.env 文件

# 扩展源文件目录(宿主机)
WORKSPACES=./php-src

# 扩展源文件目录(容器内)
EXTSPACES=/root/php-src

3.下载源码并解压,重命名

源码下载地址:https://www.php.net/releases/
解压,并重命名为 php-src ,按照步骤 2 中的文件目录结构复制到目录下即可。

4.构建 docker-compose

·切换到 php-ext目录下
·docker-compose up --build

等待出现下图即成功

image.png

5.源码安装 php

 ·进入 Ubuntu 容器
·切换到/root/php-src目录下
·依次运行一下命令进行源码安装:
./configure --enable-debug
make 
sudo make install
make clean(次步非必须)

如图所示,即为安装成功:


image.png

6.创建一个简单的扩展

6.1PHP提供了一个命令用于生成扩展的基本文件架构,只要调用该命令即可。
cd php-src/ext/
./ext_skel --extname=aatest  //aatest为扩展的名称

在命令行中出现如下提示,即为成功

root@544e81fb3734:~/php-src/ext# ./ext_skel --extname=aatest
Creating directory aatest
Creating basic files: config.m4 config.w32 .gitignore aatest.c php_aatest.h CREDITS EXPERIMENTAL tests/001.phpt aatest.php [done].

To use your new extension, you will have to execute the following steps:

1.  $ cd ..
2.  $ vi ext/aatest/config.m4
3.  $ ./buildconf
4.  $ ./configure --[with|enable]-aatest
5.  $ make
6.  $ ./sapi/cli/php -f ext/aatest/aatest.php
7.  $ vi ext/aatest/aatest.c
8.  $ make

Repeat steps 3-6 until you are satisfied with ext/aatest/config.m4 and
step 6 confirms that your module is compiled into PHP. Then, start writing
code and repeat the last two steps as often as necessary.

此时,可以按照提示步骤运行,也可继续跟随本文后面的步骤,意思相同。

成功之后打开 php-src/ext/aatest目录,上面的命令已经帮我们生成好了一些文件。
最主要的是 config.m4, php_aatest.h, aatest.c 这三个文件。

config.m4 //编译配置文件
php_aatest.h //扩展头文件
aatest.c //扩展源码

6.2修改config.m4

// 注意:dnl 开头的内容为注释
PHP_ARG_ENABLE(aatest, whether to enable aatest support,
  Make sure that the comment is aligned:
[  --enable-aatest           Enable aatest support])

if test "$PHP_AATEST" != "no"; then
    PHP_NEW_EXTENSION(aatest, aatest.c, $ext_shared)
fi

6.3修改 aatest.c

PHP_FUNCTION(confirm_aatest_compiled)
{
    php_printf("hello aatest!\n");
    return;
}

6.4编译扩展

cd aaetest
phpize
./configure --with-php-config=/usr/local/bin/php-config
make
sudo make install

----------------------------------------------------------------------
成功提示:
Build complete.
Don't forget to run 'make test'.
Installing shared extensions:     /usr/local/lib/php/extensions/no-debug-non-zts-20160303/

其中第三步,php-config 的路径来自于源码安装之后的成功提示中,如下所示:

php-config.png

6.5运行测试文件

php -q aatest.php
运行结果:
Functions available in the test extension:
confirm_aatest_compiled
hello aatest!

----------------------------------------------------------------------
此时,代表扩展是正确的。

6.6添加php.ini 和扩展

虽然上面的步骤证明了扩展是正确的,但是通过命令 php -m 发现此时扩展中还没有刚才创建的扩展,但是查看步骤6.4的存放扩展的文件夹中,已经将扩展文件加进去了。于是猜想可能还需要在配置文件中,添加扩展的路径,但是。。。php --ini查看,居然连 php.ini 文件都没有!!!

root@544e81fb3734:/# php -m
[PHP Modules]
Core
ctype
date
dom
......
[Zend Modules]

root@544e81fb3734:/# php -i | grep aatest
root@544e81fb3734:/# ls /usr/local/lib/php/extensions/no-debug-non-zts-20160303/
aatest.so  opcache.a  opcache.so

root@544e81fb3734:/# php --ini
Configuration File (php.ini) Path: /usr/local/lib
Loaded Configuration File:         (none)
Scan for additional .ini files in: (none)
Additional .ini files parsed:      (none)

查询得知,源码编译完了之后就是没有 php.ini文件,需要手动添加

1.首先确定 php.ini文件的存放路径
2.拷贝源码中的文件,并重命名为 php.ini
3.添加 extension=aatest.so,拷贝 至 步骤1的目录中

root@544e81fb3734:/# php -i | grep "php.ini"
Configuration File (php.ini) Path => /usr/local/lib
root@544e81fb3734:/# cd root/php-src/
root@544e81fb3734:~/php-src# ls
CODING_STANDARDS    Makefile.objects                  README.SUBMITTING_PATCH    Zend           config.sub       libtool        php.ini-development      stub.c
CONTRIBUTING.md     NEWS                              README.TESTING             acinclude.m4   configure        ltmain.sh      php.ini-production       tests
......
root@544e81fb3734:~/php-src# cp php.ini-development php.ini

----------------------------------------------------------------------
//php.ini文件中
......
;extension=php_pdo_sqlite.dll
;extension=php_pgsql.dll
;extension=php_shmop.dll
//添加下面这行进行 aatest 扩展的添加
extension=aatest.so

; The MIBS data available 
......
----------------------------------------------------------------------

root@544e81fb3734:~/php-src# cp php.ini /usr/local/lib/php.ini
root@544e81fb3734:~/php-src# ls /usr/local/lib/
php  php.ini  python3.6
root@544e81fb3734:~/php-src# php -i | grep "php.ini"
Configuration File (php.ini) Path => /usr/local/lib
Loaded Configuration File => /usr/local/lib/php.ini
root@544e81fb3734:~/php-src# php -m
[PHP Modules]
aatest
Core
ctype
.......
//上面两条命令查看,aatest 扩展已经有了
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,752评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,100评论 3 387
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 159,244评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,099评论 1 286
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,210评论 6 385
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,307评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,346评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,133评论 0 269
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,546评论 1 306
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,849评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,019评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,702评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,331评论 3 319
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,030评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,260评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,871评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,898评论 2 351

推荐阅读更多精彩内容