Linux中ThinkPHP路由设置指南

不管你是刚开始接触 ThinkPHP，还是已经在 Linux 服务器上摸爬滚打了一段时间，路由配置这块儿，始终是绕不过去的一道关卡。说白了，它决定了你的 URL 长什么样，用户怎么访问到你应用里的每一个功能。下面的内容，我们就把整个流程从头到尾理一遍，从环境搭建到路由定义，再到问题排查，争取一次说清楚。

一、前置准备：Linux 环境配置

在正式碰路由之前，得先把“地基”打好。Linux 环境里，这几样东西是必须的：

• Web 服务器：建议用 Nginx，轻量高效，现在的主流选择。当然，Apache 兼容性更好，也是备选项。
• PHP 环境：版本必须符合 ThinkPHP 的要求。比如 ThinkPHP6，最低得是 PHP 7.1 以上。
• Composer：PHP 的依赖管理工具，装框架全靠它。

下面以 Ubuntu 系统为例，把安装步骤拆开来看。

1.1 安装 Nginx

sudo apt update
sudo apt install nginx

装完之后，启动它，并设置开机自启：

sudo systemctl start nginx
sudo systemctl enable nginx

1.2 安装 PHP 及扩展

继续用 Ubuntu 的 apt 包管理器，装 PHP 7.4 和几个最常用的扩展：

sudo apt install php7.4 php7.4-fpm php7.4-mysql php7.4-curl php7.4-gd

装好之后，有个关键步骤：配置 PHP-FPM。编辑 /etc/php/7.4/fpm/pool.d/www.conf 这个文件，确认 listen 指令的地址和 Nginx 配置里的一致。通常是 unix:/var/run/php/php7.4-fpm.sock，这个细节很容易被忽略，但它决定了 Nginx 能不能顺利和 PHP 通信。

1.3 安装 ThinkPHP

用 Composer 创建项目，以 ThinkPHP6 为例，一行命令搞定：

composer create-project topthink/think your_project_name

然后进入项目目录：

cd your_project_name

二、配置 Web 服务器伪静态

ThinkPHP 的路由要工作，依赖的是 PATH_INFO 模式。简单说，就是所有请求都得让 Web 服务器转发到 index.php 这个入口文件上去，这里就需要配置伪静态了。

2.1 Nginx 伪静态配置

创建一个针对你项目的 Nginx 配置文件，比如 /etc/nginx/sites-a vailable/your_project：

sudo nano /etc/nginx/sites-a vailable/your_project

然后把下面的配置贴进去，记得把 your_domain_or_ip 和 /path/to/your_project 换成你自己的：

server {
    listen 80;
    server_name your_domain_or_ip;
    root /path/to/your_project/public;
    index index.php index.html;

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

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    # 防止访问隐藏文件
    location ~ /\. {
        deny all;
    }
}

启用配置并重启 Nginx：

sudo ln -s /etc/nginx/sites-a vailable/your_project /etc/nginx/sites-enabled/
sudo nginx -t  # 先测试一下语法，别急着重启
sudo systemctl restart nginx

这一步里的 try_files 指令是灵魂所在，它把所有不存在的文件或目录请求，都指向了 index.php。

2.2 Apache 伪静态配置（可选）

如果你用的是 Apache，玩法也差不多。先启用 mod_rewrite 模块：

sudo a2enmod rewrite
sudo systemctl restart apache2

然后在项目 public 目录下创建 .htaccess 文件，内容如下：

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

逻辑和 Nginx 其实是一样的：如果请求的不是真实文件或目录，就交给 index.php 处理。

三、ThinkPHP 路由配置

好了，服务器准备好了，现在轮到应用层面了。ThinkPHP 的路由配置文件，在 ThinkPHP6 里是 route/app.php。记住，要引入 Route 门面才能开始定义规则。

3.1 开启路由功能

在 config/app.php 里，确认这两个配置：

'url_route_on' => true,   // 开启路由
'url_route_must' => false, // 不强制要求所有URL都匹配路由（按需设置）

ThinkPHP6 默认是开启的，但也值得看一眼，省得到时候找不到问题在哪。

3.2 定义基础路由规则

在 route/app.php 里，开始写下你的第一条路由吧：

// GET请求路由
Route::get('blog/:id', 'blog/read');
// POST请求路由（如表单提交）
Route::post('blog/create', 'blog/create');
// 任意请求类型路由（GET/POST/PUT/DELETE）
Route::any('blog/:id', 'blog/read');

Route::get('blog/:id/[:comment]', 'blog/read');

Route::get('blog/:id$', 'blog/read');

Route::get('blog/:id', 'blog/read')->pattern(['id' => '\d+']);

'default_route_pattern' => '\w+',

Route::group('user', function() {
    Route::get('login', 'user/Login/index');
    Route::post('register', 'user/Register/create');
    Route::get('profile/:id', 'user/Profile/read');
})->pattern(['id' => '\d+']);

// 路由到类方法
Route::get('blog/:id', 'app\service\Blog@read');
// 路由到模板
Route::view('hello/:name', 'index/hello', ['city' => 'Shanghai']);
// 重定向路由
Route::redirect('old-blog/:id', 'new-blog/:id', 301);