PHPINFO

PHP 에러 핸들링 완벽 가이드: 효과적인 오류 처리 방법

PHPINFO — Thu, 6 Mar 2025 21:31:56 +0900

안녕하세요! 오늘은 PHP 개발에서 필수적인 '에러 핸들링'에 대해 쉽고 자세하게 알아보겠습니다. 웹 개발을 하다 보면 예상치 못한 오류가 발생하기 마련인데요, 이러한 오류를 어떻게 처리하느냐에 따라 사용자 경험과 애플리케이션 안정성이 크게 달라집니다.

1. 에러 핸들링, 왜 중요할까요?

사용자 경험 향상: 친절한 오류 메시지로 사용자의 혼란을 줄이고, 문제 해결을 도울 수 있습니다.
애플리케이션 안정성 확보: 오류 발생 시 프로그램이 멈추는 것을 방지하고, 지속적인 서비스 제공을 가능하게 합니다.
디버깅 효율성 증대: 오류 원인을 빠르게 파악하고 수정하여 개발 시간을 단축할 수 있습니다.
보안 강화: 민감한 정보가 노출되는 것을 방지하고, 악의적인 공격을 차단할 수 있습니다.

2. PHP 에러 종류와 처리 방법

PHP에는 다양한 종류의 에러가 있으며, 각각 다른 방식으로 처리해야 합니다.

구문 에러 (Syntax Errors):
- 코드 작성 시 문법 규칙을 어겼을 때 발생합니다.
- 예시: 세미콜론 누락, 괄호 불일치 등
- 처리 방법: 에러 메시지를 확인하고 문법 오류를 수정합니다.
경고 (Warnings):
- 프로그램 실행에는 문제가 없지만, 잠재적인 오류 가능성을 나타냅니다.
- 예시: 정의되지 않은 변수 사용, 잘못된 함수 인자 전달 등
- 처리 방법: 경고 메시지를 확인하고 코드 수정을 고려합니다.
치명적 에러 (Fatal Errors):
- 프로그램 실행을 중단시키는 심각한 오류입니다.
- 예시: 정의되지 않은 함수 호출, 메모리 부족 등
- 처리 방법: 예외 처리 또는 오류 로깅을 통해 원인을 파악하고 수정합니다.
예외 (Exceptions):
- 프로그램 실행 중 발생하는 예외적인 상황을 나타냅니다.
- try...catch 구문을 사용하여 예외처리.

3. try...catch 구문으로 예외 처리하기

예외 처리는 try...catch 구문을 사용하여 이루어집니다.

try {
    // 예외가 발생할 수 있는 코드
    $result = 10 / 0; // 0으로 나누는 오류 발생
    echo $result;
} catch (Exception $e) {
    // 예외 발생 시 실행되는 코드
    echo "오류가 발생했습니다: " . $e->getMessage();
}

try 블록: 예외가 발생할 가능성이 있는 코드를 작성합니다.
catch 블록: try 블록에서 예외가 발생했을 때 실행되는 코드를 작성합니다.
$e->getMessage(): 발생한 예외 메시지를 가져오는 메서드입니다.

4. 사용자 정의 에러 핸들러

set_error_handler() 함수를 사용하여 사용자 정의 에러 핸들러를 설정할 수 있습니다.

function customErrorHandler($errno, $errstr, $errfile, $errline) {
    echo "<b>오류:</b> [$errno] $errstr<br>";
    echo "파일: $errfile<br>";
    echo "라인: $errline<br>";
    return true; // 기본 에러 핸들러 실행 방지
}

set_error_handler("customErrorHandler");

// 의도적으로 오류 발생
echo $undefinedVariable;

5. 오류 로깅

오류를 파일이나 데이터베이스에 기록하여 추후 분석 및 디버깅에 활용할 수 있습니다.

error_log("오류 발생: " . $e->getMessage(), 3, "/path/to/error.log");

