Cila është ndryshimi midis include dhe require?

Question

Accepted Answer

Të dyja `include` dhe `require` importojnë (dhe ekzekutojnë) përmbajtjen e një skedari tjetër PHP në atë aktual. **Ndryshimi i vetëm është se si ata trajtojnë dështimin**: `require` shkakton një gabim fatal nëse skedari mungon, ndërsa `include` vetëm lëshon një paralajmërim dhe vazhdon.

## Ndryshimi kryesor: sjellja e dështimit

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

Përdorni **`require`** për skedarë të cilët aplikacioni **nuk mund të funksionojë pa ta** (klasat bërthamë, konfigurimi kritik, opsioni i bazës së të dhënave) — dëshironi që ai të ndalojë nëse ato mungojnë. Përdorni **`include`** për skedarë opsionalë (p.sh. një shablon shiriti anësor) ku një skedar i mungueshëm nuk duhet të shembë faqen.

## Variantet _once (parandaloni përfshirjen e dyfishtë)

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

`require_once`/`include_once` importojnë skedarin vetëm nëse nuk ka qenë tashmë — **thelbësore** për të shmangur gabimet "nuk mund të rindeklarojë funksionin/klasën" kur një skedar mund të përfshihet shumë herë (p.sh. një përkufizim klase i tërhequr nga disa skedarë).

## Çfarë bën përfshirja në fakt

```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 modern: autoloading zëvendëson përfshirjet manuale

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

Në PHP modern, rrallë përdorni `require` manual për klasat — **autoloaderi i Composer** i ngarkon ato sipas kërkesës. Ju ende përdorni `require "vendor/autoload.php"` një herë për ta filluar atë.

## Përse kjo ka rëndësi

Kuptuesi i `include` vs `require` është njohuri bazike por e rëndësishme për PHP — ato janë mënyra se si skedarët PHP ndajnë kodin, dhe dallimi ka rëndësi për korrektësinë.

Pika kryesore është sjellja e dështimit: **`require` për skedarë thelbësorë** (në mënyrë që aplikacioni të dështojë shpejt dhe qartë nëse një skedar kritik mungon) dhe **`include` për opsionalët** (në mënyrë që një skedar jo-kritik i mungueshëm të mos shembë faqen).

Dini **variantet `_once`** është praktikisht thelbësor për të parandaluar gabimet e zakonshme "nuk mund të rindeklarojë" nga përfshirja aksidentale e një përkufizimi klase ose funksioni dy herë.

Ekuivalentisht e rëndësishme është kuptimi i kontekstit modern: ndërsa këto konstrukte janë themelore, **PHP moderne mbështetet në autoloading të Composer** (ngarkim klasash sipas kërkesës) në vend të kërkesës manuale të çdo skedari, kështu që në kodin aktual ju e bëni `require "vendor/autoload.php"` vetëm një herë dhe lejoni autoloading-un që të trajtojë pjesën tjetër.

Dija e mekanikës include/require (dhe kur secila modalitet dështimi është e përshtatshme) dhe se si autoloading modern zëvendëson përfshirjet manuale është njohuri përditësore për të punuar me bazat e kodit PHP të vjetra dhe të reja.