QR코드 만들기, 이대로 복붙하세요! 🚀 phpqrcode 라이브러리 활용 가이드

여러분의 웹사이트나 애플리케이션에 QR코드를 적용해야 할 일이 생겼나요? 이벤트 참여, 결제 연동, 정보 공유 등 QR코드는 활용도가 정말 무궁무진합니다. PHP 환경에서 외부 API에 의존하지 않고 서버에서 직접, 안정적으로 QR코드를 생성하고 싶다면 **`phpqrcode` 라이브러리**가 아주 좋은 해결책이 될 수 있습니다. ✨

이 글에서는 **`phpqrcode` 라이브러리**를 다운로드부터 설치, 그리고 간단한 **PHP 소스 코드**를 통해 원하는 텍스트나 URL을 이미지 형태의 **QR코드**로 생성하는 방법을 자세히 알려드릴 거예요. 이 가이드만 따라오시면 여러분도 손쉽게 PHP QR코드 생성 전문가가 될 수 있을 겁니다! 🚀 지금 바로 시작해 볼까요?

phpqrcode 라이브러리 소개 및 준비물

`phpqrcode`는 **PHP**로 작성된 오픈소스 라이브러리로, 서버에서 직접 **QR코드 이미지**를 생성할 수 있는 기능을 제공합니다. GD 라이브러리(대부분의 **PHP** 설치에 포함되어 있음)에 의존하여 이미지를 생성하기 때문에 별도의 복잡한 설정 없이도 빠르게 시작할 수 있어요.

준비물

PHP 설치 환경 (버전 5.6 이상, 7.4 또는 8.x 권장)
**GD 라이브러리**가 활성화된 **PHP** (대부분 기본 활성화되어 있습니다.)
`phpqrcode` 라이브러리 다운로드 : https://phpqrcode.sourceforge.net

PHP QR Code - QR code generator, an LGPL PHP library

Overview PHP QR Code is open source (LGPL) library for generating QR Code, 2-dimensional barcode. Based on libqrencode C library, provides API for creating QR Code barcode images (PNG, JPEG thanks to GD2). Implemented purely in PHP, with no external depend

phpqrcode.sourceforge.net

`phpqrcode` 라이브러리 설치

GitHub 저장소에서 **`phpqrcode`** 라이브러리를 다운로드합니다. 보통 'Clone or download' 버튼을 클릭하여 ZIP 파일을 다운로드합니다.
다운로드한 ZIP 파일의 압축을 해제합니다.
압축을 해제한 폴더(예: `phpqrcode-master` 안에 있는 `qrlib.php` 파일과 `qr_img.php` 파일 및 관련 폴더들)를 여러분의 **PHP** 프로젝트 폴더 내, 접근하기 쉬운 경로(예: `libs/phpqrcode/`)로 복사합니다.

이제 여러분의 **PHP** 스크립트에서 `qrlib.php` 파일을 포함(include)하면 QR코드 생성 기능을 사용할 수 있습니다.

PHP QR코드 생성 기본 소스 코드 (복사해서 쓰세요!)

다음은 가장 기본적인 QR코드 생성 소스 코드입니다. `qr_code_generator.php` 라는 이름으로 파일을 저장하고 실행해 보세요.

