Какие есть варианты реализации класса-хелпера для PHP?

Question

[zorca]

В моем приложении на PHP нужно использовать несколько простых функций, которые понадобится вызывать в любых местах приложения. Как это лучше реализовать с точки зрения соответствия принципам ООП? Ребят, примеры кода или примеры реализации приводите, пожалуйста.

Answer 1

[Максим Федоров]

сложно рассуждать не имея представления о функциях.
вообще использование хелперов не есть хорошая практика с точки зрения ООП. Поэтому если есть возможность избежать создания хелпера - лучше это делать. Ну а если избежать нет возможности (например у Вас хелпер обеспечивающий дополнительные функции обработки массивов) тогда обычным классом с приватным конструктором и статическими методами....

Comments

[Avtomat]

Почему статическими? Методы можно сделать обычными ведь...

[zorca]

Я могу конкретизировать, если это поможет.

https://github.com/oxboot/ox/blob/9e4084f387562fb1...

Вот такие небольшие функции будут массово использоваться повсеместно в приложении.

В похожем проекте ребята используют и глобальные функции и класс Utils с статическими методами на борту. Равняться на них не хочу. Хочу элегантный код.

[Максим Федоров]

Avtomat, а зачем обычными? класс будет хранить состояния? нет, хелперы не хранят состояния ... нужна возможность создания нескольких экземпляров класса? нет, т.к. хелперы не хранят состояния то и создание экземпляров - избыточная операция. Как бы надобности в обычных методах нет, конечно хелпер можно сделать в виде синглтона, но стоит ли...

[Максим Федоров]

zorca, понял. Тогда класс с статическими методами, или синглтон....

[zorca]

Максим Федоров, попробовал сделать не статическими методами, плюс внедрить в контейнер приложения, все стало еще печальнее с точки зрения читабельности и удобства. Так что да, все больше склоняюсь к статическим методам класса Helpers или приложения.

[Алексей Скобкин]

zorca,

Вот такие небольшие функции будут массово использоваться повсеместно в приложении.

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

[zorca]

Алексей Скобкин, приложение в процессе активной разработки, многое еще буду перекраивать, мелкий функционал без претензий на отдельный класс пока кидаю в хелперы. В первой версии уже сформируется понятная мне самому структура.

[Алексей Скобкин]

zorca, Меня-то убеждать не надо, я с этим не соглашусь. Главное, что вы убедили себя, что обязательно всё приведёте в порядок.

Answer 2

[BoShurik]

Если это действительно простые функции, то и делать их надо функциями. Композер умеет их подключать в автозагрузку:

"autoload": {
    "files": ["src/helpers.php"]
}

Пример

Comments

[zorca]

С этого я и начал, это простейший вариант, хочу еще варианты рассмотреть.

[BoShurik]

zorca, если хотите делать по принципам ООП, то делать с использованием ООП это дело не стоит :) Функции к нему отношения имеют мало

[Adamos]

Засорять глобальное пространство более, чем требуется - дурная практика.
Требуется один статический класс-хелпер - никакого смысла дробить его на функции нет, и с точки зрения будущих изменений особенно.

[zorca]

Ваш вариант тоже решение безусловно. Но все еще в поисках третьего варианта. :-)

[BoShurik]

Adamos, кто сказал про глобальное пространство? У функций тоже может быть namespace

[zorca]

Минус глобальных функций - засорение таки глобального пространства. Хорошо, когда их 5-10, но их число может вырасти и встанет вопрос об упорядочивании вызова таких функций.

[BoShurik]

zorca, в итоге будет тоже самое, что и с классом

App\foo();
App\bar();

вместо

App\Utils::foo();
App\Utils::bar();

[zorca]

BoShurik, интересный вариант, даже не подумал об этом.

[Adamos]

BoShurik,

в итоге будет тоже самое, что и с классом

Вот именно. И в чем смысл менять шило на мыло? Разница только в возможности напороться на переопределение функции в том же пространстве.

[BoShurik]

Adamos, ну вообще, все-таки символов меньше. В php ради этого ввели короткую нотацию для массивов.
А переопределить функцию php не даст, а в случае, если функции в одном файле - то тут и ide поможет

[Adamos]

BoShurik, и один из простейший способов собрать эти функции в одном файле - это, внезапно, тот самый общий статический класс.

На случай, когда нескольким функциям нужна единая логика, в отрыве от этих функций не существующая (для чего в статическом классе можно просто объявить приватный метод) - тоже что-нибудь предложите?

[BoShurik]

Adamos, тут конечно класс выигрывает, но это уже не укладывается в описание простых функций, а больше похоже на сервис

[BoShurik]

Adamos, хотя, можно выделить такие функции во что-то вроде
App\Internal\foo();
чтобы они не мешались в неймспейсе App

Но мне пока такая ситуация не встречалась

[Adamos]

BoShurik, потому что буханка, троллейбус и все такое.

[BoShurik]

Тут как раз наоборот :) ООП используется для того, для чего оно не предназначено. Объект хелпера не инстацировать, все его методы по сути являются обычными функциями, так почему бы их не использовать? Я за семантику

Answer 3

[Антон]

Статиком в родительском классе

Answer 4

[Максим Кожин]

"Статический" класс. Хотя в PHP такого понятия нет, но смысл его в реализации статических методов.
Реализация метода __callStatic, который определит вызовы простых функций, либо переопределит некоторые из них, либо добавит новые (ну например stripos в зависимости от кодировки)

Comments

[Avtomat]

Зачем именно статический можно уточнить? Можно де сделать обычным классом и вызывать методы как обычно.

[Максим Кожин]

Avtomat,
А какой смысл от экземпляра?

Если мы делаем ArrayHelper, то экземпляр будет работать с определенным массивом. А функции для работы с массивами могут принимать как один, так и два, так и более. Тот же array_merge к примеру. Или strcasecamp для работы со строками.

Исходя из Вашей логики с экземпляром удобно будет работать, если параметр у реализуемых функций будет один. Будет реализован статический класс BaseArrayHelper, который может работать с несколькими массивами и содержать статические методы, и наследник ArrayHelper, который работает только с одним через экземпляр. Но это уже тема типизации и совсем отходит от темы хелперов. В таком случае придется написать много кода-обертки, чтобы обернуть стандартные функции - такое будет полезно, если только времени вагон.