폼 헬퍼(Form Helper)

폼 헬퍼 파일은 폼 작업을 돕는 함수들을 포함하고 있습니다.

설정

v4.3.0부터 form_helper 함수의 void HTML 요소(예: <input>)는 기본적으로 HTML5 호환으로 변경되었습니다. XHTML과 호환되어야 하는 경우 app/Config/DocTypes.php의 $html5 속성을 false로 설정해야 합니다.

헬퍼 로드하기

이 헬퍼는 다음 코드를 사용하여 로드합니다:

<?php

helper('form');

필드 값 이스케이프(Escaping)

폼 요소 내에서 HTML 및 따옴표와 같은 문자를 사용해야 할 수 있습니다. 이를 안전하게 수행하려면 공통 함수인 esc() 를 사용해야 합니다.

다음 예제를 고려해 보십시오:

<?php

$string = 'Here is a string containing "quoted" text.';

?>

<input type="text" name="myfield" value="<?= $string ?>">

위의 문자열에는 따옴표 세트가 포함되어 있어 폼이 깨질 수 있습니다. esc() 함수는 HTML 특수 문자를 변환하여 안전하게 사용할 수 있도록 합니다:

<input type="text" name="myfield" value="<?= esc($string) ?>">

참고

이 페이지에 나열된 폼 헬퍼 함수를 사용하고 연관 배열로 값을 전달하면 폼 값은 자동으로 이스케이프 처리되므로 이 함수를 호출할 필요가 없습니다. 직접 폼 요소를 생성하여 문자열로 전달하는 경우에만 사용하십시오.

사용 가능한 함수

다음 함수들을 사용할 수 있습니다:

form_open([$action = ''[, $attributes = ''[, $hidden = []]]])

매개변수:

• $action (string) – 폼 action/target URI 문자열

• $attributes (mixed) – 배열 또는 이스케이프된 문자열 형태의 HTML 속성

• $hidden (array) – 숨김 필드 정의 배열

반환:

HTML 폼 여는 태그

반환 형식:

string

Config\App::$baseURL을 기반으로 구성된 사이트 URL로 폼 여는 태그를 생성합니다. 선택적으로 폼 속성과 숨김 입력 필드를 추가할 수 있으며, app/Config/App.php 설정 파일의 $charset 속성에 따라 accept-charset 속성은 항상 추가됩니다.

직접 HTML을 하드코딩하는 대신 이 태그를 사용하는 가장 큰 이점은 URL이 변경되더라도 사이트의 이식성을 높일 수 있다는 점입니다.

간단한 예제입니다:

<?php

echo form_open('email/send');

위의 예제는 사이트 URL에 “email/send” URI 세그먼트를 더한 주소를 가리키는 폼을 생성합니다. 예:

<form action="http://example.com/index.php/email/send" method="post" accept-charset="utf-8">

다음과 같이 {locale}도 추가할 수 있습니다:

<?php

echo form_open('{locale}/email/send');

위의 예제는 사이트 URL에 현재 요청 로케일과 “email/send” URI 세그먼트를 더한 주소를 가리키는 폼을 생성합니다. 예:

<form action="http://example.com/index.php/en/email/send" method="post" accept-charset="utf-8">

속성 추가하기

다음과 같이 두 번째 매개변수에 연관 배열을 전달하여 속성을 추가할 수 있습니다:

<?php

$attributes = ['class' => 'email', 'id' => 'myform'];
echo form_open('email/send', $attributes);

또는 두 번째 매개변수를 문자열로 지정할 수도 있습니다:

<?php

echo form_open('email/send', 'class="email" id="myform"');

위의 예제들은 다음과 유사한 폼을 생성합니다:

<form action="http://example.com/index.php/email/send" class="email" id="myform" method="post" accept-charset="utf-8">

CSRF 필터가 활성화되어 있으면 form_open()은 폼의 시작 부분에 CSRF 필드를 생성합니다. $attributes 배열의 요소로 csrf_id를 전달하여 이 필드의 ID를 지정할 수 있습니다:

<?php

echo form_open('/u/sign-up', ['csrf_id' => 'my-id']);

반환값:

<form action="http://example.com/index.php/u/sign-up" method="post" accept-charset="utf-8">
<input type="hidden" id="my-id" name="csrf_test_name" value="964ede6e0ae8a680f7b8eab69136717d">

참고

CSRF 필드 자동 생성을 사용하려면 app/Config/Filters.php 파일에서 CSRF 필터를 활성화해야 합니다. 대부분의 경우 폼 페이지는 GET 메서드로 요청됩니다. 일반적으로 CSRF 보호는 POST/PUT/DELETE/PATCH 요청에 필요하지만, GET 요청의 경우에도 폼을 표시하는 페이지에는 CSRF 필터가 활성화되어 있어야 합니다.

$globals로 CSRF 필터를 활성화하면 모든 요청 유형에 대해 활성화됩니다. 하지만 public array $methods = ['POST' => ['csrf']];로 CSRF 필터를 활성화하면 GET 요청에는 숨김 CSRF 필드가 추가되지 않습니다.

숨김 입력 필드 추가하기

다음과 같이 세 번째 매개변수에 연관 배열을 전달하여 숨김 필드를 추가할 수 있습니다:

<?php

$hidden = ['username' => 'Joe', 'member_id' => '234'];
echo form_open('email/send', '', $hidden);

두 번째 매개변수에 false 값을 전달하여 건너뛸 수 있습니다.

위의 예제는 다음과 유사한 폼을 생성합니다:

<form action="http://example.com/index.php/email/send" method="post" accept-charset="utf-8">
    <input type="hidden" name="username" value="Joe">
    <input type="hidden" name="member_id" value="234">

form_open_multipart([$action = ''[, $attributes = ''[, $hidden = []]]])

매개변수:

• $action (string) – 폼 action/target URI 문자열

• $attributes (mixed) – 배열 또는 이스케이프된 문자열 형태의 HTML 속성

• $hidden (array) – 숨김 필드 정의 배열

반환:

HTML 멀티파트 폼 여는 태그

반환 형식:

string

이 함수는 위의 form_open()과 동일하지만, 파일 업로드에 필요한 multipart 속성을 추가한다는 점이 다릅니다.

form_hidden($name[, $value = ''])

매개변수:

• $name (string) – 필드 이름

• $value (string) – 필드 값

반환:

HTML 숨김 입력 요소

반환 형식:

string

숨김 입력 필드를 생성할 수 있습니다. 이름/값 문자열을 전달하여 하나의 필드를 생성할 수 있습니다:

<?php

form_hidden('username', 'johndoe');
// Would produce: <input type="hidden" name="username" value="johndoe">

… 또는 연관 배열을 전달하여 여러 필드를 생성할 수 있습니다:

<?php

$data = [
    'name'  => 'John Doe',
    'email' => 'john@example.com',
    'url'   => 'http://example.com',
];

echo form_hidden($data);
/*
 * Would produce:
 * <input type="hidden" name="name" value="John Doe">
 * <input type="hidden" name="email" value="john@example.com">
 * <input type="hidden" name="url" value="http://example.com">
 */

값 필드에 연관 배열을 전달할 수도 있습니다:

<?php

$data = [
    'name'  => 'John Doe',
    'email' => 'john@example.com',
    'url'   => 'http://example.com',
];

echo form_hidden('my_array', $data);
/*
 * Would produce:
 * <input type="hidden" name="my_array[name]" value="John Doe">
 * <input type="hidden" name="my_array[email]" value="john@example.com">
 * <input type="hidden" name="my_array[url]" value="http://example.com">
 */

추가 속성이 있는 숨김 입력 필드를 생성하려면 다음과 같이 하십시오:

<?php

$data = [
    'type'  => 'hidden',
    'name'  => 'email',
    'id'    => 'hiddenemail',
    'value' => 'john@example.com',
    'class' => 'hiddenemail',
];

echo form_input($data);
/*
 * Would produce:
 * <input type="hidden" name="email" value="john@example.com" id="hiddenemail" class="hiddenemail">
 */

form_input([$data = ''[, $value = ''[, $extra = ''[, $type = 'text']]]])

매개변수:

• $data (array) – 필드 속성 데이터

• $value (string) – 필드 값

• $extra (mixed) – 배열 또는 리터럴 문자열 형태로 태그에 추가할 추가 속성