<?php
    // phpqrcode 라이브러리의 qrlib.php 파일 경로를 지정합니다.
    // 여러분의 프로젝트 구조에 맞게 경로를 수정해주세요.
    include 'libs/phpqrcode/qrlib.php'; // 예시 경로

    // --- 1. QR 코드에 담을 데이터 설정 ---
    // 웹사이트 URL, 결제 정보, 텍스트 메시지 등 원하는 내용을 입력하세요.
    $data = 'https://www.yourdomain.com/your-page'; // 또는 'Hello World!'

    // --- 2. QR 코드 설정 (옵션) ---
    // Qr Code 레벨: L(Low), M(Medium), Q(Quartile), H(High)
    // 에러 복구 레벨이 높을수록 QR코드가 더 손상되어도 스캔 가능성이 높지만, 데이터 용량은 줄어듭니다.
    $errorCorrectionLevel = 'L'; // L: 7% 복구, M: 15%, Q: 25%, H: 30%

    // QR 코드 크기: 1 ~ 10 (숫자가 클수록 크고 섬세한 QR 코드가 생성됩니다.)
    $matrixPointSize = 4; // 기본 4 정도면 충분합니다.

    // --- 3. QR 코드 생성 및 출력 ---
    // HTTP 헤더를 설정하여 이미지를 직접 브라우저에 출력합니다.
    header('Content-Type: image/png');
    QRcode::png($data, false, $errorCorrectionLevel, $matrixPointSize, 2); // 마지막 인자는 여백 (픽셀)

    // 이미지를 파일로 저장하려면 다음과 같이 사용할 수 있습니다.
    // $fileName = 'qr_code_' . md5($data) . '.png'; // 파일명
    // QRcode::png($data, $fileName, $errorCorrectionLevel, $matrixPointSize, 2);
    // echo '<img src="' . $fileName . '" alt="QR Code">';
?>

위 소스 코드에서 `$data` 변수 값만 변경하여 여러분이 원하는 어떤 내용이든 **QR코드**로 만들 수 있습니다. `header('Content-Type: image/png');` 설정을 통해 생성된 이미지를 브라우저에 직접 출력하므로, 웹페이지에서 `<img src="qr_code_generator.php">` 형태로 호출하여 사용할 수도 있습니다.

PHP QR코드 생성 활용 예시

예시 1: 웹페이지에 QR코드 임베드하기

만약 HTML 페이지 안에 QR코드 이미지를 표시하고 싶다면, 위 `qr_code_generator.php` 파일을 별도로 두고, HTML 페이지에서는 `<img>` 태그의 `src` 속성에 해당 PHP 파일의 경로를 넣어주세요.

`index.html` (또는 `index.php` 등)

<!DOCTYPE html>
<html lang="ko">
<head>
    <meta charset="UTF-8">
    <title>PHP QR 코드 예시</title>
</head>
<body>
    <h1>QR 코드 스캔해 보세요!</h1>
    <p>아래 QR 코드를 스캔하면 특정 웹페이지로 이동합니다.</p>

    <img src="qr_code_generator.php" alt="웹사이트 QR 코드" style="width:250px; height:250px; border:1px solid #ddd;">

    <h2>결제 QR 코드 예시</h2>
    <p>결제 정보가 담긴 QR 코드를 스캔하세요.</p>
    <img src="qr_code_generator_payment.php" alt="결제 QR 코드" style="width:250px; height:250px; border:1px solid #ddd;">

</body>
</html>

이때, `qr_code_generator.php` 내부의 `$data` 변수는 쿼리 파라미터를 통해 동적으로 전달받을 수 있도록 수정하는 것이 좋습니다. 예를 들어:

`qr_code_generator.php` (수정 버전)

<?php
    include 'libs/phpqrcode/qrlib.php';

    $data = $_GET['text'] ?? 'Default QR Code Text'; // GET 파라미터 'text'로 데이터 받기
    $errorCorrectionLevel = 'L';
    $matrixPointSize = 4;

    header('Content-Type: image/png');
    QRcode::png($data, false, $errorCorrectionLevel, $matrixPointSize, 2);
?>

그리고 HTML에서 다음과 같이 호출합니다.

<img src="qr_code_generator.php?text=https%3A%2F%2Fyourdomain.com%2Fproduct%2F123" alt="상품 QR 코드">

이렇게 하면 하나의 QR코드 생성 스크립트로 다양한 내용의 QR코드를 동적으로 만들 수 있습니다.

예시 2: 결제용 QR코드 생성 (가상)

이전 '쇼핑몰 결제용 QR코드 구현' 글에서 다루었던 결제 요청 URL을 QR코드로 만드는 PHP 스크립트입니다.

`qr_code_generator_payment.php`

