PHP 擴(kuò)展開(kāi)發(fā)環(huán)境搭建

環(huán)境搭建步驟：

  1. 創(chuàng)建 docker 容器
    （原因：①. Mac下環(huán)境配置有坑，不好弄（其實(shí)就是搞不定-_-||）；②. 不想搞亂 Mac 環(huán)境；③. docker 容器可以隨時(shí)刪除和重建）
  2. 下載PHP源碼，并源碼安裝 PHP（源碼必須下，后面擴(kuò)展開(kāi)發(fā)還有用）
  3. 通過(guò)ext目錄下ext_skel腳本生成擴(kuò)展的基本框架：./ext_skel --extname；

1.環(huán)境配置說(shuō)明：

我的環(huán)境：Mac + Docker + Ubuntu + PHP7.1.26 + bg-sync
Mac、Docker、Ubuntu 這三個(gè)不用解釋，php 版本這個(gè)沒(méi)有限制，只是需要注意，生成擴(kuò)展基本框架的腳本 7.1 版本跟 7.3 的有點(diǎn)區(qū)別。
重點(diǎn)說(shuō)這個(gè) bg-sync ，這是我用到的一個(gè) Docker 容器，用來(lái)同步容器內(nèi)和宿主機(jī)（Mac）的文件，否則只能用 vim 在容器中進(jìn)行編輯。（說(shuō)白了就是技術(shù)渣，用不慣 vim .）

2.創(chuàng)建 Docker 容器

因?yàn)檫@里會(huì)用到 2 個(gè)容器，一個(gè)是 Ubuntu 容器，一個(gè)是用于同步文件的 bg-sync 容器，所以用 docker-compose 去組織容器
目錄結(jié)構(gòu):

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

docker-compose.yml 文件:

version: '3'

# 掛載數(shù)據(jù)卷
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 文件

# 擴(kuò)展源文件目錄（宿主機(jī)）
WORKSPACES=./php-src

# 擴(kuò)展源文件目錄（容器內(nèi)）
EXTSPACES=/root/php-src

3.下載源碼并解壓，重命名

源碼下載地址：https://www.php.net/releases/
解壓，并重命名為 php-src ，按照步驟 2 中的文件目錄結(jié)構(gòu)復(fù)制到目錄下即可。

4.構(gòu)建 docker-compose

·切換到 php-ext目錄下
·docker-compose up --build

等待出現(xiàn)下圖即成功

image.png

5.源碼安裝 php

 ·進(jìn)入 Ubuntu 容器
·切換到/root/php-src目錄下
·依次運(yùn)行一下命令進(jìn)行源碼安裝：
./configure --enable-debug
make 
sudo make install
make clean（次步非必須）

如圖所示，即為安裝成功：


image.png

6.創(chuàng)建一個(gè)簡(jiǎn)單的擴(kuò)展

6.1PHP提供了一個(gè)命令用于生成擴(kuò)展的基本文件架構(gòu)，只要調(diào)用該命令即可。
cd php-src/ext/
./ext_skel --extname=aatest  //aatest為擴(kuò)展的名稱

在命令行中出現(xiàn)如下提示，即為成功

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.

此時(shí)，可以按照提示步驟運(yùn)行，也可繼續(xù)跟隨本文后面的步驟，意思相同。

成功之后打開(kāi) php-src/ext/aatest目錄，上面的命令已經(jīng)幫我們生成好了一些文件。
最主要的是 config.m4, php_aatest.h, aatest.c 這三個(gè)文件。

config.m4 //編譯配置文件
php_aatest.h //擴(kuò)展頭文件
aatest.c //擴(kuò)展源碼

6.2修改config.m4

// 注意：dnl 開(kāi)頭的內(nèi)容為注釋
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編譯擴(kuò)展

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 的路徑來(lái)自于源碼安裝之后的成功提示中，如下所示：

php-config.png

6.5運(yùn)行測(cè)試文件

php -q aatest.php
運(yùn)行結(jié)果：
Functions available in the test extension:
confirm_aatest_compiled
hello aatest!

----------------------------------------------------------------------
此時(shí)，代表擴(kuò)展是正確的。

6.6添加php.ini 和擴(kuò)展

雖然上面的步驟證明了擴(kuò)展是正確的，但是通過(guò)命令 php -m 發(fā)現(xiàn)此時(shí)擴(kuò)展中還沒(méi)有剛才創(chuàng)建的擴(kuò)展，但是查看步驟6.4的存放擴(kuò)展的文件夾中，已經(jīng)將擴(kuò)展文件加進(jìn)去了。于是猜想可能還需要在配置文件中，添加擴(kuò)展的路徑，但是。。。php --ini查看，居然連 php.ini 文件都沒(méi)有?。?！

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)

查詢得知，源碼編譯完了之后就是沒(méi)有 php.ini文件，需要手動(dòng)添加

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
//添加下面這行進(jìn)行 aatest 擴(kuò)展的添加
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 擴(kuò)展已經(jīng)有了
最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡(jiǎn)書(shū)系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容