ngx fancyindex
v0.5.2
Conteúdo
O módulo Fancy Index possibilita a geração de listagens de arquivos, como o módulo autoindex integrado, mas adicionando um toque de estilo. Isso é possível porque o módulo permite um certo grau de customização do conteúdo gerado:
Este módulo foi projetado para funcionar com Nginx, um servidor web de código aberto de alto desempenho escrito por Igor Sysoev.
Para usuários do repositório Nginx estável oficial, um repositório de pacotes extras com módulos dinâmicos está disponível e o fantasiaindex está incluído.
Instale a configuração do repositório e depois o pacote do módulo:
yum -y instalar https://extras.getpagespeed.com/release-latest.rpm yum -y instalar nginx-module-fancyindex
Em seguida, carregue o módulo em /etc/nginx/nginx.conf usando:
load_module "módulos/ngx_http_fancyindex_module.so";
Os usuários podem instalar o Nginx no macOS com MacPorts; fantasiaindex está incluído:
porta sudo instalar nginx
Na maioria dos outros casos, você precisará dos fontes do Nginx. Qualquer versão a partir da série 0.8 deve funcionar.
Para usar as diretivas fancyindex_header_ e fancyindex_footer_ você também precisará do ngx_http_addition_module integrado ao Nginx.
Descompacte as fontes Nginx:
$ gunzip -c nginx-?.?.?.tar.gz | alcatrão -xvf -
Descompacte as fontes do módulo de indexação sofisticado:
$ gunzip -c nginx-fancyindex-?.?.?.tar.gz | alcatrão -xvf -
Mude para o diretório que contém as fontes Nginx, execute o script de configuração com as opções desejadas e certifique-se de colocar um sinalizador --add-module apontando para o diretório que contém a fonte do módulo de indexação sofisticado:
$ cd nginx-?.?.? $ ./configure --add-module=../nginx-fancyindex-?.?.? [--with-http_addition_module] [opções extras desejadas]
Desde a versão 0.4.0, o módulo também pode ser construído como um módulo dinâmico, usando --add-dynamic-module=… em vez disso e load_module "modules/ngx_http_fancyindex_module.so"; no arquivo de configuração
Crie e instale o software:
$ fazer
E então, como root :
#faça a instalação
Configure o Nginx usando as diretivas de configuração dos módulos.
Você pode testar o estilo integrado padrão adicionando as seguintes linhas em uma seção server em seu arquivo de configuração Nginx:
localização / {
índice sofisticado ativado; # Habilite índices sofisticados.
fantasiaindex_exact_size desativado; # Produz tamanhos de arquivo legíveis por humanos.
}
Os seguintes temas demonstram o nível de personalização que pode ser alcançado usando o módulo:
| Sintaxe: | índice sofisticado [ ligado | desligado ] |
|---|---|
| Padrão: | índice sofisticado desativado |
| Contexto: | http, servidor, localização |
| Descrição: | Ativa ou desativa índices de diretório sofisticados. |
| Sintaxe: | fantasiaindex_default_sort [ nome | tamanho | data | nome_desc | tamanho_desc | data_desc ] |
|---|---|
| Padrão: | nome fantasiaindex_default_sort |
| Contexto: | http, servidor, localização |
| Descrição: | Define o critério de classificação por padrão. |
| Sintaxe: | fantasiaindex_case_sensitive [ ligado | desligado ] |
|---|---|
| Padrão: | fantasiaindex_case_sensitive ativado |
| Contexto: | http, servidor, localização |
| Descrição: | Se ativado (configuração padrão), a classificação por nome fará distinção entre maiúsculas e minúsculas. Se desativado, o caso será ignorado ao classificar por nome. |
| Sintaxe: | fantasiaindex_directories_first [ em | desligado ] |
|---|---|
| Padrão: | fantasiaindex_directories_first em |
| Contexto: | http, servidor, localização |
| Descrição: | Se ativado (configuração padrão), agrupa diretórios e os classifica antes de todos os arquivos normais. Se desativado, os diretórios serão classificados junto com os arquivos. |
| Sintaxe: | fantasiaindex_css_href uri |
|---|---|
| Padrão: | fantasiaindex_css_href "" |
| Contexto: | http, servidor, localização |
| Descrição: | Permite inserir link para uma folha de estilo CSS nas listagens geradas. O parâmetro uri fornecido será inserido como está em uma tag HTML |
| Sintaxe: | fantasiaindex_exact_size [ ligado | desligado ] |
|---|---|
| Padrão: | fantasiaindex_exact_size ativado |
| Contexto: | http, servidor, localização |
| Descrição: | Define como representar os tamanhos dos arquivos na listagem de diretórios: com precisão ou arredondando para kilobyte, megabyte e gigabyte. |
| Sintaxe: | fantasiaindex_footer caminho [ subsolicitação | locais ] |
|---|---|
| Padrão: | fantasiaindex_footer "" |
| Contexto: | http, servidor, localização |
| Descrição: | Especifica qual arquivo deve ser inserido no final das listagens de diretórios. Se definido como uma string vazia, o rodapé padrão fornecido pelo módulo será enviado. O parâmetro opcional indica se o caminho deve ser tratado como um URI para carregar usando uma subsolicitação (o padrão) ou se se refere a um arquivo local . |
Observação
O uso desta diretiva requer o ngx_http_addition_module integrado ao Nginx.
Aviso
Ao inserir um cabeçalho/rodapé personalizado, uma subsolicitação será emitida para que qualquer URL possa ser usado como fonte para eles. Embora funcione com URLs externos, apenas o uso de URLs internos é suportado. URLs externos não foram testados e usá-los fará com que o Nginx seja bloqueado enquanto aguarda a conclusão da subsolicitação. Se você acha que o cabeçalho/rodapé externo é obrigatório para você, entre em contato.
| Sintaxe: | fantasiaindex_header caminho [ subsolicitação | locais ] |
|---|---|
| Padrão: | fantasiaindex_header "" |
| Contexto: | http, servidor, localização |
| Descrição: | Especifica qual arquivo deve ser inserido no topo das listagens de diretórios. Se definido como uma string vazia, o cabeçalho padrão fornecido pelo módulo será enviado. O parâmetro opcional indica se o caminho deve ser tratado como um URI para carregar usando uma subsolicitação (o padrão) ou se se refere a um arquivo local . |
Observação
O uso desta diretiva requer o ngx_http_addition_module integrado ao Nginx.
| Sintaxe: | fantasiaindex_show_path [ ativado | desligado ] |
|---|---|
| Padrão: | fantasiaindex_show_path ativado |
| Contexto: | http, servidor, localização |
| Descrição: | Se deve ou não gerar o caminho e a tag de fechamento após o cabeçalho. Isso é útil quando você deseja manipular o caminho exibido com um script PHP, por exemplo. |
Aviso
Esta diretiva só pode ser desativada se um cabeçalho personalizado for fornecido usando fancyindex_header.
| Sintaxe: | fantasiaindex_show_dotfiles [ on | desligado ] |
|---|---|
| Padrão: | fantasiaindex_show_dotfiles desativado |
| Contexto: | http, servidor, localização |
| Descrição: | Se deve listar os arquivos precedidos de um ponto. A convenção normal é ocultá-los. |
| Sintaxe: | fantasiaindex_ignore string1 [string2 [... stringN]] |
|---|---|
| Padrão: | Sem padrão. |
| Contexto: | http, servidor, localização |
| Descrição: | Especifica uma lista de nomes de arquivos que não serão mostrados nas listagens geradas. Se o Nginx foi construído com suporte PCRE, as strings serão interpretadas como expressões regulares. |
| Sintaxe: | fantasiaindex_hide_symlinks [ ligado | desligado ] |
|---|---|
| Padrão: | fantasiaindex_hide_symlinks desativado |
| Contexto: | http, servidor, localização |
| Descrição: | Quando ativado, as listagens geradas não conterão links simbólicos. |
| Sintaxe: | fantasiaindex_hide_parent_dir [ ligado | desligado ] |
|---|---|
| Padrão: | fantasiaindex_hide_parent_dir desativado |
| Contexto: | http, servidor, localização |
| Descrição: | Quando ativado, não mostrará o diretório pai. |
| Sintaxe: | fantasiaindex_localtime [ ativado | desligado ] |
|---|---|
| Padrão: | fantasiaindex_localtime desativado |
| Contexto: | http, servidor, localização |
| Descrição: | Permite mostrar os horários dos arquivos como hora local. O padrão é “desligado” (horário GMT). |
| Sintaxe: | string fantasiaindex_time_format |
|---|---|
| Padrão: | fantasiaindex_time_format "%Y-%b-%d %H:%M" |
| Contexto: | http, servidor, localização |
| Descrição: | String de formato usada para carimbos de data/hora. Os especificadores de formato são um subconjunto daqueles suportados pela função strftime e o comportamento é independente da localidade (por exemplo, os nomes de dia e mês estão sempre em inglês). Os formatos suportados são:
|
