Ein Artikel, der ausführlich erklärt, wie man PHP-Erweiterungen in Rust (Liunx-Version) entwickelt.

Wie wir alle wissen, sind mir als PHP-Benutzer die eingeschränkten Funktionen von PHP peinlich, beispielsweise der Aufruf des ffmpeg-Videoverarbeitungstools. Es gibt keine spezielle Erweiterung, um es zu bedienen, was? Verwenden Sie einen PHP-Systemfunktionsaufruf? Für Open-Source-PHP-Skripte ist dies zu unsicher!

Zu diesem Zeitpunkt werden Sie als erfahrener PHP-Mitarbeiter die Entwicklung einer PHP-Erweiterung in Betracht ziehen und den Betrieb von ffmpeg in der Erweiterung implementieren.

Derzeit gibt es auf der Website fast keine Artikel zur Entwicklung von PHP-Erweiterungen in Rust. Selbst die Artikel zum Prozess der Entwicklung von PHP-Erweiterungen sind sehr schwierig zu handhaben. Ich schreibe diesen Artikel! ! !

Warum PHP-Erweiterung verwenden?

Vorteile:

1. Die PHP-Erweiterung wurde in C entwickelt, daher ist die Geschwindigkeit unglaublich.

2. Hohe Kopplung, sein Erscheinungsbild wird zur Verbesserung von PHP verwendet.

3. Hohe Sicherheit. Schließlich handelt es sich bei der Erweiterung um ein kompiliertes Programm und der Code ist nicht Open Source.

Nachteile:

1. Es muss entsprechend der PHP-Version und der Systemumgebung entwickelt werden, was problematischer ist. Mit anderen Worten: Version 7.4 von PHP, Erweiterungen, die in der Linux-Umgebung entwickelt wurden, unterstützt nur diese PHP-Version und dieses PHP-System.

2. Sie müssen C und C++ kennen. Natürlich wurde dieser Artikel in Rust entwickelt. Sie müssen die Datentypen von C verstehen und sich mit der Funktionsweise und Datentypkonvertierung von Rust FFI auskennen.

3. Das Debuggen ist relativ mühsam.

Warum Rust verwenden, um PHP-Erweiterungen zu entwickeln?

Der Grund ist ganz einfach und es geht auch um die sprachlichen Merkmale von Rost.

1. Aufgrund der „Ownership“-Funktion ist Ihr Programm sicherer und weist keine verschiedenen „metaphysischen Fehler“ wie C auf.

2. Es hat die gleiche Leistung wie C.

3. Schließlich ist es die beliebteste Sprache und ich bin sehr optimistisch, was ihre Entwicklung angeht.

Rust-Entwicklungsprozess für PHP-Erweiterungen:

Natürlich verfügt Rust derzeit nicht über ein Skelett speziell für die Entwicklung von PHP-Erweiterungen. Daher ist meine Logik auch sehr einfach. Ich verwende Rust, um eine statische Bibliothek zu entwickeln und sie C [mit FFI-Kenntnissen] zur Verfügung zu stellen. Wir können die statische Rust-Bibliothek direkt in das offizielle PHP-Skelett einführen und ihre Methoden aufrufen.

Entwicklungsumgebung

Pagode [CentOS 7.6], GCC [Beinhaltet die Kompilierung des PHP-Erweiterungsskeletts, ich habe es hier in das System eingebaut, wenn die Kompilierungserweiterung einen Fehler meldet, installieren Sie es selbst ], entsprechender PHP-Versionsquellcode, Webumgebung [Installieren Sie die entsprechende PHP-Version, Nginx, MySQL usw.]

Der gesamte Entwicklungsprozess:

1. Bereiten Sie die Pagode vor

Pagodeninstallationsprozess: CentOS-Pagodenbau (sehr detailliert)_One Code Superman's Blog-CSDN Blog_Centos-Pagode

Hier nehmen wir die Entwicklung der PHP7.4-Erweiterung als Beispiel.

2. Laden Sie den Quellcode der PHP7.4-Liunx-Version herunter. Die Quellcodeversion muss genau mit der PHP-Version Ihrer Umgebung übereinstimmen! ! !

Download abgeschlossen:

3. Laden Sie den PHP-Quellcode in die Pagode hoch

/usr/phper

Erstellen Sie einen PHP-Ordner unter usr und laden Sie dann das komprimierte Quellcodepaket hoch hier .

Entpacken Sie das komprimierte Paket

4. Erstellen Sie unsere eigene Erweiterung

Es gibt eine solche PHP-Datei im Verzeichnis /usr/phper/php-7.4.30/ext, it Erweiterungen können erstellt werden!

Achten Sie auf die Einstellung der Kommandozeilenversion, denn die nachfolgenden PHP-Befehle müssen von der gleichen Version sein!

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

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视频教程》

Das obige ist der detaillierte Inhalt vonEin Artikel, der ausführlich erklärt, wie man PHP-Erweiterungen in Rust (Liunx-Version) entwickelt.. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!