첫 번째 인자: 오류 메시지
두 번째 인자: 오류 로그 유형 (3은 파일 로깅)
세 번째 인자: 오류 로그 파일 경로

6. 효과적인 에러 핸들링을 위한 팁

구체적인 오류 메시지를 제공하여 사용자가 문제를 이해하고 해결하도록 돕습니다.
오류 로깅을 통해 오류 발생 시점을 추적하고 원인을 분석합니다.
예외 처리를 사용하여 프로그램의 안정성을 높입니다.
개발환경에서는 오류를 화면에 표시하여 디버깅을 용이하게 하고 운영환경에서는 로그파일에 기록하는것이 좋습니다.
오류 처리 코드를 재사용하여 효율성을 높입니다.

이 가이드를 통해 PHP 에러 핸들링에 대한 이해를 높이고, 더 안정적인 웹 애플리케이션을 개발하는 데 도움이 되기를 바랍니다.

WSL2를 사용하여 Node.js 개발 환경 설치

PHPINFO — Wed, 2 Dec 2020 02:01:43 +0900

WSL2 설치

WSL은 Windows Subsystem for Linux의 약자로 윈도우 환경에서 가상머신 없이 리눅스 배포판 버전을 설치하여 운영할 수 있습니다.

현재 Windows 10 환경에 Ubuntu 20.04 LTS 를 설치한 상태입니다. 설치 과정은 여기에서는 생략하겠습니다.

nvm, node.js 및 npm 설치

node.js 는 버전이 빠르게 바뀌기 때문에 버전 관리자를 사용하는 것이 좋습니다.

프로젝트를 여러개 진행한다면 여러 버전 간 전환해서 사용해야 하는 경우도 있는데, nvm (Node Version Manager)을 이용해 여러 버전의 Node.js 를 설치할 수 있습니다. 그리고 npm (Node Pacackage Manager)은 이름 그대로 노드 패키지 관리자로 여러 모듈들을 관리하기 위한 용도로 사용합니다.

# cURL 설치
sudo apt install curl 

# nvm 설치
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash

# 참고, 설치 후 아래 커맨드로 확인이 안될 경우, 터미널을 닫고 다시 열면 됩니다.

# nvm 버전 확인
nvm --version

# 현재 설치된 노드 버전 나열
nvm ls

# 최신 Node.js 릴리스 설치
nvm install node

# 최신 Node.js LTS 설치 (권장)
nvm install node --lts

# 설치된 노드 버전 확인
nvm ls

# 참고 
node --version 명령을 사용하여 Node.js가 설치되어 있는지 여부 및 현재 기본 버전을 확인합니다. 
그리고 npm --version 명령을 사용하여 npm이 설치되어 있는지 확인합니다
(which node 또는 which npm 명령을 사용하여 기본 버전에 사용되는 경로도 확인 가능).

프로젝트에 사용할 Node.js 버전을 변경하려면 
새 프로젝트 디렉터리 mkdir NodeTest를 만들고 
cd NodeTest 디렉터리로 들어간 다음, 
nvm use node를 입력하여 현재 버전으로 전환하거나 
nvm use --lts를 입력하여 LTS 버전으로 전환합니다. 
nvm use v8.2.1처럼 설치한 버전의 특정 번호를 사용할 수도 있습니다. 
(사용 가능한 모든 Node.js 버전을 나열하려면 nvm ls-remote 명령을 사용합니다.)

VS Code (Visual Studio Code) 및 원격 WSL 확장 설치

먼저 VS Code 부터 설치합니다.

code.visualstudio.com/

Visual Studio Code - Code Editing. Redefined

Visual Studio Code is a code editor redefined and optimized for building and debugging modern web and cloud applications. Visual Studio Code is free and available on your favorite platform - Linux, macOS, and Windows.

code.visualstudio.com

Visual Studio Code 공식 사이트에서 윈도우 버전을 다운로드하여 설치합니다.

