PHP 自動補全網址協定與轉換為可點擊連結

處理使用者輸入的網址時，常需自動補上 https:// 或 https://，並將純文字網址/Email 轉為可點擊超連結。本文提供兩個實用函式，並說明正則表達式邏輯與邊界情況處理。

一、自動補全協定前綴

<?php
/**
 * 確保網址包含 scheme (http/https/ftp)，否則預設補上 https://
 *
 * @param string $url 使用者輸入的網址
 * @return string 補全 scheme 後的網址
 */
function ensureScheme(string $url): string {
    $url = trim($url);
    if ($url === '') {
        return '';
    }
    // 已有 scheme 直接回傳
    if (preg_match('~^https?://|^ftp://~i', $url)) {
        return $url;
    }
    // 無 scheme，預設 https
    return 'https://' . $url;
}

// 測試
var_dump(ensureScheme('example.com'));        // https://example.com
var_dump(ensureScheme('https://example.com')); // https://example.com
var_dump(ensureScheme('ftp://files.com'));    // ftp://files.com

二、將文字中的網址與 Email 轉為超連結

<?php
/**
 * 將字串中的 URL、Email 轉為 <a> 標籤
 *
 * @param string $text 原始文字
 * @param array  $options 選項 ['target' => '_blank', 'rel' => 'noopener noreferrer', 'class' => 'auto-link']
 * @return string 轉換後的 HTML
 */
function autoLink(string $text, array $options = []): string {
    $defaultOptions = [
        'target' => '_blank',
        'rel'    => 'noopener noreferrer',
        'class'  => 'auto-link',
    ];
    $opts = array_merge($defaultOptions, $options);
    $attr = sprintf('target="%s" rel="%s" class="%s"',
        htmlspecialchars($opts['target']),
        htmlspecialchars($opts['rel']),
        htmlspecialchars($opts['class'])
    );

    // 1. 處理已有 scheme 的 URL (http/https/ftp)
    //    避免重複處理已經是連結的情況 (簡易判斷：前後無 

require_once 'HTMLPurifier.auto.php';
$config = HTMLPurifier_Config::createDefault();
$purifier = new HTMLPurifier($config);
$cleanHtml = $purifier->purify($userInput);
$finalHtml = autoLink($cleanHtml);

<?php
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $rawUrl = $_POST['url'] ?? '';
    $url = ensureScheme($rawUrl);

    $comment = $_POST['comment'] ?? '';
    $commentHtml = autoLink($comment);

    // 儲存 $url, $commentHtml 到資料庫...
    // 顯示時直接輸出 $commentHtml (已含連結)
}