👨🏻‍🎓 🎠 👹 Arquivo de configuração htaccess 🚣🏼 📘 🔺

Vamos começar de longe, com o objetivo de que os novatos possam ver como o arquivo descrito no artigo funciona. Para trabalhar o site na Internet, você não precisa apenas de um PC e acessar a rede; além disso, é introduzida uma programação extraordinária, que fornece acesso às informações que utilizam as convenções HTTP e HTTPS. Este produto é o servidor da web. Existem diferentes tipos de servidores web, no entanto, o mais amplamente reconhecido é o Apache. Ele é baseado no código-fonte aberto, gratuito, está sendo aprimorado e aprimorado continuamente, compatível com muitos scripts e funciona em quase todas as plataformas, incluindo Windows, Linux, Netware 5.x.

O Apache é organizado por meio de documentos de design que são guardados na organização do conteúdo. Com a assistência deles, você pode definir padrões explícitos de atividade do servidor da web. O registro de design do princípio é chamado httpd.conf ou apache.conf (dependendo da transmissão do SO). Na maioria das vezes, todas as configurações do servidor podem ser determinadas aqui e, essencialmente, essa técnica é melhor tendo em vista o fato de que:

reduz o tempo de resposta do servidor web quando mencionado (assim, toda vez que o servidor web é acessado, o Apache não lê todos os catálogos de .htaccess); alguns pedidos, por exemplo, pedidos do módulo mod_rewrite, sob vários aspectos, funcionam melhor com o registro de design do princípio.

Seja como for, nem todos os clientes do servidor podem abordar este documento (por exemplo, por conta da facilitação compartilhada), de modo que o restante é oferecido um registro extra de organização do servidor da web - .htaccess (com um toque no início do nome).

Sumário

.Htaccess de quê
Como criar um arquivo .htaccess
Sintaxe .htaccess
oportunidades de .htaccess
Controle de acesso
Trabalhando com erros do servidor da web
Ajustando o redirecionamento 301 no htaccess
mod reescrever módulo de redirecionamento
Definindo codificação
Outras oportunidades
Se .htaccess não funcionar
Mais algumas dicas sobre como trabalhar com .htaccess
Links úteis

O que é .htaccess e para que serve?

O arquivo (ou arquivos) .htaccess definirá as regras para o servidor Web apenas no diretório em que está localizado e em seus diretórios filhos, sem alterações globais na operação de todo o servidor. A capacidade de usar .htaccess é prescrita por uma diretiva (ou seja, um comando) - AllowOverride - no arquivo de configuração principal httpd.conf, cujo nome indica diretamente que as configurações no .htaccess têm prioridade sobre as configurações no httpd.conf (a menos que de outra forma limitado pela mesma diretiva AllowOverride). Com essa diretiva, você pode permitir tudo e pode - apenas algumas ações. Instruções detalhadas para seu uso podem ser encontradas no site da Apache.

Com ele, toda vez que um servidor web é acessado, o Apache verifica todos os diretórios em busca de .htaccess. As alterações no arquivo são válidas imediatamente após o salvamento - a reinicialização de todo o servidor da Web não é necessária (ao contrário das alterações no httpd.conf).

O nome do arquivo .htaccess é comum, mas não obrigatório. Você pode definir um nome diferente no httpd.conf usando a diretiva AccessFileName, por exemplo:

AccessFileName .config

Como criar um arquivo .htaccess

Como já mencionado, os arquivos de configuração têm um formato de texto e você também pode criar .htaccess usando um editor de texto (por exemplo, Bloco de Notas ou Bloco de Notas no Windows).

O nome do arquivo é .htaccess (com um ponto no início);

tipo - "Todos os arquivos";

quebra de linha;

Modo ASCII (ao fazer upload de .htaccess para uma hospedagem usando um protocolo FTP).

O Apache é um servidor Web com distinção entre maiúsculas e minúsculas, portanto, é importante escrever o nome em letras minúsculas: .HTaccess e .htaccess são arquivos diferentes.

Os arquivos do Mac OS que começam com um ponto são invisíveis. Portanto, você pode chamá-lo de maneira diferente e, depois, transferir via FTP para a hospedagem, renomeá-lo. Geralmente eles colocam o arquivo no diretório raiz do servidor web (/ public_html) ou no diretório raiz do site (/public_html/site.com/).

Sintaxe .htaccess

A sintaxe .htaccess é semelhante à sintaxe httpd. Para cada diretiva, uma linha separada é assumida. Para sua conveniência, você pode adicionar comentários ao arquivo usando o sinal #, e o valor após # será ignorado pelo servidor da web. Este truque pode ser usado para desativar qualquer diretiva. Ele não precisa ser removido completamente do arquivo - basta comentar.