그리고, Remote - WSL 확장을 VS Code에 설치합니다.

이를 통해 WSL을 통합 개발 환경으로 사용하고, 호환성과 패치를 처리할 수 있습니다.

VS Code에서 확장 창을 열고 (Ctrl+Shift+X), Remode - WSL 을 검색하여 설치 가능합니다.

아래와 같이 LOCAL 과 WSL: UBUNTU-20.04 세션으로 구분된 것을 확인 할 수 있습니다.

여기까지 간단히 WSL2 우분투 20.04 에 Node.js 개발환경 설치를 진행했습니다.

다음 포스팅은 이 개발환경에서 간단한 웹프레임워크를 진행하는 방법을 소개해보도록 하겠습니다.

윈도우 터미널 개선 - hyper 설치

PHPINFO — Wed, 2 Dec 2020 00:39:02 +0900

Hyper ?

Hyper은 일렉트론 기반의 터미널 프로그램으로 확장성이 뛰어나고 다양한 테마 및 플러그인 설치가 가능합니다.

다운로드 및 설치

hyper.is/

Hyper™

A terminal built on web technologies

hyper.is

설치 후 간단한 설정

ctrl + ,실행 후 shell, plugins 설정 예

shell: 'C:\\Windows\\System32\\bash.exe'

plugins: [
  "hyper-material-theme"
],

설정 후 hyper를 다시 실행해 보면, 적용된다.

일단, hyper 설치 후 간단한 설정 정도 진행했고, 사용해보면서 여러가지 적용해 볼 예정입니다.

PHP 몫과 나머지 구하기

PHPINFO — Tue, 26 May 2020 21:10:58 +0900

PHP에서 몫과 나머지를 구하는 몇 가지 방법을 소개합니다.

$b를 $a로 나누었을 때의 몫과 나머지

<?php
# $b를 $a로 나누었을 때의 몫과 나머지 구하기

//몫 구하는 방법 1
$quotient = ($b - ($b % $a)) / $a; 

//몫 구하는 방법 2
$quotient = sprintf('%d', $b / $a);

// 나머지 구하는 방법
$remainder = $b % $a;

함수로 간단히 몫과 나머지 구하는 예제

<?php
function getQuotientAndRemainder($divisor, $dividend) {
    $quotient = (int)($divisor / $dividend);
    $remainder = $divisor % $dividend;
    return array( $quotient, $remainder );
}

list($quotient, $remainder) = getQuotientAndRemainder(10, 3);

참고

How to find remainder and quotient in php?

몫과 나머지 영어로

몫 : quotient

나머지 : remainder

PHP - 실제 클라이언트 IP주소 가져오기

PHPINFO — Tue, 24 Oct 2017 23:44:58 +0900

PHP개발을 하다보면, 부정사용을 방지하는 목적 등을 위해 사용자의 IP를 체크하는 경우가 있습니다.

보통 아래와 같이 사용하게 된다.

<?php

$ip = $_SERVER['REMOTE_ADDR'];

하지만 경우에 따라서는 사용자의 IP주소를 올바르게 가져오지 못하는 경우가 있는데요, 예를 들면 사용자가 프록시 서버를 경유해 특정 웹사이트로 접근하면 프록시 서버에 의해 사용자의 실제 IP주소를 숨길 수 있기 때문입니다.

그런데 이러한 경우에도, 다른 방법을 통해 실제 사용자의 IP주소를 알아낼 수 있습니다.

웹사이트에 접근할 때, 여러 가지 헤더정보를 넘겨 주게 되는데, 거기에 원래(실제) 사용자의 IP주소도 같이 넘겨 받게 됩니다. 그 메소드가 "X-Forwarded-For"이고, PHP에서는 "HTTP_X_FORWARDED_FOR" 변수에 저장됩니다.

