Я понял, что должен написать спецификацию соглашения о кодировании HTML, JavaScript и PHP для меня и моей команды.
В веб-разработке, как и в C ++, я определенно поклонник отступов и комментариев.
Тем не менее, часто в моей работе я сталкиваюсь с кодом HTML + JavaScript + PHP, который внезапно вызывает головную боль.
Я пытаюсь сделать мой код читабельным, но то, что мне кажется лучше (для отступов и комментариев), кажется, не очаровывает моих товарищей по команде, поэтому мне было интересно, есть ли лучшая или, по крайней мере, общая хорошая практика при написании «гибрида» «документы, как сегодняшние веб-страницы, которые с каждым днем становятся все сложнее.
Мне известно о том факте, что код современных веб-страниц, вероятно, немного сложен, но мне интересно, существует ли уже хорошее соглашение по этим аспектам.
источник
Есть некоторые чтения для вдохновения:
источник
Держите 3 отдельно. Наименее обслуживаемый код, с которым я имею дело, всегда, когда есть некоторый PHP, который повторяет много HTML и JavaScript, вероятно, с некоторым SQL, брошенным для хорошей меры.
Хранение всех этих элементов в отдельности значительно облегчит обслуживание кода, а также упростит работу, если у вас есть люди, работающие над различными частями приложения, например, дизайнер, которому нужно работать только с HTML / CSS.
источник
Самый простой способ написания кода для php-веб-приложения - это объединить все вместе. Однако, если вы поступите таким образом, вы быстро столкнетесь с необратимым беспорядком.
Вот некоторые полезные практики:
1) Поместите свой JavaScript в <head> документа (или, что еще лучше, в отдельные файлы, на которые есть ссылки в заголовке). Узнайте, как связать прослушиватели событий в событии document.onload, а не разбрасывать их по HTML. (Еще лучше - научитесь использовать такие фреймворки, как Jquery; это сделает ваш JavaScript намного, намного красивее).
2) Посмотрите шаблоны проектирования, такие как MVC. Вы хотите максимально отделить свою бизнес-логику, написанную на PHP, от вашего HTML. В идеале вы должны использовать хороший язык шаблонов для объединения ваших HTML-страниц; по крайней мере, PHP в вашем HTML должен быть кратким - в основном вызывая переменные и просматривая списки, созданные в другом месте.
3) Комментарии, отступы ... это просто базовые рекомендации по программированию. Я склоняюсь к тому, чтобы длина моей строки превышала 80 символов, когда я пишу HTML, просто потому, что язык чертовски многословен, но это единственная традиционная практика, которую вы должны позволять слайду - если остальная часть команды небрежна им нужно смириться и привести себя в порядок.
источник
Вот пара лакомых кусочков:
Javascript: использовать
var
при инициализации переменных.HTML: включите сценарии внизу файла, чтобы они загружались последними.
PHP: разделить файлы вверх. Не помещайте все свои классы в один файл, как если бы вы не делали это при обычной разработке C ++. Прокомментируйте как можно больше, а также запишите назначение ваших функций / классов.
источник