ObjectAccess.php

Go to the documentation of this file.

<?php
namespace TYPO3\CMS\Extbase\Reflection;

use TYPO3\CMS\Core\Utility\MathUtility;

class ObjectAccess {

    const ACCESS_GET = 0;

    const ACCESS_SET = 1;

    const ACCESS_PUBLIC = 2;

    static public function getProperty($subject, $propertyName, $forceDirectAccess = FALSE) {
        if (!is_object($subject) && !is_array($subject)) {
            throw new \InvalidArgumentException('$subject must be an object or array, ' . gettype($subject) . ' given.', 1237301367);
        }
        if (!is_string($propertyName) && (!is_array($subject) && !$subject instanceof \ArrayAccess)) {
            throw new \InvalidArgumentException('Given property name is not of type string.', 1231178303);
        }
        $propertyExists = FALSE;
        $propertyValue = self::getPropertyInternal($subject, $propertyName, $forceDirectAccess, $propertyExists);
        if ($propertyExists === TRUE) {
            return $propertyValue;
        }
        throw new \TYPO3\CMS\Extbase\Reflection\Exception\PropertyNotAccessibleException('The property "' . $propertyName . '" on the subject was not accessible.', 1263391473);
    }

    static public function getPropertyInternal($subject, $propertyName, $forceDirectAccess, &$propertyExists) {
        if ($subject === NULL || is_scalar($subject)) {
            return NULL;
        }
        $propertyExists = TRUE;
        if (is_array($subject)) {
            if (array_key_exists($propertyName, $subject)) {
                return $subject[$propertyName];
            }
            $propertyExists = FALSE;
            return NULL;
        }
        if ($forceDirectAccess === TRUE) {
            if (property_exists(get_class($subject), $propertyName)) {
                $propertyReflection = new \TYPO3\CMS\Extbase\Reflection\PropertyReflection(get_class($subject), $propertyName);
                return $propertyReflection->getValue($subject);
            } elseif (property_exists($subject, $propertyName)) {
                return $subject->{$propertyName};
            } else {
                throw new \TYPO3\CMS\Extbase\Reflection\Exception\PropertyNotAccessibleException('The property "' . $propertyName . '" on the subject does not exist.', 1302855001);
            }
        }
        if ($subject instanceof \SplObjectStorage || $subject instanceof \TYPO3\CMS\Extbase\Persistence\ObjectStorage) {
            if (MathUtility::canBeInterpretedAsInteger($propertyName)) {
                $index = 0;
                foreach ($subject as $value) {
                    if ($index === (int)$propertyName) {
                        return $value;
                    }
                    $index++;
                }
                $propertyExists = FALSE;
                return NULL;
            }
        } elseif ($subject instanceof \ArrayAccess && isset($subject[$propertyName])) {
            return $subject[$propertyName];
        }
        $getterMethodName = 'get' . ucfirst($propertyName);
        if (is_callable(array($subject, $getterMethodName))) {
            return $subject->{$getterMethodName}();
        }
        $getterMethodName = 'is' . ucfirst($propertyName);
        if (is_callable(array($subject, $getterMethodName))) {
            return $subject->{$getterMethodName}();
        }
        if (is_object($subject) && array_key_exists($propertyName, get_object_vars($subject))) {
            return $subject->{$propertyName};
        }
        $propertyExists = FALSE;
        return NULL;
    }

    static public function getPropertyPath($subject, $propertyPath) {
        $propertyPathSegments = explode('.', $propertyPath);
        foreach ($propertyPathSegments as $pathSegment) {
            $propertyExists = FALSE;
            $subject = self::getPropertyInternal($subject, $pathSegment, FALSE, $propertyExists);
            if (!$propertyExists || $subject === NULL) {
                return $subject;
            }
        }
        return $subject;
    }

    static public function setProperty(&$subject, $propertyName, $propertyValue, $forceDirectAccess = FALSE) {
        if (is_array($subject)) {
            $subject[$propertyName] = $propertyValue;
            return TRUE;
        }
        if (!is_object($subject)) {
            throw new \InvalidArgumentException('subject must be an object or array, ' . gettype($subject) . ' given.', 1237301368);
        }
        if (!is_string($propertyName)) {
            throw new \InvalidArgumentException('Given property name is not of type string.', 1231178878);
        }
        if ($forceDirectAccess === TRUE) {
            if (property_exists(get_class($subject), $propertyName)) {
                $propertyReflection = new \TYPO3\CMS\Extbase\Reflection\PropertyReflection(get_class($subject), $propertyName);
                $propertyReflection->setAccessible(TRUE);
                $propertyReflection->setValue($subject, $propertyValue);
            } else {
                $subject->{$propertyName} = $propertyValue;
            }
        } elseif (is_callable(array($subject, $setterMethodName = self::buildSetterMethodName($propertyName)))) {
            $subject->{$setterMethodName}($propertyValue);
        } elseif ($subject instanceof \ArrayAccess) {
            $subject[$propertyName] = $propertyValue;
        } elseif (array_key_exists($propertyName, get_object_vars($subject))) {
            $subject->{$propertyName} = $propertyValue;
        } else {
            return FALSE;
        }
        return TRUE;
    }