<?php
    include 'libs/phpqrcode/qrlib.php';

    // --- 1. 결제 데이터 준비 (실제 서비스에서는 보안 강화 필수) ---
    $orderId = $_GET['order_id'] ?? "TEST_ORDER_001";
    $amount = $_GET['amount'] ?? 10000;
    $productName = $_GET['product_name'] ?? "테스트 상품";
    $callbackUrl = "http://yourdomain.com/payment_callback.php?order_id=" . urlencode($orderId);

    // --- 2. 가상의 결제 PG사 요청 URL 생성 ---
    $paymentRequestUrl = "https://example-payment-gateway.com/pay?";
    $paymentRequestUrl .= "order_id=" . urlencode($orderId);
    $paymentRequestUrl .= "&amount=" . urlencode($amount);
    $paymentRequestUrl .= "&product_name=" . urlencode($productName);
    $paymentRequestUrl .= "&callback_url=" . urlencode($callbackUrl);

    $data = $paymentRequestUrl;

    // --- 3. QR 코드 생성 및 출력 ---
    $errorCorrectionLevel = 'H'; // 결제는 에러 복구 레벨을 높게 설정하는 것이 좋습니다.
    $matrixPointSize = 6;

    header('Content-Type: image/png');
    QRcode::png($data, false, $errorCorrectionLevel, $matrixPointSize, 2);
?>

그리고 HTML 페이지에서 다음과 같이 호출하여 결제 **QR코드**를 표시할 수 있습니다.

<img src="qr_code_generator_payment.php?order_id=ORD_ABC_123&amount=25000&product_name=고급커피" alt="결제 QR 코드">

주의사항 및 추가 고려 사항

보안: 중요한 정보(특히 결제 관련 데이터)를 QR코드에 담을 때는 반드시 **보안을 최우선**으로 고려해야 합니다. 직접적인 민감 정보를 **QR코드**에 넣기보다는, 해당 정보로 접근할 수 있는 **고유하고 한시적인 토큰화된 URL**을 **QR코드**에 담는 것이 안전합니다.
파일로 저장 vs. 직접 출력: QR코드 이미지를 자주 재생성해야 하거나 대량으로 생성해야 한다면 파일로 저장하여 사용하는 것이 서버 자원을 절약하고 성능에 유리할 수 있습니다. 한두 개 정도 동적으로 표시하는 경우에는 직접 출력하는 방식도 무방합니다.
캐싱: 동일한 내용을 가진 **QR코드**를 여러 번 요청할 경우, 웹 서버(Nginx, Apache) 설정에서 **QR코드 이미지**를 캐싱하도록 설정하면 서버 부하를 줄일 수 있습니다.
에러 복구 레벨: QR코드는 일부가 손상되어도 정보를 읽을 수 있는 **에러 복구 기능**이 있습니다. `QRcode::png()` 함수의 두 번째 인자 `errorCorrectionLevel`을 'L', 'M', 'Q', 'H' 중에서 선택할 수 있습니다. 'H'로 갈수록 복구율이 높지만, 정보 밀도가 낮아지거나 이미지 크기가 커질 수 있습니다.

결론: PHP QR코드 생성, 이제 여러분도 할 수 있어요! 💖

오늘 이 가이드와 함께 **`phpqrcode` 라이브러리**를 사용하여 **PHP** 환경에서 QR코드를 생성하는 방법을 알아보았습니다. 라이브러리 설치부터 실제 **PHP 소스 코드** 예시까지, 이제 여러분은 웹사이트에 QR코드를 손쉽게 추가할 수 있을 거예요. 🚀

QR코드는 단순한 이미지 이상의 강력한 도구입니다. 이 기능을 활용하여 여러분의 서비스에 편리함과 효율성을 더해보세요. 결제, 정보 공유, 이벤트 등 무궁무진한 방식으로 응용할 수 있습니다. 궁금한 점이 있다면 언제든지 다시 찾아주세요! 여러분의 성공적인 **PHP 웹 개발**을 항상 응원하겠습니다! 😊

자주 묻는 질문 (FAQ)

