Hàm trong PHP: định nghĩa, return, tham số và kiểu dữ liệu

Một hàm (function) trong PHP được định nghĩa bằng từ khóa function, một cái tên, danh sách tham số và phần thân; return gửi một giá trị về cho nơi gọi. function add(int $a, int $b): int { return $a + $b; } định nghĩa hàm, còn add(2, 3) gọi hàm và trả về 5.

<?php
function greet(string $name): string
{
    return "Hello, $name";
}

function add(int $a, int $b): int
{
    return $a + $b;
}

echo greet('Ada'), "\n";
echo add(2, 3), "\n";
echo add(add(1, 2), 10), "\n";

string và int đặt trước các tham số là khai báo kiểu, còn : string sau dấu ngoặc tròn là kiểu trả về. Cả hai đều không bắt buộc, nhưng chúng giúp bắt lỗi sớm và cho biết hàm mong đợi điều gì.

Giá trị trả về và trả về nhiều giá trị

return kết thúc hàm ngay lập tức. Một hàm không có return, hoặc chỉ có return; trơn, sẽ trả về null; hãy khai báo : void khi hàm chỉ được gọi để thực hiện một tác dụng. Một hàm chỉ trả về một giá trị, nhưng giá trị đó có thể là một mảng, và bạn destructure nó ở phía gọi:

<?php
function grade(int $score): string
{
    if ($score >= 90) {
        return 'A';
    }
    return $score >= 75 ? 'B' : 'C';   // reached only below 90
}

function stats(array $numbers): array
{
    return [
        'min' => min($numbers),
        'max' => max($numbers),
        'avg' => array_sum($numbers) / count($numbers),
    ];
}

function logLine(string $msg): void
{
    echo "[log] $msg\n";
}

echo grade(95), grade(80), grade(40), "\n";

['min' => $min, 'max' => $max, 'avg' => $avg] = stats([4, 8, 15, 16, 23, 42]);
echo "min $min, max $max, average $avg\n";

[$quotient, $remainder] = [intdiv(17, 5), 17 % 5];
echo "17 / 5 = $quotient remainder $remainder\n";

var_dump(logLine('saved'));   // a void function returns null

Xem destructuring mảng để biết các dạng khác của [...] =.

Tham số mặc định và đối số có tên

Một tham số có = value là tham số tùy chọn: nơi gọi có thể bỏ qua nó. Tham số tùy chọn đặt sau các tham số bắt buộc. Từ PHP 8.0, đối số có tên cho phép nơi gọi truyền bất kỳ tham số nào theo tên, nhờ vậy bạn bỏ qua được những tham số tùy chọn không cần đến.

<?php
function makeTag(string $text, string $tag = 'p', ?string $class = null, bool $escape = true): string
{
    $body = $escape ? htmlspecialchars($text) : $text;
    $attr = $class !== null ? " class=\"$class\"" : '';
    return "<$tag$attr>$body</$tag>";
}

echo makeTag('Hello'), "\n";
echo makeTag('Title', 'h1'), "\n";

// Named arguments: skip $tag and $class, set only $escape
echo makeTag('<b>bold</b>', escape: false), "\n";
echo makeTag(class: 'note', text: 'Order does not matter'), "\n";

Đối số có tên cũng giúp lời gọi các hàm có sẵn dễ đọc hơn: str_pad('7', 3, '0', pad_type: STR_PAD_LEFT). Tên tham số trở thành một phần giao diện công khai của hàm, nên đổi tên tham số có thể làm hỏng những nơi gọi đang dùng tên.

Truyền tham chiếu

Thông thường PHP truyền một bản sao của mỗi đối số, nên hàm không thể thay đổi biến của nơi gọi. Dấu & trước tham số sẽ truyền chính biến đó. Các hàm có sẵn như sort() hoạt động theo cách này.

<?php
function addOne(int $n): void
{
    $n++;          // changes the copy only
}

function addOneRef(int &$n): void
{
    $n++;          // changes the caller's variable
}

