生成 SEO 友好的 URL(如 /article/php-url-slug-generator)需要將標題轉換為僅包含字母、數字、連字符的「Slug」。本文提供三種方案:純 ASCII 過濾、中文轉拼音、通用透literation,並對比 PHP 內置 urlencode 的差異。
| 方案 | 輸出示例 | 適用場景 | 依賴 |
|---|---|---|---|
| ASCII 過濾 | hello-world-123 | 純英文/數字標題,簡單項目 | 無 |
| 中文轉拼音 | php-zhuan-pin-yin | 中文站點,SEO 需可讀 | composer 包 |
| 通用透literation | php-zhuan-pin-yin / cafe | 多語言、特殊字符( café → cafe ) | intl 擴展 / 库 |
| urlencode | %E4%B8%AD%E6%96%87 | 參數值傳遞,非 URL 路徑 | 內置 |
function toAsciiSlug(string $str, string $separator = '-'): string
{
// 1. 轉小寫
$str = mb_strtolower($str, 'UTF-8');
// 2. 非字母數字替換為分隔符
$str = preg_replace('/[^a-z0-9]+/u', $separator, $str);
// 3. 去除首尾分隔符
$str = trim($str, $separator);
// 4. 限制長度(可選)
return mb_substr($str, 0, 100, 'UTF-8');
}
// 測試
echo toAsciiSlug('Hello World! 123'); // hello-world-123
echo toAsciiSlug('PHP & MySQL Tutorial'); // php-mysql-tutorial
echo toAsciiSlug('中文標題'); // (空字符串,因無 ASCII 字符)
// composer require overtrue/pinyin
use Overtrue\Pinyin\Pinyin;
function toPinyinSlug(string $str, string $separator = '-'): string
{
$pinyin = new Pinyin();
// 獲取拼音陣列 [['zhong'], ['wen'], ['biao'], ['ti']]
$arr = $pinyin->permalink($str, $separator); // 直接生成 slug
return $arr;
}
// 測試
echo toPinyinSlug('PHP 中文標題轉拼音'); // php-zhong-wen-biao-ti-zhuan-pin-yin
echo toPinyinSlug('Laravel 教程'); // laravel-jiao-cheng
處理德語 ß→ss、法語 é→e、中文轉拼音(需 ICU 數據)。
// composer require behat/transliterator
use Behat\Transliterator\Transliterator;
function toTranslitSlug(string $str, string $separator = '-'): string
{
$transliterator = new Transliterator();
$str = $transliterator->transliterate($str); // 中文→拼音,特殊字符→ASCII
$str = mb_strtolower($str, 'UTF-8');
$str = preg_replace('/[^a-z0-9]+/u', $separator, $str);
return trim($str, $separator);
}
Transliterator (性能最好,需安裝擴展)function toIntlSlug(string $str, string $separator = '-'): string
{
// Any-Latin: 所有文字轉拉丁字母; Latin-ASCII: 拉丁字母轉 ASCII; Lower: 小寫
$transliterator = Transliterator::create('Any-Latin; Latin-ASCII; Lower');
$str = $transliterator->transliterate($str);
$str = preg_replace('/[^a-z0-9]+/u', $separator, $str);
return trim($str, $separator);
}
// 測試
echo toIntlSlug('Café & Crème'); // cafe-creme
echo toIntlSlug('中文測試'); // zhong-wen-ce-shi
echo toIntlSlug('Straße'); // strasse
// URL 路徑段:使用 Slug(可讀、SEO)
$url = "/article/" . toPinyinSlug($title); // /article/php-zhuan-pin-yin
// URL 參數值:使用 urlencode/rawurlencode
$param = "redirect=" . urlencode($targetUrl); // redirect=http%3A%2F%2F...
// 或構建整個查詢
$url = "/search?" . http_build_query(['q' => $keyword, 'tag' => $tag]);
function generateUniqueSlug(string $title, string $table, string $column = 'slug', $excludeId = null): string
{
$baseSlug = toPinyinSlug($title);
$slug = $baseSlug;
$counter = 1;
while (true) {
$query = DB::table($table)->where($column, $slug);
if ($excludeId) $query->where('id', '!=', $excludeId);
if (!$query->exists()) break;
$slug = $baseSlug . '-' . $counter++;
}
return $slug;
}
// 使用
$slug = generateUniqueSlug('PHP 教程', 'articles');
// 若 php-jiao-cheng 已存在 → php-jiao-cheng-1
overtrue/pinyin 生成拼音 Slug,可讀性最好,SEO 最優。intl Transliterator 或 behat/transliterator 統一處理。urlencode 生成 URL 路徑,那是給參數值用的。將 Slug 生成封裝為 Service 類,在 Model 保存前自動調用(如 Laravel boot()、ThinkPHP _before_write),實現「標題改、Slug 自動更新」的優雅體驗。