萬盛學電腦網

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

PHP 自訂函數實作 99 乘法表:參數驗證、正序倒序切換與程式碼重構

函數基礎語法回顧

<?php
function functionName($param1, $param2 = 'default') {
    // 函數主體
    return $result;
}

// 呼叫
$result = functionName('arg1');
?>
  • 關鍵字 function 宣告。
  • 參數可設預設值。
  • return 回傳值並結束函數。

需求分析:可配置的 99 乘法表函數

  • 參數 $start:起始數 (1-9)
  • 參數 $end:結束數 (1-9, 必須 ≥ start)
  • 參數 $asc:排序方向 (true=正序, false=倒序)
  • 完整參數驗證與錯誤訊息回傳。

完整實作程式碼

<?php
/**
 * 產生乘法表 HTML 字串
 *
 * @param int $start 起始數 (1-9)
 * @param int $end 結束數 (1-9)
 * @param bool $asc true=正序(遞增), false=倒序(遞減)
 * @return string HTML 字串或錯誤訊息
 */
function multiplicationTable($start = 1, $end = 9, $asc = true)
{
    // 1. 參數驗證
    if ($start < 1 || $start > 9) return '錯誤:起始數必須在 1-9 之間';
    if ($end < 1 || $end > 9) return '錯誤:結束數必須在 1-9 之間';
    if (!is_int($start)) return '錯誤:起始數必須為整數';
    if (!is_int($end)) return '錯誤:結束數必須為整數';
    if ($start > $end) return '錯誤:起始數不得大於結束數';

    $html = '';

    // 2. 產生迴圈範圍
    if ($asc) {
        $range = range($start, $end); // [1,2,3...]
    } else {
        $range = range($end, $start); // [9,8,7...]
    }

    // 3. 雙層迴圈產生內容
    foreach ($range as $i) {
        $html .= "<br>";
        foreach ($range as $n) {
            if ($i >= $n) {
                $html .= "$i×$n=" . ($i * $n) . "  ";
            }
        }
    }

    return $html;
}

// 使用範例
echo "<hr>";
echo multiplicationTable(1, 9, true);  // 正序 1-9
echo "<hr>";
echo multiplicationTable(2, 5, false); // 倒序 5-2
?>

程式碼優化重點

  1. 參數型別檢查:使用 is_int() 而非 $start != (int)$start,語意更清晰。
  2. 使用 range() 產生序列:取代手寫 for 迴圈初始化,程式碼更宣告式。
  3. 單一職責:函數只負責「產生字串」,不直接 echo,提高複用性 (可存檔、API 回傳、模板填充)。
  4. 錯誤處理:回傳錯誤字串而非 die/exit,讓呼叫端決定如何處理。
  5. 文件區塊註解:標準 PHPDoc 格式,支援 IDE 提示與自動產生文件。

進階延伸:支援自訂格式化

function multiplicationTableAdvanced($start=1, $end=9, $asc=true, $formatter=null)
{
    // ... 驗證邏輯同前 ...

    $range = $asc ? range($start, $end) : range($end, $start);
    $html = '';

    foreach ($range as $i) {
        $html .= "<br>";
        foreach ($range as $n) {
            if ($i >= $n) {
                $expr = "$i×$n";
                $result = $i * $n;
                // 使用者自訂格式化函數
                $html .= $formatter ? $formatter($expr, $result, $i, $n) : "$expr=$result  ";
            }
        }
    }
    return $html;
}

// 使用:自訂輸出為表格 td
echo multiplicationTableAdvanced(1, 5, true, function($expr, $result, $i, $n) {
    return "<td>$expr=$result</td>";
});

結語

將 99 乘法表封裝為函數,不僅展示參數驗證、迴圈控制、字串組裝等基本功,更體現「單一職責」、「參數化配置」、「開放擴充」等軟體工程原則。這是從「寫出能跑的代碼」邁向「寫出可維護代碼」的關鍵一步。

copyright © 萬盛學電腦網 all rights reserved