Mautic na TurboCloud: .htaccess recomendado para servidores com LiteSpeed

O Mautic é uma plataforma de automação de marketing que depende de regras de reescrita (rewrite) para funcionar corretamente, especialmente em rotas, formulários, campanhas e área administrativa.

Na TurboCloud, os servidores utilizam LiteSpeed, que é compatível com regras de .htaccess, mas exige um arquivo bem configurado para evitar erros como:

  • Páginas em branco ou erro 500;
  • Rotas do Mautic não funcionando corretamente;
  • Problemas ao acessar o painel;
  • URLs quebradas em formulários, campanhas ou assets.

Este artigo mostra o .htaccess recomendado para Mautic na TurboCloud e como aplicá-lo de forma simples.

Onde o Mautic está instalado?

Antes de ajustar o .htaccess, é importante saber onde o Mautic está instalado na sua hospedagem:

  • Diretamente na raiz do site (public_html); ou
  • Em uma pasta específica, por exemplo: public_html/mautic.

O arquivo .htaccess precisa ficar dentro do diretório onde o Mautic está instalado. Ou seja:

  • Se o Mautic estiver em public_html, o .htaccess fica em public_html/.htaccess;
  • Se o Mautic estiver em public_html/mautic, o .htaccess fica em public_html/mautic/.htaccess.

Passo a passo para aplicar o .htaccess do Mautic

  1. Faça login no cPanel da sua conta;
  2. Acesse o Gerenciador de Arquivos;
  3. Navegue até a pasta onde o Mautic está instalado;
  4. Localize o arquivo .htaccess:
  • Se já existir, faça um backup (download) antes de alterar;
  • Se não existir, crie um novo arquivo chamado .htaccess.

Em seguida, substitua o conteúdo atual pelo código abaixo.

.htaccess recomendado para Mautic na TurboCloud (LiteSpeed)

Você pode copiar e colar o conteúdo abaixo diretamente no arquivo .htaccess do Mautic:

# Use the front controller as index file. It serves as a fallback solution when
# every other rewrite/redirect fails (e.g. in an aliased environment without
# mod_rewrite). Additionally, this reduces the matching process for the
# start page (path "/") because otherwise Apache will apply the rewriting rules
# to each configured DirectoryIndex file (e.g. index.php, index.html, index.pl).
#DirectoryIndex index.php

<IfModule mod_rewrite.c>
RewriteEngine On

# Set Authorization header for OAuth1a for when php is running under fcgi
RewriteCond %{HTTP:Authorization} .+
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]

# Determine the RewriteBase automatically and set it as environment variable.
# If you are using Apache aliases to do mass virtual hosting or installed the
# project in a subdirectory, the base path will be prepended to allow proper
# resolution of the app.php file and to redirect to the correct URI. It will
# work in environments without path prefix as well, providing a safe, one-size
# fits all solution. But as you do not need it in this case, you can comment
# the following 2 lines to eliminate the overhead.
RewriteCond %{REQUEST_URI}::$1 ^(/.+)/(.*)::\2$
RewriteRule ^(.*) - [E=BASE:%1]

# Redirect to URI without front controller to prevent duplicate content
# (with and without `/app.php`). Only do this redirect on the initial
# rewrite by Apache and not on subsequent cycles. Otherwise we would get an
# endless redirect loop (request -> rewrite to front controller ->
# redirect -> request -> ...).
# So in case you get a "too many redirects" error or you always get redirected
# to the start page because your Apache does not expose the REDIRECT_STATUS
# environment variable, you have 2 choices:
# - disable this feature by commenting the following 2 lines or
# - use Apache >= 2.3.9 and replace all L flags by END flags and remove the
# following RewriteCond (best solution)
RewriteCond %{ENV:REDIRECT_STATUS} ^$
RewriteRule ^index\.php(/(.*)|$) %{ENV:BASE}/$2 [R=301,L]

# If the requested filename exists, simply serve it.
# We only want to let Apache serve files and not directories.
RewriteCond %{REQUEST_FILENAME} -f
RewriteRule .? - [L]

# Rewrite all other queries to the front controller.
RewriteRule .? %{ENV:BASE}/index.php [L]
</IfModule>

<IfModule !mod_rewrite.c>
<IfModule mod_alias.c>
# When mod_rewrite is not available, we instruct a temporary redirect of
# the start page to the front controller explicitly so that the website
# and the generated links can still be used.
RedirectMatch 302 ^(?!/(index\.php|index_dev\.php|app|addons|plugins|media|upgrade))(/(.*))$ /index.php$2
# RedirectTemp cannot be used instead
</IfModule>
</IfModule>

