[번역] [php 확장 개발 및 임베디드] 19장 - 호스팅 환경 설정

호스팅 환경 설정

이제 PHPAPI의 세계를 알게 되었고 zval을 다음과 같이 사용할 수 있습니다. 글쎄, 언어의 내부 확장 메커니즘은 많은 작업을 수행하므로 이제는 기어를 바꿔서 이를 가장 잘 수행하는 데 사용할 시간입니다. >

소개를 검토하면서 PHP는 다음을 구축했습니다. 계층적 시스템. 최상위 계층은 사용자 공간 기능과 클래스 라이브러리의 모든 확장을 제공하는 동시에 그 아래에는 웹 서버의 인터페이스(예: Apache, iis 및 명령) 역할을 하는 서비스 API(SAPI) 계층이 있습니다. line 인터페이스 cli) 이러한 많은 sapi 구현 중에는 내장된 sapi인 특수 sapi가 있습니다. 이 sapi 구현이 빌드되면 모든 항목을 포함하는 라이브러리 객체가 생성됩니다. 여러분이 알고 있는 PHP 및 Zend API 함수와 변수. 이 라이브러리 개체에는 외부 프로그램 호출을 단순화하는 몇 가지 추가 도우미 함수와 매크로도 포함되어 있습니다.

임베디드 API용 라이브러리 및 헤더 파일 생성도 동일하게 수행됩니다. --enable-embed를 ./configure 명령에 전달하면 됩니다. 이전과 마찬가지로 --enable-debug를 사용하면 오류 보고 및 추적에 도움이 됩니다.

물론 --enable-maintainer-zts를 켜야 할 수도 있습니다. 이미 익숙한 이유로 인해 코드 오류를 확인하는 데 도움이 되지만, 특정 순간에 다른 이유가 있다고 가정합니다. 스크립트 작업을 수행하기 위해 PHP 임베디드 라이브러리를 사용하는 여러 애플리케이션이 있습니다. 애플리케이션 중 하나는 수명이 짧고 스레드를 사용하지 않으므로 효율성을 위해 ZTS를 끄는 것이 좋습니다.

이제 두 번째 애플리케이션이 웹 서버와 같은 스레드를 사용한다고 가정하면 각 스레드는 자체 요청 컨텍스트를 추적해야 합니다. ZTS가 꺼져 있으면 처음 두 애플리케이션만 이 라이브러리를 사용할 수 있습니다. 이 켜져 있으면 두 애플리케이션 모두 자체 프로세스 공간에서 동일한 공유 객체를 사용할 수 있습니다.

물론 두 애플리케이션을 동시에 빌드하고 서로 다른 이름을 지정할 수도 있습니다. 그러나 이는 필요하지 않을 때 ZTS를 포함하는 데 따른 작은 효율성 저하보다 더 큰 문제입니다.

기본적으로 임베디드 라이브러리는 libphp5.so 공유 객체로 구축됩니다. Windows에서는 동적 링크 라이브러리이지만 선택적 static 키워드(--enable-embed=static)를 사용하여 정적 라이브러리로 구축할 수도 있습니다.

정적 라이브러리로 구축 ZTS/ZTS가 아닌 문제를 방지하고 시스템에 여러 PHP 버전이 있을 가능성이 있습니다. 결과적으로 애플리케이션 바이너리가 상당히 커지고 전체 ZendEngine 및 PHP 프레임워크를 호스팅하게 됩니다. , 선택할 때 상대적으로 더 작은 라이브러리가 필요한지 신중하게 고려해야 합니다.

어떤 빌드 방법을 선택하든 일단 make install을 실행하면 libphp5가 lib에 복사됩니다. / ./configure에서 지정한 PREFIX 디렉토리 아래의 디렉토리 또한 PREFIX/include/php/sapi/embed에도 있습니다. php_embed.h라는 헤더 파일과 기타 중요한 헤더 파일을 디렉토리에 넣으세요.

호스트 애플리케이션을 빌드하고 컴파일하려면

에서 PHP 임베디드 라이브러리를 사용할 때 필요합니다. 라이브러리의 핵심은 목적이 없는 코드 모음일 뿐입니다. 라이브러리가 작동하려면 PHP를 포함하는 애플리케이션이 필요합니다. 먼저 Zend 엔진을 시작하고 PHP를 초기화하여 처리하도록 합니다. 요청한 다음 다시 리소스 정리로 돌아갑니다.

#include <sapi/embed/php_embed.h>

int main(int argc, char *argv[])
{
    PHP_EMBED_START_BLOCK(argc,argv)
    PHP_EMBED_END_BLOCK()

    return 0;
}

여기에는 너무 많은 헤더 파일이 포함되므로 일반적으로 작은 스니펫을 빌드하는 것보다 빌드 시간이 더 오래 걸립니다. .기본 경로(/usr/local)와 다른 PREFIX를 사용하는 경우 반드시 다음과 같은 방법으로 경로를 지정하십시오.

