Magento 1.7 - remove index.php from url

Magento 1.7 - remove index.php from url

July 10, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento 1.7 - remove index.php from url

Removing index.php from Magento URLs

Are you struggling with persistent index.php appearing in your Magento URL? You’re not alone. This common issue can be frustrating, but it’s easily resolvable with the right configurations.

Understanding the Problem

The presence of index.php in your URLs is typically due to incorrect settings or misconfigured files. In your case, you’ve enabled web server rewrites and configured your .htaccess file correctly, yet the issue persists for specific URLs like those generated from email templates or custom PHP files.

Identifying the Root Cause

The key lies in how Magento handles different types of requests. By default, it treats certain paths (like doc/) differently than others.

The Solution: Fine-Tuning Your Configurations

Step 1: Check Your Base URLs

Ensure your base URL is correctly configured in the backend. Navigate to System > Configuration > General > Web. Under the Unsecure and Secure sections, verify that index.php is not appended to your base URL.

If it is, simply remove index.php from the field and save the changes.

Step 2: Optimize Your Email Templates

In your email template code, you’re using a direct link generated by {{store url="doc/toc.pdf"}}. This often causes Magento to append the index.php prefix because the path is not recognized as a standard URL.

Instead of using {{store url}}, try using a relative path:

<a href='doc/toc.pdf'>xxxx</a>

Or, if you need to ensure it’s always resolved properly:

<?php echo $this->getBaseUrl() . 'doc/toc.pdf'; ?>

Step 3: Resolve Issues with Mage::getUrl

If index.php is being added when using Mage::getUrl() in a PHP file, the issue might be due to incorrect path resolution. Double-check that your file paths are relative to the correct base directory.

Advanced Troubleshooting

Step 4: Review Your .htaccess Configuration

Ensure your .htaccess has the following rules:

RewriteEngine On
RewriteBase /

# remove index.php from request uri
RewriteCond %{THE_REQUEST} ^[A-Z]+\s(.+?)\.php[\s?] [NC]
RewriteRule ^(?!doc\b)(.*)\.php$ $1 [L,R=301,E=REQUEST_URI:$2]

# remove index.php from internal request uri
RewriteCond %{ENV:REQUEST_URI} \.php$
RewriteRule .* $1 [L,R=404]

Step 5: Clear Cache and Reindex

After making any changes, always clear your cache and reindex to ensure the updates take effect:

php bin/magento cache:clean
php bin/magento indexer:reindex

Conclusion

Removing index.php from Magento URLs often requires a combination of checking base URL configurations, fine-tuning email template links, and verifying PHP file paths. Don’t hesitate to explore our comprehensive Magento development guides for more in-depth solutions to common issues.

Remember, Magento is powerful but complex. Always backup your data before making significant changes, and don’t be afraid to seek professional help if the issue persists after following these steps.

Happy coding!

Magento 1 Performance Themes Admin

Our network