작은 프로젝트로 PHP 코딩 배우기

에이전트가 할 수 있는 일

• 파일read_file, write_file, append_file, edit_file, delete_file, make_dir, move_file, copy_file, list_dir, grep, glob이 채팅의 작업 폴더 안에서 동작해요.
• Shellphp -l file.php와 php file.php 같은 터미널 명령을 실행하고, 명령이 끝나면 실제 종료 코드를 알려줘요. 위험한 명령은 차단돼요.
• 웹web_search가 페이지를 찾고 http_get이 한 페이지를 내려받아서, 에이전트가 아직 모르는 함수에 대한 PHP 매뉴얼을 읽을 수 있어요.
• 스크린샷과 이미지ocr은 복사할 수 없는 오류 메시지 같은 스크린샷의 텍스트를 읽고, gen_image는 실제 이미지 파일을 저장해요.
• 오케스트레이션task는 병렬 서브 에이전트를 시작하고, run_on_model은 어려운 단계를 더 큰 모델로 보내고, skill은 재사용할 수 있는 절차서를 불러오고, 버전 관리 skill은 브랜치와 커밋을 다뤄요.
• 승인 모드Auto-run은 바로 실행하고, Ask first는 무언가를 바꾸는 동작 전에 멈추고, Plan only는 계획을 쓰고 아무것도 실행하지 않아요. 계획은 재시작 후에도 남아요.
• Cron내가 정한 일정에 따라 프롬프트를 실행해요. 예를 들어 에이전트에게 폴더의 모든 PHP 파일 구문을 검사하라고 시킬 수 있어요.
• 모델표준 API 엔드포인트로 연결하는 클라우드 AI 제공업체, 내 PC에서 로컬로 실행되는 모델, 또는 내장 모델을 연결해요. Test 버튼이 엔드포인트를 확인해요.

연습 두 가지를 자세히

폼에서 받은 이름 이스케이프하기

제출된 이름을 다시 보여주는 작은 HTML 폼이 있는 페이지 greeting.php를 요청해요. write_file은 폼 입력을 믿을 수 없으니 이름을 htmlspecialchars에 통과시켜 저장하고, Shell은 구문 검사를 위해 php -l greeting.php를 실행해요. php -S localhost:8000은 내 터미널에서 직접 시작해요. 이 내장 서버는 로컬 테스트 전용이라 인터넷에 공개하면 절대 안 돼요. 로컬에서만 써요. 꺾쇠괄호가 들어간 이름을 입력해서 일반 텍스트로 나타나는지 확인해요. 백엔드 개발을 위한 PHP 학습에는 이런 서버 측 폼 처리도 포함돼요. 입력이 들어오면 출력할 때 이스케이프하고 로컬에서 테스트해요. Ask first 카드에서 파일을 읽은 뒤 수락하고, 페이지는 직접 테스트해요.

Plan only로 반복문 이해하기

Plan only로 바꾸고, totals.php의 foreach 반복문을 가리키거나 붙여넣은 뒤 연관 배열로 무엇을 하는지 물어봐요. 에이전트는 각 줄을 쉬운 단계로 설명하고 두 번째 반복문의 계획을 쓰지만, 명령을 실행하거나 파일을 바꾸지는 않아요. 먼저 계획을 읽어요. PHP를 제대로 배우려면 입문 자료의 예제뿐 아니라 내 코드에 대해서도 물어봐야 해요. 설명이 이해되면 Ask first로 바꿔서 두 번째 반복문을 요청해요. edit_file이 변경을 diff로 보여주고 Shell이 php totals.php를 실행하니, 출력된 줄을 예상과 비교할 수 있어요. 새로 추가된 각 줄이 무엇을 하는지 말할 수 있을 때만 diff를 수락해요.