CoreFiles by mySites.guru
ArrayReadOnlyProxy.php67 lines, 1,651 bytes, from Joomla_5.0.0-rc-Release_Candidate-Full_Package.zip
Raw History Compare with 4.4.11-rc1
md5
66c186c3adec2a060c9c16a553d1d3fb
sha1
99fdcf1acdc00e033e08a3d133b7dd0c6d1c5e87
sha256
fcfa973bb5d69d749d23f22f3efd0bdce0f28326365c7d94f7e4bc356de63b26
<?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

/**
 * Array read-only proxy class.
 * The class provides read-only feature for Array, including its children.
 *
 * @since  5.0.0
 */
class ArrayReadOnlyProxy extends ArrayProxy implements ReadOnlyProxyInterface
{
    /**
     * Implementation of ArrayAccess interface
     *
     * @param mixed $offset The key to get
     *
     * @return mixed
     *
     * @since  5.0.0
     */
    public function offsetGet(mixed $offset): mixed
    {
        $value = $this->data[$offset] ?? null;

        // Ensure that the child also is a read-only
        if (is_scalar($value) || $value === null) {
            return $value;
        }

        if (\is_array($value)) {
            $value = new static($value);
        } elseif (\is_object($value)) {
            $value = new ObjectReadOnlyProxy($value);
        }

        return $value;
    }

    /**
     * Implementation of ArrayAccess interface
     *
     * @param  mixed   $offset The key to set
     * @param  mixed   $value  The value to set
     *
     * @return void
     *
     * @throws \RuntimeException
     *
     * @since  5.0.0
     */
    public function offsetSet(mixed $offset, mixed $value): void
    {
        throw new \RuntimeException(sprintf('ArrayReadOnlyProxy: trying to modify read-only element, by key "%s"', $offset));
    }
}

The same content is in 15 releases, Joomla 5.0.0-rc to 5.1.0-alpha4. See them all, or every version of this file.