    static public function getGettablePropertyNames($object) {
        if (!is_object($object)) {
            throw new \InvalidArgumentException('$object must be an object, ' . gettype($object) . ' given.', 1237301369);
        }
        if ($object instanceof \stdClass) {
            $declaredPropertyNames = array_keys(get_object_vars($object));
        } else {
            $declaredPropertyNames = array_keys(get_class_vars(get_class($object)));
        }
        foreach (get_class_methods($object) as $methodName) {
            if (is_callable(array($object, $methodName))) {
                if (substr($methodName, 0, 2) === 'is') {
                    $declaredPropertyNames[] = lcfirst(substr($methodName, 2));
                }
                if (substr($methodName, 0, 3) === 'get') {
                    $declaredPropertyNames[] = lcfirst(substr($methodName, 3));
                }
            }
        }
        $propertyNames = array_unique($declaredPropertyNames);
        sort($propertyNames);
        return $propertyNames;
    }

    static public function getSettablePropertyNames($object) {
        if (!is_object($object)) {
            throw new \InvalidArgumentException('$object must be an object, ' . gettype($object) . ' given.', 1264022994);
        }
        if ($object instanceof \stdClass) {
            $declaredPropertyNames = array_keys(get_object_vars($object));
        } else {
            $declaredPropertyNames = array_keys(get_class_vars(get_class($object)));
        }
        foreach (get_class_methods($object) as $methodName) {
            if (substr($methodName, 0, 3) === 'set' && is_callable(array($object, $methodName))) {
                $declaredPropertyNames[] = lcfirst(substr($methodName, 3));
            }
        }
        $propertyNames = array_unique($declaredPropertyNames);
        sort($propertyNames);
        return $propertyNames;
    }

    static public function isPropertySettable($object, $propertyName) {
        if (!is_object($object)) {
            throw new \InvalidArgumentException('$object must be an object, ' . gettype($object) . ' given.', 1259828920);
        }
        if ($object instanceof \stdClass && array_search($propertyName, array_keys(get_object_vars($object))) !== FALSE) {
            return TRUE;
        } elseif (array_search($propertyName, array_keys(get_class_vars(get_class($object)))) !== FALSE) {
            return TRUE;
        }
        return is_callable(array($object, self::buildSetterMethodName($propertyName)));
    }

    static public function isPropertyGettable($object, $propertyName) {
        if (!is_object($object)) {
            throw new \InvalidArgumentException('$object must be an object, ' . gettype($object) . ' given.', 1259828921);
        }
        if ($object instanceof \ArrayAccess && isset($object[$propertyName]) === TRUE) {
            return TRUE;
        } elseif ($object instanceof \stdClass && array_search($propertyName, array_keys(get_object_vars($object))) !== FALSE) {
            return TRUE;
        } elseif ($object instanceof \ArrayAccess && isset($object[$propertyName]) === TRUE) {
            return TRUE;
        }
        if (is_callable(array($object, 'get' . ucfirst($propertyName)))) {
            return TRUE;
        }
        if (is_callable(array($object, 'is' . ucfirst($propertyName)))) {
            return TRUE;
        }
        return array_search($propertyName, array_keys(get_class_vars(get_class($object)))) !== FALSE;
    }

    static public function getGettableProperties($object) {
        if (!is_object($object)) {
            throw new \InvalidArgumentException('$object must be an object, ' . gettype($object) . ' given.', 1237301370);
        }
        $properties = array();
        foreach (self::getGettablePropertyNames($object) as $propertyName) {
            $propertyExists = FALSE;
            $propertyValue = self::getPropertyInternal($object, $propertyName, FALSE, $propertyExists);
            if ($propertyExists === TRUE) {
                $properties[$propertyName] = $propertyValue;
            }
        }
        return $properties;
    }

    static public function buildSetterMethodName($propertyName) {
        return 'set' . ucfirst($propertyName);
    }
}