여러 줄 주석 (Block Comment)


Block Comment Concept Cartoon

그림: 여러 줄의 코드를 주석 덮개(/* ... */)로 덮어 실행에서 제외(Zzz...)시키는 블록 주석의 역할

여러 줄 주석 처리 기능은 한 줄 처리 주석과 달리 여러 줄의 내용을 한꺼번에 주석으로 처리하고자 할 때 사용하는 방법입니다. 특정 블록 영역을 주석으로 처리할 때 매우 편리합니다.

여러 줄을 주석으로 처리하는 방법은 /*로 시작해서 */로 블록을 지정하면 됩니다. 해당 기호로 감싸인 모든 코드와 텍스트는 프로그램 소스 상에서 주석으로 처리되어 실행되지 않습니다.


기본 문법 및 예제


여러 줄 주석을 사용하는 실제 예시입니다.

예제 파일 comment-02.php

<?php
    // This is a single-line comment
    /*
    This is a multiple-lines comment block
    that spans over multiple
    lines
    */
 
    // 코드의 일부를 제외하는 데 사용할 수도 있습니다.
    $x = 5 /* + 15 */ + 5;
    echo $x;
?>

결과

10


블록 주석 사용 시 주의할 점


1. 중첩 사용 금지 (Nested Comments)

여러 줄 주석 처리(/* */)는 중첩되어 사용할 수 없습니다. /* */로 이미 주석 처리된 블록 안에서 또 다른 /* */ 주석 블록을 삽입하면 PHP 파서가 */ 기호를 잘못 만나 에러를 발생시키고 실행을 중단합니다.

잘못된 사용 예:

/*
    여러 줄 주석입니다.
    /*
    서브로 여러 줄 주석을 삽입할 수 없습니다.
    */
    주석의 끝입니다. ( 부분에서 에러가 발생합니다)
*/

2. 블록 주석 내 한 줄 주석 사용

블록 주석(/* */) 내부에는 한 줄 주석(// 또는 #)을 자유롭게 삽입할 수 있습니다.

올바른 사용 예:

/*
    여러 줄 주석입니다.
    // 중간에 한 줄 주석문은 삽입이 가능합니다.
    # 이 또한 무시됩니다.
    주석의 끝입니다.
*/


서브목차