PHP伪静态怎么设置_PHP URL重写规则与服务器配置【配置】-php教程-PHP中文网

php项目中url重写失败导致404，需检查：一、apache下启用mod_rewrite并设allowoverride all，配置.htaccess规则；二、nginx中在server块用try_files或rewrite转发；三、内置服务器用router.php脚本；四、利用path_info解析路由；五、用正则精准映射固定路径。

php伪静态怎么设置_php url重写规则与服务器配置【配置】

如果您在PHP项目中希望将动态URL（如index.php?id=123）转换为更友好的形式（如/article/123），但页面无法正常响应或返回404错误，则可能是由于服务器未启用URL重写模块或重写规则未正确生效。以下是解决此问题的步骤：

一、Apache环境下启用mod_rewrite并配置.htaccess

该方法依赖Apache的mod_rewrite模块与分布式.htaccess文件，适用于共享主机或具备目录覆盖权限的独立服务器环境。其核心是通过规则将请求路径映射至实际PHP入口文件。

1、确认mod_rewrite模块已加载：访问phpinfo()页面，搜索“Loaded Modules”，检查是否存在mod_rewrite；若未出现，编辑Apache配置文件httpd.conf，取消注释或添加：
LoadModule rewrite_module modules/mod_rewrite.so

2、允许.htaccess生效：在httpd.conf中定位到段，将AllowOverride None改为AllowOverride All

3、在网站根目录创建或编辑.htaccess文件，写入以下标准规则：

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?url=$1 [QSA,L]

二、Nginx环境下在server块中配置rewrite规则

Nginx不解析.htaccess，所有重写逻辑必须集中写入主配置或站点server块，通过try_files或rewrite指令实现请求转发，确保PHP-FPM能接收原始路径信息。

1、打开Nginx站点配置文件（如/etc/nginx/sites-available/default或/usr/local/nginx/conf/vhost/example.com.conf）

2、在对应server块内的location /段中，替换或添加如下语句：

try_files $uri $uri/ /index.php?$query_string;

3、若需精确匹配特定路径（如/article/123），可使用rewrite指令：

location /article/ {
rewrite ^/article/([0-9]+)/?$ /article.php?id=$1 last;
}

4、执行nginx -t验证语法，再运行nginx -s reload重载配置

三、PHP内置开发服务器配合router脚本模拟伪静态

PHP 5.4+ 内置服务器默认不支持重写，但可通过指定router脚本拦截所有非静态资源请求，并统一交由index.php处理，适用于本地开发与调试阶段。

1、在项目根目录创建router.php，内容如下：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

if (preg_match('/\.(?:png|jpg|jpeg|gif|css|js|woff2|ttf|svg|ico|map)$/i', $_SERVER["REQUEST_URI"])) {
return false;
} else {
include __DIR__ . '/index.php';
}

2、在终端执行启动命令：php -S localhost:8000 router.php

3、此时访问http://localhost:8000/about将被自动转发至index.php，且$_SERVER['REQUEST_URI']保留原始路径值

四、通过PATH_INFO特性在PHP代码中解析路由

该方法不依赖服务器重写模块，而是利用PHP的PATH_INFO机制，在入口文件中手动提取路径参数并分发逻辑，适合无服务器配置权限或轻量级路由场景。

1、确认PHP配置中cgi.fix_pathinfo=1（默认开启），并在Apache或Nginx中启用PATH_INFO支持（如Apache需设置AcceptPathInfo On）

2、确保Web服务器将请求正确传递PATH_INFO，例如Apache中需在.htaccess添加：RewriteRule ^(.*)$ index.php/$1 [L]

3、在index.php中获取并解析路径：

$path = $_SERVER['PATH_INFO'] ?? '';
$path = trim($path, '/');
$params = explode('/', $path);

4、根据$params数组内容执行对应业务逻辑，例如：if ($params[0] === 'user' && isset($params[1])) { showUserProfile($params[1]); }

五、使用正则重写规则映射具体路径到PHP文件

当需要将固定格式的伪静态路径（如/post/123.html）直接映射到对应PHP脚本时，可采用精准正则匹配方式，避免通用规则带来的干扰，提升路由准确性与性能。

1、在Apache的.htaccess中添加明确规则：

RewriteEngine On
RewriteRule ^post/([0-9]+)\.html$ post.php?id=$1 [L]
RewriteRule ^category/([a-zA-Z0-9_-]+)/?$ category.php?slug=$1 [L]

2、在Nginx的server块中对应添加：

location ~ ^/post/([0-9]+).html$ {
rewrite ^/post/([0-9]+).html$ /post.php?id=$1 last;
}
location ~ ^/category/([a-zA-Z0-9_-]+)/?$ {
rewrite ^/category/([a-zA-Z0-9_-]+)/?$ /category.php?slug=$1 last;
}

3、确保目标PHP文件（如post.php）存在且可执行，参数接收方式与原动态URL一致