Bagaimanakah anda mentakrifkan function dengan jenis dan nilai lalai?

Question

Accepted Answer

Function PHP ditakrifkan dengan kata kunci `function`. PHP moden menyokong **pengisytiharan jenis (type declarations)** pada parameter dan nilai pulangan, **nilai lalai (default values)**, dan parameter variadic — menjadikan function lebih teguh dan mendokumentasikan dirinya sendiri.

## Function asas dengan type declarations

```php
<?php
// modern PHP — typed parameters and a typed return
function add(int $a, int $b): int {
    return $a + $b;
}

function greet(string $name, string $greeting = "Hello"): string {  // default value
    return "$greeting, $name";
}

greet("Ann");              // "Hello, Ann"
greet("Ann", "Hi");        // "Hi, Ann"
```

Type declarations (`int $a`, jenis pulangan `: int`) membuatkan PHP menyemak jenis argumen dan pulangan — menangkap pepijat dan mendokumentasikan tujuan. Nilai lalai menjadikan parameter pilihan.

## Jenis nullable dan jenis union (PHP 8+)

```php
function find(?int $id): ?User {        // ? = nullable (int|null, User|null)
    return $id ? lookup($id) : null;
}

function process(int|string $input): void {   // union type — int OR string (PHP 8)
    // ...
}
```

`?Type` membenarkan null; **union types** (`int|string`, PHP 8) membenarkan beberapa jenis — menjadikan tandatangan tepat.

## Argumen variadic dan bernama

```php
function sum(int ...$numbers): int {     // variadic — any number of int args
    return array_sum($numbers);
}
sum(1, 2, 3);            // 6

// named arguments (PHP 8) — pass by parameter name, skip optional ones
greet(name: "Ann", greeting: "Hey");
```

## Strict types (disyorkan)

```php
<?php
declare(strict_types=1);    // at the top of the file — enforce STRICT type checking

add("5", 3);   // ❌ TypeError with strict_types (without it, "5" would coerce to 5)
```

`declare(strict_types=1)` menjadikan type declarations ketat — PHP menolak jenis yang tidak sepadan dan bukannya mengubah suainya secara senyap, yang merupakan amalan moden yang disyorkan untuk menangkap pepijat.

## Mengapa ia penting

Memahami takrifan function PHP moden — terutamanya **type declarations** — adalah penting untuk menulis kod yang teguh dan boleh diselenggara, dan mencerminkan sejauh mana PHP telah berkembang daripada asal-usulnya yang loosely-typed.

Parameter dan nilai pulangan bertaip (serta jenis nullable dan union) menjadikan function mendokumentasikan dirinya sendiri dan membolehkan PHP menangkap ralat jenis, manakala argumen lalai dan bernama serta variadic menyediakan tandatangan yang fleksibel dan mudah dibaca.

Amalan moden yang paling penting ialah **`declare(strict_types=1)`**, yang menguatkuasakan pemeriksaan jenis yang ketat (menolak ketidaksepadanan dan bukannya mengubah suainya secara senyap) — alat utama untuk menangkap pepijat awal dan menulis kod yang boleh dipercayai.

Mengetahui cara untuk mentakrifkan function yang bertaip dengan baik beserta nilai lalai, dan menggunakan strict types, ialah pengetahuan harian untuk pembangunan PHP moden yang profesional, membezakan kod yang kukuh dan type-safe daripada gaya loosely-typed PHP lama.