PHP Classes
elePHPant
Icontem

File: vendor/ramsey/uuid/src/UuidFactory.php

Recommend this page to a friend!
  Classes of Renato De Oliveira Lucena  >  PHP Pokemon Script  >  vendor/ramsey/uuid/src/UuidFactory.php  >  Download  
File: vendor/ramsey/uuid/src/UuidFactory.php
Role: Class source
Content type: text/plain
Description: Class source
Class: PHP Pokemon Script
Provides an API to manage a database of Pokemons
Author: By
Last change:
Date: 2 years ago
Size: 8,166 bytes
 

 

Contents

Class file image Download
<?php
/**
 * This file is part of the ramsey/uuid library
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 *
 * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com>
 * @license http://opensource.org/licenses/MIT MIT
 * @link https://benramsey.com/projects/ramsey-uuid/ Documentation
 * @link https://packagist.org/packages/ramsey/uuid Packagist
 * @link https://github.com/ramsey/uuid GitHub
 */

namespace Ramsey\Uuid;

use
Ramsey\Uuid\Converter\NumberConverterInterface;
use
Ramsey\Uuid\Provider\NodeProviderInterface;
use
Ramsey\Uuid\Generator\RandomGeneratorInterface;
use
Ramsey\Uuid\Generator\TimeGeneratorInterface;
use
Ramsey\Uuid\Codec\CodecInterface;
use
Ramsey\Uuid\Builder\UuidBuilderInterface;