• $type (string) – 입력 필드의 타입. 예: ‘text’, ‘email’, ‘number’ 등

반환:

HTML 텍스트 입력 요소

반환 형식:

string

표준 텍스트 입력 필드를 생성할 수 있습니다. 첫 번째와 두 번째 매개변수에 최소한 필드 이름과 값을 전달할 수 있습니다:

<?php

echo form_input('username', 'johndoe');
/*
 * Would produce:
 * <input type="text" name="username" value="johndoe">
 */

또는 폼에 포함하려는 데이터가 담긴 연관 배열을 전달할 수도 있습니다:

<?php

$data = [
    'name'      => 'username',
    'id'        => 'username',
    'value'     => 'johndoe',
    'maxlength' => '100',
    'size'      => '50',
    'style'     => 'width:50%',
];
echo form_input($data);
/*
 * Would produce:
 * <input type="text" name="username" value="johndoe" id="username" maxlength="100" size="50" style="width:50%">
 */

불리언 속성을 원하면 불리언 값(true/false)을 전달합니다. 이 경우 불리언 값 자체는 중요하지 않습니다:

<?php

$data = [
    'name'     => 'username',
    'id'       => 'username',
    'value'    => '',
    'required' => true,
];
echo form_input($data);
/*
 * Would produce:
 * <input type="text" name="username" value="" id="username" required>
 */

JavaScript 등 추가 데이터를 폼에 포함하려면 세 번째 매개변수에 문자열로 전달할 수 있습니다:

<?php

$js = 'onClick="some_function ()"';
echo form_input('username', 'johndoe', $js);
/*
 * Would produce:
 * <input type="text" name="username" value="johndoe" onClick="some_function ()">
 */

또는 배열로 전달할 수도 있습니다:

<?php

$js = ['onClick' => 'some_function ();'];
echo form_input('username', 'johndoe', $js);
/*
 * Would produce:
 * <input type="text" name="username" value="johndoe" onClick="some_function ();">
 */

확장된 HTML5 입력 필드 범위를 지원하려면 네 번째 매개변수로 입력 타입을 전달할 수 있습니다:

<?php

echo form_input('email', 'joe@example.com', ['placeholder' => 'Email Address...'], 'email');
/*
 * Would produce:
 * <input type="email" name="email" value="joe@example.com" placeholder="Email Address...">
 */

form_password([$data = ''[, $value = ''[, $extra = '']]])

매개변수:

• $data (array) – 필드 속성 데이터

• $value (string) – 필드 값

• $extra (mixed) – 배열 또는 리터럴 문자열 형태로 태그에 추가할 추가 속성

반환:

HTML 비밀번호 입력 요소

반환 형식:

string

이 함수는 “password” 입력 타입을 사용한다는 점을 제외하면 위의 form_input() 함수와 모든 면에서 동일합니다.

form_upload([$data = ''[, $value = ''[, $extra = '']]])

매개변수:

• $data (array) – 필드 속성 데이터

• $value (string) – 필드 값

• $extra (mixed) – 배열 또는 리터럴 문자열 형태로 태그에 추가할 추가 속성

반환:

HTML 파일 업로드 입력 요소

반환 형식:

string

이 함수는 “file” 입력 타입을 사용하여 파일 업로드에 활용할 수 있다는 점을 제외하면 위의 form_input() 함수와 모든 면에서 동일합니다.

form_textarea([$data = ''[, $value = ''[, $extra = '']]])

매개변수:

• $data (array) – 필드 속성 데이터

• $value (string) – 필드 값

• $extra (mixed) – 배열 또는 리터럴 문자열 형태로 태그에 추가할 추가 속성

반환:

HTML textarea 요소

반환 형식:

string

이 함수는 “textarea” 타입을 생성한다는 점을 제외하면 위의 form_input() 함수와 모든 면에서 동일합니다.

참고

위 예제의 maxlength와 size 속성 대신 rows와 cols를 지정합니다.

form_dropdown([$name = ''[, $options = [][, $selected = [][, $extra = '']]]])

매개변수:

• $name (string) – 필드 이름

• $options (array) – 나열할 옵션의 연관 배열

