• Как правильно назвать пакет на github?

    pro-dev
    @pro-dev Автор вопроса
    Я использую предметный подход программирования, поэтому для меня это важно) Многие называют user и auth
  • Документирование кода в PHP 7.4 нужно ли?

    pro-dev
    @pro-dev Автор вопроса
    AUser0, у меня дока не на сайте будет. А прямо в пакете. Она не будет по дефолту подгружаться, но можно загрузить в пакет вместе с тестами. Но я понял вашу мысль. Учу. Но так не хочется генераторами пользоваться. А дублировать доку в двух местах тоже не очень. Но подумаю
  • Документирование кода в PHP 7.4 нужно ли?

    pro-dev
    @pro-dev Автор вопроса
    Максим Федоров, с другой стороны да) Надо вот подумать. А так приходится дублировать доку. Или генератор использовать.
  • Документирование кода в PHP 7.4 нужно ли?

    pro-dev
    @pro-dev Автор вопроса
    ThunderCat, Максим Федоров, понял) Благодарю за разъяснения. Тогда лучше буду делать, чтобы было всё по феншую) Хотя сейчас смотрю симфони пакеты и Yii3 там мало где это встретишь.
    @Maksclub
    в опенсорсе можно в комментариях даже примеры описать и подробности разные

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

    pro-dev
    @pro-dev
    ThunderCat, хах) Я тоже над этим посмеялся. Использую вопросы некоторых пользователей Q&A как кроссворд)
  • Как получить свойство класса?

    pro-dev
    @pro-dev
    yura_born, бред) Делайте в каждом action свои запросы) Вы пытаетесь сделать какое-то хранилище массивов. Зачем?) Экономите на спичках. Вам стоит лишь оптимизировать запросы и не более. Но если уж совсем хочется, то можете передавать этот массив между action с помощью куков ну или кэша. Но я не думаю, что вам это надо. У вас что большая нагрузка на базу данных? Нет. Зачем тогда нагружать php код? Если вы так во всем будете подходить, то у вас возникнет в скором времени оптимизировать код, так как он стал работать дольше. Подумайте.
  • Документирование кода в PHP 7.4 нужно ли?

    pro-dev
    @pro-dev Автор вопроса
    php 7.4 в принципе не так давно вышла. Я пока не обращаю внимания на некоторые баги. Библиотека опирается больше на будущее, нежели на сейчас.

    По генерации документации, да. Пока не поддерживается. Но, мне кажется, что в скором времени будет

    То есть вы за то, чтобы их писать? Даже если это просто @var?
  • Документирование кода в PHP 7.4 нужно ли?

    pro-dev
    @pro-dev Автор вопроса
    kafkiansky,

    Если код надо документировать (писать комментарии о том, что он делает), это плохой код.
    Код пишется понятным языком. В принципе, по названию методов, классов, папок и передаваемых параметров понятно что он делает. В коде отсутствуют такие общие названия как $items, $model. Вместо этого $posts И $post.

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

    Adamos,
    А все потребители вашей библиотеки перешли на PHP 7.4?
    Библиотеку старой версии никто не отменял. Но уже сейчас хочу выпустить новую версию с минимальными требованиями php7.4.

    ThunderCat,
    В большинстве случаев все достаточно прозрачно, но документацию по проекту и классам никто не отменял.

    Правильно ли я понимаю, что документирование кода в open source следует делать все равно. Даже если в док блоке только @var, @return? В будущем, возможно, будет и описание, но пока что нет.

    Максим Федоров,
    А по phpDoc — явно нотации кроме @throws, @return/@var Class[], @method остальные лишние
    Правильно ли я вас понял, что и к open source проекту это тоже относится. @var и @return лишнее? Сейчас у меня везде сгенерированные phpDoc. Теперь думаю удалять их или оставить. С одной стороны в них особой пользы нет. Комментариев и пояснений не дают, а просто дублируют свойства, которые и так понятны. Да и код при этом становится длиннее. Как лучше?
  • Документирование кода в PHP 7.4 нужно ли?

    pro-dev
    @pro-dev Автор вопроса
    Благодарю. Я тоже так думаю)
  • Как лучше вставлять ссылку в mail письмо?

    pro-dev
    @pro-dev Автор вопроса
    Немного не так меня поняли)) Я не говорю сейчас про сам токен и ссылку для него. Я говорю о том, что подтверждение на api реализовано для forntend. На Forntent тоже будет подтверждение, но только это подтверждение является обёрткой над API. Он будет играть роль UI интерфеса.

    Собственно в чём проблема. В том, что отправка сообщения производится с сервера. Сейчас ссылка такая
    api.site.ru/sinup/confirm. Эта ссылка ведет напрямую в API, что не правильно. Мне же надо ссылку вставлять на front site.ru/sinup/confirm.

    Можно вставлять в html письмо ссылку руками, но тогда может быть рассогласованность. Вдруг что-то на front поменялось, а ссылка не поменялась. Или проект поменял домен. В общем причин для изменения может быть много. В итоге нам требуется напрягать людей, которые занимаются API и менять ссылку, если мы поменяем. Поэтому, я думаю, что она должна передаваться как-то в html письмо. Но вот я думаю как лучше это сделать.
  • Яндекс метрика. Для чего нужен USER ID? Как правильно его использовать?

    pro-dev
    @pro-dev Автор вопроса
    Алексей Денисов, передаётся, спасибо. Пока только не разберусь как применять это в отчетах. Разберусь)
  • Как правильно делать счетчики на сайте?

    pro-dev
    @pro-dev Автор вопроса
    Григорий Васильков,
    Поэтому предлагается для счетчика использовать Redis, в котором это будет "чуть чуть" быстрее, что увеличит допустимую нагрузку на каждый из счетчиков. И каждые n-секунд уже повышать счетчик в базе данных, чтобы если счетчик перестанут переключать и редис его подчистит - данные остались надолго.


    То есть вы предлагаете некий гибрид: хранить в базе и redis? Почему тогда нельзя сразу оставить только redis? Не понял немного по такому подходу)

    И ещё вопрос. Если счётчики пока не большие. Например 1 шт. имеет ли смысл заводить сразу редис или пока хранить в БД?
  • Яндекс метрика. Для чего нужен USER ID? Как правильно его использовать?

    pro-dev
    @pro-dev Автор вопроса
    Да. Видел это. Пока почему-то не появилось это поле в отчетах. Можете подсказать? Пользователи заходят с разных устройств, но пользуются одной учетной записью. Я хотел бы на своём сайте обьединить эти данные используя USER ID. Правильно ли я понял, что это именно то, что мне нужно?
  • Как правильно делать счетчики на сайте?

    pro-dev
    @pro-dev Автор вопроса
    xmoonlight, нет. Сейчас правда все понятно. Надо опробовать на практике, а если в процессе появятся вопросы - я напишу их сюда. Пока что все понятно.

    Счетчиков вначале не так много. Нагрузки не большие. Скорее всего обойдусь пока без Redis. Попробую дополнительными полями.

    Какие счетчики возможно обновлять прямо в коде - буду изменять значения прямо в коде. А какие нет - с использованием событий и EventDispatcher. Это ещё и позволит в будущем быстро переписать код счетчиков на другую базу, например Redis.

    А может и сразу редис буду использовать. Так как в symfony уже его использую. Надо подумать только об этом.
  • Как правильно делать счетчики на сайте?

    pro-dev
    @pro-dev Автор вопроса
    xmoonlight, если не сложно можно услышать вообще мнение по этому вопросу? Как передавать разрешения для API?
  • Как правильно делать счетчики на сайте?

    pro-dev
    @pro-dev Автор вопроса
    xmoonlight, спасибо за дополнение ответа. Есть небольшие утончения по ответу. Если не сложно - прокомментируйте...

    Счётчики для конкретных записей - делаются рядом (в той же таблице, доп.колонкой).
    Если полей счетчиков много? Имеет смысл вынести в отдельную таблицу? Или в большинстве случаев достаточно этого? Сколько по вашему опыту можно хранить счетчиков рядом, а при каком количестве отдельная таблица? Если говорим о MYSQL или другой реляционной БД.

    Собирается - всё через update-запросы в виде транзакций из других таблиц.
    У меня события реализованы не в базе, а в коде. С помощью EventDispatcher, где есть Event и Listener. Мне кажется так правильней, чем события БД. При смене БД или переносе данных в таком случае могут возникнуть сложности. И с тестами проблема. Что думаете?

    В остальном понятно. А как хранить в редис? user:125:counter:friends? С Redis пока что в примитивном виде использовал. Сложные вещи не структурировал.
  • Как правильно разделить проект на микросервисы или сервисы?

    pro-dev
    @pro-dev Автор вопроса
    bozuriciyu, ничего не мешает) Нужно для четкого разделения большого сайта на сервисы.
  • Как правильно делать счетчики на сайте?

    pro-dev
    @pro-dev Автор вопроса
    Благодарю за ответ. Можете ещё подсказать пример какая структура данных должна быть в базе?) Пока не очень понятно. Можно почитать в другом ответе о чем речь...