Revision 1257 | Zur aktuellen Revision | Blame | Vergleich mit vorheriger | Letzte Änderung | Log anzeigen | RSS feed
<?php/*** CodeIgniter** An open source application development framework for PHP** This content is released under the MIT License (MIT)** Copyright (c) 2014 - 2016, British Columbia Institute of Technology** Permission is hereby granted, free of charge, to any person obtaining a copy* of this software and associated documentation files (the "Software"), to deal* in the Software without restriction, including without limitation the rights* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell* copies of the Software, and to permit persons to whom the Software is* furnished to do so, subject to the following conditions:** The above copyright notice and this permission notice shall be included in* all copies or substantial portions of the Software.** THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN* THE SOFTWARE.** @package CodeIgniter* @author EllisLab Dev Team* @copyright Copyright (c) 2008 - 2014, EllisLab, Inc. (https://ellislab.com/)* @copyright Copyright (c) 2014 - 2016, British Columbia Institute of Technology (http://bcit.ca/)* @license http://opensource.org/licenses/MIT MIT License* @link https://codeigniter.com* @since Version 1.0.0* @filesource*/defined('BASEPATH') OR exit('No direct script access allowed');/*** CodeIgniter Form Helpers** @package CodeIgniter* @subpackage Helpers* @category Helpers* @author EllisLab Dev Team* @link https://codeigniter.com/user_guide/helpers/form_helper.html*/// ------------------------------------------------------------------------if ( ! function_exists('form_open')){/*** Form Declaration** Creates the opening portion of the form.** @param string the URI segments of the form destination* @param array a key/value pair of attributes* @param array a key/value pair hidden data* @return string*/function form_open($action = '', $attributes = array(), $hidden = array()){$CI =& get_instance();// If no action is provided then set to the current urlif ( ! $action){$action = $CI->config->site_url($CI->uri->uri_string());}// If an action is not a full URL then turn it into oneelseif (strpos($action, '://') === FALSE){$action = $CI->config->site_url($action);}$attributes = _attributes_to_string($attributes);if (stripos($attributes, 'method=') === FALSE){$attributes .= ' method="post"';}if (stripos($attributes, 'accept-charset=') === FALSE){$attributes .= ' accept-charset="'.strtolower(config_item('charset')).'"';}$form = '<form action="'.$action.'"'.$attributes.">\n";// Add CSRF field if enabled, but leave it out for GET requests and requests to external websitesif ($CI->config->item('csrf_protection') === TRUE && strpos($action, $CI->config->base_url()) !== FALSE && ! stripos($form, 'method="get"')){$hidden[$CI->security->get_csrf_token_name()] = $CI->security->get_csrf_hash();}if (is_array($hidden)){foreach ($hidden as $name => $value){$form .= '<input type="hidden" name="'.$name.'" value="'.html_escape($value).'" style="display:none;" />'."\n";}}return $form;}}// ------------------------------------------------------------------------if ( ! function_exists('form_open_multipart')){/*** Form Declaration - Multipart type** Creates the opening portion of the form, but with "multipart/form-data".** @param string the URI segments of the form destination* @param array a key/value pair of attributes* @param array a key/value pair hidden data* @return string*/function form_open_multipart($action = '', $attributes = array(), $hidden = array()){if (is_string($attributes)){$attributes .= ' enctype="multipart/form-data"';}else{$attributes['enctype'] = 'multipart/form-data';}return form_open($action, $attributes, $hidden);}}// ------------------------------------------------------------------------if ( ! function_exists('form_hidden')){/*** Hidden Input Field** Generates hidden fields. You can pass a simple key/value string or* an associative array with multiple values.** @param mixed $name Field name* @param string $value Field value* @param bool $recursing* @return string*/function form_hidden($name, $value = '', $recursing = FALSE){static $form;if ($recursing === FALSE){$form = "\n";}if (is_array($name)){foreach ($name as $key => $val){form_hidden($key, $val, TRUE);}return $form;}if ( ! is_array($value)){$form .= '<input type="hidden" name="'.$name.'" value="'.html_escape($value)."\" />\n";}else{foreach ($value as $k => $v){$k = is_int($k) ? '' : $k;form_hidden($name.'['.$k.']', $v, TRUE);}}return $form;}}// ------------------------------------------------------------------------if ( ! function_exists('form_input')){/*** Text Input Field** @param mixed* @param string* @param mixed* @return string*/function form_input($data = '', $value = '', $extra = ''){$defaults = array('type' => 'text','name' => is_array($data) ? '' : $data,'value' => $value);return '<input '._parse_form_attributes($data, $defaults)._attributes_to_string($extra)." />\n";}}// ------------------------------------------------------------------------if ( ! function_exists('form_password')){/*** Password Field** Identical to the input function but adds the "password" type** @param mixed* @param string* @param mixed* @return string*/function form_password($data = '', $value = '', $extra = ''){is_array($data) OR $data = array('name' => $data);$data['type'] = 'password';return form_input($data, $value, $extra);}}// ------------------------------------------------------------------------if ( ! function_exists('form_upload')){/*** Upload Field** Identical to the input function but adds the "file" type** @param mixed* @param string* @param mixed* @return string*/function form_upload($data = '', $value = '', $extra = ''){$defaults = array('type' => 'file', 'name' => '');is_array($data) OR $data = array('name' => $data);$data['type'] = 'file';return '<input '._parse_form_attributes($data, $defaults)._attributes_to_string($extra)." />\n";}}// ------------------------------------------------------------------------if ( ! function_exists('form_textarea')){/*** Textarea field** @param mixed $data* @param string $value* @param mixed $extra* @return string*/function form_textarea($data = '', $value = '', $extra = ''){$defaults = array('name' => is_array($data) ? '' : $data,'cols' => '40','rows' => '10');if ( ! is_array($data) OR ! isset($data['value'])){$val = $value;}else{$val = $data['value'];unset($data['value']); // textareas don't use the value attribute}return '<textarea '._parse_form_attributes($data, $defaults)._attributes_to_string($extra).'>'.html_escape($val)."</textarea>\n";}}// ------------------------------------------------------------------------if ( ! function_exists('form_multiselect')){/*** Multi-select menu** @param string* @param array* @param mixed* @param mixed* @return string*/function form_multiselect($name = '', $options = array(), $selected = array(), $extra = ''){$extra = _attributes_to_string($extra);if (stripos($extra, 'multiple') === FALSE){$extra .= ' multiple="multiple"';}return form_dropdown($name, $options, $selected, $extra);}}// --------------------------------------------------------------------if ( ! function_exists('form_dropdown')){/*** Drop-down Menu** @param mixed $data* @param mixed $options* @param mixed $selected* @param mixed $extra* @return string*/function form_dropdown($data = '', $options = array(), $selected = array(), $extra = ''){$defaults = array();if (is_array($data)){if (isset($data['selected'])){$selected = $data['selected'];unset($data['selected']); // select tags don't have a selected attribute}if (isset($data['options'])){$options = $data['options'];unset($data['options']); // select tags don't use an options attribute}}else{$defaults = array('name' => $data);}is_array($selected) OR $selected = array($selected);is_array($options) OR $options = array($options);// If no selected state was submitted we will attempt to set it automaticallyif (empty($selected)){if (is_array($data)){if (isset($data['name'], $_POST[$data['name']])){$selected = array($_POST[$data['name']]);}}elseif (isset($_POST[$data])){$selected = array($_POST[$data]);}}$extra = _attributes_to_string($extra);$multiple = (count($selected) > 1 && stripos($extra, 'multiple') === FALSE) ? ' multiple="multiple"' : '';$form = '<select '.rtrim(_parse_form_attributes($data, $defaults)).$extra.$multiple.">\n";foreach ($options as $key => $val){$key = (string) $key;if (is_array($val)){if (empty($val)){continue;}$form .= '<optgroup label="'.$key."\">\n";foreach ($val as $optgroup_key => $optgroup_val){$sel = in_array($optgroup_key, $selected) ? ' selected="selected"' : '';$form .= '<option value="'.html_escape($optgroup_key).'"'.$sel.'>'.(string) $optgroup_val."</option>\n";}$form .= "</optgroup>\n";}else{$form .= '<option value="'.html_escape($key).'"'.(in_array($key, $selected) ? ' selected="selected"' : '').'>'.(string) $val."</option>\n";}}return $form."</select>\n";}}// ------------------------------------------------------------------------if ( ! function_exists('form_checkbox')){/*** Checkbox Field** @param mixed* @param string* @param bool* @param mixed* @return string*/function form_checkbox($data = '', $value = '', $checked = FALSE, $extra = ''){$defaults = array('type' => 'checkbox', 'name' => ( ! is_array($data) ? $data : ''), 'value' => $value);if (is_array($data) && array_key_exists('checked', $data)){$checked = $data['checked'];if ($checked == FALSE){unset($data['checked']);}else{$data['checked'] = 'checked';}}if ($checked == TRUE){$defaults['checked'] = 'checked';}else{unset($defaults['checked']);}return '<input '._parse_form_attributes($data, $defaults)._attributes_to_string($extra)." />\n";}}// ------------------------------------------------------------------------if ( ! function_exists('form_radio')){/*** Radio Button** @param mixed* @param string* @param bool* @param mixed* @return string*/function form_radio($data = '', $value = '', $checked = FALSE, $extra = ''){is_array($data) OR $data = array('name' => $data);$data['type'] = 'radio';return form_checkbox($data, $value, $checked, $extra);}}// ------------------------------------------------------------------------if ( ! function_exists('form_submit')){/*** Submit Button** @param mixed* @param string* @param mixed* @return string*/function form_submit($data = '', $value = '', $extra = ''){$defaults = array('type' => 'submit','name' => is_array($data) ? '' : $data,'value' => $value);return '<input '._parse_form_attributes($data, $defaults)._attributes_to_string($extra)." />\n";}}// ------------------------------------------------------------------------if ( ! function_exists('form_reset')){/*** Reset Button** @param mixed* @param string* @param mixed* @return string*/function form_reset($data = '', $value = '', $extra = ''){$defaults = array('type' => 'reset','name' => is_array($data) ? '' : $data,'value' => $value);return '<input '._parse_form_attributes($data, $defaults)._attributes_to_string($extra)." />\n";}}// ------------------------------------------------------------------------if ( ! function_exists('form_button')){/*** Form Button** @param mixed* @param string* @param mixed* @return string*/function form_button($data = '', $content = '', $extra = ''){$defaults = array('name' => is_array($data) ? '' : $data,'type' => 'button');if (is_array($data) && isset($data['content'])){$content = $data['content'];unset($data['content']); // content is not an attribute}return '<button '._parse_form_attributes($data, $defaults)._attributes_to_string($extra).'>'.$content."</button>\n";}}// ------------------------------------------------------------------------if ( ! function_exists('form_label')){/*** Form Label Tag** @param string The text to appear onscreen* @param string The id the label applies to* @param array Additional attributes* @return string*/function form_label($label_text = '', $id = '', $attributes = array()){$label = '<label';if ($id !== ''){$label .= ' for="'.$id.'"';}if (is_array($attributes) && count($attributes) > 0){foreach ($attributes as $key => $val){$label .= ' '.$key.'="'.$val.'"';}}return $label.'>'.$label_text.'</label>';}}// ------------------------------------------------------------------------if ( ! function_exists('form_fieldset')){/*** Fieldset Tag** Used to produce <fieldset><legend>text</legend>. To close fieldset* use form_fieldset_close()** @param string The legend text* @param array Additional attributes* @return string*/function form_fieldset($legend_text = '', $attributes = array()){$fieldset = '<fieldset'._attributes_to_string($attributes).">\n";if ($legend_text !== ''){return $fieldset.'<legend>'.$legend_text."</legend>\n";}return $fieldset;}}// ------------------------------------------------------------------------if ( ! function_exists('form_fieldset_close')){/*** Fieldset Close Tag** @param string* @return string*/function form_fieldset_close($extra = ''){return '</fieldset>'.$extra;}}// ------------------------------------------------------------------------if ( ! function_exists('form_close')){/*** Form Close Tag** @param string* @return string*/function form_close($extra = ''){return '</form>'.$extra;}}// ------------------------------------------------------------------------if ( ! function_exists('form_prep')){/*** Form Prep** Formats text so that it can be safely placed in a form field in the event it has HTML tags.** @deprecated 3.0.0 An alias for html_escape()* @param string|string[] $str Value to escape* @return string|string[] Escaped values*/function form_prep($str){return html_escape($str, TRUE);}}// ------------------------------------------------------------------------if ( ! function_exists('set_value')){/*** Form Value** Grabs a value from the POST array for the specified field so you can* re-populate an input field or textarea. If Form Validation* is active it retrieves the info from the validation class** @param string $field Field name* @param string $default Default value* @param bool $html_escape Whether to escape HTML special characters or not* @return string*/function set_value($field, $default = '', $html_escape = TRUE){$CI =& get_instance();$value = (isset($CI->form_validation) && is_object($CI->form_validation) && $CI->form_validation->has_rule($field))? $CI->form_validation->set_value($field, $default): $CI->input->post($field, FALSE);isset($value) OR $value = $default;return ($html_escape) ? html_escape($value) : $value;}}// ------------------------------------------------------------------------if ( ! function_exists('set_select')){/*** Set Select** Let's you set the selected value of a <select> menu via data in the POST array.* If Form Validation is active it retrieves the info from the validation class** @param string* @param string* @param bool* @return string*/function set_select($field, $value = '', $default = FALSE){$CI =& get_instance();if (isset($CI->form_validation) && is_object($CI->form_validation) && $CI->form_validation->has_rule($field)){return $CI->form_validation->set_select($field, $value, $default);}elseif (($input = $CI->input->post($field, FALSE)) === NULL){return ($default === TRUE) ? ' selected="selected"' : '';}$value = (string) $value;if (is_array($input)){// Note: in_array('', array(0)) returns TRUE, do not use itforeach ($input as &$v){if ($value === $v){return ' selected="selected"';}}return '';}return ($input === $value) ? ' selected="selected"' : '';}}// ------------------------------------------------------------------------if ( ! function_exists('set_checkbox')){/*** Set Checkbox** Let's you set the selected value of a checkbox via the value in the POST array.* If Form Validation is active it retrieves the info from the validation class** @param string* @param string* @param bool* @return string*/function set_checkbox($field, $value = '', $default = FALSE){$CI =& get_instance();if (isset($CI->form_validation) && is_object($CI->form_validation) && $CI->form_validation->has_rule($field)){return $CI->form_validation->set_checkbox($field, $value, $default);}// Form inputs are always strings ...$value = (string) $value;$input = $CI->input->post($field, FALSE);if (is_array($input)){// Note: in_array('', array(0)) returns TRUE, do not use itforeach ($input as &$v){if ($value === $v){return ' checked="checked"';}}return '';}// Unchecked checkbox and radio inputs are not even submitted by browsers ...if ($CI->input->method() === 'post'){return ($input === $value) ? ' checked="checked"' : '';}return ($default === TRUE) ? ' checked="checked"' : '';}}// ------------------------------------------------------------------------if ( ! function_exists('set_radio')){/*** Set Radio** Let's you set the selected value of a radio field via info in the POST array.* If Form Validation is active it retrieves the info from the validation class** @param string $field* @param string $value* @param bool $default* @return string*/function set_radio($field, $value = '', $default = FALSE){$CI =& get_instance();if (isset($CI->form_validation) && is_object($CI->form_validation) && $CI->form_validation->has_rule($field)){return $CI->form_validation->set_radio($field, $value, $default);}// Form inputs are always strings ...$value = (string) $value;$input = $CI->input->post($field, FALSE);if (is_array($input)){// Note: in_array('', array(0)) returns TRUE, do not use itforeach ($input as &$v){if ($value === $v){return ' checked="checked"';}}return '';}// Unchecked checkbox and radio inputs are not even submitted by browsers ...if ($CI->input->method() === 'post'){return ($input === $value) ? ' checked="checked"' : '';}return ($default === TRUE) ? ' checked="checked"' : '';}}// ------------------------------------------------------------------------if ( ! function_exists('form_error')){/*** Form Error** Returns the error for a specific form field. This is a helper for the* form validation class.** @param string* @param string* @param string* @return string*/function form_error($field = '', $prefix = '', $suffix = ''){if (FALSE === ($OBJ =& _get_validation_object())){return '';}return $OBJ->error($field, $prefix, $suffix);}}// ------------------------------------------------------------------------if ( ! function_exists('validation_errors')){/*** Validation Error String** Returns all the errors associated with a form submission. This is a helper* function for the form validation class.** @param string* @param string* @return string*/function validation_errors($prefix = '', $suffix = ''){if (FALSE === ($OBJ =& _get_validation_object())){return '';}return $OBJ->error_string($prefix, $suffix);}}// ------------------------------------------------------------------------if ( ! function_exists('_parse_form_attributes')){/*** Parse the form attributes** Helper function used by some of the form helpers** @param array $attributes List of attributes* @param array $default Default values* @return string*/function _parse_form_attributes($attributes, $default){if (is_array($attributes)){foreach ($default as $key => $val){if (isset($attributes[$key])){$default[$key] = $attributes[$key];unset($attributes[$key]);}}if (count($attributes) > 0){$default = array_merge($default, $attributes);}}$att = '';foreach ($default as $key => $val){if ($key === 'value'){$val = html_escape($val);}elseif ($key === 'name' && ! strlen($default['name'])){continue;}$att .= $key.'="'.$val.'" ';}return $att;}}// ------------------------------------------------------------------------if ( ! function_exists('_attributes_to_string')){/*** Attributes To String** Helper function used by some of the form helpers** @param mixed* @return string*/function _attributes_to_string($attributes){if (empty($attributes)){return '';}if (is_object($attributes)){$attributes = (array) $attributes;}if (is_array($attributes)){$atts = '';foreach ($attributes as $key => $val){$atts .= ' '.$key.'="'.$val.'"';}return $atts;}if (is_string($attributes)){return ' '.$attributes;}return FALSE;}}// ------------------------------------------------------------------------if ( ! function_exists('_get_validation_object')){/*** Validation Object** Determines what the form validation class was instantiated as, fetches* the object and returns it.** @return mixed*/function &_get_validation_object(){$CI =& get_instance();// We set this as a variable since we're returning by reference.$return = FALSE;if (FALSE !== ($object = $CI->load->is_loaded('Form_validation'))){if ( ! isset($CI->$object) OR ! is_object($CI->$object)){return $return;}return $CI->$object;}return $return;}}