Conas a shainmhíníonn tú feidhmeanna le cineálacha agus réamhshocrú?

Question

Accepted Answer

Sainmhínítear feidhmeanna PHP leis an eochairfhocal `function`. Tacaíonn PHP nua-aimseartha do **fhógra cineálacha** ar pharaiméadair agus ar luachanna filleadh, **luachanna réamhshocraithe**, agus paraiméadair variadach — ag déanamh feidhmeanna níos láidre agus fé féin-dhocúmaint.

## Feidhmeanna bunúsacha le fógra cineálacha

```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"
```

Ligean do-fhógra cineálacha (`int $a`, cineál filleadh `: int`) do PHP scrúdú a dhéanamh ar chineálacha argóinte agus filleadh — gabháil bhuganna agus an rún a dhocúmentiú. Bíonn paraiméadair roghnach de bharr luachanna réamhshocraithe.

## Cineálacha nullábla agus cineálacha aontais (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` a cheadú null; **cineálacha aontais** (`int|string`, PHP 8) a cheadú roinnt cineálacha — ag déanamh sínithe beacht.

## Argóintí variadach agus ainmnithe

```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");
```

## Cineálacha docht (molaithe)

```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)` a dhéanamh d-fhógra cineálacha docht — cuireann PHP diúltú ar chineálacha neamhionathar in ionad iad a thiontú go ciúin, ar an cleachtas nua-aimseartha molaithe do bhuganna a bhreith.

## Cén fáth a bhfuil sé tábhachtach

Tá sé tábhachtach tuiscint ar shainmhínithe feidhmeanna PHP nua-aimseartha — go háirithe **fógra cineálacha** — chun cód láidir, inchothromaíochta a scríobh, agus léiríonn sé cé chomh fada atá PHP fásta ó a bhunús lom-leor-théamhaithe.

Bíonn paraiméadair agus luachanna filleadh clóite (agus cineálacha nullábla agus aontais) ina n-feidhmeanna féin-dhocúmaint agus tugann siad deis do PHP earráidí cineálacha a bhreith, agus bíonn argóintí réamhshocraithe agus ainmnithe agus variadach a soláthair sínithe foluain, inléite.

Is é an cleachtas nua-aimseartha is tábhachtaí **`declare(strict_types=1)`**, a dhéanann seiceáil cineálacha docht a fhorgheal (diúltú do neamhionathar seachas iad a thiontú go ciúin) — uirlis ríthábhachtach buganna a bhreith go tobann agus cód iontaofa a scríobh.

Bheith ar eolas conas feidhmeanna breá-clóite le réamhsocrú a shainmhíniú, agus cineálacha docht a úsáid, is eolas laethúil atá ann do fhorbhirt PHP nua-aimseartha ghairmiúil, ag scaradh cód soladach, sábhálte-cineálacha ó an stíl lom-leor-théamhaithe de PHP níos sine.