그러므로 HTTP_X_FORWARDED_FOR 변수로 비교 체크하여 불량IP주소를 어느정도 걸러낼 수 있습니다.

PHP 환경변수값을 불러오는 getenv() 를 이용하는 방법

<?php

function getRealClientIp() {
    $ipaddress = '';
    if (getenv('HTTP_CLIENT_IP')) {
        $ipaddress = getenv('HTTP_CLIENT_IP');
    } else if(getenv('HTTP_X_FORWARDED_FOR')) {
        $ipaddress = getenv('HTTP_X_FORWARDED_FOR');
    } else if(getenv('HTTP_X_FORWARDED')) {
        $ipaddress = getenv('HTTP_X_FORWARDED');
    } else if(getenv('HTTP_FORWARDED_FOR')) {
        $ipaddress = getenv('HTTP_FORWARDED_FOR');
    } else if(getenv('HTTP_FORWARDED')) {
        $ipaddress = getenv('HTTP_FORWARDED');
    } else if(getenv('REMOTE_ADDR')) {
        $ipaddress = getenv('REMOTE_ADDR');
    } else {
        $ipaddress = '알수없음';
    }
    return $ipaddress;
}

웹서버(아파치, nginx 등)를 통해 생성된 값들을 가지고 있는 $_SERVER 배열 변수를 이용하는 방법

<?php

function getRealClientIp() {
    $ipaddress = '';
    if ($_SERVER['HTTP_CLIENT_IP']) {
        $ipaddress = $_SERVER['HTTP_CLIENT_IP'];
    } else if($_SERVER['HTTP_X_FORWARDED_FOR']) {
        $ipaddress = $_SERVER['HTTP_X_FORWARDED_FOR'];
    } else if($_SERVER['HTTP_X_FORWARDED']) {
        $ipaddress = $_SERVER['HTTP_X_FORWARDED'];
    } else if($_SERVER['HTTP_FORWARDED_FOR']) {
        $ipaddress = $_SERVER['HTTP_FORWARDED_FOR'];
    } else if($_SERVER['HTTP_FORWARDED']) {
        $ipaddress = $_SERVER['HTTP_FORWARDED'];
    } else if($_SERVER['REMOTE_ADDR']) {
        $ipaddress = $_SERVER['REMOTE_ADDR'];
    } else {
        $ipaddress = '알수없음';
    }
    return $ipaddress;
}

참고 : HTTP_X_FORWARDED_FOR 는 때로는 내부IP주소 또는 로컬IP주소를 표시하는 경우가 있고, 여러 IP주소일 경우에는 콤마(,)로 구분되어 표시됩니다.

array_map 함수

PHPINFO — Wed, 22 Jun 2016 11:07:28 +0900

PHP 에서 DB관련 작업을 진행할 때, mysql_real_escape_string 처리를 해야하는 경우가 있다.

아래와 같이 요소 하나하나

escape 처리를 할 수 있다.

<?php
$id = mysql_escape_string($array['id']);
$address = mysql_escape_string($array['address']);

배열 항목이 몇 개 아니면 상관없지만, 많다면 배열 항목 모두를 mysql_real_escape_string 하려면 여간 귀찮은 일이 아닐 수 없다.

하지만, PHP 함수 중, array_may 함수를 이용하면 한꺼번에 처리 가능하다.
아래와 같이 처리하면 된다 ^^

<?php
$array = array_map('mysql_escape_string', $array);

PHP 매뉴얼 : array_map

PHP 문자열 배열로 변환, 배열을 문자열로 변환

PHPINFO — Tue, 21 Jun 2016 15:49:43 +0900

PHP 개발을 하다 보면 문자열을 배열로 변환하거나, 또는 배열을 문자열로 변환해서 처리하는 경우가 있습니다.

PHP 문자열 배열로 변환, 배열을 문자열로 변환 예시

아래의 몇 가지 예시를 통해 PHP 문자열을 배열로 변환하는 방법, PHP배열을 문자열로 변환하는 방법에 대해서 알아보겠습니다.

