SessionId.php 1.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071
  1. <?php
  2. /**
  3. * MediaWiki session ID holder
  4. *
  5. * This program is free software; you can redistribute it and/or modify
  6. * it under the terms of the GNU General Public License as published by
  7. * the Free Software Foundation; either version 2 of the License, or
  8. * (at your option) any later version.
  9. *
  10. * This program is distributed in the hope that it will be useful,
  11. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  13. * GNU General Public License for more details.
  14. *
  15. * You should have received a copy of the GNU General Public License along
  16. * with this program; if not, write to the Free Software Foundation, Inc.,
  17. * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  18. * http://www.gnu.org/copyleft/gpl.html
  19. *
  20. * @file
  21. * @ingroup Session
  22. */
  23. namespace MediaWiki\Session;
  24. /**
  25. * Value object holding the session ID in a manner that can be globally
  26. * updated.
  27. *
  28. * This class exists because we want WebRequest to refer to the session, but it
  29. * can't hold the Session itself due to issues with circular references and it
  30. * can't just hold the ID as a string because we need to be able to update the
  31. * ID when SessionBackend::resetId() is called.
  32. *
  33. * @ingroup Session
  34. * @since 1.27
  35. */
  36. final class SessionId {
  37. /** @var string */
  38. private $id;
  39. /**
  40. * @param string $id
  41. */
  42. public function __construct( $id ) {
  43. $this->id = $id;
  44. }
  45. /**
  46. * Get the ID
  47. * @return string
  48. */
  49. public function getId() {
  50. return $this->id;
  51. }
  52. /**
  53. * Set the ID
  54. * @private For use by \MediaWiki\Session\SessionManager only
  55. * @param string $id
  56. */
  57. public function setId( $id ) {
  58. $this->id = $id;
  59. }
  60. public function __toString() {
  61. return $this->id;
  62. }
  63. }