mirror of
https://github.com/kamilwylegala/cakephp2-php8.git
synced 2024-11-15 11:28:25 +00:00
4a87a75332
- Helpers for controllers -- each controller has it's own helper in the /app/helpers directory - /logs and /modules directories - The application runs just fine without /config/database.php if controllers don't ask for db access - Changed the name of /public/dispatch.php to /public/index.php, it's nicer and more standard, won't you agree? Kamil's fix for no-mod_rewrite needs to be re-implemented - Cleanups, fixes, and even one or two comments ;) git-svn-id: https://svn.cakephp.org/repo/trunk/cake@158 3807eeeb-6ff5-0310-8944-8be069107fe0
585 lines
No EOL
16 KiB
PHP
585 lines
No EOL
16 KiB
PHP
<?PHP
|
|
//////////////////////////////////////////////////////////////////////////
|
|
// + $Id$
|
|
// +------------------------------------------------------------------+ //
|
|
// + Cake <https://developers.nextco.com/cake/> + //
|
|
// + Copyright: (c) 2005, Cake Authors/Developers + //
|
|
// + Author(s): Michal Tatarynowicz aka Pies <tatarynowicz@gmail.com> + //
|
|
// + Larry E. Masters aka PhpNut <nut@phpnut.com> + //
|
|
// + Kamil Dzielinski aka Brego <brego.dk@gmail.com> + //
|
|
// +------------------------------------------------------------------+ //
|
|
// + Licensed under The MIT License + //
|
|
// + Redistributions of files must retain the above copyright notice. + //
|
|
// + See: http://www.opensource.org/licenses/mit-license.php + //
|
|
//////////////////////////////////////////////////////////////////////////
|
|
|
|
/**
|
|
* Purpose: Controller
|
|
* Application controller (controllers are where you put all the actual code) based on RoR (www.rubyonrails.com)
|
|
* Provides basic functionality, such as rendering views (aka displaying templates).
|
|
* Automatically selects model name from on singularized object class name
|
|
* and creates the model object if proper class exists.
|
|
*
|
|
* @filesource
|
|
* @author Cake Authors/Developers
|
|
* @copyright Copyright (c) 2005, Cake Authors/Developers
|
|
* @link https://developers.nextco.com/cake/wiki/Authors Authors/Developers
|
|
* @package cake
|
|
* @subpackage cake.libs
|
|
* @since Cake v 0.2.9
|
|
* @version $Revision$
|
|
* @modifiedby $LastChangedBy$
|
|
* @lastmodified $Date$
|
|
* @license http://www.opensource.org/licenses/mit-license.php The MIT License
|
|
*
|
|
*/
|
|
|
|
/**
|
|
* Enter description here...
|
|
*/
|
|
uses('model', 'template', 'inflector');
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
*
|
|
* @package cake
|
|
* @subpackage cake.libs
|
|
* @since Cake v 0.2.9
|
|
*
|
|
*/
|
|
class Controller extends Template {
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @var unknown_type
|
|
* @access public
|
|
*/
|
|
var $name = null;
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @var unknown_type
|
|
* @access public
|
|
*/
|
|
var $parent = null;
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @var unknown_type
|
|
* @access public
|
|
*/
|
|
var $action = null;
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @var unknown_type
|
|
* @access public
|
|
*/
|
|
var $use_model = null;
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @var unknown_type
|
|
* @access private
|
|
*/
|
|
var $uses = false;
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @var unknown_type
|
|
* @access private
|
|
*/
|
|
var $_crumbs = array();
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
*/
|
|
function __construct () {
|
|
global $DB;
|
|
|
|
$r = null;
|
|
if (!preg_match('/(.*)Controller/i', get_class($this), $r))
|
|
die("Controller::__construct() : Can't get or parse my own class name, exiting.");
|
|
|
|
$this->name = strtolower($r[1]);
|
|
|
|
$model_class = Inflector::singularize($this->name);
|
|
if (($this->uses === false) && class_exists($model_class)) {
|
|
if (!$DB)
|
|
die("Controller::__construct() : ".$this->name." controller needs database access, exiting.");
|
|
|
|
$this->$model_class = new $model_class ();
|
|
}
|
|
elseif ($this->uses) {
|
|
if (!$DB)
|
|
die("Controller::__construct() : ".$this->name." controller needs database access, exiting.");
|
|
|
|
$uses = is_array($this->uses)? $this->uses: array($this->uses);
|
|
|
|
foreach ($uses as $model_name) {
|
|
$model_class = ucfirst(strtolower($model_name));
|
|
|
|
if (class_exists($model_class)) {
|
|
$this->$model_name = new $model_class (false);
|
|
}
|
|
else
|
|
die("Controller::__construct() : ".ucfirst($this->name)." requires missing model {$model_class}, exiting.");
|
|
}
|
|
}
|
|
|
|
parent::__construct();
|
|
}
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @param unknown_type $url
|
|
*/
|
|
function redirect ($url) {
|
|
$this->autoRender = false;
|
|
header ('Location: '.$this->base.$url);
|
|
}
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @param unknown_type $action
|
|
*/
|
|
function setAction ($action) {
|
|
$this->action = $action;
|
|
|
|
$args = func_get_args();
|
|
call_user_func_array(array(&$this, $action), $args);
|
|
}
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @param unknown_type $url
|
|
* @return unknown
|
|
*/
|
|
function urlFor ($url=null) {
|
|
if (empty($url)) {
|
|
return $this->base.'/'.strtolower($this->params['controller']).'/'.strtolower($this->params['action']);
|
|
}
|
|
elseif ($url[0] == '/') {
|
|
return $this->base . $url;
|
|
}
|
|
else {
|
|
return $this->base . '/' . strtolower($this->params['controller']) . '/' . $url;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @param unknown_type $options
|
|
* @param unknown_type $insert_before
|
|
* @param unknown_type $insert_after
|
|
* @return unknown
|
|
*/
|
|
function parseHtmlOptions ($options, $insert_before=' ', $insert_after=null) {
|
|
if (is_array($options)) {
|
|
$out = array();
|
|
foreach ($options as $k=>$v) {
|
|
$out[] = "{$k}=\"{$v}\"";
|
|
}
|
|
$out = join(' ', $out);
|
|
return $out? $insert_before.$out.$insert_after: null;
|
|
}
|
|
else {
|
|
return $options? $insert_before.$options.$insert_after: null;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @param unknown_type $title
|
|
* @param unknown_type $url
|
|
* @param unknown_type $html_options
|
|
* @param unknown_type $confirm_message
|
|
* @return unknown
|
|
*/
|
|
function linkTo ($title, $url, $html_options=null, $confirm_message=false) {
|
|
$confirm_message? $html_options['onClick'] = "return confirm('{$confirm_message}')": null;
|
|
return sprintf(TAG_LINK, $this->UrlFor($url), $this->parseHtmlOptions($html_options), $title);
|
|
}
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @param unknown_type $title
|
|
* @param unknown_type $url
|
|
* @param unknown_type $html_options
|
|
* @return unknown
|
|
*/
|
|
function linkOut ($title, $url=null, $html_options=null) {
|
|
$url = $url? $url: $title;
|
|
return sprintf(TAG_LINK, $url, $this->parseHtmlOptions($html_options), $title);
|
|
}
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @param unknown_type $target
|
|
* @param unknown_type $type
|
|
* @param unknown_type $html_options
|
|
* @return unknown
|
|
*/
|
|
function formTag ($target=null, $type='post', $html_options=null) {
|
|
$html_options['action'] = $this->UrlFor($target);
|
|
$html_options['method'] = $type=='get'? 'get': 'post';
|
|
$type == 'file'? $html_options['enctype'] = 'multipart/form-data': null;
|
|
|
|
return sprintf(TAG_FORM, $this->parseHtmlOptions($html_options, ''));
|
|
}
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @param unknown_type $caption
|
|
* @param unknown_type $html_options
|
|
* @return unknown
|
|
*/
|
|
function submitTag ($caption='Submit', $html_options=null) {
|
|
$html_options['value'] = $caption;
|
|
return sprintf(TAG_SUBMIT, $this->parseHtmlOptions($html_options, '', ' '));
|
|
}
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @param unknown_type $tag_name
|
|
* @param unknown_type $size
|
|
* @param unknown_type $html_options
|
|
* @return unknown
|
|
*/
|
|
function inputTag ($tag_name, $size=20, $html_options=null) {
|
|
$html_options['size'] = $size;
|
|
$html_options['value'] = isset($html_options['value'])? $html_options['value']: $this->tagValue($tag_name);
|
|
$this->tagIsInvalid($tag_name)? $html_options['class'] = 'form_error': null;
|
|
return sprintf(TAG_INPUT, $tag_name, $this->parseHtmlOptions($html_options, '', ' '));
|
|
}
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @param unknown_type $tag_name
|
|
* @param unknown_type $size
|
|
* @param unknown_type $html_options
|
|
* @return unknown
|
|
*/
|
|
function passwordTag ($tag_name, $size=20, $html_options=null) {
|
|
$html_options['size'] = $size;
|
|
empty($html_options['value'])? $html_options['value'] = $this->tagValue($tag_name): null;
|
|
return sprintf(TAG_PASSWORD, $tag_name, $this->parseHtmlOptions($html_options, '', ' '));
|
|
}
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @param unknown_type $tag_name
|
|
* @param unknown_type $value
|
|
* @param unknown_type $html_options
|
|
* @return unknown
|
|
*/
|
|
function hiddenTag ($tag_name, $value=null, $html_options=null) {
|
|
$html_options['value'] = $value? $value: $this->tagValue($tag_name);
|
|
return sprintf(TAG_HIDDEN, $tag_name, $this->parseHtmlOptions($html_options, '', ' '));
|
|
}
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @param unknown_type $tag_name
|
|
* @param unknown_type $html_options
|
|
* @return unknown
|
|
*/
|
|
function fileTag ($tag_name, $html_options=null) {
|
|
return sprintf(TAG_FILE, $tag_name, $this->parseHtmlOptions($html_options, '', ' '));
|
|
}
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @param unknown_type $tag_name
|
|
* @param unknown_type $cols
|
|
* @param unknown_type $rows
|
|
* @param unknown_type $html_options
|
|
* @return unknown
|
|
*/
|
|
function areaTag ($tag_name, $cols=60, $rows=10, $html_options=null) {
|
|
$value = empty($html_options['value'])? $this->tagValue($tag_name): empty($html_options['value']);
|
|
$html_options['cols'] = $cols;
|
|
$html_options['rows'] = $rows;
|
|
return sprintf(TAG_AREA, $tag_name, $this->parseHtmlOptions($html_options, ' '), $value);
|
|
}
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @param unknown_type $tag_name
|
|
* @param unknown_type $title
|
|
* @param unknown_type $html_options
|
|
* @return unknown
|
|
*/
|
|
function checkboxTag ($tag_name, $title=null, $html_options=null) {
|
|
$this->tagValue($tag_name)? $html_options['checked'] = 'checked': null;
|
|
$title = $title? $title: ucfirst($tag_name);
|
|
return sprintf(TAG_CHECKBOX, $tag_name, $tag_name, $tag_name, $this->parseHtmlOptions($html_options, '', ' '), $title);
|
|
}
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @param unknown_type $tag_name
|
|
* @param unknown_type $options
|
|
* @param unknown_type $inbetween
|
|
* @param unknown_type $html_options
|
|
* @return unknown
|
|
*/
|
|
function radioTags ($tag_name, $options, $inbetween=null, $html_options=null) {
|
|
$value = isset($html_options['value'])? $html_options['value']: $this->tagValue($tag_name);
|
|
$out = array();
|
|
foreach ($options as $opt_value=>$opt_title) {
|
|
$options_here = array('value' => $opt_value);
|
|
$opt_value==$value? $options_here['checked'] = 'checked': null;
|
|
$parsed_options = $this->parseHtmlOptions(array_merge($html_options, $options_here), '', ' ');
|
|
$individual_tag_name = "{$tag_name}_{$opt_value}";
|
|
$out[] = sprintf(TAG_RADIOS, $individual_tag_name, $tag_name, $individual_tag_name, $parsed_options, $opt_title);
|
|
}
|
|
|
|
$out = join($inbetween, $out);
|
|
return $out? $out: null;
|
|
}
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @param unknown_type $tag_name
|
|
* @param unknown_type $options
|
|
* @param unknown_type $outer_options
|
|
* @param unknown_type $inner_options
|
|
* @return unknown
|
|
*/
|
|
function selectTag ($tag_name, $options, $outer_options=null, $inner_options=null) {
|
|
if (!is_array($options) || !count($options))
|
|
return null;
|
|
$selected = isset($html_options['value'])? $html_options['value']: $this->tagValue($tag_name);
|
|
$select[] = sprintf(TAG_SELECT_START, $tag_name, $this->parseHtmlOptions($outer_options));
|
|
$select[] = sprintf(TAG_SELECT_EMPTY, $this->parseHtmlOptions($inner_options));
|
|
|
|
foreach ($options as $name=>$title) {
|
|
$options_here = $selected==$name? array_merge($inner_options, array('selected'=>'selected')): $inner_options;
|
|
$select[] = sprintf(TAG_SELECT_OPTION, $name, $this->parseHtmlOptions($options_here), $title);
|
|
}
|
|
|
|
$select[] = sprintf(TAG_SELECT_END);
|
|
|
|
return implode("\n", $select);
|
|
}
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @param unknown_type $path
|
|
* @param unknown_type $alt
|
|
* @param unknown_type $html_options
|
|
* @return unknown
|
|
*/
|
|
function imageTag ($path, $alt=null, $html_options=null) {
|
|
$url = "{$this->base}/images/{$path}";
|
|
return sprintf(TAG_IMAGE, $url, $alt, $this->parseHtmlOptions($html_options, '', ' '));
|
|
}
|
|
|
|
|
|
/**
|
|
* Returns a CSS link meta-tag
|
|
*
|
|
* @param string $path
|
|
* @param string $rel
|
|
* @param array $html_options
|
|
* @return string
|
|
*/
|
|
function cssTag ($path, $rel='stylesheet', $html_options=null) {
|
|
$url = "{$this->base}/css/{$path}.css";
|
|
return sprintf(TAG_CSS, $rel, $url, $this->parseHtmlOptions($html_options, '', ' '));
|
|
}
|
|
|
|
|
|
/**
|
|
* Returns a charset meta-tag
|
|
*
|
|
* @param string $charset
|
|
* @return string
|
|
*/
|
|
function charsetTag ($charset) {
|
|
return sprintf(TAG_CHARSET, $charset);
|
|
}
|
|
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @param unknown_type $names
|
|
* @param unknown_type $tr_options
|
|
* @param unknown_type $th_options
|
|
* @return unknown
|
|
*/
|
|
function tableHeaders ($names, $tr_options=null, $th_options=null) {
|
|
$args = func_get_args();
|
|
|
|
$out = array();
|
|
foreach ($names as $arg)
|
|
$out[] = sprintf(TAG_TABLE_HEADER, $this->parseHtmlOptions($th_options), $arg);
|
|
|
|
return sprintf(TAG_TABLE_HEADERS, $this->parseHtmlOptions($tr_options), join(' ', $out));
|
|
}
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @param unknown_type $data
|
|
* @param unknown_type $tr_options
|
|
* @param unknown_type $td_options
|
|
* @return unknown
|
|
*/
|
|
function tableCells ($data, $odd_tr_options=null, $even_tr_options=null) {
|
|
if (empty($data[0]) || !is_array($data[0]))
|
|
$data = array($data);
|
|
|
|
$count=0;
|
|
foreach ($data as $line) {
|
|
$count++;
|
|
$cells_out = array();
|
|
foreach ($line as $cell)
|
|
$cells_out[] = sprintf(TAG_TABLE_CELL, null, $cell);
|
|
|
|
$options = $this->parseHtmlOptions($count%2? $odd_tr_options: $even_tr_options);
|
|
$out[] = sprintf(TAG_TABLE_ROW, $options, join(' ', $cells_out));
|
|
}
|
|
|
|
return join("\n", $out);
|
|
}
|
|
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @param unknown_type $tag_name
|
|
* @return unknown
|
|
*/
|
|
function tagValue ($tag_name) {
|
|
return isset($this->params['data'][$tag_name])? $this->params['data'][$tag_name]: false;
|
|
}
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @return unknown
|
|
*/
|
|
function validate () {
|
|
$args = func_get_args();
|
|
$errors = call_user_func_array(array(&$this, 'validateErrors'), $args);
|
|
|
|
return count($errors);
|
|
}
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @return unknown
|
|
*/
|
|
function validateErrors () {
|
|
$objects = func_get_args();
|
|
if (!count($objects)) return false;
|
|
|
|
$errors = array();
|
|
foreach ($objects as $object) {
|
|
$errors = array_merge($errors, $object->invalidFields($object->data));
|
|
}
|
|
|
|
return $this->validationErrors = (count($errors)? $errors: false);
|
|
}
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @param unknown_type $field
|
|
* @param unknown_type $text
|
|
* @return unknown
|
|
*/
|
|
function tagErrorMsg ($field, $text) {
|
|
if ($error = $this->tagIsInvalid($field)) {
|
|
return sprintf(SHORT_ERROR_MESSAGE, is_array($text)? (empty($text[$error-1])? 'Error in field': $text[$error-1]): $text);
|
|
}
|
|
else {
|
|
return null;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @param unknown_type $field
|
|
* @return unknown
|
|
*/
|
|
function tagIsInvalid ($field) {
|
|
return empty($this->validationErrors[$field])? 0: $this->validationErrors[$field];
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @param unknown_type $name
|
|
* @param unknown_type $link
|
|
*/
|
|
function addCrumb ($name, $link) {
|
|
$this->_crumbs[] = array ($name, $link);
|
|
}
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @return unknown
|
|
*/
|
|
function getCrumbs () {
|
|
|
|
if (count($this->_crumbs)) {
|
|
|
|
$out = array("<a href=\"{$this->base}\">START</a>");
|
|
foreach ($this->_crumbs as $crumb) {
|
|
$out[] = "<a href=\"{$this->base}{$crumb[1]}\">{$crumb[0]}</a>";
|
|
}
|
|
|
|
return join(' » ', $out);
|
|
}
|
|
else
|
|
return null;
|
|
}
|
|
|
|
/**
|
|
* Enter description here...
|
|
*
|
|
* @param unknown_type $code
|
|
* @param unknown_type $name
|
|
* @param unknown_type $message
|
|
*/
|
|
function error ($code, $name, $message) {
|
|
header ("HTTP/1.0 {$code} {$name}");
|
|
print ($this->_render(VIEWS.'layouts/error.thtml', array('code'=>$code,'name'=>$name,'message'=>$message)));
|
|
}
|
|
}
|
|
|
|
?>
|