- md5
- 2ebb856ab20025e66ae71486fa530075
- sha1
- dee21e57d227aefd70c135e7927e97d457d63061
- sha256
- 5dd15b11288896aad8d32cf203f8d0e6a50674370b116f5eba511f59b211b31a
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239
<?php
/**
* Joomla! Content Management System
*
* @copyright Copyright (C) 2005 - 2019 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
namespace Joomla\CMS\Session;
defined('JPATH_PLATFORM') or die;
use Joomla\CMS\Application\ApplicationHelper;
use Joomla\CMS\Factory;
use Joomla\CMS\Language\Text;
use Joomla\CMS\Log\Log;
use Joomla\CMS\Router\Route;
use Joomla\Session\Session as BaseSession;
/**
* Class for managing HTTP sessions
*
* @since 1.5
*/
class Session extends BaseSession
{
/**
* Checks for a form token in the request.
*
* Use in conjunction with HTMLHelper::_('form.token') or JSession::getFormToken.
*
* @param string $method The request method in which to look for the token key.
*
* @return boolean True if found and valid, false otherwise.
*
* @since 2.5.4
*/
public static function checkToken($method = 'post')
{
$app = Factory::getApplication();
$token = static::getFormToken();
// Check from header first
if ($token === $app->input->server->get('HTTP_X_CSRF_TOKEN', '', 'alnum'))
{
return true;
}
// Then fallback to HTTP query
if (!$app->input->$method->get($token, '', 'alnum'))
{
if ($app->getSession()->isNew())
{
// Redirect to login screen.
$app->enqueueMessage(Text::_('JLIB_ENVIRONMENT_SESSION_EXPIRED'), 'warning');
$app->redirect(Route::_('index.php'));
return true;
}
return false;
}
return true;
}
/**
* Method to determine a hash for anti-spoofing variable names
*
* @param boolean $forceNew If true, force a new token to be created
*
* @return string Hashed var name
*
* @since 1.6
*/
public static function getFormToken($forceNew = false)
{
$user = Factory::getUser();
return ApplicationHelper::getHash($user->get('id', 0) . Factory::getApplication()->getSession()->getToken($forceNew));
}
/**
* Returns the global session object.
*
* @return static The Session object.
*
* @since 1.5
* @deprecated 5.0 Load the session service from the dependency injection container or via $app->getSession()
*/
public static function getInstance()
{
Log::add(
__METHOD__ . '() is deprecated. Load the session from the dependency injection container or via Factory::getApplication()->getSession().',
Log::WARNING,
'deprecated'
);
return Factory::getApplication()->getSession();
}
/**
* Get data from the session store
*
* @param string $name Name of a variable
* @param mixed $default Default value of a variable if not set
*
* @return mixed Value of a variable
*
* @since 1.5
*/
public function get($name, $default = null)
{
// Handle B/C by checking if a namespace was passed to the method, will be removed at 5.0
if (func_num_args() > 2)
{
$args = func_get_args();
if (!empty($args[2]))
{
Log::add(
'Passing a namespace as a parameter to ' . __METHOD__ . '() is deprecated. The namespace should be prepended to the name instead.',
Log::WARNING,
'deprecated'
);
$name = $args[2] . '.' . $name;
}
}
return parent::get($name, $default);
}
/**
* Set data into the session store.
*
* @param string $name Name of a variable.
* @param mixed $value Value of a variable.
*
* @return mixed Old value of a variable.
*
* @since 1.5
*/
public function set($name, $value = null)
{
// Handle B/C by checking if a namespace was passed to the method, will be removed at 5.0
if (func_num_args() > 2)
{
$args = func_get_args();
if (!empty($args[2]))
{
Log::add(
'Passing a namespace as a parameter to ' . __METHOD__ . '() is deprecated. The namespace should be prepended to the name instead.',
Log::WARNING,
'deprecated'
);
$name = $args[2] . '.' . $name;
}
}
return parent::set($name, $value);
}
/**
* Check whether data exists in the session store
*
* @param string $name Name of variable
*
* @return boolean True if the variable exists
*
* @since 1.5
*/
public function has($name)
{
// Handle B/C by checking if a namespace was passed to the method, will be removed at 5.0
if (func_num_args() > 1)
{
$args = func_get_args();
if (!empty($args[1]))
{
Log::add(
'Passing a namespace as a parameter to ' . __METHOD__ . '() is deprecated. The namespace should be prepended to the name instead.',
Log::WARNING,
'deprecated'
);
$name = $args[1] . '.' . $name;
}
}
return parent::has($name);
}
/**
* Clears all variables from the session store
*
* @return void
*
* @since 1.5
*/
public function clear()
{
// Handle B/C by checking if parameters were passed to this method; if so proxy to the new remove() method, will be removed at 5.0
if (func_num_args() >= 1)
{
$args = func_get_args();
if (!empty($args[0]))
{
Log::add(
'Using ' . __METHOD__ . '() to remove a single element from the session is deprecated. Use ' . __CLASS__ . '::remove() instead.',
Log::WARNING,
'deprecated'
);
$name = $args[0];
// Also check for a namespace
if (func_num_args() > 1 && !empty($args[1]))
{
Log::add(
'Passing a namespace as a parameter to ' . __METHOD__ . '() is deprecated. The namespace should be prepended to the name instead.',
Log::WARNING,
'deprecated'
);
$name = $args[1] . '.' . $name;
}
return $this->remove($name);
}
}
return parent::clear();
}
}
The same content is in 4 releases, Joomla 4.0.0-alpha7 to 4.0.0-alpha10. See them all, or every version of this file.