예 1) 문자열을 배열로 변환

<?php
$str = 'apple,mango,tomato,banana';
$str_arr = explode(',', $str);

echo '<pre>';
var_dump($str_arr);
echo '</pre>';

[결과] 아래와 같이 배열로 성공적으로 변환된 것을 볼 수 있습니다.

array(4) {
  [0]=>
  string(5) "apple"
  [1]=>
  string(5) "mango"
  [2]=>
  string(6) "tomato"
  [3]=>
  string(6) "banana"
}

예 2) 공백(스페이스)을 포함하는 문자열을 배열로 변환

<?php
$str = 'apple, mango, tomato,   banana';
$str_arr = explode(',', $str);

echo '<pre>';
var_dump($str_arr);
echo '</pre>';

[결과] 아래와 같이 배열로 성공적으로 변환되었지만, 각 요소들을 보면 공백(스페이스) 그대로 포함되어 있습니다.

array(4) {
  [0]=>
  string(5) "apple"
  [1]=>
  string(6) " mango"
  [2]=>
  string(7) " tomato"
  [3]=>
  string(9) "   banana"
}

예 3) 앞뒤 콤마를 포함하는 문자열을 배열로 변환

<?php
$str = ',apple, mango, tomato,   banana,';
$str_arr = explode(',', $str);

echo '<pre>';
var_dump($str_arr);
echo '</pre>';

[결과] 아래와 같이 배열로 성공적으로 변환되었지만, 배열 첫 번째 요소와 마지막 요소에 빈 값이 들어가 있다.

array(6) {
  [0]=>
  string(0) ""
  [1]=>
  string(5) "apple"
  [2]=>
  string(6) " mango"
  [3]=>
  string(7) " tomato"
  [4]=>
  string(9) "   banana"
  [5]=>
  string(0) ""
}

예 4) 문자열에서 공백 및 앞뒤 콤마(,)를 제거하여 배열로 변환

<?php
$str = ',apple, mango, tomato,   banana,';
$str = trim($str); // 문자열 앞 뒤 공백 제거
$str = ltrim($str,','); // 문자열 맨 앞 콤마(,) 제거
$str = rtrim($str,','); // 문자열 맨 마지막 콤마(,) 제거
$str = str_replace(array("\r\n","\r","\n"),'',$str); // 개행문자 제거
$str_arr = array_map('trim', explode(',', $str)); //문자열을 배열로 변환 & 각 배열요소 트림(trim) 처리

echo '<pre>';
var_dump($str_arr);
echo '</pre>';

[결과] 아래와 같이 배열로 성공적으로 변환되었습니다.

array(4) {
  [0]=>
  string(5) "apple"
  [1]=>
  string(5) "mango"
  [2]=>
  string(6) "tomato"
  [3]=>
  string(6) "banana"
}

배열을 문자열로 변환하는 것은 예 4)에서 처리된 배열을 implode 함수를 이용해서 처리하면 됩니다.

<?php
$str = ',apple, mango, tomato,   banana,';
$str = trim($str); // 문자열 앞 뒤 공백 제거
$str = ltrim($str,','); // 문자열 맨 앞 콤마(,) 제거
$str = rtrim($str,','); // 문자열 맨 마지막 콤마(,) 제거
$str = str_replace(array("\r\n","\r","\n"),'',$str); // 개행문자 제거
$str_arr = array_map('trim', explode(',', $str)); //문자열을 배열로 변환 & 각 배열요소 트림(trim) 처리

// echo '<pre>';
// var_dump($str_arr);
// echo '</pre>';

$str = implode(',', $str_arr);
var_dump($str);

[결과] 아래와 같이 문자열로 성공적으로 변환되었다.

string(25) "apple,mango,tomato,banana"