gcc -I /usr/local/php-dev/include/php/ \
	-I /usr/local/php-dev/include/php/main/ \
	-I /usr/local/php-dev/include/php/Zend/ \
	-I /usr/local/php-dev/include/php/TSRM/ \
	-lphp5 \
	-o embed1 
	embed1.c

매우 번거로우므로 간단한 Makefile을 대신 사용하는 것이 좋습니다:

CC = gcc 
CFLAGS = -c \
    -I /usr/local/php-dev/include/php/ \
    -I /usr/local/php-dev/include/php/main/ \
    -I /usr/local/php-dev/include/php/Zend/ \
    -I /usr/local/php-dev/include/php/TSRM/ \
    -Wall -g
LDFLAGS = -lphp5

all: embed1.c
    $(CC) -o embed1.o embed1.c $(CFLAGS)
    $(CC) -o embed1 embed1.o $(LDFLAGS)

이 Makefile은 이전에 제공된 명령과 몇 가지 중요한 차이점이 있습니다. 먼저 -Wall 스위치를 사용하여 컴파일 시간 경고를 활성화하고, -g를 사용하여 디버깅 정보를 활성화합니다. 두 개의 독립적인 단계입니다. 나중에 더 많은 소스 파일을 추가하는 것이 상대적으로 쉽습니다. 이 Makefile을 직접 재구성하십시오. 그러나 여기서는 공백 대신 Tab(가로 탭 문자)을 사용합니다. 🎜>이제 embed1.c 소스 파일을 수정한 후 make 명령만 실행하면 새로운 embed1 실행 프로그램을 빌드할 수 있습니다.

Re -래퍼를 삽입하여 cli 만들기

이제 앱에서 PHP에 액세스할 수 있으므로 이 장의 나머지 부분에서는 이에 관한 모든 것을 수행합니다. 이 테스트 애플리케이션 프레임워크에서 cli sapi를 다시 만드는 것이 중심입니다.

cli 바이너리 프로그램의 가장 기본적인 기능은 스크립트 이름을 지정하는 것입니다. php로 처리되는 명령줄 해석 및 실행. 애플리케이션에 cli를 구현하려면 embed1.c의 내용을 다음 코드로 바꾸세요. 참고: 원본의 코드입니다. 작업을 번역기 환경에서 직접 실행할 수 없어 위 코드가 수정되었습니다.

물론 테스트하려면 파일이 필요합니다. 작은 PHP 스크립트를 만들고 이름 test.php를 다운로드하고 포함 프로그램을 사용하여 명령줄에서 실행합니다.

#include <stdio.h>
#include <sapi/embed/php_embed.h>

int main(int argc, char *argv[]) {
    zend_file_handle    script;

    /* 基本的参数检查 */
    if ( argc <= 1 ) {
        fprintf(stderr, "Usage: %s <filename.php> <arguments>\n", argv[0]);
        return -1;
    }
    
    /* 设置一个文件处理结构 */
    script.type             = ZEND_HANDLE_FP;
    script.filename         = argv[1];
    script.opened_path      = NULL;
    script.free_filename    = 0;
    if ( !(script.handle.fp = fopen(script.filename, "rb")) ) {
        fprintf(stderr, "Unable to open: %s\n", argv[1]);
        return -1;
    }
    
    /* 在将命令行参数注册给php时(php中的$argv/$argc), 忽略第一个命令行参数, 因为它对php脚本无意义 */
    argc --;
    argv ++;
    
    PHP_EMBED_START_BLOCK(argc, argv)
        php_execute_script(&script TSRMLS_CC);
    PHP_EMBED_END_BLOCK()
    
    return 0;
}

다른 인수를 명령줄에 전달하면 $_SERVER['argc']/$_SERVER['argv']를 사용하여 PHP 스크립트에서 해당 인수를 볼 수 있습니다.

PHP_EMBED_START_BLOCK()과 PHP_EMBED_END_BLOCK() 사이의 코드는 들여쓰기되어 있습니다. 이는 이 두 매크로가 실제로 C 언어에서 코드 블록 범위를 형성하기 때문입니다. 즉, PHP_EMBED_START_BLOCK()에는 여는 중괄호 "{"가 포함되어 있습니다. 그리고 PHP_EMBED_END_BLOCK()에는 해당 닫는 중괄호 "}"가 있습니다. 그렇게 하는 데 있어 매우 중요한 문제는 별도의 시작/중지 함수에 넣을 수 없다는 것입니다. 이 문제에 대한 해결책은 다음 장에서 볼 수 있습니다.

오래된 기술의 새로운 사용

