CodeIgniter User Guide Version 2.1.0


입력클래스 Input Class

입력클래스는 두가지 목적으로 사용됩니다:

  1. 보안을 위해서 전역(global) 입력 데이터를 전처리 합니다.
  2. 입력클래스는 입력데이터를 가져오거나, 가져온 데이터를 전처리하는 헬퍼함수를 제공합니다.

참고: 이 클래스는 시스템에 의해 자동으로 초기화 되므로 여러분이 초기화 하실 필요가 없습니다.

보안 필터링 Security Filtering

컨트롤러가 호출되면 보안필터링 함수는 자동으로 호출됩니다. 필터링은 다음 작업을 수행합니다:

XSS Filtering

입력 클래스는 크로스 사이트 스크립팅 공격을 방지하기 위해 자동으로 입력 값을 필터링하는 기능이 있습니다.application/config/config.php 파일을 다음과 같이 설정하여 POST 또는 COOKIE 데이터를 처리할 때 자동으로 필터를 실행할 수 있습니다 :

$config['global_xss_filtering'] = TRUE;

응용 프로그램에서 XSS 필터링을 사용하는 방법은 보안클래스를 참조하십시오.

POST, COOKIE, 혹은 SERVER 데이터 사용하기

CodeIgniter는 POST, COOKIE 혹은 SERVER 아이템을 가져오기 위해서 3가지 헬퍼함수를 제공합니다. 각 아이템들을 직접가져오는것보다($_POST['something']) 헬퍼를 사용하면 더 좋은 이유는 ,헬퍼가 아이템이 세팅되어있는지를 먼저체크하고 세팅되어있지않다면 false 를 반환하기 때문입니다. 아이템이 존재하는지 먼저 검사하고 처리할 필요가 없어집니다. 다시말하면 , 일반적으로 여러분안 아래와 같이 프로그램할 것입니다.:

if ( ! isset($_POST['something']))
{
    $something = FALSE;
}
else
{
    $something = $_POST['something'];
}

CodeIgniter 에서는 아래와 같이 간단하게 위의 기능을 수행할 수 있는것이죠:

$something = $this->input->post('something');

세가지함수는 아래와 같습니다:

$this->input->post()

첫번째 파라미터는 POST 아이템의 이름(name)이 들어갑니다:

$this->input->post('some_data');

찾고자하는 아이템이 존재하지않으면 함수는 FALSE 를 리턴합니다.

선택적으로 사용하는 두번째 파라미터는 데이터를 XSS 필터링 되게 합니다. 두번재 파라미터를 TRUE로 하시면 됩니다;

$this->input->post('some_data', TRUE);

파라미터를 지정하지 않고 호출하면 POST로 넘어오는 모든 값을 연관 배열로 리턴합니다.

첫 번째 파라미터를 NULL로 하고, 두번째 인수에 부울(boolean)값을 넘겨주면,부울값에 따라모든 POST값에 XSS필터를 적용하거나,하지 않을 수 있습니다.

POST입력값이 없으면 FALSE를 리턴합니다.

$this->input->post(NULL, TRUE); // returns all POST items with XSS filter
$this->input->post(); // returns all POST items without XSS filter

$this->input->get()

이함수는 get 데이터를 가져온다는 점만 빼면 post 함수와 동일합니다:

$this->input->get('some_data', TRUE);

파라미터를 지정하지 않고 호출하면 GET으로 넘어오는 모든 값을 연관 배열로 리턴합니다.

첫 번째 파라미터를 NULL로 하고, 두번째 인수에 부울(boolean)값을 넘겨주면,부울값에 따라모든 GET값에 XSS필터를 적용하거나,하지 않을 수 있습니다.

GET입력값이 없으면 FALSE를 리턴합니다.

$this->input->get(NULL, TRUE); // returns all GET items with XSS filter
$this->input->get(); // returns all GET items without XSS filtering

$this->input->get_post()

이함수는 post 와 get 을 모두 뒤져서 데이터를 가져옵니다 . post를 먼저찾고 그다음 get 을 찾습니다:

$this->input->get_post('some_data', TRUE);

$this->input->cookie()

이함수는 쿠키에서 데이터를 가져온다는점을 배면 post 함수와 동일합니다:

$this->input->cookie('some_data', TRUE);

