Зачем дублируют неймспейс в наименовании класса?

Question

[devastation_kvlt]

В популярных фреймворках принято называть классы так:

App\Repositories\UserRepository
App\Controllers\UserController

Почему не так?

App\Repositories\User
App\Controllers\User

Ведь это лаконичнее. Какие есть доводы в пользу такого наименования?

Answer 1

[Mikhail Osher]

А при импорте обоих классов, что будете делать? На то и называют уникальными именами, чтобы можно было сразу отличить один класс от другого. Более того, такая архитектура (App\Repositories, App\Controllers) используется далеко не во всех проектах. Поэтому логично указать как функциональную составляющую (сервис, контроллер), так и доменную (user, app, article).

Comments

[Алексей Уколов]

Это на вкус и цвет. Я предпочитаю алиасами импорта коллизии разрешать и не делать суффиксы.

[Максим Тимофеев]

Алексей Уколов, это приводит к тому что в разных классах Вы имеете разные именования и потом поддерживать это сложно. Алиасы должны быть как крайний случай. Если есть возможность избежать дублирования названий классов - это надо сделать. Тогда код читается проще. Так что тут не совсем вопрос вкуса и цвета.
Да если Вы имеете феноменальную память и везде какой-нибудь app/request/Builder именуете RequestBuilder - отлично, но на деле думаю в коде где-то так, где-то RequestBuilder где-то Builder, где-то RB и просматривая код не сразу очевидно, что это одинаковые классы.

[Алексей Николаев]

При импорте просто импортируется неймспейс, что гораздо лаконичнее и понятнее по коду. Я не знаю, кем надо быть, чтобы получить проблемы с этим - сам так же пишу. Ведь все очень просто - максимум лаконичности, максимум логичности, минимум дублирования.

namespace App;

use App\Repository;
use App\Controller;

// ...

$UserRepository = new Repository\User;
$UserController = new Controllers\User;

Если кто скажет, что дублируется слово Repository в коде - если критично, то можно использовать алиас для конкретной сущности. Но, это грязно, как и импортировать конкретные сущности.

[Mikhail Osher]

Не видел ни одной команды, где в PHP импортируют namespace.
Такое видел только в Java, и то, импорты стандартных пакетов.

[Алексей Николаев]

Mikhail Osher, use Namespace1\Namespace2
Подробнее в документации

[Mikhail Osher]

Алексей Николаев, я в курсе, как это работает, спасибо :)

Дело в том, что такое я не встречал ни в одном проекте за долгие годы

Answer 2

[Иван Шумов]

Фреймворки пишутся не 1, не 2, а большим числом людей. Поэтому создается универсальный naming convention. Кроме того - в одной директории под одним namespace могут лежать разные файлы, как, например, UserRepository и UserModel.

Comments

[Алексей Николаев]

Позор таким разработчикам, что кладут репозиторий и модель в одну кучу. Если такое есть во фреймворке - стоит задуматься о переходе на что-нибудь другое.

[Иван Шумов]

Алексей Николаев, скажите, на вендора из 3х файлов вам действительно нужно иметь 3 поддиректории?) Или для небольшой выделенной компоненты?

[Алексей Николаев]

Иван Шумов, да, потому что есть такая вещь, как регламент, который стоит соблюдать. В BEM, например, нормально, когда в папке 1-2 файла. Кроме того, когда нужно будет расширить компоненту, гораздо легче будет докинуть нужные файлы в уже имеющиеся директории, чем множить кучу или переделывать.

[Иван Шумов]

Алексей Николаев, а для этого есть версионность в вендорах, обратная совместимость и много ещё чего. Никакой критики. Все по одному стандарту разрабатывать не могут, поэтому инструменты имеют гибкость

Answer 3

[Кирилл Горелов]

Хабр рекомендую. Должно ответить на твой вопрос. Это хорошо, что интересуешься.
Мне свое время помогла эта статья.