Cad é an difríochtaí idir include agus require?

Question

Accepted Answer

Iompórtálann `include` agus `require` araile (agus fhorghníomhaíonn siad) inneachar chomhad PHP eile isteach san ceann reatha. Is é an **t-aon dhifríocht an dóigh a láimhseálann siad teipeanna**: déanann `require` earráid dhúnmharú má tá an comhad ar iarraidh, agus ní dhéanann `include` ach rabhadh a asthaiscint agus leanúint ar aghaidh.

## An príomhdhifríocht: iompar teipe

```php
<?php
include "config.php";    // if missing → WARNING, script CONTINUES
require "database.php";  // if missing → FATAL ERROR, script STOPS
```

```text
include → file missing → emits a Warning, execution continues (file's code skipped)
require → file missing → throws a Fatal Error, execution HALTS
```

Baineann **`require`** a úsáid le comhaid nach féidir leis an fheidhmchlár a rith gan iad (príomhranganna, cumraitheoireacht ríthábhachtach, socrúchán bunachar sonraí) — ba bhreá leat go stopfadh sé go crua mura bhfuil siad ann. Baineann **`include`** a úsáid le comhaid bhreise (m.sh. teimpléad tabhla taoibh) áit nach gceart do chomhad ar iarraidh an leathanach a thuairteanna.

## Na leaganacha _once (cosc ar dhúbailte-thairisceana)

```php
require_once "functions.php";   // include the file ONLY if not already included
include_once "helper.php";
```

Iompórtálann `require_once`/`include_once` an comhad ach amháin mura bhfuil sé curtha isteach cheana féin — **riachtanach** chun earráidí "cannot redeclare function/class" a sheachaint nuair is féidir go gcuirfear comhad isteach cúpla uair (m.sh. sainmhíniú ranga a tharraingítear isteach ag roinnt comhad).

## Cad a dhéanann tairisceana i ndáiríre

```php
// included files share the SAME scope and can define functions, classes, variables
// config.php:
$dbHost = "localhost";
// main.php:
require "config.php";
echo $dbHost;   // "localhost" — the variable is available
```

## PHP Nua: an fhéinobáil a chuireann ionad ar na tairisceana láimhe

```php
// ❌ old style — manually requiring every class file
require_once "User.php";
require_once "Order.php";

// ✅ modern — Composer AUTOLOADING loads classes on demand automatically
require "vendor/autoload.php";   // one line; classes load when used (PSR-4)
$user = new User();               // User.php loaded automatically
```

I PHP nua-aimseartha, is annamh a bhainimid úsáid as `require` láimhe do ranganna — cuireann **fé-úsáideoir Composer** iad ar fáil ar éileamh. Úsáideann tú i gcónaí `require "vendor/autoload.php"` fadó chun an fé-úsáideoir a thosú.

## Cén fáth a bhíonn tábhacht ann

Tá sé ríthábhachtach a thuiscint `include` i gcoinne `require` — tá sé sin ar eolas bhunúsach PHP - is é an dóigh ina dhéanann comhaid PHP cód a roinnt ar a chéile, agus tá tábhacht ag an bhforoinn maidir le cóireachta.

Is é an phríomhphointe iompar teipe an dá shonrasc: **`require` do chomhaid riachtanacha** (ionas go dteipfidh ar an fheidhmchlár go tapa agus go soiléir mura bhfuil comhad ríthábhachtach ann) agus **`include` do chomhaid roghnach** (ionas nach tuairteanna comhad neamhríthábhachtach ar iarraidh an leathanach).

Is praicticiúil a bheith ar eolas agat ar na leaganacha **`_once`** chun na hearráidí coitianta "cannot redeclare" a sheachaint ó sainmhíniú ranga nó feidhme a chur isteach dhá uair le titim.

Is é an chomhchéim an tuiscint ar an chomhthéacs nua-aimseartha: cé go bhfuil na tógálacha sin bunúsach, **braitheann PHP nua-aimseartha ar fhé-úsáidí Composer** (ranganna á n-ualadh ar éileamh) seachas gach comhad a cheangal láimhe, agus mar sin i gcód reatha ní dhéanann tú ach `require "vendor/autoload.php"` fadó agus lig do fhé-úsáidí an chuid eile a dhéileáil.

Tá an tuiscint ar dhá chuid de thechnioc na tairisceana (agus cathain atá feidhm i ngach modh teipe) agus conas a bhíonn fé-úsáidí nua-aimseartha ag ionadú do thairisceana láimhe ar eolas gach lá maidir le hoibriú le bunachair chóid PHP sean agus nua.