Полный ответ:

1. Что это такое?

__DIR__ — это магическая константа (magic constant), которая возвращает полный абсолютный путь к директории, в которой находится текущий исполняемый файл.

• Возвращаемое значение: Абсолютный путь без завершающего слеша (кроме корневой директории).
• Особенность: Её значение определяется во время компиляции скрипта и зависит от местоположения файла, в котором она используется.

2. Основное использование и примеры

// Предположим, файл находится в /var/www/html/myproject/index.php

echo __DIR__;
// Выведет: /var/www/html/myproject (на Linux) или C:\xampp\htdocs\myproject (на Windows)

// Использование для подключения файлов
require_once __DIR__ . '/config/database.php';
// Подключит файл /var/www/html/myproject/config/database.php

// Создание абсолютного пути
$logFile = __DIR__ . '/logs/app.log';

3. Ключевые преимущества перед относительными путями

Это главная причина, почему __DIR__ так важна.

Проблема относительных путей: Относительные пути зависят от текущей рабочей директории (CWD - Current Working Directory), которая может меняться в зависимости от того, как запущен скрипт (из браузера, через командную строку, из другого скрипта).

// Проблемный код (работает не всегда)
require_once '../config.php'; // Может сломаться, если CWD изменится

Решение с __DIR__: Путь, сформированный с помощью __DIR__, всегда будет абсолютным и предсказуемым, независимо от того, откуда был вызван скрипт.

// Надежный код (работает всегда)
require_once __DIR__ . '/../config.php'; // Всегда будет указывать на правильный файл

4. Сравнение с родственными константами

Эквивалентность:

__DIR__ === dirname(__FILE__) // Всегда true

5. Практическое применение

1. Безопасное подключение файлов:

   // Внутри /app/bootstrap.php
   require __DIR__ . '/../vendor/autoload.php';
   $config = require __DIR__ . '/config/app.php';
   

2. Определение корневой директории проекта:

   // В файле /public/index.php
   define('PROJECT_ROOT', dirname(__DIR__));
   // PROJECT_ROOT будет содержать путь к корню проекта
   

3. Работа с файловой системой:

   $cacheDir = __DIR__ . '/cache';
   if (!is_dir($cacheDir)) {
       mkdir($cacheDir, 0755, true);
   }
   

6. Особенности и лучшие практики

• Символы .. (на уровень выше) работают корректно:

  // Файл: /app/src/Class.php
  $rootDir = __DIR__ . '/../..'; // Путь к корню проекта
  

• Используйте с DIRECTORY_SEPARATOR для максимальной кроссплатформенности (хотя прямой слеш / обычно работает везде):

  $filePath = __DIR__ . DIRECTORY_SEPARATOR . 'subdir' . DIRECTORY_SEPARATOR . 'file.php';
  

• В симлинках: __DIR__ возвращает путь к реальному файлу, а не к симлинку (в отличие от getcwd()).

Итог:

__DIR__ — это магическая константа, возвращающая абсолютный путь к директории текущего файла. Её главное преимущество — создание надежных абсолютных путей для подключения файлов, что делает код независимым от текущей рабочей директории. Это обязательный инструмент для создания качественного, переносимого и надежного PHP-кода. Всегда предпочтительнее использовать __DIR__ вместо относительных путей или dirname(__FILE__).