$this->input->server()

이함수는 server변수들 에서 데이터를 가져온다는점을 빼면 위 함수와 동일합니다:

$this->input->server('some_data');

$this->input->set_cookie()

쿠키를 생성합니다. 이 메서드를 이용해서 쿠키를 생성하는데는 두가지 방법이 있습니다. 하나는 배열을 넘겨주는것이고 다른 하나는 개별변수를 넘겨주는것입니다.

 

배열을 이용하는 방법

연관배열을 첫번째 파라미터로 넘겨주면 됩니다.:

$cookie = array(
    'name'   => 'The Cookie Name',
    'value'  => 'The Value',
    'expire' => '86500',
    'domain' => '.some-domain.com',
    'path'   => '/',
    'prefix' => 'myprefix_',
    'secure' => TRUE
);

$this->input->set_cookie($cookie);

주의:

이름(name)과 값(value) 만을 사용해야 합니다. 쿠키를 삭제하려면 만료시간(expire)에 공백을 넣습니다.

만료시간은 단위이며, 현재시간 + 지정한 만료시간으로 설정될 것입니다.개발자는 현재시간을 고려할 필요없이 지금으로 부터 몇초후에 쿠키가 만료될지만 지정하시면 됩니다 .만료시간을 0으로 하면 브라우저가 열려있는동안에만 쿠키가 살아있습니다.

사이트 요청방법에 상관없이 전체 사이트에 적용할 쿠키는 domain 항목에 점으로 시작하는 사이트주소를 적으시면 됩니다

예: .your-domain.com

보통 패스(path)부분은 신경쓸 필요가 없습니다. 메서드가 루트패스를 알아서 설정합니다.

서버의 다른 쿠키와 이름이 같을 가능성이 있을 경우에만, 접두어(prefix)를 설정하세요.

보안 부울 값은 보안 쿠키를 사용하려는 경우에만 TRUE로해야합니다.

개별 매개 변수를 전달하는 방법

아래와 같이 각각 전달합니다:

$this->input->set_cookie($name, $value, $expire, $domain, $path, $prefix, $secure);

$this->input->cookie()

쿠키를 읽어옵니다. 첫번째 파라미터는 읽을 쿠키의 이름이며, 접두어가 있는경우 접두어도 같이 적어주세요:

cookie('some_cookie');

읽으려고하면 쿠키가 존재하지 않으면 FALSE (Boolean)을 리턴합니다.

옵션인 두번째 파라미터는 데이터에 XSS 필터링을 적용할지를 결정합니다. 두번째 파라미터가 TRUE일 경우 적용됩니다;

cookie('some_cookie', TRUE);

$this->input->ip_address()

현재사용자의 IP 주소를 리턴합니다. IP 주소가 유효하지 않다면 함수는 0.0.0.0 을 리턴합니다

echo $this->input->ip_address();

$this->input->valid_ip($ip)

IP 주소를 받아서 주소가 유효한지 아닌지에 따라서 TRUE 나 FALSE 를 리턴합니다. 참고: The $this->input->ip_address() 함수는 자동으로 ip 유효성을검사합니다.

if ( ! $this->input->valid_ip($ip))
{
     echo 'Not Valid';
}
else
{
     echo 'Valid';
}

$this->input->user_agent()

현재 사용자의 user agent (web browser) 를 리턴합니다. 유효한 값이 없을때는 FALSE 를 리턴합니다.

echo $this->input->user_agent();

See the User Agent Class for methods which extract information from the user agent string.

$this->input->request_headers()

Apache 이외 (apache_request_headers() 를 지원하지 않는) 환경에서 유용합니다. 헤더의 배열을 반환합니다.

$headers = $this->input->request_headers();

$this->input->get_request_header();

요청 헤더의 배열에서 지정한 요소를 반환합니다.

$this->input->get_request_header('some-header', TRUE);

$this->input->is_ajax_request()

서버 헤더에 HTTP_X_REQUESTED_WITH 가 설정되어 있는지 확인하고 결과를 부울(TRUE,FALSE)로 반환합니다.

 

$this->input->is_cli_request()

STDIN 상수​가 설정되어 있는지 확인합니다. PHP가 커맨드 라인에서 실행되고 있는지 확인하는 안전한 방법입니다.

 

$this->input->is_cli_request()