Book Image

Mastering NGINX - Second Edition

By : Dimitri Aivaliotis
Book Image

Mastering NGINX - Second Edition

By: Dimitri Aivaliotis

Overview of this book

NGINX is a high-performance HTTP server and mail proxy designed to use very few system resources. But despite its power it is often a challenge to properly configure NGINX to meet your expectations. Mastering Nginx is the solution – an insider’s guide that will clarify the murky waters of NGINX’s configuration. Tune NGINX for various situations, improve your NGINX experience with some of the more obscure configuration directives, and discover how to design and personalize a configuration to match your needs. To begin with, quickly brush up on installing and setting up the NGINX server on the OS and its integration with third-party modules. From here, move on to explain NGINX's mail proxy module and its authentication, and reverse proxy to solve scaling issues. Then see how to integrate NGINX with your applications to perform tasks. The latter part of the book focuses on working through techniques to solve common web issues and the know-hows using NGINX modules. Finally, we will also explore different configurations that will help you troubleshoot NGINX server and assist with performance tuning.
Table of Contents (20 chapters)
Mastering NGINX - Second Edition
About the Author
About the Reviewer
Directive Reference
Persisting Solaris Network Tunings

Integrating with Lua

Using NGINX with ngx_lua can help you write more performant applications. Instead of passing logic to an upstream server, Lua can handle this processing. The ngx_lua module can be invoked at different phases of NGINX request processing.

Many of the ngx_lua configuration directives directly reference the phase of the request that they affect. For instance, there will be init_by_lua, init_worker_by_lua, content_by_lua, rewrite_by_lua, access_by_lua, header_filter_by_lua, body_filter_by_lua, and log_by_lua to do something with Lua at that phase of the request. Depending on where in the request processing chain you want to use Lua, you use the corresponding directive.

Loading a Lua script to handle a request involves using the lua_package_path directive to specify the location in which to find the script, and then using the appropriate _by_lua directive to execute the script:

    lua_package_path    "$prefixlib/?.lua;;";
    server {
        location / {