• $selected (array) – selected 속성으로 표시할 필드 목록

• $extra (mixed) – 배열 또는 리터럴 문자열 형태로 태그에 추가할 추가 속성

반환:

HTML select(드롭다운) 요소

반환 형식:

string

표준 드롭다운 필드를 생성할 수 있습니다. 첫 번째 매개변수에는 필드 이름, 두 번째 매개변수에는 옵션의 연관 배열, 세 번째 매개변수에는 선택하려는 값이 들어갑니다. 세 번째 매개변수에 여러 항목의 배열을 전달하면 헬퍼가 다중 선택을 생성해 줍니다.

예제:

<?php

$options = [
    'small'  => 'Small Shirt',
    'med'    => 'Medium Shirt',
    'large'  => 'Large Shirt',
    'xlarge' => 'Extra Large Shirt',
];

$shirts_on_sale = ['small', 'large'];
echo form_dropdown('shirts', $options, 'large');
/*
 * Would produce:
 * <select name="shirts">
 *     <option value="small">Small Shirt</option>
 *     <option value="med">Medium Shirt</option>
 *     <option value="large" selected="selected">Large Shirt</option>
 *     <option value="xlarge">Extra Large Shirt</option>
 * </select>
 */

echo form_dropdown('shirts', $options, $shirts_on_sale);
/*
 * Would produce:
 * <select name="shirts" multiple="multiple">
 *     <option value="small" selected="selected">Small Shirt</option>
 *     <option value="med">Medium Shirt</option>
 *     <option value="large" selected="selected">Large Shirt</option>
 *     <option value="xlarge">Extra Large Shirt</option>
 * </select>
 */

여는 <select> 태그에 id 속성이나 JavaScript 등 추가 데이터를 포함하려면 네 번째 매개변수에 문자열로 전달할 수 있습니다:

<?php

$js = 'id="shirts" onChange="some_function();"';
echo form_dropdown('shirts', $options, 'large', $js);

또는 배열로 전달할 수도 있습니다:

<?php

$js = [
    'id'       => 'shirts',
    'onChange' => 'some_function();',
];
echo form_dropdown('shirts', $options, 'large', $js);

$options로 전달된 배열이 다차원 배열이면 form_dropdown()은 배열 키를 레이블로 하는 <optgroup>을 생성합니다.

form_multiselect([$name = ''[, $options = [][, $selected = [][, $extra = '']]]])

매개변수:

• $name (string) – 필드 이름

• $options (array) – 나열할 옵션의 연관 배열

• $selected (array) – selected 속성으로 표시할 필드 목록

• $extra (mixed) – 배열 또는 리터럴 문자열 형태로 태그에 추가할 추가 속성

반환:

multiple 속성이 있는 HTML select 요소

반환 형식:

string

표준 다중 선택 필드를 생성할 수 있습니다. 첫 번째 매개변수에는 필드 이름, 두 번째 매개변수에는 옵션의 연관 배열, 세 번째 매개변수에는 선택하려는 값이나 값들이 들어갑니다.

매개변수 사용법은 위의 form_dropdown()과 동일하지만, 필드 이름은 POST 배열 구문(예: foo[])을 사용해야 합니다.

form_fieldset([$legend_text = ''[, $attributes = []]])

매개변수:

• $legend_text (string) – <legend> 태그에 넣을 텍스트

• $attributes (array) – <fieldset> 태그에 설정할 속성

반환:

HTML fieldset 여는 태그

반환 형식:

string

fieldset/legend 필드를 생성할 수 있습니다.

예제:

<?php

echo form_fieldset('Address Information');
echo "<p>fieldset content here</p>\n";
echo form_fieldset_close();

?>

<!-- Produces: -->
<fieldset>
    <legend>Address Information</legend>
    <p>form content here</p>
</fieldset>

다른 함수들과 마찬가지로 추가 속성을 설정하려면 두 번째 매개변수에 연관 배열을 전달할 수 있습니다:

<?php

$attributes = [
    'id'    => 'address_info',
    'class' => 'address_info',
];

echo form_fieldset('Address Information', $attributes);
echo "<p>fieldset content here</p>\n";
echo form_fieldset_close();

?>