As possibilidades do arquivo de configuração são enormes. Abaixo estão as configurações básicas em .htaccess.

oportunidades de .htaccess

Controle de acesso

Proibição de acesso à Web:

Negar pedido, permitir
Negar de todos

Proibição de acesso à Web, exceto IP:

order deny, allow deny from all allow from xxx.xxx.xxx.xxx

Proibição de acesso à Web para IP:

 Order allow, deny Allow from all Deny from xxx.xxx.xxx.xxx

Proibição de acesso a arquivos:

 <Files private.html > Order allow, deny Deny from all

Diretório de segurança com a senha:

 AuthType Basic AuthName "Directory Name" AuthUserFile /home/cpanel_user/.htpasswds/public_html/smth/passwd require valid-user # where AuthName "Directory Name is the secured directory name, nd # /home/cpanel_user/.htpasswds/public_html/smth/passwd is the file location with the password.

Trabalhando com os erros do servidor da web

Às vezes, em vez da página esperada, um visitante pode encontrar uma resposta do servidor da Web na forma de um erro com uma explicação concisa, mas nem sempre clara para um usuário simples, do motivo. Uma lista completa de códigos de status pode ser encontrada na Wikipedia. Para os erros mais comuns (por exemplo, 404 ou 500), é desejável criar sua própria página com melhor aparência e apresentar a rota de saída ao visitante. É definido da seguinte forma:

ErrorDocument 404 seudominio.com/erro/404.html
# onde yourdomain.com/error/404.html é o caminho para a página criada.

Ajustando o redirecionamento 301 no htaccess

Para criar um redirecionamento permanente, é usado o redirecionamento da diretiva 301, que transfere todo o peso da página para um novo URL (portanto, é preferível um redirecionamento 302 para fins de SEO).

Redirecionando o site inteiro para um novo domínio:

 Redirect 301 / http://www.newdomain.com/

Redirecionar página para nova:

 Redirect 301 /page1.html http://mydomain.com/page2.html

Mod reescrever módulo de redirecionamento

O módulo mod_rewrite é um mecanismo indispensável para alterar URLs "on the fly". Sua utilidade e, ao mesmo tempo, a dificuldade está no fato de que você pode usar uma infinidade de regras que incluem ainda mais variáveis.

Para que o módulo funcione, primeiro precisamos de diretivas

RewriteEngine On (inclui o mecanismo de conversão)

Opções FollowSymLinks (condição de operação mod_rewrite).

Se o administrador do servidor desativou esta opção para o diretório do usuário, o mecanismo de conversão não pode ser usado. Essa restrição é imposta aos servidores de hospedagem virtual por motivos de segurança.

Para conhecer melhor o módulo, recomendamos consultar a fonte.

RewriteRule

Uma das diretivas mais funcionais do módulo mod_rewrite é o RewriteRule. Para especificar a condição sob a qual a regra funcionará, a diretiva RewriteCond é usada. Ele (um ou mais) deve ser prescrito antes da RewriteRule.

Redirecione a página para o novo domínio:

 RewriteRule ^ page1 \ .html $ http://newdomain.com/ [R = 301]

Redirecionando um site de um domínio sem www para um domínio de www:

 RewriteEngine On RewriteCond% {HTTP_HOST}! ^ Www \ .. * [NC] RewriteRule ^ (. *) Http: //www.% {HTTP_HOST} / $ 1 [R = 301]

E vice-versa:

 RewriteCond% {HTTP_HOST} ^ www \. (. *) $ [NC] RewriteRule ^ (. *) $ Http: //% 1 / $ 1 [R = 301, L]

Redirecionamento HTTPS (você deve primeiro instalar um certificado HTTPS):

 RewriteEngine On RewriteCond% {https}! On RewriteRule (. *) Https: //% {HTTP_HOST}% {REQUEST_URI} [R = 301, L]

Essas linhas devem ser colocadas no topo do .htaccess.

Definindo a codificação

A tabela de símbolos na qual abrir o site é determinada pelo navegador. No entanto, você pode definir a codificação padrão:

 AddDefaultCharset UTF-8

Essa alteração se aplica ao .htaccess e a todas as páginas do site. Você pode definir a codificação para um tipo específico de arquivo, por exemplo, windows-1251 para html:

 AddType "application / x-httpd-php3; charset = windows-1251" .html

Muitas vezes, a própria página carrega em si (nomeadamente no título) informações sobre a codificação usada. É necessário verificar se a codificação especificada no documento e no arquivo de configuração corresponde. O utf-8 fornecido aqui é quase sempre necessário quando se trabalha com cms populares, pois são projetados para uma ampla gama de usuários em todo o mundo. A propósito, por padrão, a mesma codificação está configurada em nossos servidores de hospedagem compartilhada.