class
UuidFactory implements UuidFactoryInterface
{
   
/**
     * @var CodecInterface
     */
   
private $codec = null;

   
/**
     * @var NodeProviderInterface
     */
   
private $nodeProvider = null;

   
/**
     * @var NumberConverterInterface
     */
   
private $numberConverter = null;

   
/**
     * @var RandomGeneratorInterface
     */
   
private $randomGenerator = null;

   
/**
     * @var TimeGeneratorInterface
     */
   
private $timeGenerator = null;

   
/**
     * @var UuidBuilderInterface
     */
   
private $uuidBuilder = null;

   
/**
     * Constructs a `UuidFactory` for creating `Ramsey\Uuid\UuidInterface` instances
     *
     * @param FeatureSet $features A set of features for use when creating UUIDs
     */
   
public function __construct(FeatureSet $features = null)
    {
       
$features = $features ?: new FeatureSet();

       
$this->codec = $features->getCodec();
       
$this->nodeProvider = $features->getNodeProvider();
       
$this->numberConverter = $features->getNumberConverter();
       
$this->randomGenerator = $features->getRandomGenerator();
       
$this->timeGenerator = $features->getTimeGenerator();
       
$this->uuidBuilder = $features->getBuilder();
    }

   
/**
     * Returns the UUID coder-decoder used by this factory
     *
     * @return CodecInterface
     */
   
public function getCodec()
    {
        return
$this->codec;
    }

   
/**
     * Sets the UUID coder-decoder used by this factory
     *
     * @param CodecInterface $codec
     */
   
public function setCodec(CodecInterface $codec)
    {
       
$this->codec = $codec;
    }

   
/**
     * Returns the system node ID provider used by this factory
     *
     * @return NodeProviderInterface
     */
   
public function getNodeProvider()
    {
        return
$this->nodeProvider;
    }

   
/**
     * Returns the random UUID generator used by this factory
     *
     * @return RandomGeneratorInterface
     */
   
public function getRandomGenerator()
    {
        return
$this->randomGenerator;
    }

   
/**
     * Returns the time-based UUID generator used by this factory
     *
     * @return TimeGeneratorInterface
     */
   
public function getTimeGenerator()
    {
        return
$this->timeGenerator;
    }

   
/**
     * Sets the time-based UUID generator this factory will use to generate version 1 UUIDs
     *
     * @param TimeGeneratorInterface $generator
     */
   
public function setTimeGenerator(TimeGeneratorInterface $generator)
    {
       
$this->timeGenerator = $generator;
    }

   
/**
     * Returns the number converter used by this factory
     *
     * @return NumberConverterInterface
     */
   
public function getNumberConverter()
    {
        return
$this->numberConverter;
    }

   
/**
     * Sets the random UUID generator this factory will use to generate version 4 UUIDs
     *
     * @param RandomGeneratorInterface $generator
     */
   
public function setRandomGenerator(RandomGeneratorInterface $generator)
    {
       
$this->randomGenerator = $generator;
    }

   
/**
     * Sets the number converter this factory will use
     *
     * @param NumberConverterInterface $converter
     */
   
public function setNumberConverter(NumberConverterInterface $converter)
    {
       
$this->numberConverter = $converter;
    }

   
/**
     * Returns the UUID builder this factory uses when creating `Uuid` instances
     *
     * @return UuidBuilderInterface $builder
     */
   
public function getUuidBuilder()
    {
        return
$this->uuidBuilder;
    }

   
/**
     * Sets the UUID builder this factory will use when creating `Uuid` instances
     *
     * @param UuidBuilderInterface $builder
     */
   
public function setUuidBuilder(UuidBuilderInterface $builder)
    {
       
$this->uuidBuilder = $builder;
    }

    public function
fromBytes($bytes)
    {
        return
$this->codec->decodeBytes($bytes);
    }

    public function
fromString($uuid)
    {
       
$uuid = strtolower($uuid);
        return
$this->codec->decode($uuid);
    }

    public function
fromInteger($integer)
    {
       
$hex = $this->numberConverter->toHex($integer);
       
$hex = str_pad($hex, 32, '0', STR_PAD_LEFT);

        return
$this->fromString($hex);
    }

    public function
uuid1($node = null, $clockSeq = null)
    {
       
$bytes = $this->timeGenerator->generate($node, $clockSeq);
       
$hex = bin2hex($bytes);

        return
$this->uuidFromHashedName($hex, 1);
    }

    public function
uuid3($ns, $name)
    {
        return
$this->uuidFromNsAndName($ns, $name, 3, 'md5');
    }

    public function
uuid4()
    {
       
$bytes = $this->randomGenerator->generate(16);

       
// When converting the bytes to hex, it turns into a 32-character
        // hexadecimal string that looks a lot like an MD5 hash, so at this
        // point, we can just pass it to uuidFromHashedName.
       
$hex = bin2hex($bytes);

        return
$this->uuidFromHashedName($hex, 4);
    }

    public function
uuid5($ns, $name)
    {
        return
$this->uuidFromNsAndName($ns, $name, 5, 'sha1');
    }

   
/**
     * Returns a `Uuid`
     *
     * Uses the configured builder and codec and the provided array of hexadecimal
     * value UUID fields to construct a `Uuid` object.
     *
     * @param array $fields An array of fields from which to construct a UUID;
     * see {@see \Ramsey\Uuid\UuidInterface::getFieldsHex()} for array structure.
     * @return UuidInterface
     */
   
public function uuid(array $fields)
    {
        return
$this->uuidBuilder->build($this->codec, $fields);
    }

   
/**
     * Returns a version 3 or 5 namespaced `Uuid`
     *
     * @param string|UuidInterface $ns The UUID namespace to use
     * @param string $name The string to hash together with the namespace
     * @param int $version The version of UUID to create (3 or 5)
     * @param string $hashFunction The hash function to use when hashing together
     * the namespace and name
     * @return UuidInterface
     */
   
protected function uuidFromNsAndName($ns, $name, $version, $hashFunction)
    {
        if (!(
$ns instanceof UuidInterface)) {
           
$ns = $this->codec->decode($ns);
        }

       
$hash = call_user_func($hashFunction, ($ns->getBytes() . $name));

        return
$this->uuidFromHashedName($hash, $version);
    }

   
/**
     * Returns a `Uuid` created from `$hash` with the version field set to `$version`
     * and the variant field set for RFC 4122
     *
     * @param string $hash The hash to use when creating the UUID
     * @param int $version The UUID version to set for this hash (1, 3, 4, or 5)
     * @return UuidInterface
     */
   
protected function uuidFromHashedName($hash, $version)
    {
       
$timeHi = BinaryUtils::applyVersion(substr($hash, 12, 4), $version);
       
$clockSeqHi = BinaryUtils::applyVariant(hexdec(substr($hash, 16, 2)));

       
$fields = array(
           
'time_low' => substr($hash, 0, 8),
           
'time_mid' => substr($hash, 8, 4),
           
'time_hi_and_version' => str_pad(dechex($timeHi), 4, '0', STR_PAD_LEFT),
           
'clock_seq_hi_and_reserved' => str_pad(dechex($clockSeqHi), 2, '0', STR_PAD_LEFT),
           
'clock_seq_low' => substr($hash, 18, 2),
           
'node' => substr($hash, 20, 12),
        );

        return
$this->uuid($fields);
    }
}