萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 字符串轉 URL 友好格式:Slug 生成、中文轉拼音、特殊字符處理

生成 SEO 友好的 URL(如 /article/php-url-slug-generator)需要將標題轉換為僅包含字母、數字、連字符的「Slug」。本文提供三種方案:純 ASCII 過濾、中文轉拼音、通用透literation,並對比 PHP 內置 urlencode 的差異。

方案對比

方案輸出示例適用場景依賴
ASCII 過濾hello-world-123純英文/數字標題,簡單項目無
中文轉拼音php-zhuan-pin-yin中文站點,SEO 需可讀composer 包
通用透literationphp-zhuan-pin-yin / cafe多語言、特殊字符( café → cafe )intl 擴展 / 库
urlencode%E4%B8%AD%E6%96%87參數值傳遞,非 URL 路徑內置

1. 純 ASCII 過濾(零依賴)

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 字符)

2. 中文轉拼音(推薦:overtrue/pinyin)

// 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

3. 通用透literation(推薦:behat/transliterator 或 intl)

處理德語 ß→ss、法語 é→e、中文轉拼音(需 ICU 數據)。

方案 A:behat/transliterator (純 PHP,無擴展依賴)

// 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);
}

方案 B:PHP intl 擴展 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

4. URL 路徑 vs 參數值:別混淆

// 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]);

進階:Slug 唯一性處理(資料庫層面)

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

總結建議

  1. 中文站點: 用 overtrue/pinyin 生成拼音 Slug,可讀性最好,SEO 最優。
  2. 多語言站點: 用 intl Transliterator 或 behat/transliterator 統一處理。
  3. 純英文/簡單項目: 純 ASCII 過濾函數足夠,零依賴。
  4. 永遠不要用 urlencode 生成 URL 路徑,那是給參數值用的。
  5. 數據庫唯一索引 + 衝突時追加數字 保證 Slug 唯一。

將 Slug 生成封裝為 Service 類,在 Model 保存前自動調用(如 Laravel boot()、ThinkPHP _before_write),實現「標題改、Slug 自動更新」的優雅體驗。

copyright © 萬盛學電腦網 all rights reserved