도구
로그인
한국어

코드 배우기PHP

PHP 보안 기초

PHP 8.3 기준

htmlspecialchars·PDO prepare·password_hash·CSRF 토큰·파일 올리기·세션 쿠키를 고친 코드로 익혀요.

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, &lt;script&gt;alert(1)&lt;/script&gt;</p>

htmlspecialchars() 가 < > & " ' 를 글자 그대로 보이는 꼴로 바꿔요. ENT_QUOTES 로 홑따옴표까지, ENT_SUBSTITUTE 로 깨진 글자까지 막아요. 짧은 e() 함수를 만들어 모든 출력에 사용하면 빠뜨리지 않아요.

서버·브라우저에서 돌린 결과

3SQL 은 준비문(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'

고친 코드

<?phpfunction 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_hash

md5()·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() 로 다시 저장해요.

서버·브라우저에서 돌린 결과

5CSRF 토큰

로그인한 사람이 다른 사이트에 들어갔는데, 그 사이트가 우리 송금 주소로 몰래 폼을 보내면 브라우저는 우리 쿠키를 같이 실어 보내요. 틀린 코드는 그 요청을 진짜로 믿어요.

틀린 코드

<?phpsession_start(); if ($_SERVER['REQUEST_METHOD'] === 'POST') {    transferMoney($_SESSION['user_id'], $_POST['to'], (int)$_POST['amount']);}

고친 코드

<?phpsession_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 로도 실려 갈 수 있어요. 로그인 앞뒤로 세션 번호가 같으면, 미리 번호를 심어 둔 사람이 그 번호로 로그인한 척할 수 있어요(세션 고정).

틀린 코드

<?phpsession_start(); if (checkLogin($_POST['email'], $_POST['password'])) {    $_SESSION['user_id'] = findUserId($_POST['email']);}

고친 코드

<?phpsession_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·세션·요청이 있어야 돎)

자주 묻는 것

입력을 걸렀으면 출력 이스케이프는 안 해도 되나요?

해야 해요. 거르기는 값이 맞는지, 이스케이프는 HTML 로 읽히지 않게 하는 일이라 둘 다 필요해요. 출력마다 htmlspecialchars 를 사용해요.

mysqli_real_escape_string 으로도 되나요?

빠뜨리기 쉽고 따옴표 밖 자리에서는 소용없어요. PDO 나 mysqli 의 준비문으로 값을 따로 넘기는 것이 안전해요.

비밀번호 칸 길이는 얼마로 하나요?

password_hash 결과는 지금 60자지만 방식이 바뀔 수 있어서 255자로 넉넉히 둬요.