PHP_EMBED_START_BLOCK()이 호출된 후 애플리케이션은 시작 부분에 있습니다. 이는 RINIT 콜백 함수가 완료된 후와 동일합니다. 이 시점에서 php_execute_script() 명령 또는 PHP_FUNCTION() 내에 나타날 수 있는 다른 유효한 php/Zend API 지시문을 실행할 수 있습니다. 또는 RINIT() 블록.

초기 변수 설정

第2章"变量的里里外外"中介绍了操纵符号表的概念, 第5至18章则介绍了怎样通过用户空间脚本调用内部函数使用这些技术. 到这里这些处理也并没有发生变化, 虽然这里并没有激活的用户空间脚本, 但是你的包装应用仍然可以操纵符号表. 将你的PHP_EMBED_START_BLOCK()/PHP_EMBED_END_BLOCK()代码块替换为下面的代码:

    PHP_EMBED_START_BLOCK(argc, argv)
        zval    *type;

        ALLOC_INIT_ZVAL(type);
        ZVAL_STRING(type, "Embedded", 1);
        ZEND_SET_SYMBOL(&EG(symbol_table), "type", type);
        
        php_execute_script(&script TSRMLS_CC);
    PHP_EMBED_END_BLOCK()

现在使用make重新构建embed1, 并用下面的测试脚本进行测试:

<?php
	var_dump($type);
?>

当然, 这个简单的概念可以很容易的扩展为填充这个类型信息到$_SERVER超级全局变量数组中.

    PHP_EMBED_START_BLOCK(argc, argv)
        zval    **SERVER_PP, *type;

        /* 注册$_SERVER超级全局变量 */
        zend_is_auto_global_quick("_SERVER", sizeof("_SERVER") - 1, 0 TSRMLS_CC);
        /* 查找$_SERVER超级全局变量 */
        zend_hash_find(&EG(symbol_table), "_SERVER", sizeof("_SERVER"), (void **)&SERVER_PP) ;

        /* $_SERVER['SAPI_TYPE'] = "Embedded"; */
        ALLOC_INIT_ZVAL(type);
        ZVAL_STRING(type, "Embedded", 1);
        ZEND_SET_SYMBOL(Z_ARRVAL_PP(SERVER_PP), "SAPI_TYPE", type);

        php_execute_script(&script TSRMLS_CC);
    PHP_EMBED_END_BLOCK()

译注: 译者的环境中代码运行到zend_hash_find()处$_SERVER尚未注册, 经过跟踪, 发现它是直到编译用户空间代码的时候, 发现用户空间使用了$_SERVER变量才进行的注册. 因此, 上面的代码中增加了zend_is_auto_global_quick()的调用, 通过这个调用将完成对$_SERVER的注册.

覆写INI选项

在第13章"INI设置"中, 有一部分是讲INI修改处理器的, 在那里看到的是INI阶段的处理. PHP_EMBED_START_BLOCK()宏则将这些代码放到了运行时阶段. 也就是说这个时候修改某些设置(比如register_globals/magic_quotes_gpc)已经有点迟了.

不过在内部访问也没有什么不好. 所谓的"管理设置"比如safe_mode在这个略迟的阶段可以使用下面的zend_alter_ini_entry()命令打开或关闭:

int zend_alter_ini_entry(char *name, uint name_length,
                         char *new_value, uint new_value_length,
                         int modify_type, int stage);

name, new_value以及它们对应的长度参数的含义正如你所预期的: 修改名为name的INI设置的值为new_value. 要注意name_length包含了末尾的NULL字节, 然而new_value_length则不包含; 然而, 无论如何, 两个字符串都必须是NULL终止的.

modify_type则提供简化的访问控制检查. 回顾每个INI设置都有一个modifiable属性, 它是PHP_INI_SYSTEM, PHP_INI_PERDIR, PHP_INI_USER等常量的组合值. 当使用zend_alter_ini_entry()修改INI设置时, modify_type参数必须包含至少一个INI设置的modifiable属性值.

用户空间的ini_set()函数通过传递PHP_INI_USER利用了这个特性, 也就是说只有modifiable属性包含PHP_INI_USER标记的INI设置才能使用这个函数修改. 当在你的嵌入式应用中使用这个API调用时, 你可以通过传递PHP_INI_ALL标记短路这个访问控制系统, 它将包含所有的INI访问级别.

stage必须对应于Zend Engine的当前状态; 对于这些简单的嵌入式示例, 总是PHP_INI_STAGE_RUNTIME. 如果这是一个扩展或更高端的嵌入式应用, 你可能就需要将这个值设置为PHP_INI_STAGE_STARTUP或PHP_INI_STAGE_ACTIVE.

