1. Home
  2. Go Live Processes
  3. Building the .htaccess File
Searching...

Building the .htaccess File

Contents

You will need your 301s before you can create a complete the .htaccess file.

Overview

This .htaccess configuration is optimized for our Plesk/Nginx environment, addressing common scenarios like domain redirection and URL rewriting, specifically for our needs.

Copy and paste the content below into your .htaccess file or download the template from the link above.

# .htaccess Configuration
# Version: 1.0
# Date: 2024-08-23
# Description: Initial version with domain redirection, PHP handling, and URL rewriting rules.

#AddType application/x-httpd-php .html

# Directory Options
Options +FollowSymLinks -MultiViews

# Enable Rewrite Engine
RewriteEngine On
RewriteBase /

# ---- New Domain Redirection ----
# Redirect any version of the old domain to the new domain (HTTPS)
RewriteCond %{HTTP_HOST} ^(www\.)?oldexample\.com$ [NC]
RewriteRule ^(.*)$ https://www.newexample.com/$1 [L,R=301]

# ---- Same Domain Redirection ----
# Redirect non-www to www on the same domain (HTTPS)
RewriteCond %{HTTP_HOST} !^www\. [NC]
RewriteCond %{HTTP_HOST} ^(.+)$ [NC]
RewriteRule ^(.*)$ https://www.%1/$1 [L,R=301]

# ---- index.html Redirection ----
RewriteCond %{THE_REQUEST} /\index\.html [NC]
RewriteRule ^index\.html$ / [L,R=301]

# ---- CSS/JS Versioning ----
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.+)\.(\d+)\.(bmp|css|cur|gif|ico|jpe?g|js|png|svgz?|webp|webmanifest)$ $1.$3 [L]

# ---- 301 Specific URL Redirects ----
# Example: Redirect 301 /old-page.html /new-page.html
Redirect 301 /old-page.html /new-page.html
Redirect 301 /another-old-page.html /another-new-page.html

Instructions for Creating and Editing.htaccess

  1. Creating the File: Use a text editor to create a file named .htaccess and place it in the directory you want to control.
  2. Editing the File: Use a text editor to add or modify directives.
  3. RewriteCond RewriteRule Directives: Leave ALL 3 Sets of if Unsure:
  4. Customize for Your Domain: Replace oldexample.com and newexample.com with your actual project URLs.

Backup: Always back up your .htaccess file before making changes.

Testing and Deployment

  1. Test your .htaccess file in a staging environment to ensure all redirects work as expected.
  2. Deploy final .htaccess file to your live environment.
  3. Use .htaccess tester tools to verify your rules.
  4. Monitor your website to ensure all redirects are functioning correctly.

made with love – .htaccess tester

Updated on September 3, 2024
Was this article helpful?
Yes No

Related Articles