안녕하세요! 가족과 함께하는 스마트 라이프입니다. 지난 시간에는 데이터를 주고받는 표준 택배 상자 JSON을 배웠죠? 오늘은 마법 주문서(코드)에 나만 볼 수 있는 비밀 메모를 남기는 ‘주석(Comment)’ 마법을 배워보겠습니다. 훌륭한 마법사는 자신이 쓴 주문이 무엇인지 나중에도 헷갈리지 않게 꼼꼼히 기록해둔답니다!

1. 컴퓨터는 못 읽는 마법사만의 언어
주석은 프로그램 코드 안에 들어있지만, 컴퓨터는 무시하고 지나치는 특별한 문장이에요. 오직 사람(마법사)만 읽을 수 있죠. 복잡한 주문이 어떤 일을 하는지, 혹은 나중에 어떤 부분을 더 고쳐야 할지 적어둘 때 사용합니다.
2. 주석을 쓰는 두 가지 방법
PHP 마법 학교에는 두 종류의 주석 마법이 있어요. 상황에 맞춰 골라 써보세요!
- 한 줄 주석 (//): 슬래시를 두 번 쓰면 그 줄의 끝까지가 메모가 돼요. 짧은 메모에 딱이죠!
- 여러 줄 주석 (/* … */): 마법 일기처럼 길게 쓰고 싶을 때 사용해요. 시작과 끝을 꼭 닫아줘야 한답니다.
<?php
// 이것은 한 줄 주석이에요. '금화' 변수를 만드는 중이에요.
$gold = 100;
/*
여러 줄 주석 마법!
여기에는 이 주문이 왜 필요한지
아주 길게 적을 수 있답니다.
*/
echo "금화 " . $gold . "개 충전 완료!";
?>
3. 왜 주석을 써야 할까요?
나중에 여러분이 만든 아주 멋진 웹사이트를 다른 친구 마법사가 고쳐야 할 때가 올 거예요. 그때 주석이 없다면 친구는 주문서를 보고 머리를 긁적일지도 몰라요.
1. 미래의 나를 위해: 한 달 뒤에 내 코드를 봐도 금방 이해할 수 있어요.
2. 동료 마법사를 위해: 함께 프로젝트를 할 때 친절한 가이드가 돼요.
3. 잠시 주문 멈추기: 지우기는 아깝지만 잠시 실행하고 싶지 않은 코드를 주석으로 만들면 컴퓨터가 실행하지 않아요.

4. 생활 속의 주석: 요리 레시피의 꿀팁
엄마의 요리 책을 보면 ‘설탕 2스푼’ 옆에 작은 글씨로 ‘(너무 달면 1스푼만!)’이라고 적힌 메모를 본 적 있나요? 요리 순서에는 영향을 주지 않지만 요리사에게는 아주 소중한 정보죠. 아이와 함께 책이나 일기장 구석에 우리만의 ‘주석’을 달아보며 중요한 정보를 보충하는 연습을 해보세요.
마치며: 배려심 깊은 마법사가 진정한 고수!
코드를 잘 짜는 것만큼이나 남이 읽기 쉽게 정리하는 능력도 정말 중요합니다. 주석은 여러분의 코드를 ‘작품’으로 만들어주는 마지막 한 조각이에요. 오늘부터 여러분의 주문서에 다정하고 꼼꼼한 메모를 남겨보는 건 어떨까요? 다음 시간에는 드디어 대망의 ’30강: 마법 학교 졸업 프로젝트 시작!’으로 찾아오겠습니다!



