- md5
- f2c64fe4d26366123c6bccb4a8d2f0c2
- sha1
- c6218a3ab1f4d7948aabdedcb404ba765412051c
- sha256
- 112ec65b85ac9afad4fc6e3ba342e75c7f27ae2649a304eca4039df3c516a35e
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586
<?php
/**
* Joomla! Content Management System
*
* @copyright (C) 2008 Open Source Matters, Inc. <https://www.joomla.org>
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
namespace Joomla\CMS\HTML\Helpers;
use Joomla\CMS\Document\HtmlDocument;
use Joomla\CMS\Factory;
use Joomla\CMS\Session\Session;
use Joomla\Utilities\ArrayHelper;
// phpcs:disable PSR1.Files.SideEffects
\defined('_JEXEC') or die;
// phpcs:enable PSR1.Files.SideEffects
/**
* Utility class for form elements
*
* @since 1.5
*/
abstract class Form
{
/**
* Array containing information for loaded files.
*
* @var array
*
* @since 3.8.0
*/
protected static $loaded = [];
/**
* Displays a hidden token field to reduce the risk of CSRF exploits
*
* Use in conjunction with Session::checkToken()
*
* @param array $attribs Input element attributes.
*
* @return string A hidden input field with a token
*
* @see Session::checkToken()
* @since 1.5
*/
public static function token(array $attribs = [])
{
$attributes = '';
if ($attribs !== []) {
$attributes .= ' ' . ArrayHelper::toString($attribs);
}
return '<input type="hidden" name="' . Session::getFormToken() . '" value="1"' . $attributes . '>';
}
/**
* Add CSRF form token to Joomla script options that developers can get it by Javascript.
*
* @param string $name The script option key name.
*
* @return void
*
* @since 3.8.0
*/
public static function csrf($name = 'csrf.token')
{
if (isset(static::$loaded[__METHOD__][$name])) {
return;
}
/** @var HtmlDocument $doc */
$doc = Factory::getDocument();
if (!$doc instanceof HtmlDocument || $doc->getType() !== 'html') {
return;
}
$doc->addScriptOptions($name, Session::getFormToken());
static::$loaded[__METHOD__][$name] = true;
}
}
The same content is in 154 releases, Joomla 5.0.0-alpha1 to 6.2.0. See them all, or every version of this file.