PHP 4 на практике

       

Комментарии в коде РНР


Комментарии следует использовать даже в относительно простых и незамысловатых сценариях. В РНР существуют два формата комментариев:

  • Однострочные комментарии обычно используются для коротких пояснений или примечаний, относящихся к локальному коду.
  • Многострочные комментарии обычно используются при оформлении алгоритмов на псевдокоде и в более подробных объяснениях.
  • Оба способа в конечном счете приводят к одинаковому результату и совершенно не влияют на общее быстродействие сценария. Выбор варианта остается за вами.

    Однострочные комментарии

    При оформлении однострочных комментариев используется два стиля комментирования. Оба стиля работают абсолютно одинаково, но в них используются разные служебные символы. В одном случае комментарий начинается с двойного символа «косая черта» (//), а в другом — с символа фунта (#). Ниже приведены примеры обоих стилей:

    <?

    // Выбрать цвет роз $rose_color = "red";

    # Выбрать цвет фиалок $violet_color = "blue";

    print "Roses are $rose_color, violets are $violet_color"

    ?>

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



    <?

    // файл: example. php

    // автор: У.Дж.Гилмор

    // дата: 24 августа 2000 г.

    print "An example with comments";

    ?>

    Многострочные комментарии

    В РНР существует возможность построения подробных комментариев, занимающих несколько строк. Такие комментарии оформляются в стиле языка С — их начало и конец обозначаются символами /* и */.

    <?

    /*

    Сценарий: multi_coramment_example.php

      Назначение : пример использования многострочных комментариев

      Автор: У.Дж.Гилмор

      Дата: 14 июня 2000 г.

    */

    print "A multiline comment can be found at the top of this script!";

    ?>

    Как видите, многострочные комментарии особенно удобны для вывода относительно длинной сводной информации обо всем сценарии или его части.



    Содержание раздела