LOGIN
Raspberry Pi

센서 데이터 수집 시스템 구축 1 - 개인페이지 서버

라즈베리파이가 보낸 측정값을 kgorani.kr 에서 받아 DB에 저장하는 부분

파일 위치

- DB 테이블 : sensor_readings (kgorani DB)
- 설정 : public_html/config/config.php
- 검증 함수 : public_html/includes/sensor.php
- 수신 주소 : public_html/api/sensor.php → https://kgorani.kr/api/sensor.php

1. DB 테이블

USE kgorani;

CREATE TABLE sensor_readings (
  id           BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
  measured_at  DATETIME      NOT NULL,              -- 라즈베리파이에서 측정한 시각
  temperature  DECIMAL(4,1)  NULL,                  -- 온도 (°C), 측정 실패 시 NULL
  humidity     DECIMAL(4,1)  NULL,                  -- 습도 (%), 측정 실패 시 NULL
  light        TINYINT(1)    NULL,                  -- 전등 1=켜짐 0=꺼짐
  received_at  DATETIME      NOT NULL DEFAULT CURRENT_TIMESTAMP,   -- 서버가 받은 시각
  PRIMARY KEY (id),
  UNIQUE KEY uq_sensor_measured (measured_at)       -- 같은 측정값이 재전송돼도 한 번만 저장
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

2. 토큰 만들기 · config.php 설정

php -r 'echo bin2hex(random_bytes(32)), "\n";'
나온 64글자를 config.php 와 라즈베리파이 서버 .env 에 똑같이 넣는다
// ── 라즈베리파이 센서 API ────────────────────────────────────
const SENSOR_API_TOKEN     = '여기에_토큰';
const SENSOR_REQUIRE_HTTPS = true;    // HTTPS 요청만 받음 (토큰이 평문으로 오가지 않게)

3. includes/sensor.php

<?php
/**
 * 라즈베리파이 센서 데이터 — 공통 함수
 * 사용처: api/sensor.php (수신), RASPBERRY PI 페이지 (표시)
 */
if (!defined('APP_INIT')) { http_response_code(403); exit; }

date_default_timezone_set('Asia/Seoul');

const SENSOR_MAX_BATCH = 500;           // 한 번에 받을 수 있는 측정값 개수
const SENSOR_MAX_AGE_DAYS = 30;         // 이보다 오래된 측정값은 거부

/** 라즈베리파이가 보낸 토큰 확인 (타이밍 공격 방지를 위해 hash_equals) */
function sensor_token_ok(string $sent): bool
{
    if (!defined('SENSOR_API_TOKEN') || strlen(SENSOR_API_TOKEN) < 32) {
        return false;   // 토큰이 설정되지 않았거나 너무 짧으면 무조건 거부
    }
    return $sent !== '' && hash_equals(SENSOR_API_TOKEN, $sent);
}

/**
 * 측정값 1개 검증
 * 통과: ['measured_at' => ..., 'temperature' => ..., 'humidity' => ..., 'light' => ...]
 * 실패: null
 */
function validate_reading($r): ?array
{
    if (!is_array($r)) {
        return null;
    }

    // 측정 시각: 'YYYY-MM-DD HH:MM:SS', 미래(5분 이상) 또는 30일 넘게 지난 값은 거부
    $at = $r['measured_at'] ?? null;
    if (!is_string($at)) {
        return null;
    }
    $d = DateTimeImmutable::createFromFormat('!Y-m-d H:i:s', $at);
    if (!$d || $d->format('Y-m-d H:i:s') !== $at) {
        return null;
    }
    $now = new DateTimeImmutable();
    if ($d > $now->modify('+5 minutes') || $d < $now->modify('-' . SENSOR_MAX_AGE_DAYS . ' days')) {
        return null;
    }

    // 숫자 범위 검사 (DHT11 측정 범위보다 넉넉하게)
    $num = function ($v, float $min, float $max) {
        if ($v === null) {
            return null;
        }
        if (!is_int($v) && !is_float($v)) {
            return false;
        }
        return ($v < $min || $v > $max) ? false : round((float)$v, 1);
    };
    $t = $num($r['temperature'] ?? null, -40, 80);
    $h = $num($r['humidity'] ?? null, 0, 100);
    if ($t === false || $h === false) {
        return null;
    }

    // 전등: 1(켜짐) / 0(꺼짐) / null(측정 안 함)
    $l = $r['light'] ?? null;
    if (is_bool($l)) {
        $l = (int)$l;
    }
    if ($l !== null && $l !== 0 && $l !== 1) {
        return null;
    }

    if ($t === null && $h === null && $l === null) {
        return null;    // 아무 값도 없는 측정은 저장하지 않음
    }
    return ['measured_at' => $at, 'temperature' => $t, 'humidity' => $h, 'light' => $l];
}

4. api/sensor.php

<?php
/**
 * 센서 데이터 수신 API — 라즈베리파이의 collector.py 가 호출
 *
 * 요청: POST, Content-Type: application/json
 *       헤더 X-Sensor-Token: (config.php 의 SENSOR_API_TOKEN 과 같은 값)
 *       본문 {"readings": [{"measured_at": "2026-11-17 18:00:00", "temperature": 23.5, "humidity": 41, "light": 1}, ...]}
 * 응답: {"ok": true, "received": 3, "saved": 3, "rejected": 0}
 *
 * init.php 를 쓰지 않는 이유: 1분마다 오는 요청이 세션 · 접속 기록(최근 접속 IP)에 쌓이지 않게
 */
define('APP_INIT', true);
require __DIR__ . '/../config/config.php';
require __DIR__ . '/../includes/db.php';
require __DIR__ . '/../includes/sensor.php';

header('Content-Type: application/json; charset=utf-8');
header('X-Content-Type-Options: nosniff');
header('Cache-Control: no-store');

function reply(int $code, array $data): never
{
    http_response_code($code);
    echo json_encode($data, JSON_UNESCAPED_UNICODE);
    exit;
}

// 1) POST 만 허용
if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
    reply(405, ['ok' => false, 'message' => 'POST 요청만 받습니다.']);
}