$a = 5;
addOne($a);
echo $a, "\n";

addOneRef($a);
echo $a, "\n";

function addItem(array &$cart, string $item): void
{
    $cart[] = $item;
}

$cart = [];
addItem($cart, 'apple');
addItem($cart, 'pear');
print_r($cart);

Trả về một giá trị mới thường rõ ràng hơn là sửa đối số. Chỉ dùng tham chiếu khi hàm thật sự được thiết kế để sửa một thứ tại chỗ.

Khai báo kiểu và strict_types

Mặc định, PHP chuyển đối số sang kiểu đã khai báo khi có thể: add("5", 3) biến "5" thành 5. Đặt declare(strict_types=1); ở ngay đầu tệp sẽ tắt việc đó cho các lời gọi trong tệp này, nên sai kiểu sẽ ném ra TypeError thay vì được chuyển đổi.

<?php
declare(strict_types=1);
// This throws a TypeError on purpose: "5" is a string, not an int

function add(int $a, int $b): int
{
    return $a + $b;
}

echo add(2, 3), "\n";
echo add("5", 3), "\n";

Không có dòng declare, cùng lời gọi đó in ra 8. Các chuỗi không phải số, như "five", ném ra TypeError ở cả hai chế độ.

Các kiểu bạn có thể khai báo cho tham số và giá trị trả về:

<?php
// ?string: a string or null
function findUser(int $id): ?string
{
    $users = [1 => 'Ada', 2 => 'Linus'];
    return $users[$id] ?? null;
}

// int|float: a union type (PHP 8.0)
function half(int|float $n): float
{
    return $n / 2;
}

// mixed: anything at all
function describe(mixed $value): string
{
    return get_debug_type($value);
}

var_dump(findUser(1), findUser(9));
var_dump(half(5), half(2.5));
echo describe([1, 2]), ' ', describe(null), ' ', describe(1.5), "\n";

never là kiểu trả về cho những hàm luôn ném ngoại lệ hoặc thoát chương trình. Tên lớp và interface cũng dùng được làm kiểu.

Số lượng đối số thay đổi với ...$args

...$numbers gom bất kỳ số lượng đối số nào vào một mảng. Cũng dấu ... đó ở phía gọi sẽ trải một mảng ra thành các đối số riêng lẻ.

<?php
function sum(int ...$numbers): int
{
    return array_sum($numbers);
}

echo sum(), "\n";
echo sum(1, 2, 3), "\n";

$values = [10, 20, 30];
echo sum(...$values), "\n";          // spread an array

function logMessage(string $level, string ...$parts): string
{
    return strtoupper($level) . ': ' . implode(' ', $parts);
}

echo logMessage('info', 'user', 'Ada', 'logged in'), "\n";

Dùng biến bên ngoài trong một hàm

Một hàm có phạm vi riêng. Biến định nghĩa bên ngoài không nhìn thấy được ở bên trong, điều khiến những người quen JavaScript bất ngờ:

<?php
$taxRate = 0.2;

function priceWithTax(float $price): float
{
    return $price * (1 + $taxRate);   // $taxRate is undefined here
}

Warning: Undefined variable $taxRate in /path/to/index.php on line 6

và hàm trả về giá chưa cộng thuế. Thay vào đó, hãy truyền giá trị vào qua tham số. Cách này giúp hàm thể hiện rõ nó phụ thuộc vào gì và dễ kiểm thử:

<?php
$taxRate = 0.2;

function priceWithTax(float $price, float $taxRate): float
{
    return $price * (1 + $taxRate);
}

echo priceWithTax(100, $taxRate), "\n";
echo priceWithTax(100, 0.1), "\n";

Từ khóa global cũng dùng được, nhưng nó che giấu sự phụ thuộc; phạm vi biến có nói về nó. Với những hàm ngắn được truyền cho hàm khác, như callback của array_map(), xem hàm ẩn danh, loại hàm có thể giữ lại biến bên ngoài bằng use.