Использование стандартов кодирования с WordPress

Я много пишу о стандартах кодирования в WordPress и о том значении, которое, по моему мнению, они имеют для отдельных лиц, команд и при работе с основным приложением, которым является сам WordPress.

За последний год или около того я отказался от работы в основном со стандартами кодирования WordPress и начал использовать стандартные рекомендации PHP для кодирования.

Обратите внимание, что я не говорил, что отказываюсь от стандартов кодирования WordPress и что я ставлю рекомендации PSR выше них, но у меня есть причины, по которым я использую каждый из них. И для всех, кто работает с проектами на основе WordPress, я думаю, важно понимать, когда уместно использовать каждый из них.

И это цели этого поста.

Стандарты кодирования с WordPress

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

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

На момент написания этой статьи я работаю над двумя проектами, один из которых использует стандарты кодирования WordPress; остальные используют PSR.

Вот в чем дело:

Решение заключается не в том, какой набор стандартов кодирования лучше. Люди любят спорить по этому поводу, и это нормально для них. Я не. Вместо этого я стараюсь занимать максимально прагматичную позицию.

И для этого я пытаюсь использовать набор вопросов для принятия решений о том, какие стандарты кодирования использовать.

Фильтр для принятия решений

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

Я сделал все возможное, чтобы зафиксировать порядок, в котором я рассматриваю, какой набор стандартов использовать, и я делюсь ими здесь. Без особого порядка.

• Вордпресс. Вы пишете что-то, что должно быть совместимо с большим количеством установок WordPress (не считая версий PHP)?
• WordPress Вы работаете над поддержкой проекта, написанного для старой версии PHP или написанного с использованием стандартов кодирования WordPress?
• Вордпресс. Вы унаследовали проект или поддерживаете проект, у которого нет бюджета на рефакторинг кодовой базы?
• Вордпресс или ПСР. Вы работаете с командой, которая использует это в качестве основного набора стандартов кодирования?
• ПСР. Можете ли вы убедить своего клиента использовать PHP7+?
• ПСР. Есть ли у вас полный контроль над средой, в которой развернут проект?
• ПСР. У вас есть проект, который ранее был написан на более старой версии PHP, и у которого есть бюджет на новый сервер и рефакторинг?
• ПСР. Вы хотите написать кодовую базу, которая поможет перенести ваши навыки PHP в более современную эпоху, а также привнести с собой WordPress?

И, наконец, еще один вопрос, который я хотел бы задать, заключается в следующем:

Какие стандарты кодирования используются в вашей системе, насколько легко настроить вашу IDE? Потратьте время на его настройку и ответьте на приведенный выше вопрос, чтобы определить, какой набор стандартов вы используете.

В конечном счете, цель состоит в том, чтобы как можно проще определить, какой стандарт использовать.

Заключительный пост?

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

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

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

А пока подумайте над приведенными выше стандартами кодирования и посмотрите, не поможет ли это в управлении некоторыми из ваших существующих проектов.

Примечание об объектно-ориентированном программировании

Обратите также внимание, что ранее на этой неделе я начал — или возобновил, в зависимости от того, как долго вы читаете этот материал — объектно-ориентированное программирование в WordPress. Так что, если вы тоже заинтересованы в этом, вы можете начать с этого поста (поскольку он также ссылается на некоторые другие).