Bagaimana untuk melaksanakan konfigurasi pemuatan modul dinamik Nginx

Nginx ialah pelayan web berprestasi tinggi dan perisian proksi terbalik Nginx versi 1.9.11 yang dikeluarkan baru-baru ini menyokong pemuatan modul dinamik. Ciri baharu ini membolehkan pengguna memanjangkan dan menyesuaikan fungsi dengan menambah modul dinamik baharu tanpa menyusun semula dan memasang semula Nginx. Artikel ini akan memperkenalkan cara melaksanakan konfigurasi pemuatan modul dinamik dalam Nginx dan memberikan contoh kod khusus.

Prinsip pemuatan modul dinamik Nginx adalah untuk menghidupkan sokongan untuk modul dinamik melalui mod kompilasi baharu--"--add-dynamic-module=module_path". Apabila menggunakan mod kompilasi ini, kompilasi menjana fail perpustakaan pautan dinamik (.so) Pustaka pautan dinamik ini boleh dimuatkan dan dipunggah secara dinamik apabila Nginx bermula dan berjalan. Berbanding dengan modul statik, modul dinamik mempunyai fleksibiliti yang lebih baik.

Berikut ialah kaedah pelaksanaan khusus:

1 Tulis kod sumber modul dinamik

Ambil contoh penambahan pengepala Pengepala merujuk kepada pengepala permintaan dan respons dalam aplikasi web tidak menyediakan penambahan fungsi Pengepala, tetapi boleh dilaksanakan melalui modul tersuai. Kod berikut ialah contoh mudah untuk menambah pengepala Pengepala:

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

Kod ini melaksanakan modul tersuai Nginx ngx_http_add_header_module Modul tersuai ini mempunyai dua fungsi ngx_http_add_header_handler dan ngx_http_add_header_init Header digunakan untuk melaksanakan logik tertentu. , yang terakhir digunakan untuk memulakan modul. Setiap modul mesti mentakrifkan konteks modul ngx_http_add_header_module_ctx, dan pembolehubah struktur ngx_module_t ngx_http_add_header_module, yang mengandungi nombor versi, konteks dan maklumat lain modul.

2. Susun dan jana perpustakaan pautan dinamik

Gunakan arahan berikut untuk menyusun kod untuk menjana perpustakaan pautan dinamik:

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

Melaksanakan arahan di atas akan mencipta direktori my_module di bawah modul HTTP Nginx, yang mengandungi Makefile yang digunakan untuk membina fail modul dinamik dan beberapa kod sumber dan fail pengepala yang diperlukan Fail perpustakaan pautan dinamik (.so) yang dihasilkan berada dalam direktori objs/.

3. Muatkan modul dinamik

Tambahkan kod berikut pada fail konfigurasi Nginx nginx.conf untuk memuatkan perpustakaan pautan dinamik:

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

Muatkan ngx_http_add_header_module.so fail pustaka modul pautan dinamik melalui http load_module arahan kemudian tentukan blok pelayan, nyatakan item konfigurasi lokasi dalam blok pelayan untuk menambah pengepala Pengepala.

4. Muat Semula Nginx

Jalankan arahan berikut untuk memuat semula pelayan Nginx:

nginx -s reload

Arahan ini boleh memuatkan semula konfigurasi, memulakan semula Nginx, mematikan Nginx dan operasi lain.

Pada ketika ini, proses melaksanakan konfigurasi pemuatan modul dinamik dalam Nginx selesai.

Ringkasan:

Melalui pengenalan di atas, kita boleh memahami secara ringkas kaedah pelaksanaan pemuatan modul dinamik dalam Nginx 1.9.11 dan versi yang lebih baru. Semasa proses pelaksanaan, anda perlu menulis kod sumber modul dinamik, menyusun dan menjana perpustakaan pautan dinamik, memuatkan perpustakaan modul dan memuatkan semula Nginx mengikut urutan. Menggunakan modul dinamik membolehkan pengguna membangunkan fungsi tertentu dalam peringkat selepas keluaran, menjadikan pelancaran produk lebih pantas dan lebih fleksibel.

Atas ialah kandungan terperinci Bagaimana untuk melaksanakan konfigurasi pemuatan modul dinamik Nginx. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!