- md5
- b5721b178c13eb93ff316b25117e38c8
- sha1
- 1660850e2aac34c1fa12ad605d4e41d99ed3e133
- sha256
- f7afb0ce1397730165c4020dde75244434a96b508dcf52c192ec022eb477e1d4
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596
<?php
/**
* Joomla! Content Management System
*
* @copyright (C) 2023 Open Source Matters, Inc. <https://www.joomla.org>
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
namespace Joomla\CMS\Proxy;
// phpcs:disable PSR1.Files.SideEffects
\defined('_JEXEC') or die;
// phpcs:enable PSR1.Files.SideEffects
/**
* Object read-only proxy class.
* The class provides read-only feature for Object, including its children.
*
* @since 5.0.0
*/
class ObjectReadOnlyProxy extends ObjectProxy implements ReadOnlyProxyInterface
{
/**
* Implementing reading from object
*
* @param mixed $key The key name to read
*
* @return mixed
*
* @since 5.0.0
*/
public function __get($key): mixed
{
$value = $this->data->$key ?? null;
// Ensure that the child also is a read-only
if (\is_scalar($value) || $value === null) {
return $value;
}
if (\is_object($value)) {
return new static($value);
}
if (\is_array($value)) {
return new ArrayReadOnlyProxy($value);
}
return $value;
}
/**
* Implementing writing to object
*
* @param mixed $key The key name to write
* @param mixed $value The value to write
*
* @return void
*
* @throws \RuntimeException
*
* @since 5.0.0
*/
public function __set($key, $value): void
{
throw new \RuntimeException(sprintf('ObjectReadOnlyProxy: trying to modify read-only element, by key "%s"', $key));
}
/**
* Implementation of Iterator interface
*
* @return mixed
*
* @since 5.0.0
*/
public function current(): mixed
{
$value = $this->iterator->current();
// Ensure that the child also is a read-only
if (\is_scalar($value) || $value === null) {
return $value;
}
if (\is_object($value)) {
return new static($value);
}
if (\is_array($value)) {
return new ArrayReadOnlyProxy($value);
}
return $value;
}
}
The same content is in 23 releases, Joomla 5.0.0-beta2 to 5.2.0-beta2. See them all, or every version of this file.