[Summary view] [Print] [Text view]

   1  <?php
   2  /*
   3   * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
   4   * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
   5   * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
   6   * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
   7   * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
   8   * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
   9   * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  10   * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  11   * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  12   * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  13   * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  14   *
  15   * This software consists of voluntary contributions made by many individuals
  16   * and is licensed under the MIT license.
  17   */
  18  
  19  declare(strict_types=1);
  20  
  21  namespace ProxyManager\Factory;
  22  
  23  use ProxyManager\Proxy\AccessInterceptorInterface;
  24  use ProxyManager\ProxyGenerator\AccessInterceptorScopeLocalizerGenerator;
  25  use ProxyManager\ProxyGenerator\ProxyGeneratorInterface;
  26  use ProxyManager\Signature\Exception\InvalidSignatureException;
  27  use ProxyManager\Signature\Exception\MissingSignatureException;
  28  
  29  /**
  30   * Factory responsible of producing proxy objects
  31   *
  32   * @author Marco Pivetta <ocramius@gmail.com>
  33   * @license MIT
  34   */
  35  class AccessInterceptorScopeLocalizerFactory extends AbstractBaseFactory
  36  {
  37      /**
  38       * @var \ProxyManager\ProxyGenerator\AccessInterceptorScopeLocalizerGenerator|null
  39       */
  40      private $generator;
  41  
  42      /**
  43       * @param object     $instance           the object to be localized within the access interceptor
  44       * @param \Closure[] $prefixInterceptors an array (indexed by method name) of interceptor closures to be called
  45       *                                       before method logic is executed
  46       * @param \Closure[] $suffixInterceptors an array (indexed by method name) of interceptor closures to be called
  47       *                                       after method logic is executed
  48       *
  49       * @return AccessInterceptorInterface
  50       *
  51       * @throws InvalidSignatureException
  52       * @throws MissingSignatureException
  53       * @throws \OutOfBoundsException
  54       */
  55      public function createProxy(
  56          $instance,
  57          array $prefixInterceptors = [],
  58          array $suffixInterceptors = []
  59      ) : AccessInterceptorInterface {
  60          $proxyClassName = $this->generateProxy(get_class($instance));
  61  
  62          return $proxyClassName::staticProxyConstructor($instance, $prefixInterceptors, $suffixInterceptors);
  63      }
  64  
  65      /**
  66       * {@inheritDoc}
  67       */
  68      protected function getGenerator() : ProxyGeneratorInterface
  69      {
  70          return $this->generator ?: $this->generator = new AccessInterceptorScopeLocalizerGenerator();
  71      }
  72  }