[Français] [développement d'extensions php et embarquées] Chapitre 19 - Mise en place de l'environnement d'hébergement

Configurer l'environnement d'hébergement

Vous connaissez maintenant le monde de PHPAPI et pouvez utiliser zval comme eh bien Le mécanisme d'extension interne du langage effectue beaucoup de travail, et il est temps de changer de vitesse et de l'utiliser pour faire ce qu'il fait le mieux : interpréter le code de script >

En revoyant l'introduction, PHP a construit un. système hiérarchique. La couche supérieure fournit toutes les extensions des fonctions de l'espace utilisateur et des bibliothèques de classes. En même temps, en dessous se trouve la couche API de service (SAPI), qui joue le rôle d'interface du serveur Web (comme Apache, iis et command). line interface cli). Parmi ces nombreuses implémentations sapi, il existe une sapi spéciale qui est la sapi intégrée. Lorsque cette implémentation sapi est construite, elle créera un objet bibliothèque qui contient tous les éléments. Fonctions et variables des API PHP et Zend que vous connaissez. Cet objet de bibliothèque contient également des fonctions d'assistance et des macros supplémentaires pour simplifier l'appel de programmes externes.

La génération de bibliothèques et de fichiers d'en-tête pour les API intégrées effectue la même chose. actions comme la compilation d'autres sapis. Passez simplement --enable-embed à la commande ./configure Comme auparavant, utilisez --enable- debug est utile pour le rapport et le suivi des erreurs.

Vous. Vous devrez peut-être également activer --enable-maintainer-zts, bien sûr, pour des raisons que vous connaissez déjà, cela vous aidera à remarquer l'erreur de code, cependant, il y a d'autres raisons ici Supposons qu'à un certain moment, vous. avoir plusieurs applications utilisant la bibliothèque PHP intégrée pour effectuer des tâches de script ; l'une des applications est un simple cycle de vie courte et n'utilise pas de threads, donc pour plus d'efficacité, vous souhaiterez peut-être désactiver ZTS.

En supposant maintenant que la deuxième application utilise des threads, comme un serveur Web, chaque thread doit suivre son propre contexte de requête. Si ZTS est désactivé, seules les deux premières applications peuvent utiliser cette bibliothèque ; est activé, les deux applications peuvent utiliser le même objet partagé dans leur propre espace de processus.

Bien sûr, vous pouvez également créer les deux versions en même temps et leur donner des noms différents, mais c'est plus un problème que le petit gain d'efficacité lié à l'inclusion de ZTS lorsqu'il n'est pas nécessaire

Par défaut, la bibliothèque intégrée sera construite comme un objet partagé libphp5.so, ou comme. une bibliothèque de liens dynamiques sous Windows, cependant, elle peut également être construite en tant que bibliothèque statique à l'aide du mot-clé statique facultatif (--enable-embed=static).

Construire en tant que bibliothèque statique évite le problème ZTS/non-ZTS, et potentiellement avoir plusieurs versions de PHP sur un système. Le risque est que cela signifie que votre binaire d'application deviendra considérablement plus grand et qu'il hébergera donc l'intégralité du framework ZendEngine et PHP. , lors du choix, vous devez soigneusement déterminer si vous avez besoin d'une bibliothèque relativement plus petite.

Peu importe la méthode de construction que vous choisissez, une fois que vous avez exécuté make install, libphp5 sera copié dans la bibliothèque / sous le répertoire PREFIX spécifié par votre ./configure. De plus, il sera également copié dans PREFIX/include/php/sapi/embed. Mettez le fichier d'en-tête nommé php_embed.h dans le répertoire, ainsi que plusieurs autres en-têtes importants. fichiers dont vous avez besoin lorsque vous utilisez la bibliothèque php intégrée pour compiler le programme

. En son cœur, une bibliothèque n'est qu'une collection de code sans but. Pour qu'elle fonctionne, vous avez besoin d'une application qui intègre PHP. Tout d'abord, encapsulons une application très simple, qui démarre le moteur Zend et initialise PHP pour le traiter. une demande, puis retourne nettoyer les ressources .

#include <sapi/embed/php_embed.h>

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

    return 0;
}

Comme cela implique tellement de fichiers d'en-tête, la construction prendra en fait plus de temps que pour un si petit code La fragmentation prend généralement du temps. Si vous utilisez un PREFIX différent du chemin par défaut (/usr/local), assurez-vous de spécifier le chemin de la manière suivante :

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

dû. à cette commande Il est difficile de saisir à chaque fois. Vous préférerez peut-être utiliser un simple Makefile à la place :

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)

#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;
}

$ ./embed1 test.php

    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()

<?php
	var_dump($type);
?>

    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()

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

    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()

    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()