<!-- Produces: -->
<fieldset id="address_info" class="address_info">
    <legend>Address Information</legend>
    <p>form content here</p>
</fieldset>

form_fieldset_close([$extra = ''])

매개변수:

• $extra (string) – 닫는 태그 아래에 그대로 추가할 내용

반환:

HTML fieldset 닫는 태그

반환 형식:

string

닫는 </fieldset> 태그를 생성합니다. 이 함수를 사용하는 유일한 이점은 태그 아래에 추가될 데이터를 전달할 수 있다는 것입니다. 예:

<?php

$string = '</div></div>';
echo form_fieldset_close($string);
// Would produce: </fieldset></div></div>

form_checkbox([$data = ''[, $value = ''[, $checked = false[, $extra = '']]]])

매개변수:

• $data (array) – 필드 속성 데이터

• $value (string) – 필드 값

• $checked (bool) – 체크박스를 checked 상태로 표시할지 여부

• $extra (mixed) – 배열 또는 리터럴 문자열 형태로 태그에 추가할 추가 속성

반환:

HTML 체크박스 입력 요소

반환 형식:

string

체크박스 필드를 생성할 수 있습니다. 간단한 예제:

<?php

echo form_checkbox('newsletter', 'accept', true);
// Would produce:  <input type="checkbox" name="newsletter" value="accept" checked="checked">

세 번째 매개변수는 체크박스의 선택 여부를 결정하는 불리언 true/false 값을 포함합니다.

이 헬퍼의 다른 폼 함수들과 마찬가지로 함수에 속성 배열을 전달할 수도 있습니다:

<?php

$data = [
    'name'    => 'newsletter',
    'id'      => 'newsletter',
    'value'   => 'accept',
    'checked' => true,
    'style'   => 'margin:10px',
];

echo form_checkbox($data);
// Would produce: <input type="checkbox" name="newsletter" id="newsletter" value="accept" checked="checked" style="margin:10px">

다른 함수들과 마찬가지로 JavaScript 등 추가 데이터를 태그에 포함하려면 네 번째 매개변수에 문자열로 전달할 수 있습니다:

<?php

$js = 'onClick="some_function()"';
echo form_checkbox('newsletter', 'accept', true, $js);

또는 배열로 전달할 수도 있습니다:

<?php

$js = ['onClick' => 'some_function();'];
echo form_checkbox('newsletter', 'accept', true, $js);

form_radio([$data = ''[, $value = ''[, $checked = false[, $extra = '']]]])

매개변수:

• $data (array) – 필드 속성 데이터

• $value (string) – 필드 값

• $checked (bool) – 라디오 버튼을 checked 상태로 표시할지 여부

• $extra (mixed) – 배열 또는 리터럴 문자열 형태로 태그에 추가할 추가 속성

반환:

HTML 라디오 입력 요소

반환 형식:

string

이 함수는 “radio” 입력 타입을 사용한다는 점을 제외하면 위의 form_checkbox() 함수와 모든 면에서 동일합니다.

form_label([$label_text = ''[, $id = ''[, $attributes = []]]])

매개변수:

• $label_text (string) – <label> 태그에 넣을 텍스트

• $id (string) – 레이블을 만들 폼 요소의 ID

• $attributes (string) – HTML 속성

반환:

HTML label 요소

반환 형식:

string

<label>을 생성할 수 있습니다. 간단한 예제:

<?php

echo form_label('What is your Name', 'username');
// Would produce:  <label for="username">What is your Name</label>

다른 함수들과 마찬가지로 추가 속성을 설정하려면 세 번째 매개변수에 연관 배열을 전달할 수 있습니다.

예제:

<?php

$attributes = [
    'class' => 'mycustomclass',
    'style' => 'color: #000;',
];

echo form_label('What is your Name', 'username', $attributes);
// Would produce:  <label for="username" class="mycustomclass" style="color: #000;">What is your Name</label>

form_submit([$data = ''[, $value = ''[, $extra = '']]])

매개변수:

• $data (string) – 버튼 이름

• $value (string) – 버튼 값

• $extra (mixed) – 배열 또는 리터럴 문자열 형태로 태그에 추가할 추가 속성

반환:

HTML input submit 요소