下面是扩展embed1.c源文件, 让它在执行脚本文件之前强制开启safe_mode.

    PHP_EMBED_START_BLOCK(argc, argv)
        zval    **SERVER_PP, *type;

        /* 不论php.ini中如何设置都强制开启safe_mode */
        zend_alter_ini_entry("safe_mode", sizeof("safe_mode"), "1", sizeof("1") - 1, PHP_INI_ALL, PHP_INI_STAGE_RUNTIME);
        
        /* 注册$_SERVER超级全局变量 */
        zend_is_auto_global_quick("_SERVER", sizeof("_SERVER") - 1, 0 TSRMLS_CC);
        /* 查找$_SERVER超级全局变量 */
        zend_hash_find(&EG(symbol_table), "_SERVER", sizeof("_SERVER"), (void **)&SERVER_PP) ;
        
        /* $_SERVER['SAPI_TYPE'] = "Embedded"; */
        ALLOC_INIT_ZVAL(type);
        ZVAL_STRING(type, "Embedded", 1);
        ZEND_SET_SYMBOL(Z_ARRVAL_PP(SERVER_PP), "SAPI_TYPE", type);
        
        php_execute_script(&script TSRMLS_CC);
    PHP_EMBED_END_BLOCK()

定义附加的超级全局变量

在第12章"启动, 终止, 以及其中的一些点"中, 你知道了用户空间全局变量以及超级全局变量可以在启动(MINIT)阶段定义. 同样, 本章介绍的嵌入式直接跳过了启动阶段, 处于运行时状态. 和覆写INI一样, 这并不会显得太迟.

超级全局变量的定义实际上只需要在脚本编译之前定义即可, 并且在php的进程生命周期中它只应该出现一次. 在扩展中的正常情况下, MINIT是唯一可以保证这些条件的地方.

由于你的包装应用现在是在控制中的, 因此可以保证定义用户空间自动全局变量的这些点位于真正编译脚本源文件的php_execute_script()命令之前. 我们定义一个$_EMBED超级全局变量并给它设置一个初始值来进行测试:

    PHP_EMBED_START_BLOCK(argc, argv)
        zval    **SERVER_PP, *type, *EMBED, *foo;

        /* 在全局作用域创建$_EMBED数组 */
        ALLOC_INIT_ZVAL(EMBED);
        array_init(EMBED);
        ZEND_SET_SYMBOL(&EG(symbol_table), "_EMBED", EMBED);

        /* $_EMBED['foo'] = 'Bar'; */
        ALLOC_INIT_ZVAL(foo);
        ZVAL_STRING(foo, "Bar", 1); 
        add_assoc_zval_ex(EMBED, "foo", sizeof("foo"), foo);

        /* 注册超级全局变量$_EMBED */
        zend_register_auto_global("_EMBED", sizeof("_EMBED")
#ifdef ZEND_ENGINE_2
            , 1, NULL TSRMLS_CC);
#else
            , 1 TSRMLS_CC);
#endif

        /* 不论php.ini中如何设置都强制开启safe_mode */
        zend_alter_ini_entry("safe_mode", sizeof("safe_mode"), "1", sizeof("1") - 1, PHP_INI_ALL, PHP_INI_STAGE_RUNTIME);

        /* 注册$_SERVER超级全局变量 */
        zend_is_auto_global_quick("_SERVER", sizeof("_SERVER") - 1, 0 TSRMLS_CC);
        /* 查找$_SERVER超级全局变量 */
        zend_hash_find(&EG(symbol_table), "_SERVER", sizeof("_SERVER"), (void **)&SERVER_PP) ;

        /* $_SERVER['SAPI_TYPE'] = "Embedded"; */
        ALLOC_INIT_ZVAL(type);
        ZVAL_STRING(type, "Embedded", 1); 
        ZEND_SET_SYMBOL(Z_ARRVAL_PP(SERVER_PP), "SAPI_TYPE", type);

        php_execute_script(&script TSRMLS_CC);
    PHP_EMBED_END_BLOCK()

要记住, Zend Engine 2(php 5.0或更高)使用了不同的zend_register_auto_global()元婴, 因此你需要用前面讲php 4兼容时候讲过的#ifdef. 如果你不关心旧版本php的兼容性, 则可以丢弃这些指令让代码变得更加整洁.

小结

如你所见, 将完整的Zend Engine和PHP语言嵌入到你的应用中相比如扩展新功能来说工作量要少. 由于它们共享相同的基础API, 我们可以学习尝试让其他实例可访问.

通过本章的学习, 你了解了最简单的嵌入式脚本代码格式, 同时还有all-in-one的宏PHP_EBED_START_BLOCK()和PHP_EMBED_END_BLOCK(). 下一章你将回到这些宏的层的使用, 利用它们将php和你的宿主系统结合起来.

以上就是[翻译][php扩展开发和嵌入式]第19章-设置宿主环境的内容，更多相关内容请关注PHP中文网（www.php.cn）！