Как правильно задавать пространства имен?

Question

[Евгений Иванов]

Простой вопрос, но что то я не понимаю (

читаю PSR-0

Полностью определённое пространство имён и имя класса должны иметь следующую структуру: \\(\)*.

Примеры
\Doctrine\Common\IsolatedClassLoader => /path/to/project/lib/vendor/Doctrine/Common/IsolatedClassLoader.php

и далее идут другие требования...

У меня есть проект test.local
папка test.local содержит:
файл index.php
папку classes
папка classes содержит файл myclass.php с одноименным классом.

Как корректно задать пространства имен в php файлах и подключить myclass.php (вызвать там экземпляр класса) в файле index.php?

index.php

namespace Junior;
use \Junior\classes\myclass as myclass;
$myclass = new myclass();
$myclass->Hello();

classes\myclass.php

namespace \Junior\classes\;
class myclass 
{
function Hello()
{
echo 'Hello';	
}
}

Fatal error: Uncaught Error: Class 'Junior\classes\myclass' not found in C:\DATA\OpenServer\domains\test.local\index.php:4

PS
\Doctrine\Common\IsolatedClassLoader => /path/to/project/lib/vendor/Doctrine/Common/IsolatedClassLoader.php
Не понятно что это и зачем надо.

Comments

[Сергей delphinpro]

автозагрузчик где?

[Евгений Иванов]

Сергей delphinpro, как я понял из доков вот он

use \Junior\classes\myclass as myclass;

Конструкция use импортирует класс из другого пространства имен, а оператор as устанавливает для него псевдоним.

Я без понятия, что тут имели ввиду и как это работает.

Раньше писал так
include __DIR__./'classes/myclass.php';

Про автозагрузчик идею понял (инклудим файлы php, в которых содержаться одноименные классы)

spl_autoload_register(function ($class_name) {
    include $class_name . '.php';
});

Но как использовать её в рабочем примере пока не знаю.
Как, где она вызывается?

[Сергей delphinpro]

Евгений Иванов, Дополнил ответ

[Дмитрий]

Выкинуть и начать читать про psr4 , а лучше сразу начать пользоваться композером

Answer 1

[Сергей delphinpro]

PSR-0 не рекомендую. Используйте PSR-4
https://qna.habr.com/q/272575#answer_715210

--------------------------------------
Поясняю по вашему случаю:

Структура файлов:

/classes/
  myclass.php
index.php
composer.phar
composer.json

Содержимое файлов:

composer.json:

{
  "require": {
    "php": "^7.4"
  },
  "autoload": {
    "psr-4": {
      "Junior\\classes\\": "classes"
    }
  }
}

index.php:

include __DIR__.'/vendor/autoload.php'; // Вот он – автозагрузчик, сгенерированный композером
use Junior\classes\myclass;
$myclass = new myclass();
$myclass->Hello();

myclass.php:

namespace Junior\classes;

class myclass {
  function Hello() {
    echo 'Hello';	
  }
}

Скачать composer.phar (Хотя в опенсервере, кажется встроенный есть)
Для генерации автозагрузчика открываем консоль опенсервера и выполняем команды

cd C:/DATA/OpenServer/domains/test.local
php composer.phar du

Comments

[Евгений Иванов]

Про композер тоже не достаточно хорошо понимаю (гуглил, читал, смотрел ролики и т.д.).
Зачем его везде используют?

Я перехожу с десктопных языков - там всё подключается через пространства имен или автоматически или руками.
И ничего страшного писать в С++ #include
Или в c# using System;

А вот код

spl_autoload_register(function ($class_name) {
    include $class_name . '.php';
});

не достаточно потнятен. Что там подключают?
И программист думает, ищет аргумент переданный в функцию и потом понимает, что было подключено.

[Сергей delphinpro]

Евгений Иванов,

spl_autoload_register(function ($class_name) {
include $class_name . '.php';
});

При первом обращении к незагруженному классу PHP вызовет замыкание, переданное в spl_autoload_register и передаст ему имя требуемого класса ($class_name). По имени этого класса будет найден файл, его содержащий, и подключен.

[Дмитрий]

При композере вы один раз подключаете автолоад и дальше только нэймспэйсами

[Евгений Иванов]

Сергей delphinpro, спасибо, посмотрел - код работает.
А что это значит? То что в php файлах, в папке classes обязательно присутствует namespace Junior\classes;?

"Junior\\classes\\": "classes"

А если (ну а вдруг) в папке classes1 (за которую отвечает другой разраб) будет namespace Vasya\classes1;
то вручную прописывать в composer/json

"Vasya\\classes1\\": "classes1"

?

И странно, что в index.php нет неймспейса namespace Junior; (по логике должен же быть т.к. он корневой элемент нашего сайта)

[Сергей delphinpro]

Евгений Иванов,
Это запись – маппинг неймспейса на директорию.
Тут говорится, что неймспейс Junior\classes расположен в папке classes. И дальше вглубь по именам директорий.
Неймспейс вообще может быть любым
Например так
"Junior\\App\\" : "classes"
И дальше везде использовать это корневое пространство имён.
use Junior\App\myclass;

Если нужны другие корневые пространства, то они пишутся здесь же, рядом.
пример из ларавел (просто он под рукой):

"psr-4": {
            "App\\": "app/",
            "Database\\Helpers\\": "database/helpers/",
            "Database\\Factories\\": "database/factories/",
            "Database\\Seeders\\": "database/seeders/"
},

И странно, что в index.php нет неймспейса namespace Junior; (по логике должен же быть т.к. он корневой элемент нашего сайта)

Ничего странного, и логики тут вашей нет.
Мы указали, что корень пространства имен находится в папке classes. Index.php не там расположен. И вообще, он не содержит классов/функций, ему не нужен неймспейс.
Если погружаться дальше, то index.php – это единая точка входа в приложение. Сюда переадресуются все запросы, здесь подключается автозагрузчик и инициализируется приложение, роутер или как-то иначе разруливается, чего хочет пользователь.

[Евгений Иванов]

Сергей delphinpro,

Тут говорится, что неймспейс Junior\classes расположен в папке classes.
Неймспейс вообще может быть любым.

Вы имели ввиду, что мы можем написать его любым?
Это понятно, что мы не обязаны ориентироваться на структуру каталогов.
Но, для корректной работы, неймспейс в json и в указанной папке (php файлах в этой папке) должны совпадать.

Ничего странного, и логики тут вашей нет.

Спасибо, идею понял - но всё равно логика и архитектурное решение странное.
Пишем кучу классов и инклудим всё в автолоад.
Автолоад подключаем во все файлы (или в индекс).

В десктопных языках подключаются только те классы, пространства, которые нужны.
И тот же Visual Studio автоматически выделяет серым не используемые пространства имен и не включает их при сборке.

И всё это даже не компилируется (там промежуточный язык и своя виртуальная машина), а вынесено в отдельный фреймворк (.NET). В результате приложение получается быстрым (ничего лишнего не загружается) и компактным (20-50 килобайт).

До композера, в PHP, я просто инклудил что нужно, куда нужно.
В PHP, как я понял, мы просто собираем всё в кучу чтобы не "заморачиваться" с инклудами - у нас заинклужено всё, осталось для доступа прописать неймспейс, который часто един для всех файлов в одной папке...

[Сергей delphinpro]

Евгений Иванов,

Но, для корректной работы, неймспейс в json и в указанной папке (php файлах в этой папке) должны совпадать.

Это обязательно. Я имел ввиду, что корневой неймспейс не обязан совпадать с корневой папкой (названия).

В PHP, как я понял, мы просто собираем всё в кучу чтобы не "заморачиваться" с инклудами - у нас заинклужено всё, осталось для доступа прописать неймспейс, который часто един для всех файлов в одной папке...

Выглядит так. Но в реале файлы инклудятся только когда обращается к соответствующему классу.
Если у вас на сайте 100500 классов, они не будут при каждом запросе все грузиься в память. Только те, которые нужны для обработки запроса.
Именно за это отвечает автозагрузчик.

В десктопных языках

Здесь иначе. Я тоже изучал php после "десктопа".
Тут нужно просто принять факты, а не искать аналогии.

[Сергей delphinpro]

Евгений Иванов,

До композера, в PHP, я просто инклудил что нужно, куда нужно.

А теперь (с композером) вы просто будете импортировать классы (use).
Причём, если вы используете не блокнот, а хорошую IDE (уровня phpStorm), то даже об этом вам не нужно думать. IDE сама вставит необходимые use. Просто пишите код.

[Евгений Иванов]

Сергей delphinpro,

но в реале файлы инклудятся только когда обращается к соответствующему классу.

Как так? Интерпритатор же читает файл сверху вниз.
Если вверху нет инклуда, а внизу вызван класс-метод, то будет ошибка. И это не только про композер, но и про spl_autoload_register. Интерпритатор производит какой то анализ файла до его выполнения?
"Собирает" файл в память из php кода?

Если у вас на сайте 100500 классов, они не будут при каждом запросе все грузиься в память.

Это понятно, оно нигде не грузится.

[Сергей delphinpro]

Если вверху нет инклуда, а внизу вызван класс-метод, то будет ошибка.

Если перед этим был вызван spl_autoload_register, то сначала будет выполнен переданный ему коллбек, а уже потом фатал еррор, если ничего не найдется.
Именно на основе этой функции работают все автозагрузчики в php