Outras oportunidades

- Determine o arquivo de índice do site:

Por padrão, a página de índice é considerada index.html. Com a ajuda da seguinte diretiva, você pode especificar outro nome de arquivo que saia primeiro ao acessar o diretório:

DirectoryIndex index.php

- Uma diretiva útil é FilesMatch, que especifica os limites da regra pelo nome do arquivo usando expressões regulares. Com sua ajuda, por exemplo, você pode negar o acesso a determinados arquivos:

 <FilesMatch "\. (htaccess | htpasswd | ini | phps | fla | psd | log | sh) $"> Order Allow, Deny Deny from all </ FilesMatch>

Existem algumas diretivas que não são suportadas em nossos servidores de hospedagem compartilhada, mas você pode permiti-las no seu VPS, por exemplo.

O motivo é que o servidor da web executando como suPHP não suporta php_flag e php_value. Portanto, sugerimos o uso do cPanel (a subseção “Escolhendo uma versão do PHP” é extremamente útil, para trabalhar com error_log - “Error Log”) ou para criar um arquivo php.ini local para essa finalidade. Trouxemos algumas diretrizes abaixo:

- Para evitar um congelamento do servidor da web ao processar scripts gravados incorretamente, existe max_execution_time. Com sua ajuda, o tempo em segundos alocado para o processamento do script PHP é indicado. Você pode aumentar o tempo limite do servidor da web ao executar o script:

 php_value max_execution_time 60

- Determine o tamanho máximo do arquivo de upload:

 php_value upload_max_filesize 128M (here, instead of 128, put the desired value)

- Imprima erros de PHP em um arquivo separado:

 php_flag log_errors on php_value error_log /home/path/to/public_html/domain/PHP_errors.log # PHP_errors.log is the name of the file, and # / home / path / to / public_html / domain - the path to it).

PS Em uma hospedagem compartilhada, é difícil determinar com precisão quais diretivas funcionarão no .htaccess, porque muitas daquelas que levam a uma alteração na configuração do servidor da Web são proibidas por razões óbvias - essas alterações afetam todos os usuários da mídia.

Se .htaccess não funcionar

Você pode verificar a operação do arquivo escrevendo diretivas simples que, com a sintaxe correta e as configurações httpd corretas (conforme descrito no início do artigo), devem funcionar:

- por exemplo, negando o acesso ao site de fora usando uma diretiva

 Order deny, allow Deny from all

- ou escrevendo no arquivo um conjunto de caracteres sem sentido que não são diretivas. Se o servidor da web interage com o htaccess, é claro que ele não poderá lê-los e fornecer 500 erros.

Se o problema realmente existir, você deve primeiro procurar a causa no arquivo de configuração principal:

- verifique se o servidor permite o uso do arquivo .htaccess: existe uma entrada AllowOverride All (e não é comentada usando #);

- verifique se uma entrada do VirtualHost foi criada para o domínio. Como exemplo:

 <VirtualHost *: 80> DocumentRoot / www / example1 ServerName www.example.com # Other directives </ Virtualhost>

- o nome do arquivo de configuração adicional é indicado conforme necessário. Se for .htaccess, então:

 AccessFileName .htaccess

- o nome do host do servidor está presente (especificado ao criar redirecionamentos de URL) como o endereço IP do servidor ou domínio:

 ServerName www.example.com

Se o motivo não estiver no httpd, é necessário verificar se há .htaccess quanto a erros de sintaxe. Você pode usar serviços online (por exemplo, www.htaccesscheck.com , htaccess.madewithlove.be ) ou - a fonte original, onde há uma lista completa de diretivas, juntamente com a sintaxe.

Mais algumas dicas sobre como trabalhar com .htaccess

É altamente desejável fazer uma cópia de backup do arquivo antes de qualquer edição, para que, no pior resultado, você possa "reverter" as alterações.

Recomendamos fazer alterações passo a passo, usando o mínimo de diretivas - e, em caso de falha, será mais fácil calcular qual regra causou o erro.

Embora as alterações tenham efeito imediato, o cache do navegador não foi cancelado - para verificar o trabalho do site após a edição do .htaccess, use-o para limpá-lo regularmente ou carregue a página para ignorá-lo - através da combinação de teclas Ctrl + F5 (no Safari: Ctrl + R, no Mac OS: Cmd + R).

O erro mais comum do servidor da web ao trabalhar com .htaccess é 500 e indica um problema na sintaxe (erro de digitação em uma diretiva, por exemplo), ou esse tipo de diretiva não é permitido no arquivo de configuração principal.

Arquivo de configuração htaccess