taguri.php 2.4 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697
  1. <?php
  2. /**
  3. * StatusNet, the distributed open-source microblogging tool
  4. *
  5. * Utility for creating new tag: URIs
  6. *
  7. * PHP version 5
  8. *
  9. * LICENCE: This program is free software: you can redistribute it and/or modify
  10. * it under the terms of the GNU Affero General Public License as published by
  11. * the Free Software Foundation, either version 3 of the License, or
  12. * (at your option) any later version.
  13. *
  14. * This program is distributed in the hope that it will be useful,
  15. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  17. * GNU Affero General Public License for more details.
  18. *
  19. * You should have received a copy of the GNU Affero General Public License
  20. * along with this program. If not, see <http://www.gnu.org/licenses/>.
  21. *
  22. * @category URI
  23. * @package StatusNet
  24. * @author Evan Prodromou <evan@status.net>
  25. * @copyright 2010 StatusNet, Inc.
  26. * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html AGPLv3
  27. * @link http://status.net/
  28. */
  29. if (!defined('STATUSNET')) {
  30. exit(1);
  31. }
  32. /**
  33. * Mint tag: URIs
  34. *
  35. * tag: URIs are unique identifiers according to http://tools.ietf.org/html/rfc4151.
  36. *
  37. * We use them for creating URIs for things that can't be HTTP retrieved.
  38. *
  39. * @category URI
  40. * @package StatusNet
  41. * @author Evan Prodromou <evan@status.net>
  42. * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html AGPLv3
  43. * @link http://status.net/
  44. */
  45. class TagURI
  46. {
  47. /**
  48. * Return the base part of a tag URI
  49. *
  50. * Note: use mint() instead.
  51. *
  52. * @return string Tag URI base to use
  53. */
  54. static function base()
  55. {
  56. $base = common_config('integration', 'taguri');
  57. if (empty($base)) {
  58. $base = common_config('site', 'server').','.date('Y-m-d');
  59. $pathPart = trim(common_config('site', 'path'), '/');
  60. if (!empty($pathPart)) {
  61. $base .= ':'.str_replace('/', ':', $pathPart);
  62. }
  63. }
  64. return $base;
  65. }
  66. /**
  67. * Make a new tag URI
  68. *
  69. * Builds the proper base and creates all the parts
  70. *
  71. * @return string minted URI
  72. */
  73. static function mint()
  74. {
  75. $base = self::base();
  76. $args = func_get_args();
  77. $format = array_shift($args);
  78. $extra = vsprintf($format, $args);
  79. return 'tag:'.$base.':'.$extra;
  80. }
  81. }