SEO友好URL
(Search Engine Optimization):漢譯為搜索引擎優(yōu)化眶掌。
一個SEO友好的URL格式可以大大提升網(wǎng)站的爬取率以及索引率强饮。此外派桩,在URL這個地方部署關(guān)鍵詞可以提升網(wǎng)頁的相關(guān)性伶授。
1.創(chuàng)建觀察者類 確保 在app目錄下創(chuàng)建Observers 文件夾
然后我們在Observers目錄中創(chuàng)建 TopicObserver.php類文件
知識點:
在 Laravel 的世界中气堕,你對 Eloquent 大多數(shù)操作都會或多或少的觸發(fā)一些模型事件,Laravel 事先已經(jīng)定義好了 10 個模型事件以供我們使用畔师,它們分別是:
creating, created, updating, updated, saving, saved, deleting, deleted, restoring, restored娶靡。
creating 是在數(shù)據(jù)創(chuàng)建之前觸發(fā),created 是數(shù)據(jù)創(chuàng)建之后觸發(fā)
updating 是在數(shù)據(jù)更新之前觸發(fā)看锉,updated 是在數(shù)據(jù)更新之后觸發(fā)
deleting 是在刪除數(shù)據(jù)之前觸發(fā)姿锭,deleted是在刪除數(shù)據(jù)之后觸發(fā)
saving 是在保存數(shù)據(jù)之前觸發(fā) ,saved 是在數(shù)據(jù)創(chuàng)建之后觸發(fā)
需要注意的是 當模型不存在伯铣,需要新增的時候呻此,依次觸發(fā)的順序則是
saving -> creating -> created -> saved
當模型已存在,不是新建的時候腔寡,依次觸發(fā)的順序是:
saving -> updating -> updated -> saved
saving 和 saved 則會在 Eloquent 實例的 original 數(shù)組真值更改前后觸發(fā)
2.去百度翻譯 API:注冊個百度翻譯 獲取api 的key
接口作用:用于把我們標題或關(guān)鍵字翻譯成英文焚鲜。
這里邏輯是:調(diào)用接口翻譯成英文,要是調(diào)用或翻譯失敗我們就將標題翻譯成拼音放前,然后生成slug字段內(nèi)容忿磅。
所以這里需要兩個擴展包:
3.安裝Guzzle擴展包:發(fā)送 http 請求的(我這里直接下載最新的,沒指定版本) ,這里用于對接百度翻譯 API接口
composer require "guzzlehttp/guzzle"
4.安裝依賴 PinYin
$ composer require "overtrue/pinyin"
5.修改配置
config/services.php
'baidu_translate' => [
'appid' => env('BAIDU_TRANSLATE_APPID'),
'key' => env('BAIDU_TRANSLATE_KEY'),
],
.env
BAIDU_TRANSLATE_APPID=201703xxxxxxxxxxxxx
BAIDU_TRANSLATE_KEY=q0s6axxxxxxxxxxxxxxxxx
6.封裝一個翻譯類
app/Handlers/SlugTranslateHandler
<?php
namespace App\Handlers;
use GuzzleHttp\Client;
use Overtrue\Pinyin\Pinyin;
use Illuminate\Support\Str;
class SlugTranslateHandler
{
public function translate($text)
{
//實例化 HTTP客戶端
$http = new Client;
//初始化配置信息
$api = 'https://fanyi-api.baidu.com/api/trans/vip/translate';
$appid = config('services.baidu_translate.appid');
$key = config('services.baidu_translate.key');
$salt = time();
// 如果沒有配置百度翻譯凭语,自動使用兼容的拼音方案
if (empty($appid) || empty($key)) {
return $this->pinyin($text);
}
// 根據(jù)文檔葱她,生成 sign
// http://api.fanyi.baidu.com/api/trans/product/apidoc
// appid+q+salt+密鑰 的MD5值
$sign = md5($appid. $text . $salt . $key);
//請求參數(shù)
$query = http_build_query([
"q" => $text,
"from" => "zh",
"to" => "en",
"appid" => $appid,
"salt" => $salt,
"sign" => $sign,
]);
//發(fā)送 HTTP Get 請求
$response = $http->get($api.$query);
$result = json_decode($response->getBody(), true);
// 獲取結(jié)果,如果請求成功似扔,dd($result) 結(jié)果如下:
// array:3 [▼
// "from" => "zh"
// "to" => "en"
// "trans_result" => array:1 [▼
// 0 => array:2 [▼
// "src" => "XSS 安全漏洞"
// "dst" => "XSS security vulnerability"
// ]
// ]
// ]
//獲取翻譯結(jié)果
if (isset($result['trans_result'][0]['dst'])) {
return Str::slug($result['trans_result'][0]['dst']);
} else {
// 如果百度翻譯沒有結(jié)果吨些,使用拼音作為后備計劃。
return $this->pinyin($text);
}
}
public function pinyin($text)
{
return Str::slug(app(Pinyin::class)->permalink($text));
}
}
7.用Redis隊列實現(xiàn)異步處理任務(wù) (這樣就不影響用戶創(chuàng)建話題帖子了3婕浮)
7.1.Composer 安裝Redis依賴:
composer require "predis/predis"
修改環(huán)境變量QUEUE_DRIVER 的值為 redis:
.env
# SESSION_DRIVER=file
SESSION_DRIVER=redis
7.2.處理隊列中任務(wù)失敗的情況
使用 queue:failed-table 命令來創(chuàng)建 failed_jobs 表的遷移文件:
$ php artisan queue:failed-table
會新建 database/migrations/{timestamp}_create_failed_jobs_table.php 文件
最新版本laravel10默認已有這個文件了锤灿,使用 以下 命令生成 failed_jobs 表就好了:
$ php artisan migrate
3.生成任務(wù)類
使用以下 Artisan 命令來生成一個新的隊列任務(wù):
$ php artisan make:job TranslateSlug
該命令會在 app/Jobs 目錄下生成一個新的類:
app/Jobs/TranslateSlug.php
編輯任務(wù)內(nèi)容(調(diào)用翻譯接口并異步更新slug字段):
<?php
namespace App\Jobs;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldBeUnique;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Queue\SerializesModels;
use App\Models\Topic;
use App\Handlers\SlugTranslateHandler;
use Illuminate\Support\Facades\DB;
class TranslateSlug implements ShouldQueue
{
use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
protected $topic;
/**
* Create a new job instance.
*/
public function __construct(Topic $topic)
{
// 隊列任務(wù)構(gòu)造器中接收了 Eloquent 模型,將會只序列化模型的 ID
$this->topic = $topic;
}
/**
* Execute the job.
*/
public function handle(): void
{
$slug = app(SlugTranslateHandler::class)->translate($this->topic->title);
DB::table('topics')->where('id', $this->topic->id)->update(['slug' => $slug]);
}
}
8.在我們創(chuàng)建的觀察類(即Topic 模型監(jiān)控器)app/Observers/TopicObserver.php
中用 隊列執(zhí)行的方式 調(diào)用 Slug 翻譯
namespace App\Observers;
use App\Jobs\TranslateSlug;
...
/**
* 保存進數(shù)據(jù)庫以后(因為創(chuàng)建帖子的時候辆脸,要創(chuàng)建完成后才有id)
*/
public function saved(Topic $topic)
{
//使用隊列 實現(xiàn)異步修改slug 從而不影響用戶創(chuàng)建話題
if (!$topic->slug) {
// 推送任務(wù)到隊列
dispatch(new TranslateSlug($topic));
}
}
9.修改一下路由
Route::get('topics/{topic}/{slug?}','TopicsController@show')->name('topics.show')
在模型 Topic 模型中創(chuàng)建link() 方法
<?php
namespace App\Models;
class Topic extends Model{
.
.
.
public function link($params = [])
{
return route('topics.show', array_merge([$this->id, $this->slug], $params));
}}
參數(shù) $params 允許附加 URL 參數(shù)的設(shè)
強制跳轉(zhuǎn)
當文章有 Slug 的時候但校,我們希望用戶一直使用正確的、帶著 Slug 的鏈接來訪問啡氢。我們可以在控制器中對 Slug 進行判斷状囱,當條件允許的時候术裸,我們將發(fā)送 301 永久重定向指令給瀏覽器,跳轉(zhuǎn)到帶 Slug 的鏈接:
app/Http/Controllers/TopicsController.php
后面的slug 我們可以看到雖然是生成了slug 但是用戶在瀏覽器中輸入的如果不是我們生成的slug會導致輸入任意slug都可以訪問到我們的文章
這是我們不愿意看到的亭枷,我們要確保已經(jīng)生成的slug url 必須是和url中的是一致匹配的袭艺,如果用戶惡意輸入錯誤的slug 我們將修正這個url的slug
我們在app/Http/Controllers/TopicsController.php 文件中 路由定義的show() 方法 添加如下限制
public function show(Request $request, Topic $topic)
{
// 防止用戶惡意輸入
if ( ! empty($topic->slug) && $topic->slug != $request->slug) {
return redirect($topic->link(), 301);
}
return view('topics.show', compact('topic'));
}
ok了