반환 형식:

string

표준 제출 버튼을 생성할 수 있습니다. 간단한 예제:

<?php

echo form_submit('mysubmit', 'Submit Post!');
// Would produce:  <input type="submit" name="mysubmit" value="Submit Post!">

다른 함수들과 마찬가지로 직접 속성을 설정하려면 첫 번째 매개변수에 연관 배열을 전달할 수 있습니다. 세 번째 매개변수를 사용하면 JavaScript 등 추가 데이터를 폼에 추가할 수 있습니다.

form_reset([$data = ''[, $value = ''[, $extra = '']]])

매개변수:

• $data (string) – 버튼 이름

• $value (string) – 버튼 값

• $extra (mixed) – 배열 또는 리터럴 문자열 형태로 태그에 추가할 추가 속성

반환:

HTML input reset 요소

반환 형식:

string

표준 리셋 버튼을 생성할 수 있습니다. 사용법은 form_submit()과 동일합니다.

form_button([$data = ''[, $content = ''[, $extra = '']]])

매개변수:

• $data (string) – 버튼 이름

• $content (string) – 버튼 레이블

• $extra (mixed) – 배열 또는 리터럴 문자열 형태로 태그에 추가할 추가 속성

반환:

HTML button 요소

반환 형식:

string

표준 버튼 요소를 생성할 수 있습니다. 첫 번째와 두 번째 매개변수에 최소한 버튼 이름과 내용을 전달할 수 있습니다:

<?php

echo form_button('name', 'content');
// Would produce: <button name="name" type="button">Content</button>

또는 폼에 포함하려는 데이터가 담긴 연관 배열을 전달할 수도 있습니다:

<?php

$data = [
    'name'    => 'button',
    'id'      => 'button',
    'value'   => 'true',
    'type'    => 'reset',
    'content' => 'Reset',
];

echo form_button($data);
// Would produce: <button name="button" id="button" value="true" type="reset">Reset</button>

JavaScript 등 추가 데이터를 폼에 포함하려면 세 번째 매개변수에 문자열로 전달할 수 있습니다:

<?php

$js = 'onClick="some_function()"';
echo form_button('mybutton', 'Click Me', $js);

form_close([$extra = ''])

매개변수:

• $extra (string) – 닫는 태그 아래에 그대로 추가할 내용

반환:

HTML 폼 닫는 태그

반환 형식:

string

닫는 </form> 태그를 생성합니다. 이 함수를 사용하는 유일한 이점은 태그 아래에 추가될 데이터를 전달할 수 있다는 것입니다. 예:

<?php

$string = '</div></div>';
echo form_close($string);
// Would produce:  </form> </div></div>

set_value($field[, $default = ''[, $html_escape = true]])

매개변수:

• $field (string) – 필드 이름

• $default (string) – 기본값

• $html_escape (bool) – 값의 HTML 이스케이프 처리를 끌지 여부

반환:

필드 값

반환 형식:

string

입력 또는 textarea 요소의 값을 설정할 수 있습니다. 함수의 첫 번째 매개변수로 필드 이름을 제공해야 합니다. 두 번째(선택적) 매개변수를 사용하면 필드의 기본값을 설정할 수 있습니다. 세 번째(선택적) 매개변수를 사용하면 form_input() 등과 함께 이 함수를 사용할 때 이중 이스케이프를 피하기 위해 값의 HTML 이스케이프 처리를 끌 수 있습니다.

예제:

<input type="text" name="quantity" value="<?= set_value('quantity', '0') ?>" size="50">

위의 폼은 처음 로드될 때 “0”을 표시합니다.

set_select($field[, $value = ''[, $default = false]])

매개변수:

• $field (string) – 필드 이름

• $value (string) – 확인할 값

• $default (string) – 해당 값이 기본값인지 여부

반환:

‘selected’ 속성 또는 빈 문자열

반환 형식:

string

<select> 메뉴를 사용하는 경우 이 함수를 통해 선택된 메뉴 항목을 표시할 수 있습니다.

첫 번째 매개변수에는 select 메뉴의 이름, 두 번째 매개변수에는 각 항목의 값이 들어가야 하며, 세 번째(선택적) 매개변수를 사용하면 항목을 기본값으로 설정할 수 있습니다(불리언 true/false 사용).

