Rust（Liunx版）でPHP拡張機能を開発する方法を詳しく解説した記事

誰もが知っているように、phper として、ffmpeg ビデオ処理ツールの呼び出しなど、php の機能が限られていることを恥ずかしく思います。操作するための特別な拡張機能はありません。 PHPシステム関数呼び出しを使用していますか?オープンソースの PHP スクリプトの場合、これはあまりにも危険です。

この時点で、上級 phper として、php 拡張機能の開発を検討し、その拡張機能に ffmpeg の操作を実装します。

現状、サイト c には Rust で PHP 拡張機能を開発する方法に関する記事はほとんどなく、PHP 拡張機能の開発プロセスに関する記事ですら非常に扱いにくいです。 この記事を書いています! ！ ！

php 拡張機能を使用する理由

利点:

1. PHP 拡張機能は C で開発されているため、速度は驚異的です。

2. 結合度が高く、その外観は PHP を強化するために使用されます。

3. 高いセキュリティ: 結局のところ、拡張機能はコンパイルされたプログラムであり、コードはオープンソースではありません。

デメリット:

1. PHPのバージョンやシステム環境に合わせて開発する必要があり、面倒です。つまり、Linux 環境で開発された拡張機能である PHP バージョン 7.4 は、この PHP バージョンとシステムのみをサポートします。

2. C と C の知識が必要です。もちろん、この記事は Rust で開発されています。C のデータ型を理解し、Rust FFI の操作とデータ型変換に習熟する必要があります。

3. デバッグは比較的面倒です。

PHP 拡張機能の開発に Rust を使用する理由は何ですか?

理由は非常に簡単で、Rust の言語機能についても説明されています。

1. 「所有権」機能のおかげで、プログラムはより安全になり、C のようなさまざまな「形而上学的なバグ」を抱えなくなります。

2. C と同等のパフォーマンスを持ちます。

3. 結局のところ、これは最も人気のある言語であり、私はその開発について非常に楽観的です。

rust 開発 PHP 拡張プロセス:

もちろん、現時点では Rust には PHP 拡張機能の開発に特化したスケルトンはありません。私のロジックも非常に単純で、Rust を使用して静的ライブラリを開発し、それを C に公開しています (FFI の知識が含まれています)。 Rust 静的ライブラリを公式の PHP スケルトンに直接導入し、そのメソッドを呼び出すことができます。

開発環境

Pagoda [CentOS 7.6]、GCC [PHP 拡張スケルトンのコンパイルを含む] , ここでシステムに組み込んでいます。コンパイル拡張機能が関連エラーを報告する場合は、自分でインストールしてください]、対応する PHP バージョンのソース コード、Web 環境 [対応する PHP バージョン、nginx、mysql などをパゴダにインストールしてください] ]

全体的な開発プロセス:

#1. Pagoda の準備

Pagoda のインストール プロセス: CentOS Pagoda の構築 (超詳細)_One Code Superman's Blog-CSDN Blog_centos Pagoda

ここで取り上げますphp7.4 拡張機能の開発を例として説明します。

2. php7.4 liunx バージョンのソース コードをダウンロードします。

php 公式 Web サイト: PHP: Hypertext Preprocessor

# ＃＃＃ ＃＃＃＃＃ ＃＃＃＃＃＃＃＃＃＃＃＃ 知らせ！ソース コードのバージョンは、環境の PHP バージョンとまったく同じである必要があります。 ！ ！

ダウンロード完了:

3. PHP をアップロードします。ソース コード パゴダに移動します。

/usr/phper

usr の下に phper フォルダーを作成し、ソース コード圧縮パッケージをここにアップロードします。

# 圧縮パッケージを解凍します

## 4. 独自の拡張機能を作成します

/usr/phper/php-7.4.30/ext ディレクトリには、拡張機能を作成できる php ファイルがあります。

# 後続の php コマンドは同じバージョンである必要があるため、コマンド ラインのバージョンの設定には注意してください。

 在刚刚的目录下，点击终端，输入创建扩展命令。

php ext_skel.php --ext 扩展名称

 

 这里就多出了一个新的扩展源码文件。

 

 在该目录下点击终端，输入：

phpize

 接着输入：

./configure --with-php-config=/www/server/php/74/bin/php-config

注意这个参数php路径，如果是别的版本，请自行在宝塔里安装找到对应版本路径，它们都是放一起的。

 回车开始进行检查了

 最后输入：

make

进行编译。

 

 这个目录下便是编译出来的so扩展最终文件了！

 让我们看下默认生成的扩展有哪些功能

 查看主文件【需了解php扩展骨架，这里以它默认给的为例】

 也就是说，刚刚编译出来的扩展，是有这两个函数的，咱们测试一下玩玩。

注意！每次修改主文件，都需要重新按上述命令跑一遍，否则不生效，很奇怪！

