PHP 웹 코드에서 먼저 막을 일곱 가지 PHP 는 브라우저가 보낸 값을 받아 HTML 을 만들어 돌려주는 일을 가장 많이 해요. 그래서 "받을 때 거르고, 낼 때 바꾸고, DB 에는 따로 넘긴다"는 세 습관이 대부분의 사고를 막아요.
항목마다 틀린 코드와 고친 코드를 나란히 두었어요. 실행 결과가 있는 것은 서버 PHP 와 브라우저 PHP 로 돌려 본 결과이고, DB·세션·파일 올리기처럼 서버가 있어야 하는 것은 문법만 확인했어요.
올리기 전에 볼 것 모든 echo·<?= 출력에 e()(htmlspecialchars)를 사용했나 SQL 에 변수를 이어 붙인 곳이 없나(prepare 만) 비밀번호를 password_hash() 로만 저장하나 상태를 바꾸는 POST 폼에 CSRF 토큰이 있나 올린 파일을 웹 뿌리 밖에 무작위 이름으로 두나 세션 쿠키가 secure·httponly·samesite 인가 운영 서버에서 display_errors 를 껐나(오류는 기록 파일로) 1 들어온 값 거르기$_GET·$_POST 로 들어온 값은 모두 글자예요. PHP 8 은 숫자가 아닌 글자 '20abc' 와 숫자 19 를 견줄 때 19 를 글자로 바꿔 글자끼리 견줘서, 엉뚱하게 참이 돼요.
틀린 코드
<?php $input = ['age' => '20abc' ]; if ($input ['age' ] > 19 ) { echo "adult\n" ; } else { echo "minor\n" ; } 실행하면 adult
고친 코드
<?php $input = ['age' => '20abc' ]; $age = filter_var ($input ['age' ], FILTER_VALIDATE_INT , ['options' => ['min_range' => 0 , 'max_range' => 150 ]]);if ($age === false ) { echo "invalid age\n" ; } else { echo $age > 19 ? "adult\n" : "minor\n" ; } 실행하면 invalid age
filter_var() 와 FILTER_VALIDATE_INT 로 "정수인가, 범위 안인가"를 먼저 보고, 실패(false)면 멈춰요. 걸러 낸 값만 그 뒤 코드에 넘겨요. 예제에서는 $_GET 대신 $input 배열로 흉내 냈어요.
서버·브라우저에서 돌린 결과
2 화면에 낼 때 이스케이프이름 칸에 <script> 를 적으면 그 글이 HTML 로 들어가 다른 사람 브라우저에서 돌아요(XSS). 입력을 거르는 것만으로는 부족하고, 화면에 낼 때마다 바꿔야 해요.
틀린 코드
<?php $name = '<script>alert(1)</script>' ; echo "<p>Hello, $name</p>\n" ;실행하면 <p>Hello, <script>alert(1)</script></p>
고친 코드
<?php $name = '<script>alert(1)</script>' ; function e (string $s ): string { return htmlspecialchars ($s , ENT_QUOTES | ENT_SUBSTITUTE , 'UTF-8' ); } echo '<p>Hello, ' . e ($name ) . "</p>\n" ;실행하면 <p>Hello, <script>alert(1)</script></p>
htmlspecialchars() 가 < > & " ' 를 글자 그대로 보이는 꼴로 바꿔요. ENT_QUOTES 로 홑따옴표까지, ENT_SUBSTITUTE 로 깨진 글자까지 막아요. 짧은 e() 함수를 만들어 모든 출력에 사용하면 빠뜨리지 않아요.
서버·브라우저에서 돌린 결과
3 SQL 은 준비문(PDO prepare)으로값을 SQL 글에 이어 붙이면 따옴표 하나로 조건이 바뀌어요. 틀린 코드가 만든 SQL 은 OR '1'='1' 이 붙어 모든 회원을 꺼내요(SQL 주입).
틀린 코드
<?php $name = "x' OR '1'='1" ; $sql = "SELECT id, name FROM users WHERE name = '$name'" ;echo $sql , "\n" ;실행하면 SELECT id, name FROM users WHERE name = 'x' OR '1'='1'
고친 코드
<?php function findUsers (PDO $pdo , string $name ): array { $stmt = $pdo ->prepare ('SELECT id, name FROM users WHERE name = ?' ); $stmt ->execute ([$name ]); return $stmt ->fetchAll (PDO ::FETCH_ASSOC ); } $pdo = new PDO ('mysql:host=localhost;dbname=app;charset=utf8mb4' , 'app' , getenv ('DB_PASS' ) ?: '' , [ PDO ::ATTR_ERRMODE => PDO ::ERRMODE_EXCEPTION , PDO ::ATTR_EMULATE_PREPARES => false , ]); $rows = findUsers ($pdo , "x' OR '1'='1" );prepare() 로 자리(?)를 둔 SQL 을 먼저 보내고, 값은 execute([...]) 로 따로 넘겨요. 값은 SQL 로 읽히지 않아요. 표 이름·정렬 칸처럼 자리로 못 넘기는 것은 미리 정한 목록에서만 고르게 해요. 고친 코드는 DB 가 있어야 돌아서 이 화면에서는 문법만 확인했어요.
서버·브라우저에서 돌린 결과
4 비밀번호는 password_hashmd5()·sha1() 은 빨라서 흔한 비밀번호를 금방 맞혀 볼 수 있고, 같은 비밀번호는 늘 같은 값이 돼요. 위 md5 값은 검색만 해도 원래 글이 나와요.
틀린 코드
<?php $hash = md5 ('hunter2' ); echo $hash , "\n" ;echo $hash === md5 ('hunter2' ) ? "login ok\n" : "login failed\n" ;실행하면 2ab96390c7dbe3439de74d0c9b0b1767
login ok
고친 코드
<?php $hash = password_hash ('hunter2' , PASSWORD_DEFAULT ); var_dump (password_verify ('hunter2' , $hash ));var_dump (password_verify ('hunter3' , $hash ));var_dump (password_get_info ($hash )['algoName' ]);실행하면 bool(true)
bool(false)
string(6) "bcrypt"
password_hash() 는 일부러 느린 계산과 무작위 소금(salt)을 사용해서 같은 비밀번호도 매번 다른 값이 돼요. 확인은 password_verify() 로만 하고, DB 칸은 길이 255 로 넉넉히 둬요. PASSWORD_DEFAULT 는 PHP 버전이 오르면 더 센 방식으로 바뀔 수 있어서 password_needs_rehash() 로 다시 저장해요.
서버·브라우저에서 돌린 결과
5 CSRF 토큰로그인한 사람이 다른 사이트에 들어갔는데, 그 사이트가 우리 송금 주소로 몰래 폼을 보내면 브라우저는 우리 쿠키를 같이 실어 보내요. 틀린 코드는 그 요청을 진짜로 믿어요.
틀린 코드
<?php session_start (); if ($_SERVER ['REQUEST_METHOD' ] === 'POST' ) { transferMoney ($_SESSION ['user_id' ], $_POST ['to' ], (int )$_POST ['amount' ]); } 고친 코드
<?php session_start ();$_SESSION ['csrf' ] ??= bin2hex (random_bytes (32 )); if ($_SERVER ['REQUEST_METHOD' ] === 'POST' ) { if (!hash_equals ($_SESSION ['csrf' ], (string )($_POST ['csrf' ] ?? '' ))) { http_response_code (403 ); exit ('bad form token' ); } transferMoney ($_SESSION ['user_id' ], $_POST ['to' ], (int )$_POST ['amount' ]); } $token = htmlspecialchars ($_SESSION ['csrf' ], ENT_QUOTES , 'UTF-8' );echo '<form method="post"><input type="hidden" name="csrf" value="' . $token . '">...</form>' ;세션마다 맞히기 어려운 토큰(random_bytes)을 만들어 폼에 숨겨 두고, 받을 때 hash_equals() 로 견줘요. 남의 사이트는 이 토큰을 읽을 수 없어요. 세션 쿠키의 SameSite 설정과 같이 사용하면 더 든든해요.
문법만 확인(DB·세션·요청이 있어야 돎)
6 파일 올리기 검사$_FILES[...]['type'] 과 파일 이름은 보내는 쪽이 마음대로 적어요. shell.php 를 이미지라고 속여 웹 폴더에 올리면 주소로 열어 서버에서 돌릴 수 있어요.
틀린 코드
<?php $name = $_FILES ['photo' ]['name' ]; if ($_FILES ['photo' ]['type' ] === 'image/png' ) { move_uploaded_file ($_FILES ['photo' ]['tmp_name' ], __DIR__ . '/uploads/' . $name ); } 고친 코드
<?php $f = $_FILES ['photo' ] ?? null ;if (!is_array ($f ) || $f ['error' ] !== UPLOAD_ERR_OK || $f ['size' ] > 2 * 1024 * 1024 ) { exit ('upload failed' ); } $mime = (new finfo (FILEINFO_MIME_TYPE ))->file ($f ['tmp_name' ]);$ext = ['image/png' => 'png' , 'image/jpeg' => 'jpg' , 'image/webp' => 'webp' ][$mime ] ?? null ;if ($ext === null ) { exit ('only png, jpg or webp' ); } $dir = dirname (__DIR__) . '/storage/uploads' ;$file = bin2hex (random_bytes (16 )) . '.' . $ext ;move_uploaded_file ($f ['tmp_name' ], $dir . '/' . $file );오류 값과 크기를 먼저 보고, 내용으로 형식을 확인(finfo)해서 허락한 확장자만 우리가 붙여요. 이름은 무작위로 새로 짓고, 웹 뿌리(public) 밖에 저장해 PHP 로 내려줘요.
문법만 확인(DB·세션·요청이 있어야 돎)
7 세션 쿠키 설정기본 세션 쿠키는 자바스크립트로 읽히거나(httponly 꺼짐) http 로도 실려 갈 수 있어요. 로그인 앞뒤로 세션 번호가 같으면, 미리 번호를 심어 둔 사람이 그 번호로 로그인한 척할 수 있어요(세션 고정).
틀린 코드
<?php session_start (); if (checkLogin ($_POST ['email' ], $_POST ['password' ])) { $_SESSION ['user_id' ] = findUserId ($_POST ['email' ]); } 고친 코드
<?php session_set_cookie_params ([ 'lifetime' => 0 , 'path' => '/' , 'secure' => true , 'httponly' => true , 'samesite' => 'Lax' , ]); session_start (); if (checkLogin ($_POST ['email' ], $_POST ['password' ])) { session_regenerate_id (true ); $_SESSION ['user_id' ] = findUserId ($_POST ['email' ]); } session_start() 전에 secure·httponly·samesite 를 켜고, 로그인에 성공하면 session_regenerate_id(true) 로 번호를 새로 받아요. 로그아웃 때는 session_destroy() 와 쿠키 지우기를 같이 해요.
문법만 확인(DB·세션·요청이 있어야 돎)
이어서 볼 주제 같이 보면 좋은 주제 캡슐화 다음 주제 구조 잡기 같이 보면 좋은 주제 PHP 실행 자주 묻는 것 입력을 걸렀으면 출력 이스케이프는 안 해도 되나요? 해야 해요. 거르기는 값이 맞는지, 이스케이프는 HTML 로 읽히지 않게 하는 일이라 둘 다 필요해요. 출력마다 htmlspecialchars 를 사용해요.
mysqli_real_escape_string 으로도 되나요? 빠뜨리기 쉽고 따옴표 밖 자리에서는 소용없어요. PDO 나 mysqli 의 준비문으로 값을 따로 넘기는 것이 안전해요.
비밀번호 칸 길이는 얼마로 하나요? password_hash 결과는 지금 60자지만 방식이 바뀔 수 있어서 255자로 넉넉히 둬요.