src/http/modules/ngx_http_try_files_module.c - nginx source code

Global variables defined

Data types defined

Functions defined

Source code


  1. /*
  2. * Copyright (C) Igor Sysoev
  3. * Copyright (C) Nginx, Inc.
  4. */


  5. #include <ngx_config.h>
  6. #include <ngx_core.h>
  7. #include <ngx_http.h>


  8. typedef struct {
  9.     ngx_array_t           *lengths;
  10.     ngx_array_t           *values;
  11.     ngx_str_t              name;

  12.     unsigned               code:10;
  13.     unsigned               test_dir:1;
  14. } ngx_http_try_file_t;


  15. typedef struct {
  16.     ngx_http_try_file_t   *try_files;
  17. } ngx_http_try_files_loc_conf_t;


  18. static ngx_int_t ngx_http_try_files_handler(ngx_http_request_t *r);
  19. static char *ngx_http_try_files(ngx_conf_t *cf, ngx_command_t *cmd, void *conf);
  20. static void *ngx_http_try_files_create_loc_conf(ngx_conf_t *cf);
  21. static ngx_int_t ngx_http_try_files_init(ngx_conf_t *cf);


  22. static ngx_command_t  ngx_http_try_files_commands[] = {

  23.     { ngx_string("try_files"),
  24.       NGX_HTTP_SRV_CONF|NGX_HTTP_LOC_CONF|NGX_CONF_2MORE,
  25.       ngx_http_try_files,
  26.       NGX_HTTP_LOC_CONF_OFFSET,
  27.       0,
  28.       NULL },

  29.       ngx_null_command
  30. };


  31. static ngx_http_module_t  ngx_http_try_files_module_ctx = {
  32.     NULL,                                  /* preconfiguration */
  33.     ngx_http_try_files_init,               /* postconfiguration */

  34.     NULL,                                  /* create main configuration */
  35.     NULL,                                  /* init main configuration */

  36.     NULL,                                  /* create server configuration */
  37.     NULL,                                  /* merge server configuration */

  38.     ngx_http_try_files_create_loc_conf,    /* create location configuration */
  39.     NULL                                   /* merge location configuration */
  40. };


  41. ngx_module_t  ngx_http_try_files_module = {
  42.     NGX_MODULE_V1,
  43.     &ngx_http_try_files_module_ctx,        /* module context */
  44.     ngx_http_try_files_commands,           /* module directives */
  45.     NGX_HTTP_MODULE,                       /* module type */
  46.     NULL,                                  /* init master */
  47.     NULL,                                  /* init module */
  48.     NULL,                                  /* init process */
  49.     NULL,                                  /* init thread */
  50.     NULL,                                  /* exit thread */
  51.     NULL,                                  /* exit process */
  52.     NULL,                                  /* exit master */
  53.     NGX_MODULE_V1_PADDING
  54. };


  55. static ngx_int_t
  56. ngx_http_try_files_handler(ngx_http_request_t *r)
  57. {
  58.     size_t                          len, root, alias, reserve, allocated;
  59.     u_char                         *p, *name;
  60.     ngx_str_t                       path, args;
  61.     ngx_uint_t                      test_dir;
  62.     ngx_http_try_file_t            *tf;
  63.     ngx_open_file_info_t            of;
  64.     ngx_http_script_code_pt         code;
  65.     ngx_http_script_engine_t        e;
  66.     ngx_http_core_loc_conf_t       *clcf;
  67.     ngx_http_script_len_code_pt     lcode;
  68.     ngx_http_try_files_loc_conf_t  *tlcf;

  69.     tlcf = ngx_http_get_module_loc_conf(r, ngx_http_try_files_module);

  70.     if (tlcf->try_files == NULL) {
  71.         return NGX_DECLINED;
  72.     }

  73.     ngx_log_debug0(NGX_LOG_DEBUG_HTTP, r->connection->log, 0,
  74.                    "try files handler");

  75.     allocated = 0;
  76.     root = 0;
  77.     name = NULL;
  78.     /* suppress MSVC warning */
  79.     path.data = NULL;

  80.     tf = tlcf->try_files;

  81.     clcf = ngx_http_get_module_loc_conf(r, ngx_http_core_module);

  82.     alias = clcf->alias;

  83.     for ( ;; ) {

  84.         if (tf->lengths) {
  85.             ngx_memzero(&e, sizeof(ngx_http_script_engine_t));

  86.             e.ip = tf->lengths->elts;
  87.             e.request = r;

  88.             /* 1 is for terminating '\0' as in static names */
  89.             len = 1;

  90.             while (*(uintptr_t *) e.ip) {
  91.                 lcode = *(ngx_http_script_len_code_pt *) e.ip;
  92.                 len += lcode(&e);
  93.             }

  94.         } else {
  95.             len = tf->name.len;
  96.         }

  97.         if (!alias) {
  98.             reserve = len > r->uri.len ? len - r->uri.len : 0;

  99.         } else if (alias == NGX_MAX_SIZE_T_VALUE) {
  100.             reserve = len;

  101.         } else {
  102.             reserve = len > r->uri.len - alias ? len - (r->uri.len - alias) : 0;
  103.         }

  104.         if (reserve > allocated || !allocated) {

  105.             /* 16 bytes are preallocation */
  106.             allocated = reserve + 16;

  107.             if (ngx_http_map_uri_to_path(r, &path, &root, allocated) == NULL) {
  108.                 return NGX_HTTP_INTERNAL_SERVER_ERROR;
  109.             }

  110.             name = path.data + root;
  111.         }

  112.         if (tf->values == NULL) {

  113.             /* tf->name.len includes the terminating '\0' */

  114.             ngx_memcpy(name, tf->name.data, tf->name.len);

  115.             path.len = (name + tf->name.len - 1) - path.data;

  116.         } else {
  117.             e.ip = tf->values->elts;
  118.             e.pos = name;
  119.             e.flushed = 1;

  120.             while (*(uintptr_t *) e.ip) {
  121.                 code = *(ngx_http_script_code_pt *) e.ip;
  122.                 code((ngx_http_script_engine_t *) &e);
  123.             }

  124.             path.len = e.pos - path.data;

  125.             *e.pos = '\0';

  126.             if (alias && alias != NGX_MAX_SIZE_T_VALUE
  127.                 && ngx_strncmp(name, r->uri.data, alias) == 0)
  128.             {
  129.                 ngx_memmove(name, name + alias, len - alias);
  130.                 path.len -= alias;
  131.             }
  132.         }

  133.         test_dir = tf->test_dir;

  134.         tf++;

  135.         ngx_log_debug3(NGX_LOG_DEBUG_HTTP, r->connection->log, 0,
  136.                        "trying to use %s: \"%s\" \"%s\"",
  137.                        test_dir ? "dir" : "file", name, path.data);

  138.         if (tf->lengths == NULL && tf->name.len == 0) {

  139.             if (tf->code) {
  140.                 return tf->code;
  141.             }

  142.             path.len -= root;
  143.             path.data += root;

  144.             if (path.data[0] == '@') {
  145.                 (void) ngx_http_named_location(r, &path);

  146.             } else {
  147.                 ngx_http_split_args(r, &path, &args);

  148.                 (void) ngx_http_internal_redirect(r, &path, &args);
  149.             }

  150.             ngx_http_finalize_request(r, NGX_DONE);
  151.             return NGX_DONE;
  152.         }

  153.         ngx_memzero(&of, sizeof(ngx_open_file_info_t));

  154.         of.read_ahead = clcf->read_ahead;
  155.         of.directio = clcf->directio;
  156.         of.valid = clcf->open_file_cache_valid;
  157.         of.min_uses = clcf->open_file_cache_min_uses;
  158.         of.test_only = 1;
  159.         of.errors = clcf->open_file_cache_errors;
  160.         of.events = clcf->open_file_cache_events;

  161.         if (ngx_http_set_disable_symlinks(r, clcf, &path, &of) != NGX_OK) {
  162.             return NGX_HTTP_INTERNAL_SERVER_ERROR;
  163.         }

  164.         if (ngx_open_cached_file(clcf->open_file_cache, &path, &of, r->pool)
  165.             != NGX_OK)
  166.         {
  167.             if (of.err == 0) {
  168.                 return NGX_HTTP_INTERNAL_SERVER_ERROR;
  169.             }

  170.             if (of.err != NGX_ENOENT
  171.                 && of.err != NGX_ENOTDIR
  172.                 && of.err != NGX_ENAMETOOLONG)
  173.             {
  174.                 ngx_log_error(NGX_LOG_CRIT, r->connection->log, of.err,
  175.                               "%s \"%s\" failed", of.failed, path.data);
  176.             }

  177.             continue;
  178.         }

  179.         if (of.is_dir != test_dir) {
  180.             continue;
  181.         }

  182.         path.len -= root;
  183.         path.data += root;

  184.         if (!alias) {
  185.             r->uri = path;

  186.         } else if (alias == NGX_MAX_SIZE_T_VALUE) {
  187.             if (!test_dir) {
  188.                 r->uri = path;
  189.                 r->add_uri_to_alias = 1;
  190.             }

  191.         } else {
  192.             name = r->uri.data;

  193.             r->uri.len = alias + path.len;
  194.             r->uri.data = ngx_pnalloc(r->pool, r->uri.len);
  195.             if (r->uri.data == NULL) {
  196.                 r->uri.len = 0;
  197.                 return NGX_HTTP_INTERNAL_SERVER_ERROR;
  198.             }

  199.             p = ngx_copy(r->uri.data, name, alias);
  200.             ngx_memcpy(p, path.data, path.len);
  201.         }

  202.         ngx_http_set_exten(r);

  203.         ngx_log_debug1(NGX_LOG_DEBUG_HTTP, r->connection->log, 0,
  204.                        "try file uri: \"%V\"", &r->uri);

  205.         return NGX_DECLINED;
  206.     }

  207.     /* not reached */
  208. }


  209. static char *
  210. ngx_http_try_files(ngx_conf_t *cf, ngx_command_t *cmd, void *conf)
  211. {
  212.     ngx_http_try_files_loc_conf_t *tlcf = conf;

  213.     ngx_str_t                  *value;
  214.     ngx_int_t                   code;
  215.     ngx_uint_t                  i, n;
  216.     ngx_http_try_file_t        *tf;
  217.     ngx_http_script_compile_t   sc;

  218.     if (tlcf->try_files) {
  219.         return "is duplicate";
  220.     }

  221.     tf = ngx_pcalloc(cf->pool, cf->args->nelts * sizeof(ngx_http_try_file_t));
  222.     if (tf == NULL) {
  223.         return NGX_CONF_ERROR;
  224.     }

  225.     tlcf->try_files = tf;

  226.     value = cf->args->elts;

  227.     for (i = 0; i < cf->args->nelts - 1; i++) {

  228.         tf[i].name = value[i + 1];

  229.         if (tf[i].name.len > 0
  230.             && tf[i].name.data[tf[i].name.len - 1] == '/'
  231.             && i + 2 < cf->args->nelts)
  232.         {
  233.             tf[i].test_dir = 1;
  234.             tf[i].name.len--;
  235.             tf[i].name.data[tf[i].name.len] = '\0';
  236.         }

  237.         n = ngx_http_script_variables_count(&tf[i].name);

  238.         if (n) {
  239.             ngx_memzero(&sc, sizeof(ngx_http_script_compile_t));

  240.             sc.cf = cf;
  241.             sc.source = &tf[i].name;
  242.             sc.lengths = &tf[i].lengths;
  243.             sc.values = &tf[i].values;
  244.             sc.variables = n;
  245.             sc.complete_lengths = 1;
  246.             sc.complete_values = 1;

  247.             if (ngx_http_script_compile(&sc) != NGX_OK) {
  248.                 return NGX_CONF_ERROR;
  249.             }

  250.         } else {
  251.             /* add trailing '\0' to length */
  252.             tf[i].name.len++;
  253.         }
  254.     }

  255.     if (tf[i - 1].name.data[0] == '=') {

  256.         code = ngx_atoi(tf[i - 1].name.data + 1, tf[i - 1].name.len - 2);

  257.         if (code == NGX_ERROR || code > 999) {
  258.             ngx_conf_log_error(NGX_LOG_EMERG, cf, 0,
  259.                                "invalid code \"%*s\"",
  260.                                tf[i - 1].name.len - 1, tf[i - 1].name.data);
  261.             return NGX_CONF_ERROR;
  262.         }

  263.         tf[i].code = code;
  264.     }

  265.     return NGX_CONF_OK;
  266. }


  267. static void *
  268. ngx_http_try_files_create_loc_conf(ngx_conf_t *cf)
  269. {
  270.     ngx_http_try_files_loc_conf_t  *tlcf;

  271.     tlcf = ngx_pcalloc(cf->pool, sizeof(ngx_http_try_files_loc_conf_t));
  272.     if (tlcf == NULL) {
  273.         return NULL;
  274.     }

  275.     /*
  276.      * set by ngx_pcalloc():
  277.      *
  278.      *     tlcf->try_files = NULL;
  279.      */

  280.     return tlcf;
  281. }


  282. static ngx_int_t
  283. ngx_http_try_files_init(ngx_conf_t *cf)
  284. {
  285.     ngx_http_handler_pt        *h;
  286.     ngx_http_core_main_conf_t  *cmcf;

  287.     cmcf = ngx_http_conf_get_module_main_conf(cf, ngx_http_core_module);

  288.     h = ngx_array_push(&cmcf->phases[NGX_HTTP_PRECONTENT_PHASE].handlers);
  289.     if (h == NULL) {
  290.         return NGX_ERROR;
  291.     }

  292.     *h = ngx_http_try_files_handler;

  293.     return NGX_OK;
  294. }