경우에 따라서는 예 2) 예 3) 도 필요한 경우가 있지만, 예 4)처럼 공백 및 앞 뒤의 콤마를 제거하여 배열로 변환하는 처리가 더 필요할 것 같아서 정리해봤습니다.

include, require, include_once, require_once 비교 차이점

PHPINFO — Thu, 16 Jun 2016 15:07:28 +0900

include와 require 그리고 include_once, require_once 는 기본적으로 파일을 불러올 때 쓰는 함수입니다.

include와 require는 수행 실패를 다루는 방법을 제외하고 완전히 동일합니다. 둘 모두 Warning을 발생시키지만, require는 Fatal Error가 나타납니다. 즉, 파일이 없을 때 페이지 처리를 멈추고 싶으면 require를 사용하면 됩니다. include는 멈추지 않고 스크립트가 계속 실행됩니다.

require는 실패시에 치명적인 E_ERROR 등급 오류가 발생한다는 점을 제외하면, include와 동일합니다. 즉, include가 경고(E_WARNING)만 발생하고 스크립트는 계속 진행되는 것과 달리, 스크립트가 중단됩니다.

쓰는 방법은 아래와 같습니다.

include "파일";

require "파일";

또는

include ("파일");

require ("파일");

include_once, require_once 는 기본적인 동작은 include, require 와 동일하고, 해당 파일을 오직 한번만 불러오기 위한 옵션이라고 생각하시면 됩니다.

따라서 아래와 같이 여러번 호출하여도 한번만 인클루드 되도록 처리됩니다.

include_once "inc.php";

require_once "inc.php";

파일을 불러오는 함수에 대해서 알아보았는데, 경우에 따라 적절한 함수를 쓰면 되겠죠? ^^

phpinfo()

PHPINFO — Sun, 15 Sep 2013 04:19:37 +0900

phpinfo - PHP의 설정정보를 출력해줍니다.

bool phpinfo ([ int $what = INFO_ALL ] )

현재 PHP 상태에 관련된, 다양한 정보를 출력합니다. 출력되는 정보에는 PHP컴파일 옵션과 확장기능, PHP버전, 서버정보 및 환경, PHP의 환경, OS버전정보, 경로(PATH), 구성옵션, 구성옵션의 마스터값(Master Value), 로컬값(Local Value), HTTP헤더, PHP라이센스 등의 정보가 있습니다.

또한 phpinfo()에는 EGPCS (Environment, GET, POST, Cookie, Server)의 정보가 포함되어 있어서, 디버그툴로도 유용합니다.

간단히 아래와 같이 phpinfo.php 파일을 작성하여, 브라우저에서 호출하면, 정보를 확인 가능합니다.

// Show all information, defaults to INFO_ALL
phpinfo();

// Show just the module information.
// phpinfo(8) yields identical results.
phpinfo(INFO_MODULES);


참조> https://secure.php.net/manual/kr/function.phpinfo.php

PHP란?

PHPINFO — Fri, 13 Sep 2013 23:02:02 +0900

PHP란 무엇일까요?

PHP는 재귀 약자^[각주:1](recursive acronym)로 PHP: Hypertext Preprocessor 를 의미합니다.

널리 사용되고 있는 오픈소스 범용스크립트 언어입니다.

PHP는 특히 웹개발에 적합하여, HTML에 포함하는 것이 가능합니다.

참고로, 대표적인 재귀 약자의 몇가지 예입니다.

GNU - GNU is Not Unix

LAME - LAME Ain't an MP3 Encoder

YAML - YAML Ain't Markup Language

WINE - Wine Is Not an Emulator

참고> 위키백과

기초적인 PHP의 예시입니다.

<html>
    <head>
        <title>Example</title>
    </head>
    <body>
        <?php
            echo "Hi, I'm a PHP script!";
        ?>
     </body>
</html>

원래 문장 안에 약자가 그대로 들어 있도록 이름을 지은 것이다. [본문으로]