რა განსხვავებაა include და require შორის?

Question

Accepted Answer

ორივე `include` და `require` ხელმისაწვდომი და აконკრეტებს სხვა PHP ფайლის შინაარსს მიმდინარე ფაილში. **ერთადერთი განსხვავება ის არის, თუ როგორ ამუშავებენ უარეს შედეგს**: `require` ათავისუფლებს ფატალურ შეცდომას თუ ფაილი აკლია, მაშინ როდესაც `include` მხოლოდ გაფრთხილებას გამოუშვებს და გაგრძელდება.

## ძირითადი განსხვავება: უარეს შედეგის ქცევა

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

გამოიყენეთ **`require`** ფაილებისთვის, რომელთა გარეშე აპლიკაცია **ვერ დაიშვებს** (ძირითადი კლასები, კრიტიკული კონფიგურაცია, მონაცემთა ბაზის დაყენება) — გსურთ რომ ის მკაცრად შეჩერდეს თუ ისინი აკლია. გამოიყენეთ **`include`** სურვილის მიერ ფაილებისთვის (მაგ. გვერდის ტემპლატი) სადაც აკლული ფაილი არ უნდა დაანგრიოს გვერდი.

## _once ვარიანტები (ორმაგი ჩართვის თავიდან აცილება)

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

`require_once`/`include_once` ხელმისაწვდომი ფაილი მხოლოდ იმ შემთხვევაში, თუ ის უკვე ხელმისაწვდომი არ არის — **აუცილებელი** თავიდან აცილებისთვის "cannot redeclare function/class" შეცდომების თავიდან აცილებისთვის როდესაც ფაილი რამდენჯერმე შეიძლება იყოს ჩართული (მაგ. კლასის განმარტება რომელიც მრავალი ფაილით არის გამოძახებული).

## რა აკეთებს ჩართვა

```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: ავტოჩატვირთვა ხელით ჩართვას ცვლის

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

მოდერნულ PHP-ში, იყენებთ ხელით `require` კლასების შესთავსებას — **Composer-ის ავტოჩატვირთვა** იჭირბის მათ მოთხოვნისას. თქვენ ჯერ კიდევ იყენებთ `require "vendor/autoload.php"` ერთხელ მის ჩამორთმევისთვის.

## რატომ არის ეს მნიშვნელოვანი

`include` vs `require` გაგება ძირითადი მაგრამ მნიშვნელოვანი PHP ცოდნა — ისინი არის როგორ PHP ფაილები იზიარებენ კოდს, და განსხვავება მნიშვნელოვანია სისწორისთვის.

მთავარი პუნქტი არის უარეს შედეგის ქცევა: **`require` აუცილებელი ფაილებისთვის** (ასე რომ აპლიკაცია წარუმატებლად და ნათლად ჩერდება თუ კრიტიკული ფაილი აკლია) და **`include` სურვილის მიერ** (ასე რომ აკლული არაკრიტიკული ფაილი არ დაანგრიოს გვერდს).

ცოდნა **`_once` ვარიანტების** შესახებ პრაქტიკულად აუცილებელია თავიდან აცილებისთვის ჩვეულებრივი "cannot redeclare" შეცდომების კლასის ან ფუნქციის განმარტების ორჯერ შემთხვევით ჩართვისას.

თანაბრად მნიშვნელოვანი არის მოდერული კონტექსტის გაგება: მიუხედავად იმისა, რომ ეს კონსტრუქციები ფუნდამენტური არის, **მოდერული PHP ეყრდნობა Composer ავტოჩატვირთვას** (კლასების ჩატვირთვა მოთხოვნის შესაბამისად) ხელით ყოველი ფაილის მოთხოვნის ნაცვლად, ასე რომ მიმდინარე კოდში ძირითადად მხოლოდ `require "vendor/autoload.php"` ერთხელ გეუბნებით და ავტოჩატვირთვას დანარჩენი დაუბარებელი.

ორივე include/require მექანიკის ცოდნა (და როდის თითოეული უარეს შედეგის რეჟიმი მიზანშეწონილია) და თუ როგორ მოდერული ავტოჩატვირთვა ხელით ჩართვას აჭარბებს არის ყოველდღიური ცოდნა ძველი და ახალი PHP კოდების ბაზებთან მუშაობისთვის.