uuid.php 3.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111
  1. <?php
  2. /**
  3. * StatusNet - the distributed open-source microblogging tool
  4. * Copyright (C) 2010, StatusNet, Inc.
  5. *
  6. * UUID generation
  7. *
  8. * PHP version 5
  9. *
  10. * This program is free software: you can redistribute it and/or modify
  11. * it under the terms of the GNU Affero General Public License as published by
  12. * the Free Software Foundation, either version 3 of the License, or
  13. * (at your option) any later version.
  14. *
  15. * This program is distributed in the hope that it will be useful,
  16. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  17. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  18. * GNU Affero General Public License for more details.
  19. *
  20. * You should have received a copy of the GNU Affero General Public License
  21. * along with this program. If not, see <http://www.gnu.org/licenses/>.
  22. *
  23. * @category UUID
  24. * @package StatusNet
  25. * @author Evan Prodromou <evan@status.net>
  26. * @copyright 2010 StatusNet, Inc.
  27. * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html AGPL 3.0
  28. * @link http://status.net/
  29. */
  30. if (!defined('STATUSNET')) {
  31. // This check helps protect against security problems;
  32. // your code file can't be executed directly from the web.
  33. exit(1);
  34. }
  35. /**
  36. * UUID generation
  37. *
  38. * @category General
  39. * @package StatusNet
  40. * @author Evan Prodromou <evan@status.net>
  41. * @copyright 2010 StatusNet, Inc.
  42. * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html AGPL 3.0
  43. * @link http://status.net/
  44. */
  45. class UUID
  46. {
  47. const REGEX = '[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}';
  48. protected $str = null;
  49. /**
  50. * Constructor for a UUID
  51. *
  52. * Uses gen() to create a new UUID
  53. */
  54. function __construct()
  55. {
  56. $this->str = self::gen();
  57. }
  58. /**
  59. * For serializing to a string
  60. *
  61. * @return string version of self
  62. */
  63. function __toString()
  64. {
  65. return $this->str;
  66. }
  67. /**
  68. * For serializing to a string
  69. *
  70. * @return string version of self
  71. */
  72. function getString()
  73. {
  74. return $this->str;
  75. }
  76. /**
  77. * Generate a new UUID
  78. *
  79. * @return 36-char v4 (random-ish) UUID
  80. */
  81. static function gen()
  82. {
  83. return sprintf('%s-%s-%04x-%04x-%s',
  84. // 32 bits for "time_low"
  85. common_random_hexstr(4),
  86. // 16 bits for "time_mid"
  87. common_random_hexstr(2),
  88. // 16 bits for "time_hi_and_version",
  89. // four most significant bits holds version number 4
  90. (hexdec(common_random_hexstr(2)) & 0x0fff) | 0x4000,
  91. // 16 bits, 8 bits for "clk_seq_hi_res",
  92. // 8 bits for "clk_seq_low",
  93. // two most significant bits holds zero and one
  94. // for variant DCE1.1
  95. (hexdec(common_random_hexstr(2)) & 0x3fff) | 0x8000,
  96. // 48 bits for "node"
  97. common_random_hexstr(6));
  98. }
  99. }