移除URL中.php后缀及路径内index.php并兼容自定义PHP路由的技术问题

开发者阿泽

2026-4-28

我来帮你解决这个URL重写和路由兼容的问题，咱们一步步调整配置和代码，确保两种URL格式都能正常工作：

第一步：调整`.htaccess`配置

这个配置要同时实现移除中间的index.php、移除末尾的.php后缀，还要兼容你的自定义路由和静态页面：

RewriteEngine On

# 1. 永久重定向：移除URL中间的index.php（比如shop/index.php/product/test → shop/product/test）
RewriteCond %{THE_REQUEST} /index\.php/ [NC]
RewriteRule ^(.*)index\.php/(.*)$ /$1$2 [L,R=301]

# 2. 永久重定向：处理直接访问index.php的情况（比如shop/index.php → shop/）
RewriteCond %{THE_REQUEST} /index\.php$ [NC]
RewriteRule ^(.*)index\.php$ /$1 [L,R=301]

# 3. 内部转发：把自定义路由请求交给index.php处理（比如shop/product/test → shop/index.php/product/test）
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php/$1 [L]

# 4. 内部重写：处理静态页面的.php后缀移除（比如shop/contact → shop/contact.php）
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME}.php -f
RewriteRule ^([^\.]+)$ $1.php [NC,L]

配置说明：

前两条规则负责URL美化的重定向，把带index.php的旧URL跳转到干净的新URL，利于SEO和用户体验。
第三条规则是路由核心：当请求的路径不是真实文件/目录时，自动转发给index.php，让你的路由代码处理自定义路径（比如product/test）。
第四条规则专门处理静态页面：比如请求contact时，自动匹配对应的contact.php文件，避免404。

第二步：修改`routes.php`路由逻辑

原来的代码依赖URL里的index.php字符串来解析路由，现在URL里已经没有了，所以要调整路由解析逻辑：

<?php
// 自动获取当前项目的基础路径（比如/shop/，适配子目录部署）
$baseUrl = dirname($_SERVER['SCRIPT_NAME']);
if ($baseUrl !== '/' && substr($baseUrl, -1) !== '/') {
    $baseUrl .= '/';
}

// 从请求URL中提取纯净的路由部分（比如shop/product/test → product/test）
$requestUri = $_SERVER['REQUEST_URI'];
$route = preg_replace('#^' . preg_quote($baseUrl, '#') . '#', '', $requestUri);
$route = ltrim($route, '/');

// 路由为空时加载首页
if (empty($route)) {
    require __DIR__.'/templates/index.php';
    exit();
}

// 处理购物车添加路由：/cart/add/{productId}
if (strpos($route, 'cart/add/') === 0) {
    $routeParts = explode('/', $route);
    if (count($routeParts) >= 3) {
        $productId = (int)$routeParts[2];
        header("Location: " . $baseUrl);
        exit();
    } else {
        echo "Ungültige URL";
        exit();
    }
}

// 处理产品详情路由：/product/{slug}
if (strpos($route, 'product/') === 0) {
    $routeParts = explode('/', $route);
    if (count($routeParts) !== 2) {
        echo "Ungültige URL";
        exit();
    }
    $slug = $routeParts[1];
    if (0 === strlen($slug)) {
        echo "Ungülites Produkt";
        exit();
    }
    require "includes/functions.inc.php";
    require "includes/dbh.inc.php";
    $product = getProductBySlug($slug, $conn);
    if (null === $product) {
        echo "Ungülites Produkt";
        exit();
    }
    require_once __DIR__ . '/templates/watchdetail.php';
    exit();
}

// 未匹配到任何路由时返回404
echo "404 - Seite nicht gefunden";
exit();

代码修改说明：

用dirname($_SERVER['SCRIPT_NAME'])自动获取项目基础路径，不管你部署在根目录还是子目录（比如/shop/），都能正确解析路由。
从请求URL中剥离基础路径，得到纯净的路由字符串（比如product/test），不再依赖index.php的位置。
调整了路由匹配的判断逻辑，确保更精准（比如用strpos($route, 'product/') === 0确保路由以product/开头）。
增加了404兜底逻辑，避免未匹配路由时出现空白页面。

验证测试

现在你可以测试两种场景：

静态页面：访问shop/contact会自动加载shop/contact.php，不会出现404。
自定义路由：访问shop/product/test会被转发到index.php处理，加载产品详情页；旧URLshop/index.php/product/test会自动跳转到新的干净URL。

注意事项：

确保你的服务器开启了mod_rewrite模块。
测试前清空浏览器缓存（因为301重定向会被浏览器缓存）。
.htaccess要放在你的项目根目录（比如shop目录下），不要放在服务器根目录。

内容的提问来源于stack exchange，提问作者Felix Mutter