萬盛學電腦網

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

PHP 函數完整教學:定義、參數、回傳值、變數範圍與最佳實務

函數是程式碼重用的基本單位。PHP 內建 700+ 函數,也支援使用者自訂函數。本文完整涵蓋函數定義、參數傳遞、回傳值、變數範圍、型別宣告、可變參數、匿名函數等核心概念。

函數定義與呼叫

<?php
// 定義函數
function writeMyName() {
    echo "Kai Jim Refsnes";
}

// 呼叫函數
writeMyName(); // 輸出:Kai Jim Refsnes

// 在程式流程中穿插呼叫
echo "Hello world!<br>";
echo "My name is ";
writeMyName();
echo ".<br>That's right, ";
writeMyName();
echo " is my name.";
?>

函數參數

位置參數

<?php
function writeMyName(string $fname): void {
    echo "$fname Refsnes<br>";
}

writeMyName("Kai Jim"); // Kai Jim Refsnes
writeMyName("Hege");    // Hege Refsnes
writeMyName("Stale");   // Stale Refsnes
?>

多參數

<?php
function writeMyName(string $fname, string $punctuation): void {
    echo "$fname Refsnes$punctuation<br>";
}

writeMyName("Kai Jim", ".");
writeMyName("Hege", "!");
writeMyName("Ståle", "...");
?>

預設參數值(選用參數)

<?php
function greet(string $name, string $greeting = "Hello"): void {
    echo "$greeting, $name!<br>";
}

greet("John");           // Hello, John!
greet("John", "Hi");     // Hi, John!
greet("Mary", "早安");    // 早安, Mary!

// 注意:有預設值的參數必須在無預設值參數之後
// function foo($a = 1, $b) {} // 錯誤
?>

型別宣告與回傳型別(PHP 7+)

<?php
// 純量型別:int, float, string, bool
// 類別/介面型別
// 回傳型別宣告在參數列後:: type

function add(int $x, int $y): int {
    return $x + $y;
}

function getUser(int $id): ?User { // 可回傳 null
    // ...
    return null;
}

// 嚴格模式(檔案最頂端宣告)
declare(strict_types=1);
?>

回傳值

<?php
function add(int $x, int $y): int {
    $total = $x + $y;
    return $total; // 結束函數並回傳值
}

echo "1 + 16 = " . add(1, 16); // 1 + 16 = 17

// 多重回傳(透過陣列或物件)
function divmod(int $a, int $b): array {
    return [$a / $b, $a % $b];
}

[$quotient, $remainder] = divmod(10, 3); // 解構賦值 PHP 7.1+
echo "商:$quotient 餘數:$remainder";
?>

變數範圍

static 靜態區域變數範例

<?php
function counter(): int {
    static $count = 0;
    return ++$count;
}

echo counter(); // 1
echo counter(); // 2
echo counter(); // 3
// $count 值在函數呼叫間保持
?>

進階功能特性

可變參數函數

<?php
// ... 運算子收集剩餘參數為陣列
function sum(int ...$numbers): int {
    return array_sum($numbers);
}

echo sum(1, 2, 3);       // 6
echo sum(1, 2, 3, 4, 5); // 15
echo sum(...[1, 2, 3]);  // 解包陣列傳入
?>

參考傳遞

<?php
function addPrefix(string &$str, string $prefix): void {
    $str = $prefix . $str;
}

$name = "John";
addPrefix($name, "Mr. ");
echo $name; // Mr. John
?>

匿名函數 / 閉包

<?php
// 指派給變數
$greet = function(string $name): string {
    return "Hello, $name";
};

echo $greet("World"); // Hello, World

// 閉包:繼承外部作用域變數
$multiplier = 3;
$multiply = function(int $n) use ($multiplier): int {
    return $n * $multiplier;
};

echo $multiply(5); // 15

// 箭頭函數 PHP 7.4+(隱式繼承外部變數)
$multiply = fn(int $n) => $n * $multiplier;
?>

呼叫函數的函數

<?php
function apply(callable $func, mixed $value): mixed {
    return $func($value);
}

echo apply('strtoupper', 'hello'); // HELLO
echo apply(fn($x) => $x * 2, 5);   // 10
?>

最佳實務總結

  1. 單一職責:一個函數只做一件事
  2. 命名語意化:動詞開頭 calculateTotal()、validateEmail()
  3. 加上型別宣告:參數與回傳值皆標註型別
  4. 避免全域變數:透過參數傳遞依賴
  5. 早期返回:減少巢狀層級
  6. 文件化:撰寫 DocBlock 註解
✅ 現代 PHP 函數簽名範本:
function verbNoun(Type1 $param1, Type2 $param2 = default): ReturnType {
    // 實作
    return $result;
}
copyright © 萬盛學電腦網 all rights reserved
範圍類型說明範例
區域變數函數內部宣告,僅函數內可見function foo() { $x = 1; }
全域變數函數外部宣告,需 global 關鍵字在函數內存取$x = 1; function foo() { global $x; }
靜態變數函數內宣告 static,保持值跨呼叫function foo() { static $c = 0; return ++$c; }
超全域變數PHP 內建,任何地方可見$GLOBALS, $_GET, $_POST, $_SESSION...