phpize
./configure --with-php-config=/www/server/php/74/bin/php-config
make

5、使用扩展

 复制刚刚生成的扩展文件到我们php环境的扩展里

 

 配置php.ini加载hello.so扩展

 

 

extension = hello.so

保存后记得重新启动下php，否则不生效的！

 

 

在文件管理中点击终端，输入：

php -m

可以看到我们的扩展在列表中了。

创建一个站点，测试下扩展中两个函数。

 看好，php版本是7.4

 

 访问站点

 没有问题哦！

当然也可以通过命令行运行php脚本查看结果【前提是网站那里php命令行版本设置的7.4】

php index.php

 OK！从创建到生成到使用扩展的流程结束，接下来才进入正题，开始用rust开发扩展。

6、rust与php扩展的整合开发

开发工具：CLion

需要rust环境与CLion中rust插件的安装与配置，这个自行去百度，比我想象中的全！

 创建一个hello命名的库项目

 我们写两个导出函数，分别是加法功能和base64字符串解析功能。

 lib.rs

#![crate_type = "staticlib"]

extern crate libc;

//使用C类型约束
use std::ffi::{CStr, CString};
use libc::{c_char, c_int};

//add_int【参数：两个c语言的int类型】：对两个int类型数值进行相加
#[no_mangle]
pub extern "C" fn add_int(x:c_int, y:c_int) -> c_int{
    //两个数相加
    return x + y;
}

//base64_decode函数【参数：c语言的*char类型】：对字符串进行base64解码
#[no_mangle]
pub extern "C" fn base64_decode(s:*const c_char) -> *mut c_char {
    //c char类型转&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!("类型错误！");
    }
    let n = String::from_utf8(s.unwrap().clone()).unwrap();
    //String 转 C CString
    let a = CString::new(n.as_str()).unwrap();
    //C CString 转 C char
    //这里实属无奈，因为rust ffi中阐述，对字符串返回只能是该字符串地址，所以需要该方法进行返回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"

注意在编译过程中涉及系统类型，不然在引入该静态库编译扩展可能报错，提示不支持。

编译64位静态库

rustup target add x86_64-unknown-linux-musl
cargo build --target x86_64-unknown-linux-musl --release

编译32位静态库

rustup target add i686-unknown-linux-musl
cargo build --target i686-unknown-linux-musl --release

这里我们是64位系统。

 会生成一个.a文件，该文件便是liunx支持的静态库文件。

生成支持C语言的胶水头文件【用于C调用该库需要写的函数声明，很方便】

创建cbindgen.toml文件

内容：

language = "C"

 

 安装cbindgen,创建头文件。

cargo install --force cbindgen
cbindgen --config cbindgen.toml --crate 项目名称 --output 头文件名称.h

 

 自动生成了C语言的函数声明hello.h文件，用于调用。

回到之前我们创建的hello扩展

创建lib文件夹

 将刚刚编译出来的静态库.a文件上传到lib目录下

 将刚刚创建的.h头文件上传到扩展目录下

 配置.m4预编译文件【关键】

 设置引入lib文件夹中的静态库文件

 

  PHP_ADD_LIBRARY_WITH_PATH(hello, /usr/phper/php-7.4.30/ext/hello/lib, HELLO_SHARED_LIBADD)
  PHP_SUBST(HELLO_SHARED_LIBADD)

 保存.m4

 编写主文件

 

/* 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中两个数相加函数并返回。
    
	php_printf("The extension %d is loaded and working!\r\n", 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

删除之前生成的扩展文件

 重新生成扩展

 

phpize
./configure --with-php-config=/www/server/php/74/bin/php-config
make

 大小都变了，说明我们的静态库在里面了哈哈。

按上述使用扩展流程替换扩展

注意！替换扩展文件后要重启PHP哦，不然不生效！

7、测试rust开发的php扩展

 

 

 网页测试

 命令行测试

 也可以通过php扩展骨架直接进行测试

 

 

 编写要执行测试的扩展函数

--TEST--
hello_test2() Basic test
--SKIPIF--
<?php
if (!extension_loaded(&#39;hello&#39;)) {
	echo &#39;skip&#39;;
}
?>
--FILE--
<?php
hello_test1();
var_dump(hello_test2(&#39;5LiA56CB6LaF5Lq6&#39;));
?>
--EXPECT--
string(11) "Hello World"
string(9) "Hello PHP"

 扩展目录下直接输入：

make test

 

执行后 tests目录下输出了一个.out文件

 

 是不是这样更方便了呢？

 以上就是整体的开发流程，需要经通过的话还是多少要了解C语言、php扩展骨架、rust精通。

推荐学习：《PHP视频教程》

以上がRust（Liunx版）でPHP拡張機能を開発する方法を詳しく解説した記事の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。