萬盛學電腦網

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

PHP 函數預設參數值:語法、型別、陷阱與最佳實踐

語法基本

<?php
/**
 * 輸出帶顏色的文字
 * @param string $text  文字內容
 * @param string $color CSS 顏色值,預設 'black'
 */
function printColored(string $text, string $color = 'black'): void {
    echo "<span style='color:{$color}'>{$text}</span>";
}

// 呼叫方式
printColored('這是黑色字');           // 使用預設黑色
printColored('這是藍色字', 'blue');   // 覆蓋為藍色
printColored('這是紅色字', '#ff0000'); // 十六進位色碼

核心規則

  1. 預設值必須是常數運算式:不能是變數、函數呼叫、新物件 (PHP 8.1+ 允許 new Class() 作為預設值)。
  2. 預設參數必須在非預設參數之後:function foo($a, $b = 1) ✓;function foo($a = 1, $b) ✗ (Fatal Error)。
  3. 預設值在每次呼叫時評估** (PHP 8.1+ 新物件例外):
function bad($arr = []) { ... } // 陣列字面值 OK
function bad($time = time()) { ... } // Fatal Error: 預設值不可為函數呼叫

// PHP 8.1+ 新特性:new Class() 作為預設值
function greet(Greeter $g = new DefaultGreeter()) { ... }

型別宣告與預設值結合 (PHP 7.0+)

function query(
    string $sql,
    array  $params = [],
    int    $fetchMode = PDO::FETCH_ASSOC,
    ?float $timeout = null
): array { ... }

常見陷阱:可變預設值陷阱

<?php
// ❌ 錯誤:預設陣列被所有呼叫共享 (PHP 不會像 Python 這樣,但物件會)
function addItem(string $item, array $list = []): array {
    $list[] = $item;
    return $list;
}
var_dump(addItem('a')); // ['a']
var_dump(addItem('b')); // ['b'] (PHP 重新建立陣列,安全)

// ⚠️ 但物件預設值會共享實例 (PHP 8.1+ new Class() 除外)
class Logger { public $logs = []; }
function logMsg(string $msg, Logger $logger = new Logger()): void { // PHP < 8.1 錯誤;8.1+ 每次新建
    $logger->logs[] = $msg;
}

進階模式:Named Arguments (PHP 8.0+) 替代部分預設參數

function createUser(
    string $email,
    string $password,
    string $role = 'user',
    bool   $active = true,
    array  $meta = []
): User { ... }

// 僅指定需要覆蓋的參數,順序不拘
$user = createUser(
    email: 'a@b.com',
    password: 'secret',
    active: false, // 略過 $role,直接指定 $active
);

結語

預設參數讓 API 更彈性、呼叫端更簡潔。掌握「常數運算式限制、順序規則、可變物件共享風險、PHP 8.1+ new Class() 新語法、PHP 8.0+ Named Arguments」五大要點,能設計出既簡潔又安全的函數簽名。

copyright © 萬盛學電腦網 all rights reserved