<IfModule mod_php5.c>
# @link https://github.com/mautic/mautic/issues/1504
php_value always_populate_raw_post_data -1
</IfModule>

<IfModule mod_deflate.c>
<IfModule mod_filter.c>
AddOutputFilterByType DEFLATE application/javascript
AddOutputFilterByType DEFLATE application/rss+xml
AddOutputFilterByType DEFLATE application/vnd.ms-fontobject
AddOutputFilterByType DEFLATE application/x-font
AddOutputFilterByType DEFLATE application/x-font-opentype
AddOutputFilterByType DEFLATE application/x-font-otf
AddOutputFilterByType DEFLATE application/x-font-truetype
AddOutputFilterByType DEFLATE application/x-font-ttf
AddOutputFilterByType DEFLATE application/x-javascript
AddOutputFilterByType DEFLATE font/opentype
AddOutputFilterByType DEFLATE font/otf
AddOutputFilterByType DEFLATE font/ttf
AddOutputFilterByType DEFLATE image/svg+xml
AddOutputFilterByType DEFLATE image/x-icon
AddOutputFilterByType DEFLATE text/css
AddOutputFilterByType DEFLATE text/javascript
# Do not enable compression for file types that could contain secrets
#AddOutputFilterByType DEFLATE text/html
#AddOutputFilterByType DEFLATE text/plain
#AddOutputFilterByType DEFLATE text/xml
#AddOutputFilterByType DEFLATE application/xhtml+xml
#AddOutputFilterByType DEFLATE application/xml
#AddOutputFilterByType DEFLATE application/json
<IfModule mod_setenvif.c>
<IfModule mod_header.c>
# Remove browser bugs (only needed for really old browsers)
BrowserMatch ^Mozilla/4 gzip-only-text/html
BrowserMatch ^Mozilla/4\.0[678] no-gzip
BrowserMatch \bMSIE !no-gzip !gzip-only-text/html
Header append Vary User-Agent
</IfModule>
</IfModule>
</IfModule>
</IfModule>

# Apache 2.4+
<IfModule authz_core_module>
# Deny access via HTTP requests to all PHP files.
<FilesMatch "\.php$">
Require all denied
</FilesMatch>

# Deny access via HTTP requests to composer files.
<FilesMatch "^(composer\.json|composer\.lock)$">
Require all denied
</FilesMatch>

# Except those whitelisted bellow.
<FilesMatch "^(index|index_dev|filemanager|upgrade)\.php$">
Require all granted
</FilesMatch>
</IfModule>

# Fallback for Apache < 2.4
<IfModule !authz_core_module>
# Deny access via HTTP requests to all PHP files.
<FilesMatch "\.php$">
Order deny,allow
Deny from all
</FilesMatch>

# Deny access via HTTP requests to composer files
<FilesMatch "^(composer\.json|composer\.lock)$">
Order deny,allow
Deny from all
</FilesMatch>

# Except those whitelisted bellow.
<FilesMatch "^(index|index_dev|filemanager|upgrade)\.php$">
Order allow,deny
Allow from all
</FilesMatch>
</IfModule>

Após aplicar o .htaccess

Depois de salvar o arquivo .htaccess:

  • Acesse o painel do Mautic pela URL configurada;
  • Teste login, formulários e páginas de campanha;
  • Verifique se não há erro 403, 404 ou 500 nas principais rotas.

Se algo não funcionar após a alteração, revise:

  • Se o arquivo está no diretório correto do Mautic;
  • Se não há outro .htaccess em nível superior interferindo;
  • Se o domínio/subdomínio está apontando para o local certo.

Quando acionar o suporte

Caso tenha dúvidas ou encontre erros após aplicar o .htaccess:

  • Informe o domínio ou subdomínio onde o Mautic está instalado;
  • Descreva o erro (mensagem ou comportamento);
  • Informe se houve alteração recente de pasta, domínio ou DNS.

Nossa equipe pode orientar na validação do ambiente, sempre considerando que o Mautic é um sistema avançado e, em muitos casos, o desenvolvedor ou responsável pelo sistema também deve participar dos ajustes.

¿Fue útil la respuesta? 160 Los Usuarios han Encontrado Esto Útil (536 Votos)