Yii2框架如何修改URL结构：将?id=参数格式改为controller/view/username及姓名组合形式

Alright, let's break down how to fix both of these Yii2 URL routing issues to get clean, user-friendly URLs instead of query parameter messes. I've tackled similar setups before, so here's the step-by-step implementation for each case:

This is a common pattern for user profiles or any resource identified by a unique username. Here's how to set it up:

Step 1: Configure URL Manager #

First, update your URL routing rules in config/web.php under the components section. Make sure enablePrettyUrl is turned on and showScriptName is disabled to hide index.php from URLs:

'components' => [
    'urlManager' => [
        'enablePrettyUrl' => true,
        'showScriptName' => false,
        'rules' => [
            // Add this rule before generic ones to prioritize it
            '<controller:\w+>/view/<username:\w+>' => '<controller>/view',
            // Keep your other existing rules here
            '<controller:\w+>/<action:\w+>' => '<controller>/<action>',
        ],
    ],
    // Other components...
],

Step 2: Modify the Controller Action #

Your existing actionView probably accepts an $id parameter. Adjust it to take a $username instead, then fetch the model using that username:

public function actionView($username)
{
    $model = $this->findModelByUsername($username);
    return $this->render('view', ['model' => $model]);
}

// Add this helper method to your controller
protected function findModelByUsername($username)
{
    if (($model = User::findOne(['username' => $username])) !== null) {
        return $model;
    }
    throw new \yii\web\NotFoundHttpException('The requested user does not exist.');
}

Step 3: Generate URLs Correctly #

When creating links to the view page, use the username parameter instead of id:

// In your views or templates
echo \yii\helpers\Url::to(['user/view', 'username' => $model->username]);

For this case, we're using a combined FirstName+LastName string as the identifier. Critical note: Ensure this combination is unique in your database—otherwise, you'll run into ambiguous matches.

Step 1: Update URL Rules #

Add a specific rule for the traitor controller in config/web.php:

'urlManager' => [
    'enablePrettyUrl' => true,
    'showScriptName' => false,
    'rules' => [
        // Prioritize this rule over generic ones
        'traitor/<fullname:[a-zA-Z]+>' => 'traitor/index',
        // Other rules...
    ],
],

The [a-zA-Z]+ pattern assumes your full names only use letters—adjust it if you need to include hyphens or other characters (e.g., [a-zA-Z-]+).

Step 2: Adjust the Controller Action #

Modify the actionIndex in your TraitorController to accept the $fullname parameter and fetch the corresponding model:

public function actionIndex($fullname)
{
    // Query the model by concatenated first and last name
    $model = \app\models\Traitor::find()
        ->where('CONCAT(first_name, last_name) = :fullname', [':fullname' => $fullname])
        ->one();

    if (!$model) {
        throw new \yii\web\NotFoundHttpException('Traitor not found.');
    }

    return $this->render('index', ['model' => $model]);
}

For better performance, consider adding a fullname_slug field to your traitor table (populate it with first_name + last_name on save) and query directly against that field instead of concatenating at runtime.

Step 3: Generate the Clean URL #

When creating links, concatenate the first and last names:

echo \yii\helpers\Url::to(['traitor/index', 'fullname' => $model->first_name . $model->last_name]);

• Unique Identifiers: Always ensure username or the FirstName+LastName combination is unique in your database. If duplicates exist, add a suffix (like JohnRichmond1) to maintain uniqueness.
• URL Rewriting: Don't forget to set up server-level URL rewriting:
  • For Apache, add a .htaccess file in your web root:

    RewriteEngine on
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule . index.php
    

  • For Nginx, update your server block:

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

• Slug Handling: If names contain spaces or special characters, use Yii's slug helper to sanitize them:

  $slug = \Yii::$app->formatter->asSlug($model->first_name . ' ' . $model->last_name);
  // This converts "John Richmond" to "john-richmond" (adjust your URL pattern to match hyphens)
  

内容的提问来源于stack exchange，提问作者Denys Maksiura