// 2) HTTPS 강제 (토큰이 평문으로 오가지 않도록)
$isHttps = !empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off';
if (SENSOR_REQUIRE_HTTPS && !$isHttps) {
    reply(403, ['ok' => false, 'message' => 'HTTPS 로만 전송할 수 있습니다.']);
}

// 3) 토큰 확인
if (!sensor_token_ok((string)($_SERVER['HTTP_X_SENSOR_TOKEN'] ?? ''))) {
    error_log('센서 API 인증 실패: ' . ($_SERVER['REMOTE_ADDR'] ?? '?'));
    reply(401, ['ok' => false, 'message' => '인증 실패']);
}

// 4) 본문 읽기 (최대 256KB)
$raw = file_get_contents('php://input', false, null, 0, 262145);
if ($raw === false || strlen($raw) > 262144) {
    reply(413, ['ok' => false, 'message' => '요청이 너무 큽니다.']);
}
$body = json_decode($raw, true);
if (!is_array($body) || !isset($body['readings']) || !is_array($body['readings'])) {
    reply(400, ['ok' => false, 'message' => 'JSON 형식이 올바르지 않습니다.']);
}
if (count($body['readings']) > SENSOR_MAX_BATCH) {
    reply(413, ['ok' => false, 'message' => '한 번에 최대 ' . SENSOR_MAX_BATCH . '개까지 보낼 수 있습니다.']);
}

// 5) 하나씩 검증 → 통과한 것만 저장
$valid = [];
foreach ($body['readings'] as $r) {
    $v = validate_reading($r);
    if ($v !== null) {
        $valid[] = $v;
    }
}

$saved = 0;
try {
    $pdo = db();
    $pdo->beginTransaction();
    // 같은 측정 시각이 다시 오면(재전송) 무시 → 중복 저장 방지
    $ins = $pdo->prepare(
        'INSERT IGNORE INTO sensor_readings (measured_at, temperature, humidity, light) VALUES (?, ?, ?, ?)'
    );
    foreach ($valid as $v) {
        $ins->execute([$v['measured_at'], $v['temperature'], $v['humidity'], $v['light']]);
        $saved += $ins->rowCount();
    }
    $pdo->commit();
} catch (PDOException $e) {
    if (isset($pdo) && $pdo->inTransaction()) {
        $pdo->rollBack();
    }
    error_log('센서 데이터 저장 실패: ' . $e->getMessage());
    reply(500, ['ok' => false, 'message' => '저장 실패']);
}

reply(200, [
    'ok'       => true,
    'received' => count($body['readings']),
    'saved'    => $saved,
    'rejected' => count($body['readings']) - count($valid),
]);

5. 저장 확인

SELECT * FROM kgorani.sensor_readings ORDER BY id DESC LIMIT 10;

보안 처리
- 토큰 인증 (hash_equals 로 비교 → 응답 시간으로 토큰 추측 불가)
- HTTPS 요청만 허용
- 측정값마다 범위 · 형식 · 시각 검사, Prepared Statement 로 저장
- 요청 크기 256KB, 한 번에 500개 제한
- 측정 시각 UNIQUE + INSERT IGNORE 로 재전송 중복 방지
- 세션 · 접속 기록을 쓰지 않아 메인 화면의 최근 접속 IP 에 섞이지 않음
목록