first commit

2020-08-06 14:58:51 +08:00
commit 17096657dc
780 changed files with 92857 additions and 0 deletions
--- a/vendor/symfony/property-access/PropertyAccessorBuilder.php
+++ b/vendor/symfony/property-access/PropertyAccessorBuilder.php
@@ -0,0 +1,140 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\PropertyAccess;
+
+use Psr\Cache\CacheItemPoolInterface;
+
+/**
+ * A configurable builder to create a PropertyAccessor.
+ *
+ * @author Jérémie Augustin <jeremie.augustin@pixel-cookers.com>
+ */
+class PropertyAccessorBuilder
+{
+    /**
+     * @var bool
+     */
+    private $magicCall = false;
+
+    /**
+     * @var bool
+     */
+    private $throwExceptionOnInvalidIndex = false;
+
+    /**
+     * @var CacheItemPoolInterface|null
+     */
+    private $cacheItemPool;
+
+    /**
+     * Enables the use of "__call" by the PropertyAccessor.
+     *
+     * @return $this
+     */
+    public function enableMagicCall()
+    {
+        $this->magicCall = true;
+
+        return $this;
+    }
+
+    /**
+     * Disables the use of "__call" by the PropertyAccessor.
+     *
+     * @return $this
+     */
+    public function disableMagicCall()
+    {
+        $this->magicCall = false;
+
+        return $this;
+    }
+
+    /**
+     * @return bool whether the use of "__call" by the PropertyAccessor is enabled
+     */
+    public function isMagicCallEnabled()
+    {
+        return $this->magicCall;
+    }
+
+    /**
+     * Enables exceptions when reading a non-existing index.
+     *
+     * This has no influence on writing non-existing indices with PropertyAccessorInterface::setValue()
+     * which are always created on-the-fly.
+     *
+     * @return $this
+     */
+    public function enableExceptionOnInvalidIndex()
+    {
+        $this->throwExceptionOnInvalidIndex = true;
+
+        return $this;
+    }
+
+    /**
+     * Disables exceptions when reading a non-existing index.
+     *
+     * Instead, null is returned when calling PropertyAccessorInterface::getValue() on a non-existing index.
+     *
+     * @return $this
+     */
+    public function disableExceptionOnInvalidIndex()
+    {
+        $this->throwExceptionOnInvalidIndex = false;
+
+        return $this;
+    }
+
+    /**
+     * @return bool whether an exception is thrown or null is returned when reading a non-existing index
+     */
+    public function isExceptionOnInvalidIndexEnabled()
+    {
+        return $this->throwExceptionOnInvalidIndex;
+    }
+
+    /**
+     * Sets a cache system.
+     *
+     * @param CacheItemPoolInterface|null $cacheItemPool
+     *
+     * @return PropertyAccessorBuilder The builder object
+     */
+    public function setCacheItemPool(CacheItemPoolInterface $cacheItemPool = null)
+    {
+        $this->cacheItemPool = $cacheItemPool;
+
+        return $this;
+    }
+
+    /**
+     * Gets the used cache system.
+     *
+     * @return CacheItemPoolInterface|null
+     */
+    public function getCacheItemPool()
+    {
+        return $this->cacheItemPool;
+    }
+
+    /**
+     * Builds and returns a new PropertyAccessor object.
+     *
+     * @return PropertyAccessorInterface The built PropertyAccessor
+     */
+    public function getPropertyAccessor()
+    {
+        return new PropertyAccessor($this->magicCall, $this->throwExceptionOnInvalidIndex, $this->cacheItemPool);
+    }
+}