站長(zhǎng)資訊網(wǎng)
php入門(mén)到就業(yè)線上直播課：進(jìn)入學(xué)習(xí)
Apipost = Postman + Swagger + Mock + Jmeter 超好用的API調(diào)試工具：點(diǎn)擊使用
眾所周知，作為一名phper，對(duì)php有限的功能感到尷尬，比如：調(diào)用ffmpeg視頻處理工具。沒(méi)有專(zhuān)門(mén)的擴(kuò)展來(lái)操作的，什么？利用php system函數(shù)調(diào)用？對(duì)于開(kāi)源的php腳本，這太不安全了！
這個(gè)時(shí)候作為深資的phper會(huì)考慮開(kāi)發(fā)php擴(kuò)展，在擴(kuò)展中實(shí)現(xiàn)對(duì)ffmpeg的操作。
目前c站上對(duì)于rust如何開(kāi)發(fā)php擴(kuò)展的文章幾乎沒(méi)有，就連開(kāi)發(fā)php擴(kuò)展流程的文章也都很對(duì)付。特此撰寫(xiě)此文?。?！
為什么要使用php擴(kuò)展？
優(yōu)點(diǎn)：
1、php擴(kuò)展是C開(kāi)發(fā)的，那速度沒(méi)得說(shuō)。
2、耦合性高，它的出現(xiàn)就是用來(lái)增強(qiáng)php的。
3、安全性高，畢竟擴(kuò)展是編譯后的程序，代碼不開(kāi)源。
缺點(diǎn)：
1、需針對(duì)php版本及系統(tǒng)環(huán)境進(jìn)行開(kāi)發(fā)，那么就比較麻煩了。也就是說(shuō)7.4版本的php，liunx環(huán)境下開(kāi)發(fā)的擴(kuò)展，只支持該php版本及系統(tǒng)。
2、需要會(huì)C、C++，當(dāng)然本文是以rust進(jìn)行開(kāi)發(fā)，對(duì)C的數(shù)據(jù)類(lèi)型進(jìn)行了解，對(duì)rust FFI的操作及數(shù)據(jù)類(lèi)型轉(zhuǎn)換需精通。
3、調(diào)試相對(duì)麻煩。
為什么要用rust開(kāi)發(fā)php擴(kuò)展？
原因很簡(jiǎn)單，這還要說(shuō)起rust的語(yǔ)言特性。
1、因“所有權(quán)”的特性使你的程序更安全，不會(huì)像C那樣出現(xiàn)各種“玄學(xué)BUG”。
2、擁有C一樣的性能。
3、畢竟是最受歡迎的語(yǔ)言，我很看好它的發(fā)展。
rust開(kāi)發(fā)php擴(kuò)展流程：
當(dāng)然，rust目前是沒(méi)有專(zhuān)門(mén)開(kāi)發(fā)php擴(kuò)展的骨架。所以我的邏輯也很簡(jiǎn)單，利用rust開(kāi)發(fā)靜態(tài)庫(kù)暴露給C【涉及FFI的了解】。我們?cè)趐hp官方骨架中直接引入rust靜態(tài)庫(kù)調(diào)用其方法即可。
開(kāi)發(fā)環(huán)境
寶塔【CentOS 7.6】、GCC【涉及php擴(kuò)展骨架的編譯，我這里系統(tǒng)內(nèi)置就有，如果編譯擴(kuò)展報(bào)相關(guān)錯(cuò)了自行安裝】、對(duì)應(yīng)php版本源碼、web環(huán)境【寶塔中安裝對(duì)應(yīng)php版本、nginx、mysql等等】
開(kāi)發(fā)整體流程：
1、準(zhǔn)備寶塔
寶塔安裝流程：CentOS寶塔搭建（超詳細(xì)）_一碼超人的博客-CSDN博客_centos 寶塔
這里我們以開(kāi)發(fā)php7.4擴(kuò)展為例。
2、下載php7.4 liunx版源碼
php官網(wǎng)：PHP: Hypertext Preprocessor
注意！該源碼版本必須與你環(huán)境php版本完全一致?。?！
下載完畢：
3、上傳php源碼到寶塔
/usr/phper
在usr下創(chuàng)建一個(gè)phper文件夾，然后將源碼壓縮包上傳到此處。
解壓該壓縮包
4、創(chuàng)建一個(gè)我們自己的擴(kuò)展
/usr/phper/php-7.4.30/ext目錄下有這么一個(gè)php文件，它可以創(chuàng)建擴(kuò)展！
注意設(shè)置命令行版本，因?yàn)榻酉聛?lái)利用php命令必須是版本一致的！
在剛剛的目錄下，點(diǎn)擊終端，輸入創(chuàng)建擴(kuò)展命令。
php ext_skel.php --ext 擴(kuò)展名稱(chēng)
這里就多出了一個(gè)新的擴(kuò)展源碼文件。
在該目錄下點(diǎn)擊終端，輸入：
phpize
接著輸入：
./configure --with-php-config=/www/server/php/74/bin/php-config
注意這個(gè)參數(shù)php路徑，如果是別的版本，請(qǐng)自行在寶塔里安裝找到對(duì)應(yīng)版本路徑，它們都是放一起的。
回車(chē)開(kāi)始進(jìn)行檢查了
最后輸入：
make
進(jìn)行編譯。
這個(gè)目錄下便是編譯出來(lái)的so擴(kuò)展最終文件了！
讓我們看下默認(rèn)生成的擴(kuò)展有哪些功能
查看主文件【需了解php擴(kuò)展骨架，這里以它默認(rèn)給的為例】
也就是說(shuō)，剛剛編譯出來(lái)的擴(kuò)展，是有這兩個(gè)函數(shù)的，咱們測(cè)試一下玩玩。
注意！每次修改主文件，都需要重新按上述命令跑一遍，否則不生效，很奇怪！
phpize ./configure --with-php-config=/www/server/php/74/bin/php-config make
5、使用擴(kuò)展
復(fù)制剛剛生成的擴(kuò)展文件到我們php環(huán)境的擴(kuò)展里
配置php.ini加載hello.so擴(kuò)展
extension = hello.so
保存后記得重新啟動(dòng)下php，否則不生效的！
在文件管理中點(diǎn)擊終端，輸入：
php -m
可以看到我們的擴(kuò)展在列表中了。
創(chuàng)建一個(gè)站點(diǎn)，測(cè)試下擴(kuò)展中兩個(gè)函數(shù)。
看好，php版本是7.4
訪問(wèn)站點(diǎn)
沒(méi)有問(wèn)題哦！
當(dāng)然也可以通過(guò)命令行運(yùn)行php腳本查看結(jié)果【前提是網(wǎng)站那里php命令行版本設(shè)置的7.4】
php index.php
OK！從創(chuàng)建到生成到使用擴(kuò)展的流程結(jié)束，接下來(lái)才進(jìn)入正題，開(kāi)始用rust開(kāi)發(fā)擴(kuò)展。
6、rust與php擴(kuò)展的整合開(kāi)發(fā)
開(kāi)發(fā)工具：CLion
需要rust環(huán)境與CLion中rust插件的安裝與配置，這個(gè)自行去百度，比我想象中的全！
創(chuàng)建一個(gè)hello命名的庫(kù)項(xiàng)目
我們寫(xiě)兩個(gè)導(dǎo)出函數(shù)，分別是加法功能和base64字符串解析功能。
lib.rs
#![crate_type = "staticlib"] extern crate libc; //使用C類(lèi)型約束 use std::ffi::{CStr, CString}; use libc::{c_char, c_int}; //add_int【參數(shù)：兩個(gè)c語(yǔ)言的int類(lèi)型】：對(duì)兩個(gè)int類(lèi)型數(shù)值進(jìn)行相加 #[no_mangle] pub extern "C" fn add_int(x:c_int, y:c_int) -> c_int{ //兩個(gè)數(shù)相加 return x + y; } //base64_decode函數(shù)【參數(shù)：c語(yǔ)言的*char類(lèi)型】：對(duì)字符串進(jìn)行base64解碼 #[no_mangle] pub extern "C" fn base64_decode(s:*const c_char) -> *mut c_char { //c char類(lèi)型轉(zhuǎn)&str let h = unsafe{CStr::from_ptr(s).to_str().unwrap()}; //base64 解碼 let s = base64::decode(h.to_string()); if let Err(_s) = s { panic!("類(lèi)型錯(cuò)誤！"); } let n = String::from_utf8(s.unwrap().clone()).unwrap(); //String 轉(zhuǎn) C CString let a = CString::new(n.as_str()).unwrap(); //C CString 轉(zhuǎn) C char //這里實(shí)屬無(wú)奈，因?yàn)閞ust ffi中闡述，對(duì)字符串返回只能是該字符串地址，所以需要該方法進(jìn)行返回C才能接收到！ let r = a.into_raw(); return r; }
Cargo.toml
[package] name = "hello" version = "0.1.0" edition = "2021" # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html [lib] name = "hello" crate-type = ["staticlib"] [dependencies] libc = "*" base64 = "0.12.1"
注意在編譯過(guò)程中涉及系統(tǒng)類(lèi)型，不然在引入該靜態(tài)庫(kù)編譯擴(kuò)展可能報(bào)錯(cuò)，提示不支持。
編譯64位靜態(tài)庫(kù)
rustup target add x86_64-unknown-linux-musl cargo build --target x86_64-unknown-linux-musl --release
編譯32位靜態(tài)庫(kù)
rustup target add i686-unknown-linux-musl cargo build --target i686-unknown-linux-musl --release
這里我們是64位系統(tǒng)。
會(huì)生成一個(gè).a文件，該文件便是liunx支持的靜態(tài)庫(kù)文件。
生成支持C語(yǔ)言的膠水頭文件【用于C調(diào)用該庫(kù)需要寫(xiě)的函數(shù)聲明，很方便】
創(chuàng)建cbindgen.toml文件
內(nèi)容：
language = "C"
安裝cbindgen,創(chuàng)建頭文件。
cargo install --force cbindgen cbindgen --config cbindgen.toml --crate 項(xiàng)目名稱(chēng) --output 頭文件名稱(chēng).h
自動(dòng)生成了C語(yǔ)言的函數(shù)聲明hello.h文件，用于調(diào)用。
回到之前我們創(chuàng)建的hello擴(kuò)展
創(chuàng)建lib文件夾
將剛剛編譯出來(lái)的靜態(tài)庫(kù).a文件上傳到lib目錄下
將剛剛創(chuàng)建的.h頭文件上傳到擴(kuò)展目錄下
配置.m4預(yù)編譯文件【關(guān)鍵】
設(shè)置引入lib文件夾中的靜態(tài)庫(kù)文件
PHP_ADD_LIBRARY_WITH_PATH(hello, /usr/phper/php-7.4.30/ext/hello/lib, HELLO_SHARED_LIBADD) PHP_SUBST(HELLO_SHARED_LIBADD)
保存.m4
編寫(xiě)主文件
/* hello extension for PHP */ #ifdef HAVE_CONFIG_H # include "config.h" #endif #include "php.h" #include "ext/standard/info.h" #include "php_hello.h" #include "hello.h"//引入頭文件 /* For compatibility with older PHP versions */ #ifndef ZEND_PARSE_PARAMETERS_NONE #define ZEND_PARSE_PARAMETERS_NONE() ZEND_PARSE_PARAMETERS_START(0, 0) ZEND_PARSE_PARAMETERS_END() #endif /* {{{ void hello_test1() */ PHP_FUNCTION(hello_test1) { ZEND_PARSE_PARAMETERS_NONE(); int num = add_int(1,2);//rust中兩個(gè)數(shù)相加函數(shù)并返回。 php_printf("The extension %d is loaded and working!rn", num); } /* }}} */ /* {{{ string hello_test2( [ string $var ] ) */ PHP_FUNCTION(hello_test2) { char *var = "World"; size_t var_len = sizeof("World") - 1; zend_string *retval; ZEND_PARSE_PARAMETERS_START(0, 1) Z_PARAM_OPTIONAL Z_PARAM_STRING(var, var_len) ZEND_PARSE_PARAMETERS_END(); char *newstr = base64_decode(var);//rust中解析base64字符串并返回。 retval = strpprintf(0, "Hello %s", newstr); RETURN_STR(retval); } /* }}}*/ /* {{{ PHP_RINIT_FUNCTION */ PHP_RINIT_FUNCTION(hello) { #if defined(ZTS) && defined(COMPILE_DL_HELLO) ZEND_TSRMLS_CACHE_UPDATE(); #endif return SUCCESS; } /* }}} */ /* {{{ PHP_MINFO_FUNCTION */ PHP_MINFO_FUNCTION(hello) { php_info_print_table_start(); php_info_print_table_header(2, "hello support", "enabled"); php_info_print_table_end(); } /* }}} */ /* {{{ arginfo */ ZEND_BEGIN_ARG_INFO(arginfo_hello_test1, 0) ZEND_END_ARG_INFO() ZEND_BEGIN_ARG_INFO(arginfo_hello_test2, 0) ZEND_ARG_INFO(0, str) ZEND_END_ARG_INFO() /* }}} */ /* {{{ hello_functions[] */ static const zend_function_entry hello_functions[] = { PHP_FE(hello_test1, arginfo_hello_test1) PHP_FE(hello_test2, arginfo_hello_test2) PHP_FE_END }; /* }}} */ /* {{{ hello_module_entry */ zend_module_entry hello_module_entry = { STANDARD_MODULE_HEADER, "hello", /* Extension name */ hello_functions, /* zend_function_entry */ NULL, /* PHP_MINIT - Module initialization */ NULL, /* PHP_MSHUTDOWN - Module shutdown */ PHP_RINIT(hello), /* PHP_RINIT - Request initialization */ NULL, /* PHP_RSHUTDOWN - Request shutdown */ PHP_MINFO(hello), /* PHP_MINFO - Module info */ PHP_HELLO_VERSION, /* Version */ STANDARD_MODULE_PROPERTIES }; /* }}} */ #ifdef COMPILE_DL_HELLO # ifdef ZTS ZEND_TSRMLS_CACHE_DEFINE() # endif ZEND_GET_MODULE(hello) #endif
刪除之前生成的擴(kuò)展文件
重新生成擴(kuò)展
phpize ./configure --with-php-config=/www/server/php/74/bin/php-config make
大小都變了，說(shuō)明我們的靜態(tài)庫(kù)在里面了哈哈。
按上述使用擴(kuò)展流程替換擴(kuò)展
注意！替換擴(kuò)展文件后要重啟PHP哦，不然不生效！
7、測(cè)試rust開(kāi)發(fā)的php擴(kuò)展
網(wǎng)頁(yè)測(cè)試
命令行測(cè)試
也可以通過(guò)php擴(kuò)展骨架直接進(jìn)行測(cè)試
編寫(xiě)要執(zhí)行測(cè)試的擴(kuò)展函數(shù)
--TEST-- hello_test2() Basic test --SKIPIF-- <?php if (!extension_loaded('hello')) { echo 'skip'; } ?> --FILE-- <?php hello_test1(); var_dump(hello_test2('5LiA56CB6LaF5Lq6')); ?> --EXPECT-- string(11) "Hello World" string(9) "Hello PHP"
擴(kuò)展目錄下直接輸入：
make test
執(zhí)行后 tests目錄下輸出了一個(gè).out文件
是不是這樣更方便了呢？
