microid.php 2.45 KB
Newer Older
Evan Prodromou's avatar
Evan Prodromou committed
1 2
<?php
/**
3
 * StatusNet, the distributed open-source microblogging tool
Evan Prodromou's avatar
Evan Prodromou committed
4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22
 *
 * Microid class
 *
 * PHP version 5
 *
 * LICENCE: This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Affero General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Affero General Public License for more details.
 *
 * You should have received a copy of the GNU Affero General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 *
 * @category  ID
23
 * @package   StatusNet
24
 * @author    Evan Prodromou <evan@status.net>
25
 * @copyright 2008 StatusNet, Inc.
Evan Prodromou's avatar
Evan Prodromou committed
26
 * @license   http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
27
 * @link      http://status.net/
Evan Prodromou's avatar
Evan Prodromou committed
28 29
 */

30
if (!defined('STATUSNET') && !defined('LACONICA')) {
Evan Prodromou's avatar
Evan Prodromou committed
31 32 33 34 35 36 37
    exit(1);
}

/**
 * A class for microids
 *
 * @category ID
38
 * @package  StatusNet
39
 * @author   Evan Prodromou <evan@status.net>
Evan Prodromou's avatar
Evan Prodromou committed
40
 * @license  http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
41
 * @link     http://status.net/
Evan Prodromou's avatar
Evan Prodromou committed
42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97
 * @see      http://microid.org/
 */

class Microid
{
    /** Agent part of the ID. */

    var $agent = null;

    /** Resource part of the ID. */

    var $resource = null;

    /**
     * Constructor
     *
     * @param string $agent    Agent of the ID
     * @param string $resource Resource part
     */

    function __construct($agent, $resource)
    {
        $this->agent    = $agent;
        $this->resource = $resource;

    }

    /**
     * Generate a MicroID string
     *
     * @return string MicroID for agent and resource
     */

    function toString()
    {
        $agent_proto    = $this->_getProto($this->agent);
        $resource_proto = $this->_getProto($this->resource);

        return $agent_proto.'+'.$resource_proto.':sha1:'.
          sha1(sha1($this->agent).sha1($this->resource));
    }

    /**
     * Utility for getting the protocol part of a URI
     *
     * @param string $uri URI to parse
     *
     * @return string scheme part of the URI
     */

    function _getProto($uri)
    {
        $colon = strpos($uri, ':');
        return substr($uri, 0, $colon);
    }
}