ThinkPHP5.1.34伪静态配置步骤是啥-ThinkPHP-PHP中文网

apache下.htaccess不生效的三个硬性前提是：mod_rewrite模块已启用、allowoverride设为all、.htaccess文件置于public目录；任一缺失均导致404且无提示。

thinkphp5.1.34伪静态配置步骤是啥

Apache下.htaccess不生效的三个硬性前提

TP5.1.34 的伪静态不是写完 .htaccess 就能用，必须同时满足三件事：mod_rewrite 模块已启用、AllowOverride 设为 All（不能是 None 或 FileInfo）、.htaccess 文件放在 public 目录（不是项目根目录）。任一缺失都会返回 404，且毫无提示。

常见错误现象：

访问 /index/index 显示 404，但加 /index.php/index/index 能正常打开
修改了 .htaccess 内容，重启 Apache 后完全没反应
用 phpinfo() 查不到 mod_rewrite 模块

实操建议：

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

在 phpEnv 或本地 XAMPP 中，进 Apache 设置 → 模块管理 → 勾选 rewrite_module 并重启 Apache 进程（仅重载配置无效）
找到你项目的虚拟主机配置文件（如 phpenv\apache\vhosts\mytp5.conf），手动添加或修改 <directory></directory> 块，确保含 AllowOverride All 和 Require all granted

.htaccess 必须新建在 public/ 下，内容严格用这个版本（开头结尾无空行、无中文标点）：

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

Nginx中location / 里 try_files 和 if 判断的区别

TP5.1.34 在 Nginx 下最稳妥的写法是 try_files，而不是 if (!-e $request_filename)。后者在某些 Nginx 版本中会因变量解析顺序导致 PATH_INFO 丢失，最终路由解析失败，返回空白或 404。

实操建议：

在站点 server 块的 location / { } 内，直接替换为：

location / {
    try_files $uri $uri/ /public/index.php?$query_string;
}

紧接着检查 PHP 处理块（通常是 location ~ \.php$）中是否包含：fastcgi_param PATH_INFO $fastcgi_path_info; —— 缺失这行，$_SERVER['PATH_INFO'] 就为空，TP5.1.34 的路由中间件无法提取路径参数
宝塔用户可在「网站 → 设置 → 伪静态」中选择「ThinkPHP 5」，但注意它默认生成的是 /index.php?s= 形式；若你的入口是 public/index.php，必须手动改成 /public/index.php?s=

TP5.1.34 框架层必须开启的三项配置

服务器重写只是第一步，框架本身若没对齐，照样暴露 index.php 或抛出 Route not found。TP5.1.34 默认不强制开启完整路由，需人工确认。

实操建议：

打开 config/app.php，确保以下三项存在且为 true：'url_route_on' => true、'url_common_param' => false（避免 GET 参数污染 PATH_INFO）、'pathinfo_depr' => '/'（与 Apache/Nginx 规则中的 /$1 或 ?s=$1 匹配）
不要依赖全局 URL_MODEL 配置，TP5.1.34 已废弃该常量，改用 url_route_on + 路由定义
检查 app/middleware.php 是否禁用了 think\middleware\ParseUrl，禁用会导致 PATH_INFO 解析跳过，所有路由失效

为什么本地 PHP 内置服务器跑不起来伪静态

PHP 自带的 php -S 不支持 rewrite，也没有 .htaccess 或 nginx.conf 的概念。直接访问 http://localhost:8000/index/index 必然 404，因为请求根本没走到 public/index.php。

实操建议：

本地调试时，必须用 public/router.php 作为路由器文件：php -S localhost:8000 public/router.php
public/router.php 内容只需一行：require_once __DIR__ . '/../index.php';，它会把所有请求兜底交给 TP 入口
别试图在 router.php 里手写 $_SERVER['PATH_INFO'] = $_SERVER['REQUEST_URI']; —— TP5.1.34 的 ParseUrl 中间件已自动处理，强行覆盖反而破坏路由优先级

最容易被忽略的是 AllowOverride All 的作用域和 fastcgi_param PATH_INFO 的存在性——前者决定规则是否加载，后者决定规则加载后能否被框架正确消费。这两处错一个，整个伪静态链就断在中间，查日志也看不到明显报错。