Q1: `phpqrcode` 대신 다른 PHP QR코드 라이브러리도 있나요?

A1: 네, 물론입니다. Composer를 통해 쉽게 설치할 수 있는 `bacon/bacon-qr-code`와 같은 라이브러리도 있습니다. `phpqrcode`가 비교적 가볍고 사용법이 직관적이어서 많이 사용되지만, 프로젝트 요구사항에 따라 더 유연한 기능을 제공하는 라이브러리를 검토해볼 수 있습니다.

Q2: QR코드 색상을 바꾸거나 로고를 넣을 수 있나요?

A2: **`phpqrcode`** 라이브러리는 기본적으로 흑백 **QR코드**를 생성합니다. 색상 변경이나 로고 삽입을 위해서는 생성된 **QR코드 이미지**를 **PHP GD 라이브러리** 함수를 사용하거나 다른 이미지 처리 라이브러리를 통해 후처리해야 합니다. 또는 **QR코드 생성**을 위한 전문적인 외부 API 중 이러한 커스터마이징 옵션을 제공하는 서비스를 이용하는 방법도 있습니다.

Q3: 생성된 QR코드가 너무 작아서 스캔이 잘 안 돼요.

A3: `QRcode::png()` 함수의 세 번째 인자인 `matrixPointSize` 값을 늘려보세요. 이 값은 **QR코드**의 한 '점(모듈)'의 크기를 픽셀 단위로 조절합니다. 숫자가 클수록 **QR코드 이미지**가 커지고, 섬세하게 표현되어 스캔률이 높아집니다. 또한, 주변 여백(border)도 적절히 조절해야 스캔 오류를 줄일 수 있습니다.

Q4: QR코드에 한글을 넣으려면 어떻게 해야 하나요?

A4: QR코드는 기본적으로 텍스트 인코딩을 UTF-8로 처리합니다. PHP 코드에서 `$data` 변수에 한글 문자열을 직접 할당하면 대부분의 경우 문제없이 **QR코드**가 생성됩니다. 혹시 문제가 발생한다면, **PHP** 스크립트 파일 자체가 UTF-8로 저장되어 있는지 확인하고, 필요 시 `urlencode()` 함수를 사용하여 데이터를 한 번 더 인코딩해볼 수 있습니다.

Q5: PHP QR코드 생성이 너무 느려요. 서버 성능 문제가 있을까요?

A5: **QR코드 생성**은 CPU 자원을 사용하는 이미지 처리 과정이므로, 한 번에 많은 수의 **QR코드**를 생성하거나 동시 접속자 수가 많을 경우 서버 부하를 유발할 수 있습니다. 해결책으로는

자주 사용되는 **QR코드**는 미리 생성하여 파일로 저장하고 캐싱합니다.
이미지 생성 시 `matrixPointSize`나 `errorCorrectionLevel`을 너무 높게 설정하지 않도록 합니다.
서버에 **PHP** GD 라이브러리가 최적화되어 있는지 확인하고, 필요 시 서버 성능을 업그레이드합니다.
대량 생성 시에는 백그라운드 프로세스로 처리하는 것을 고려해볼 수 있습니다.

'PHP' 카테고리의 다른 글

클라우드, Nextcloud! 🚀 Docker로 10분 만에 초고속 설치 가이드 (0)	2025.11.22
Composer 윈도우 설치부터 환경변수 세팅까지⏱️5분 컷! 완벽 가이드 (0)	2025.11.22
PHP QR코드, 이젠 Composer로 끝! ✨ Endroid/qr-code로 만드는 세련된 QR코드 생성 가이드 (1)	2025.11.22
PHP 5.6은 이제 그만! 😱 PHP 7.4 마이그레이션, 호환성 지옥 탈출 완벽 가이드 (0)	2025.11.21

**phpqrcode 라이브러리** 소개 및 준비물

준비물

**`phpqrcode`** 라이브러리 설치

**PHP QR코드 생성** 기본 소스 코드 (복사해서 쓰세요!)

**PHP QR코드 생성** 활용 예시