Comment implémenter la configuration de chargement de module dynamique de Nginx

Nginx est un serveur Web et un logiciel de proxy inverse hautes performances. La version 1.9.11 et ultérieure de Nginx récemment publiée prend en charge le chargement de modules dynamiques. Cette nouvelle fonctionnalité permet aux utilisateurs d'étendre et de personnaliser les fonctionnalités en ajoutant de nouveaux modules dynamiques sans recompiler ni réinstaller Nginx. Cet article expliquera comment implémenter la configuration de chargement dynamique de module dans Nginx et donnera des exemples de code spécifiques.

Le principe du chargement des modules dynamiques Nginx est d'activer la prise en charge des modules dynamiques via un nouveau mode de compilation--"--add-dynamic-module=module_path". Lors de l'utilisation de ce mode de compilation, la compilation génère un fichier de bibliothèque de liens dynamiques (.so) qui peut être chargée et déchargée dynamiquement lorsque Nginx démarre et s'exécute. Par rapport aux modules statiques, les modules dynamiques ont une meilleure flexibilité.

Voici la méthode d'implémentation spécifique :

1. Écrivez le code source du module dynamique

Prenons l'exemple de l'implémentation de l'ajout d'en-têtes d'en-tête. Les en-têtes d'en-tête font référence aux en-têtes de requêtes et de réponses dans les applications Web. ne fournit pas d'ajout de fonction d'en-tête, mais peut être implémenté via des modules personnalisés. Le code suivant est un exemple simple d'ajout d'un en-tête Header :

#include <ngx_config.h>
#include <ngx_core.h>
#include <ngx_http.h>

static ngx_int_t ngx_http_add_header_handler(ngx_http_request_t *r) {
    ngx_table_elt_t *h;
    h = ngx_list_push(&r->headers_out.headers);
    h->hash = 1;
    ngx_str_set(&h->key, "MyHeader");
    ngx_str_set(&h->value, "Hello Nginx!");
    r->headers_out.content_length_n = sizeof("Hello Nginx!") - 1;
    ngx_http_clear_content_length(r);
    ngx_http_header_filter(r);
    ngx_http_send_header(r);
    return NGX_OK;
}

static ngx_int_t ngx_http_add_header_init(ngx_conf_t *cf) {
    ngx_http_handler_pt *h;
    ngx_http_core_main_conf_t *cmcf;
    cmcf = ngx_http_conf_get_module_main_conf(cf, ngx_http_core_module);
    h = ngx_array_push(&cmcf->phases[NGX_HTTP_CONTENT_PHASE].handlers);
    if(h == NULL) {
        return NGX_ERROR;
    }
    *h = ngx_http_add_header_handler;
    return NGX_OK;
}

static ngx_http_module_t ngx_http_add_header_module_ctx = {
    NULL, ngx_http_add_header_init, NULL, NULL, NULL, NULL, NULL, NULL
};

ngx_module_t ngx_http_add_header_module = {
    NGX_MODULE_V1, &ngx_http_add_header_module_ctx, NULL, NGX_HTTP_MODULE, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NGX_MODULE_V1_PADDING
};

Ce code implémente le module personnalisé Nginx ngx_http_add_header_module. Ce module personnalisé a deux fonctions ngx_http_add_header_handler et ngx_http_add_header_init. Le premier est utilisé pour implémenter la logique spécifique d'ajout d'un en-tête Header. , ce dernier sert à initialiser le module. Chaque module doit définir un contexte de module ngx_http_add_header_module_ctx et une variable de structure ngx_module_t ngx_http_add_header_module, qui contient le numéro de version, le contexte et d'autres informations du module.

2. Compilez et générez la bibliothèque de liens dynamiques

Utilisez la commande suivante pour compiler le code permettant de générer la bibliothèque de liens dynamiques :

./configure --prefix=/usr/local/nginx --add-dynamic-module=./src/http/modules/my_module && make && make install

L'exécution de la commande ci-dessus créera le répertoire my_module sous le module HTTP de Nginx, qui contient le Makefile utilisé pour créer le fichier de module dynamique ainsi que certains codes sources et fichiers d'en-tête nécessaires. Le fichier de bibliothèque de liens dynamiques généré (.so) se trouve dans le répertoire objs/.

3. Charger les modules dynamiques

Ajoutez le code suivant dans le fichier de configuration Nginx nginx.conf pour charger la bibliothèque de liens dynamiques :

load_module modules/ngx_http_add_header_module.so;

http {
    server {
        listen 80;
        server_name myweb.com;
        location / {
            add_header MyHeader "Hello Nginx!";
            root /var/www/html;
        }
    }
}

Chargez le fichier de bibliothèque de liens dynamiques ngx_http_add_header_module.so via la commande load_module sous le module http, et puis définissez un bloc serveur, spécifiez l'élément de configuration d'emplacement dans le bloc serveur pour ajouter l'en-tête Header.

4. Recharger Nginx

Exécutez la commande suivante pour recharger le serveur Nginx :

nginx -s reload

Cette commande peut recharger la configuration, redémarrer Nginx, arrêter Nginx et d'autres opérations.

À ce stade, le processus de mise en œuvre de la configuration de chargement dynamique des modules dans Nginx est terminé.

Résumé :

Grâce à l'introduction ci-dessus, nous pouvons brièvement comprendre la méthode d'implémentation de chargement dynamique de module dans Nginx 1.9.11 et les versions ultérieures. Pendant le processus d'implémentation, vous devez écrire le code source du module dynamique, compiler et générer la bibliothèque de liens dynamiques, charger la bibliothèque de modules et recharger Nginx dans l'ordre. L'utilisation de modules dynamiques permet aux utilisateurs de développer une certaine fonction après la sortie, ce qui rend le lancement du produit plus rapide et plus flexible.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!