예제:

<select name="myselect">
    <option value="one" <?= set_select('myselect', 'one', true) ?>>One</option>
    <option value="two" <?= set_select('myselect', 'two') ?>>Two</option>
    <option value="three" <?= set_select('myselect', 'three') ?>>Three</option>
</select>

set_checkbox($field[, $value = ''[, $default = false]])

매개변수:

• $field (string) – 필드 이름

• $value (string) – 확인할 값

• $default (string) – 해당 값이 기본값인지 여부

반환:

‘checked’ 속성 또는 빈 문자열

반환 형식:

string

제출된 상태 그대로 체크박스를 표시할 수 있습니다.

첫 번째 매개변수에는 체크박스의 이름, 두 번째 매개변수에는 체크박스의 값이 들어가야 하며, 세 번째(선택적) 매개변수를 사용하면 항목을 기본값으로 설정할 수 있습니다(불리언 true/false 사용).

예제:

<input type="checkbox" name="mycheck[]" value="1" <?= set_checkbox('mycheck', '1') ?>>
<input type="checkbox" name="mycheck[]" value="2" <?= set_checkbox('mycheck', '2') ?>>

set_radio($field[, $value = ''[, $default = false]])

매개변수:

• $field (string) – 필드 이름

• $value (string) – 확인할 값

• $default (string) – 해당 값이 기본값인지 여부

반환:

‘checked’ 속성 또는 빈 문자열

반환 형식:

string

제출된 상태 그대로 라디오 버튼을 표시할 수 있습니다. 이 함수는 위의 set_checkbox() 함수와 동일합니다.

예제:

<input type="radio" name="myradio" value="1" <?= set_radio('myradio', '1', true) ?>>
<input type="radio" name="myradio" value="2" <?= set_radio('myradio', '2') ?>>

validation_errors()

Added in version 4.3.0.

반환:

유효성 검사 오류

반환 형식:

array

유효성 검사 오류를 반환합니다. 이 함수는 먼저 세션에 저장된 유효성 검사 오류를 확인합니다. 오류를 세션에 저장하려면 redirect()와 함께 withInput()을 사용해야 합니다.

반환된 배열은 Validation::getErrors()와 동일합니다. 자세한 내용은 Validation을 참고하십시오.

참고

이 함수는 모델 내 유효성 검사과 함께 동작하지 않습니다. 모델 유효성 검사에서 오류를 가져오려면 유효성 검사 오류 가져오기를 참고하십시오.

예제:

<?php $errors = validation_errors(); ?>

validation_list_errors($template = 'list')

Added in version 4.3.0.

매개변수:

• $template (string) – 유효성 검사 템플릿 이름

반환:

렌더링된 유효성 검사 오류의 HTML

반환 형식:

string

렌더링된 유효성 검사 오류의 HTML을 반환합니다.

$template 매개변수는 유효성 검사 템플릿 이름입니다. 자세한 내용은 오류 표시 사용자 정의를 참고하십시오.

이 함수는 내부적으로 validation_errors()를 사용합니다.

참고

이 함수는 모델 내 유효성 검사과 함께 동작하지 않습니다. 모델 유효성 검사에서 오류를 가져오려면 유효성 검사 오류 가져오기를 참고하십시오.

예제:

<?= validation_list_errors() ?>

validation_show_error($field, $template = 'single')

Added in version 4.3.0.

매개변수:

• $field (string) – 필드 이름

• $template (string) – 유효성 검사 템플릿 이름

반환:

렌더링된 유효성 검사 오류의 HTML

반환 형식:

string

지정된 필드에 대한 단일 오류를 형식화된 HTML로 반환합니다.

$template 매개변수는 유효성 검사 템플릿 이름입니다. 자세한 내용은 오류 표시 사용자 정의를 참고하십시오.

이 함수는 내부적으로 validation_errors()를 사용합니다.

참고

이 함수는 모델 내 유효성 검사과 함께 동작하지 않습니다. 모델 유효성 검사에서 오류를 가져오려면 유효성 검사 오류 가져오기를 참고하십시오.

예제:

<?= validation_show_error('username') ?>